این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Engage SDK Other Verticals: دستورالعمل‌های یکپارچه‌سازی فنی شخص ثالث، سایر عمودی‌ها Engage SDK: دستورالعمل‌های یکپارچه‌سازی فنی شخص ثالث

Google در حال ساخت یک سطح روی دستگاه است که برنامه های کاربران را بر اساس عمودی سازماندهی می کند و یک تجربه همهجانبه جدید را برای مصرف شخصی و کشف محتوای برنامه امکان پذیر می کند. این تجربه تمام صفحه به شرکای توسعه‌دهنده فرصتی می‌دهد تا بهترین محتوای غنی خود را در یک کانال اختصاصی خارج از برنامه خود به نمایش بگذارند.

این سند حاوی دستورالعمل‌هایی برای شرکای توسعه‌دهنده است تا محتوای جدیدی مانند رزرواسیون، رویدادها، مکان‌های اقامتی، مکان‌های دیدنی، افراد و سایر محتواها را ادغام کنند. با استفاده از Engage SDK برای پر کردن این سطح جدید، ممکن است به هیچ یک از این دسته‌ها تعلق نداشته باشند.

جزئیات یکپارچه سازی

اصطلاحات

این ادغام شامل سه نوع خوشه زیر است: توصیه ، ویژه و ادامه .

خوشه‌های توصیه ، پیشنهادهای شخصی‌شده از یک شریک توسعه‌دهنده را نشان می‌دهند. این یک نمای رابط کاربری است که شامل گروهی از توصیه‌های یک شریک توسعه‌دهنده است.
- ArticleEntity : ArticleEntity که یک توصیه مبتنی بر متن برای محتوای مرتبط با بیش از یک دسته محتوا را نشان می دهد. آیتم ArticleEntity به توسعه دهندگان این امکان را می دهد که محتوای متنی و تصویری متنوعی را با ابرداده های بیشتری برای بیان اطلاعات به کاربران در مقایسه با GenericFeaturedEntity ارائه دهند. مثال: محتوای بازاریابی، قطعه خبر
  شکل 1: UI که یک ArticleEntity را در کلاستر Recommendations نشان می دهد.
- EventEntity : EventEntity نشان دهنده رویدادی است که در آینده اتفاق می افتد. زمان شروع رویداد یک بخش مهم از اطلاعات است که باید به کاربران منتقل شود.
  شکل 2: رابط کاربری که یک EventEntity را در کلاستر Recommendations نشان می دهد.
- LodgingEntity : LodgingEntity نشان دهنده محل اقامتی مانند هتل، آپارتمان، خانه تعطیلات برای اجاره کوتاه مدت و بلند مدت است.
  شکل 3: UI که یک LodgingEntity را در کلاستر Recommendations نشان می دهد.
- StoreEntity : StoreEntity یک فروشگاه، رستوران، کافه و غیره را نشان می‌دهد. محتوایی را که در آن مکان غذاخوری یا فروشگاه، بخش مهمی از اطلاعات است که باید به کاربران منتقل شود، برجسته می‌کند.
  شکل 4: رابط کاربری که یک StoreEntity را در کلاستر Recommendations نشان می دهد.
- PointOfInterestEntity : PointOfInterestEntity نشان دهنده مکان مورد علاقه مانند، پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه توریستی، مسیر پیاده روی و غیره است. محتوایی را برجسته می کند که در آن مکان یک قطعه اطلاعات مهم است که باید به کاربران منتقل شود. نباید برای اقامت، فروشگاه یا محل غذاخوری استفاده شود.
  شکل 5: رابط کاربری که یک PointOfInterestEntity را در کلاستر Recommendations نشان می دهد.
- PersonEntity : PersonEntity نماینده یک شخص است. توصیه‌ها می‌تواند برجسته کردن یک فرد در دسته‌هایی مانند سلامت و تناسب اندام، ورزش، دوستیابی و غیره باشد.
  شکل 5: UI که یک PersonEntity منفرد را در خوشه Recommendations نشان می دهد.
خوشه Continuation محتوایی را نشان می‌دهد که اخیراً توسط کاربران چند شریک توسعه‌دهنده در یک گروه UI واحد درگیر شده است. هر شریک توسعه دهنده مجاز است حداکثر 10 موجودیت را در خوشه Continuation پخش کند.
محتوای ادامه شما می تواند ساختار زیر را داشته باشد:
- ArticleEntity : ArticleEntity که یک توصیه مبتنی بر متن برای محتوای مرتبط با بیش از یک دسته محتوا را نشان می دهد. این موجودیت می تواند برای نشان دادن مقالات خبری ناتمام یا سایر محتوایی که کاربر مایل است از جایی که آن را ترک کرده است به مصرف خود ادامه دهد، استفاده شود. مثال: محتوای بازاریابی، قطعه خبر
  شکل 6. UI که یک ArticleEntity منفرد را در یک Cluster Continuation نشان می دهد.
- RestaurantReservationEntity : RestaurantReservationEntity نشان دهنده رزرو یک رستوران یا کافه است و به کاربران کمک می کند تا رزروهای رستوران آتی یا در حال انجام را پیگیری کنند.
  شکل 7. UI که یک RestaurantReservationEntity را در یک Cluster Continuation نشان می دهد.
- EventReservationEntity : EventReservationEntity یک رزرو برای یک رویداد را نشان می دهد و به کاربران کمک می کند رزرو رویدادهای آینده یا در حال انجام را پیگیری کنند. رویدادها می توانند شامل موارد زیر باشند، اما نه محدود به آنها:
  - رویدادهای ورزشی مانند رزرو برای یک مسابقه فوتبال
  - رویدادهای بازی مانند رزرو برای ورزش های الکترونیکی
  - رویدادهای سرگرمی مانند رزرو فیلم در سینما، کنسرت، تئاتر، امضای کتاب
  - رزرو سفر یا نقاط مورد علاقه مانند تورهای راهنما، بلیط موزه
  - اجتماعی / سمینار / کنفرانس ها رزرو
  - آموزش / رزرو جلسات آموزشی
  شکل 8. UI که یک EventReservationEntity را در یک Cluster Continuation نشان می دهد.
- LodgingReservationEntity : LodgingEntityReservation نشان‌دهنده رزرو اقامتگاه مسافرتی است و به کاربران کمک می‌کند رزروهای آتی یا جاری هتل یا تعطیلات را ردیابی کنند.
  شکل 9. UI که یک LodgingReservationEntity را در یک Cluster Continuation نشان می دهد.
- TransportationReservationEntity : TransportationReservationEntity نشان دهنده یک رزرو برای حمل و نقل با هر حالتی است و به کاربران کمک می کند تا رزروهای مربوط به پرواز، کشتی، قطار، اتوبوس، سواری-تگرگ یا کروز آینده یا جاری را پیگیری کنند.
  شکل 10. UI که یک TransportationReservationEntity را در یک Cluster Continuation نشان می دهد.
- VehicleRentalReservationEntity : VehicleRentalReservationEntity یک رزرو خودروی اجاره ای را نشان می دهد و به کاربران کمک می کند تا رزروهای اجاره خودروی آینده یا در حال انجام را پیگیری کنند.
  شکل 11. UI که یک VehicleRentalReservationEntity را در یک Cluster Continuation نشان می دهد.
خوشه Featured یک نمای رابط کاربری است که قهرمان انتخاب شده GenericFeaturedEntity را از بسیاری از شرکای توسعه دهنده در یک گروه UI به نمایش می گذارد. یک خوشه ویژه وجود دارد که در نزدیکی بالای رابط کاربری ظاهر شده است، با اولویت بالاتر از همه خوشه‌های توصیه. هر شریک توسعه‌دهنده مجاز است یک موجودیت واحد از نوع پشتیبانی‌شده را در «ویژگی‌ها» با تعداد زیادی نهاد (احتمالاً از انواع مختلف) از چندین برنامه‌نویس برنامه در خوشه ویژه پخش کند.
- GenericFeaturedEntity : GenericFeaturedEntity با آیتم توصیه تفاوت دارد زیرا آیتم Featured باید برای یک محتوای برتر از توسعه دهندگان استفاده شود و باید مهمترین محتوایی را نشان دهد که برای کاربران جالب و مرتبط باشد.
  شکل 12: رابط کاربری یک کارت GenericFeaturedEntity قهرمان واحد را در یک خوشه ویژه نشان می دهد

قبل از کار

حداقل سطح API: 19

کتابخانه com.google.android.engage:engage-core به برنامه خود اضافه کنید:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

خلاصه

طراحی بر اساس اجرای یک سرویس محدود است.

داده‌هایی که مشتری می‌تواند منتشر کند مشمول محدودیت‌های زیر برای انواع مختلف خوشه است:

نوع خوشه	محدودیت های خوشه ای	حداقل محدودیت موجودیت در یک خوشه	حداکثر محدودیت موجودیت در یک خوشه
خوشه(های) توصیه	حداکثر 5	حداقل 5	حداکثر 25 ( `ArticleEntity` ، `EventEntity` ، `LodgingEntity` ، `StoreEntity` ، `PointOfInterestEntity` ، یا `PersonEntity` )
خوشه ادامه	حداکثر 1	حداقل 1	حداکثر 10 ( `ArticleEntity` ، `EventReservationEntity` ، `LodgingReservationEntity` ، `TransportationReservationEntity` ، یا `VehicleRentalReservationEntity` )
خوشه برجسته	حداکثر 1	حداقل 1	حداکثر 10 ( `GenericFeaturedEntity` )

مرحله 1: داده های موجودیت را ارائه دهید

SDK موجودیت های مختلفی را برای نشان دادن هر نوع مورد تعریف کرده است. ما نهادهای زیر را برای دسته دیگر پشتیبانی می کنیم:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

نمودارهای زیر ویژگی ها و الزامات موجود برای هر نوع را مشخص می کند.

`GenericFeaturedEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
تصاویر پوستر	مورد نیاز	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
عنوان	اختیاری	عنوان نهاد.	متن رایگان اندازه متن پیشنهادی: 50 کاراکتر
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. درمان ویژه UX در بالای تصویر/فیلم، به عنوان مثال، به عنوان همپوشانی نشان روی تصویر "به روز رسانی زنده" مدت زمان خواندن مقاله
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
دسته بندی های محتوا	اختیاری	دسته بندی محتوا را در موجودیت توضیح دهید.	فهرست Enums برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

`ArticleEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	متن رایگان اندازه متن پیشنهادی: حداکثر 50 کاراکتر
تصاویر پوستر	اختیاری	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
منبع - عنوان	اختیاری	نام نویسنده، سازمان یا گزارشگر	متن رایگان اندازه متن پیشنهادی: زیر 25 کاراکتر
منبع - تصویر	اختیاری	تصویری از منبع مانند نویسنده، سازمان، گزارشگر	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. درمان ویژه UX در بالای تصویر/ویدئو، به عنوان مثال به عنوان پوشش نشان روی تصویر "به روز رسانی زنده" مدت زمان خواندن مقاله
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
زمان انتشار محتوا	اختیاری	این مهر زمانی در میلی ثانیه در زمانی است که محتوا در برنامه منتشر شد/به‌روزرسانی شد.	مهر زمانی دوره در میلی ثانیه
آخرین زمان نامزدی	مشروط الزامی است	مهر زمانی دوره در میلی ثانیه زمانی که کاربر آخرین بار با این موجودیت تعامل داشت. توجه: اگر این موجودیت بخشی از خوشه ادامه باشد، این فیلد ضروری است.	مهر زمانی دوره در میلی ثانیه
درصد پیشرفت	مشروط الزامی است	درصد محتوای کامل مصرف شده توسط کاربر تا به امروز. توجه: اگر این موجودیت بخشی از خوشه ادامه باشد، این فیلد ضروری است.	مقدار int بین 0 تا 100 شامل.
دسته بندی های محتوا	اختیاری	دسته بندی محتوا را در موجودیت توضیح دهید.	فهرست Enums برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

`EventEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
زمان شروع	مورد نیاز	مهر زمانی دورانی که انتظار می رود رویداد شروع شود. توجه: این در میلی ثانیه نمایش داده می شود.	مهر زمانی دوره در میلی ثانیه
حالت رویداد	مورد نیاز	فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود.	تعداد: VIRTUAL، IN_PERSON، یا HYBRID
تصاویر پوستر	مورد نیاز	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
مکان - کشور	مشروط الزامی است	کشوری که رویداد در آن رخ می دهد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - شهر	مشروط الزامی است	شهری که رویداد در آن اتفاق می افتد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - نشانی نمایش	مشروط الزامی است	آدرس یا نام محل برگزاری رویداد که باید به کاربر نمایش داده شود. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) مکانی که رویداد در آن میزبانی می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که رویداد در آن میزبانی می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) مکانی که رویداد در آن میزبانی می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
محل - محله	اختیاری	محله ای (در صورت وجود) که رویداد در آن برگزار می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
زمان پایان	اختیاری	مهر زمانی دوره ای که انتظار می رود رویداد به پایان برسد. توجه: این در میلی ثانیه نمایش داده می شود.	مهر زمانی دوره در میلی ثانیه
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
قیمت - قیمت فعلی	مشروط مورد نیاز است	قیمت فعلی بلیط/گذرنامه برای رویداد. در صورت ارائه قیمت خطی باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی بلیط/گذرنامه برای رویداد.	متن رایگان
فراخوان قیمت	اختیاری	اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
دسته بندی های محتوا	اختیاری	دسته بندی محتوا را در موجودیت توضیح دهید.	فهرست فهرست های واجد شرایط TYPE_MOVIES_AND_TV_SHOWS (مثال - سینما) TYPE_DIGITAL_GAMES (مثال - ورزشهای الکترونیکی) TYPE_MUSIC (مثال - کنسرت) TYPE_TRAVEL_AND_LOCAL (مثال - تور، جشنواره) TYPE_HEALTH_AND_FITENESS (مثال - کلاس یوگا) TYPE_EDUCATION (مثال - کلاس) TYPE_SPORTS (مثال - بازی فوتبال) TYPE_DATING (مثال - ملاقات) برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

`LodgingEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
تصاویر پوستر	مورد نیاز	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
مکان - کشور	مورد نیاز	کشوری که اقامت در آن اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - شهر	مورد نیاز	شهری که در آن اقامتگاه اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - نشانی نمایش	مورد نیاز	آدرس اقامتگاهی که به کاربر نمایش داده می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) محل اقامت.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که اقامتگاه در آن واقع شده است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) اقامتگاه.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
محل - محله	اختیاری	محله (در صورت وجود) محل اقامت.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
AvailabilityTimeWindow - زمان شروع	اختیاری	زمانی که انتظار می‌رود اقامتگاه باز/در دسترس باشد، مهر زمانی دوره در میلی‌ثانیه است.	مهر زمانی دوره در میلی ثانیه
AvailabilityTimeWindow - زمان پایان	اختیاری	مهر زمانی دوره در میلی ثانیه که انتظار می‌رود اقامتگاه باز/در دسترس باشد.	مهر زمانی دوره در میلی ثانیه
رتبه - حداکثر مقدار	اختیاری	حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه - ارزش فعلی	اختیاری	ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه بندی - شمارش	اختیاری	شمارش رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما نحوه نمایش تعداد به کاربران را کنترل می‌کند، این قسمت را وارد کنید. از یک رشته مختصر استفاده کنید. به عنوان مثال، اگر تعداد 1,000,000 باشد، از مخفف‌هایی مانند 1M استفاده کنید تا این تعداد در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	شمارش رتبه بندی برای اقامتگاه. توجه: اگر خودتان منطق مخفف نمایشگر را مدیریت نمی‌کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، تعداد به کاربران نمایش داده می شود.	طولانی
قیمت - قیمت فعلی	مشروط مورد نیاز است	قیمت فعلی اقامتگاه در صورت ارائه قیمت خطی باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی اقامتگاه، که در UI مشخص شده است.	متن رایگان
فراخوان قیمت	اختیاری	اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

`StoreEntity`

شی StoreEntity نشان دهنده یک فروشگاه فردی است که شرکای توسعه دهنده می خواهند منتشر کنند، مانند یک رستوران یا یک فروشگاه مواد غذایی.

صفت	مورد نیاز	توضیحات	قالب
تصاویر پوستر	مورد نیاز	حداقل یک تصویر باید ارائه شود.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	اختیاری	نام فروشگاه.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
مکان	اختیاری	موقعیت فروشگاه.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
فراخوانی	اختیاری	فراخوانی برای ارائه تبلیغات، رویداد یا به‌روزرسانی برای فروشگاه، در صورت وجود.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
چاپ ریز چاپ	اختیاری	متن چاپ دقیق برای فراخوانی.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
توضیحات	اختیاری	توضیحات فروشگاه	متن رایگان اندازه متن توصیه شده: کمتر از 90 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
رتبه - حداکثر مقدار	اختیاری	حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه - ارزش فعلی	اختیاری	ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه بندی - شمارش	اختیاری	شمارش رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	شمارش رتبه بندی برای اقامتگاه. توجه: اگر نمی‌خواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد	طولانی

`PointOfInterestEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
تصاویر پوستر	مورد نیاز	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
مکان - کشور	مورد نیاز	کشوری که نقطه مورد علاقه در آن اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - شهر	مورد نیاز	شهری که نقطه دیدنی در آن اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - نشانی نمایش	مورد نیاز	آدرس نقطه مورد علاقه که به کاربر نمایش داده می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) نقطه مورد علاقه.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که نقطه مورد نظر در آن واقع شده است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) نقطه مورد علاقه.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
محل - محله	اختیاری	محله (در صورت وجود) نقطه مورد علاقه.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
AvailabilityTimeWindow - زمان شروع	اختیاری	زمانی که انتظار می‌رود نقطه مورد نظر باز/در دسترس باشد، مهر زمانی دوره در میلی‌ثانیه است.	مهر زمانی دوره در میلی ثانیه
AvailabilityTimeWindow - زمان پایان	اختیاری	مهر زمانی دوره در میلی ثانیه که انتظار می رود نقطه مورد نظر باز/در دسترس باشد.	مهر زمانی دوره در میلی ثانیه
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
رتبه - حداکثر مقدار	اختیاری	حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه - ارزش فعلی	اختیاری	ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه بندی - شمارش	اختیاری	شمارش رتبه بندی برای نقطه مورد علاقه. توجه: اگر برنامه شما نحوه نمایش تعداد به کاربران را کنترل می‌کند، این قسمت را وارد کنید. از یک رشته مختصر استفاده کنید. به عنوان مثال، اگر تعداد 1,000,000 باشد، از مخفف‌هایی مانند 1M استفاده کنید تا این تعداد در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	شمارش رتبه بندی برای نقطه مورد علاقه. توجه: اگر خودتان از منطق اختصارات نمایشگر استفاده نمی کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، تعداد به کاربران نمایش داده می شود	طولانی
قیمت - قیمت فعلی	مشروط مورد نیاز است	قیمت فعلی بلیت / مجوز ورود برای نقطه مورد علاقه. در صورت ارائه قیمت خطی باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی بلیط / مجوز ورود برای نقطه مورد علاقه.	متن رایگان
فراخوان قیمت	اختیاری	اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.	متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)
دسته بندی های محتوا	اختیاری	دسته بندی محتوا را در موجودیت توضیح دهید.	فهرست فهرست های واجد شرایط TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (مثال - تئاتر) TYPE_MEDICAL (مثال - بیمارستان) TYPE_EDUCATION (مثال - مدرسه) TYPE_SPORTS (مثال - استادیوم) برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

`PersonEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
مشخصات - نام	مورد نیاز	نام یا شناسه یا دسته نمایه، به عنوان مثال "John Doe"، "@TeamPixel"، و غیره.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
نمایه - آواتار	مورد نیاز	تصویر نمایه یا تصویر آواتار کاربر. توجه: تصویر باید مربع 1:1 باشد.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
نمایه - متن اضافی	اختیاری	متن رایگان مانند دسته پروفایل.	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نمایه - تصویر اضافی	اختیاری	تصویر کوچک مانند نشان تأیید شده.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
تصویر هدر	اختیاری	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
محبوبیت - شمارش	اختیاری	تصویر هدر را نشان می دهد. باید با تصویر پروفایل متفاوت باشد. اگر تصویر اضافی برای برجسته کردن شخص مانند کارش وجود داشته باشد، می‌توان از آن استفاده کرد. توجه: تصویر باید 16:9 باشد. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید	رشته اندازه متن توصیه شده: حداکثر 20 کاراکتر برای تعداد + برچسب ترکیب شده است
محبوبیت - مقدار شمارش	اختیاری	تعداد فالوورها یا ارزش محبوبیت. توجه: اگر برنامه شما نمی‌خواهد منطقی در مورد نحوه بهینه‌سازی یک عدد بزرگ برای اندازه‌های مختلف نمایشگر انجام دهد، مقدار شمارش را ارائه دهید. اگر تعداد و مقدار تعداد هر دو ارائه شده باشد، از شمارش استفاده می شود.	طولانی
محبوبیت - برچسب	اختیاری	برچسب محبوبیت را مشخص کنید. به عنوان مثال - "پسند".	رشته اندازه متن توصیه شده: حداکثر 20 کاراکتر برای تعداد + برچسب ترکیب شده است
محبوبیت - بصری	اختیاری	مشخص کنید که این تعامل برای چیست. به عنوان مثال - تصویری که نماد Likes، Emojis را نشان می دهد. می تواند بیش از 1 تصویر ارائه دهد، اگرچه ممکن است همه آنها در همه عوامل شکل نشان داده نشوند. توجه: تصویر باید مربع 1:1 باشد	برای راهنمایی به مشخصات تصویر مراجعه کنید.
رتبه - حداکثر مقدار	مورد نیاز	حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه - ارزش فعلی	مورد نیاز	ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.	عدد >= 0.0
رتبه بندی - شمارش	اختیاری	تعداد رتبه‌بندی‌ها برای نهاد. توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	تعداد رتبه‌بندی‌ها برای نهاد. توجه: اگر نمی‌خواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد	طولانی
مکان - کشور	اختیاری	کشوری که فرد در آن قرار دارد یا در حال خدمت است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - شهر	اختیاری	شهری که فرد در آن قرار دارد یا در آن خدمت می کند.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - نشانی نمایش	اختیاری	آدرسی که شخص در آن قرار دارد یا در آن خدمت می کند به کاربر نمایش داده می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) جایی که فرد در آن واقع شده یا در حال خدمت است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - ایالت	اختیاری	ایالت (در صورت وجود) جایی که فرد در آن قرار دارد یا در حال خدمت است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) جایی که شخص در آن قرار دارد یا در حال خدمت است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
محل - محله	اختیاری	محله ای (در صورت وجود) که فرد در آن قرار دارد یا در حال خدمت است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
نشان ها	اختیاری	هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.
نشان - متن	اختیاری	عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است	متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
دسته بندی های محتوا	اختیاری	دسته بندی محتوا را در موجودیت توضیح دهید.	فهرست فهرست های واجد شرایط TYPE_HEALTH_AND_FITENESS (مثال - مربی یوگا/تناسب اندام) TYPE_HOME_AND_AUTO (مثال - لوله کش) TYPE_SPORTS (مثال - بازیکن) TYPE_DATING برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

`RestaurantReservationEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
زمان شروع رزرو	مورد نیاز	زمانی که انتظار می‌رود رزرو شروع شود، مهر زمانی دوره در میلی‌ثانیه است.	مهر زمانی دوره در میلی ثانیه
مکان - کشور	مورد نیاز	کشوری که رستوران در آن اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - شهر	مورد نیاز	شهری که رستوران در آن اتفاق می افتد.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - نشانی نمایش	مورد نیاز	آدرس پیش رستورانی که به کاربر نمایش داده می شود.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) رستوران.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که رستوران در آن واقع شده است.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) رستوران.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
محل - محله	اختیاری	محله (در صورت وجود) رستوران.	متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر
تصاویر پوستر	اختیاری	هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن پیشنهادی: 180 کاراکتر
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
اندازه جدول	اختیاری	تعداد افراد در گروه رزرو	عدد صحیح > 0

`EventReservationEntity`

صفت	مورد نیاز	توضیحات	قالب
اکشن اوری	مورد نیاز	پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان نهاد.	رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر
زمان شروع	مورد نیاز	مهر زمانی دورانی که انتظار می رود رویداد شروع شود. توجه: این در میلی ثانیه نمایش داده می شود.	مهر زمانی دوره در میلی ثانیه
حالت رویداد	مورد نیاز	فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود.	تعداد: VIRTUAL، IN_PERSON، یا HYBRID
مکان - کشور	مشروط الزامی است	کشوری که رویداد در آن رخ می دهد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است	متن رایگان اندازه متن توصیه شده: حداکثر ~ 20 کاراکتر
مکان - شهر	مشروط مورد نیاز است	شهری که رویداد در آن اتفاق می افتد. توجه: این مورد برای رویدادهایی که در in_person یا هیبرید هستند لازم است	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - آدرس نمایش	به طور مشروط مورد نیاز است	آدرس یا نام مکان که در آن رویداد برگزار می شود که باید به کاربر نمایش داده شود. توجه: این مورد برای رویدادهایی که در in_person یا هیبرید هستند لازم است	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) از مکانی که در آن رویداد برگزار می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که در آن رویداد برگزار می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - کد پستی	اختیاری	کد پستی (در صورت وجود) از مکانی که در آن رویداد برگزار می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - محله	اختیاری	محله (در صورت وجود) که در آن رویداد برگزار می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
تصاویر پوستر	اختیاری	ما فقط در هنگام ارائه چندین تصویر فقط 1 تصویر را نشان خواهیم داد. نسبت ابعاد توصیه شده 16: 9 است توجه: تصویر بسیار توصیه می شود. اگر نشان ارائه شده است ، از فضای امن 24 dps در هر دو قسمت بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
زمان پایان	اختیاری	زمانی که انتظار می رود این رویداد به پایان برسد. توجه: این در میلی ثانیه به نمایش گذاشته می شود.	زمان سنجی دوره در میلی ثانیه
ارائه دهنده خدمات - نام	اختیاری	نام ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	متن رایگان به عنوان مثال ، نام سازمان دهنده/تور رویداد
ارائه دهنده خدمات - تصویر	اختیاری	آرم/تصویر ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف واحد برای توصیف موجودیت. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده: 180 بار
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس ، با هر زیرنویس یک خط متن. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
نشان ها	اختیاری	هر نشان یا متن رایگان (حداکثر 15 کاراکتر) یا تصویر کوچک است.
نشان - متن	اختیاری	عنوان برای نشان توجه: برای نشان یا متن یا تصویر لازم است	متن رایگان اندازه متن توصیه شده: حداکثر 15 کاراکتر
نشان - تصویر	اختیاری	تصویر کوچک درمان ویژه UX ، به عنوان مثال به عنوان پوشش نشان در تصویر کوچک تصویر/فیلم. توجه: برای نشان یا متن یا تصویر لازم است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
شناسه رزرو	اختیاری	شناسه رزرو برای رزرو رویداد.	متن رایگان
قیمت - نسخه فعلی	به طور مشروط مورد نیاز است	قیمت فعلی بلیط/پاس برای این رویداد. در صورت ارائه قیمت Strikethrough باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی بلیط/پاس برای این رویداد.	متن رایگان
فراخوان قیمت	اختیاری	در صورت وجود ، فراخوان قیمت برای ارائه یک تبلیغ ، رویداد ، تخفیف عضو.	متن رایگان اندازه متن توصیه شده: زیر 45 کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد)
رتبه بندی - مقدار حداکثر	اختیاری	حداکثر مقدار مقیاس رتبه بندی. اگر مقدار فعلی رتبه بندی نیز ارائه شود ، باید ارائه شود.	شماره> = 0.0
رتبه بندی - مقدار فعلی	اختیاری	مقدار فعلی مقیاس رتبه بندی. اگر حداکثر ارزش رتبه بندی نیز ارائه شود ، باید ارائه شود.	شماره> = 0.0
رتبه بندی - شمارش	اختیاری	تعداد رتبه بندی های این رویداد. توجه: اگر برنامه شما می خواهد نحوه نمایش این کار را به کاربران کنترل کند ، این قسمت را ارائه دهید. رشته مختصر را که می تواند برای کاربر نمایش داده شود فراهم کنید. به عنوان مثال ، اگر تعداد آنها 1،000،000 است ، استفاده از اختصارات مانند 1M را در نظر بگیرید تا در اندازه های صفحه نمایش کوچکتر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	تعداد رتبه بندی های این رویداد. توجه: اگر نمی خواهید منطق اختصاری نمایشگر را اداره کنید ، این قسمت را ارائه دهید. اگر هر دو مقدار شمارش و شمارش وجود داشته باشد ، ما از Count برای نمایش به کاربران استفاده خواهیم کرد	طولانی
مقولات محتوا	اختیاری	دسته مطالب موجود در موجودیت را شرح دهید.	لیست عناصر واجد شرایط type_movies_and_tv_shows (مثال - سینما) type_digital_games (مثال - eSports) type_music (مثال - کنسرت) type_travel_and_local (مثال - تور ، جشنواره) type_health_and_fiteness (مثال - کلاس یوگا) type_education (مثال - کلاس) type_sports (مثال - بازی فوتبال) type_dating (مثال - ملاقات) برای راهنمایی به بخش گروه محتوا مراجعه کنید.

`LodgingReservationEntity`

صفت	مورد نیاز	توضیحات	قالب
عمل	مورد نیاز	پیوند عمیق به نهاد در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای انتساب استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان موجودیت.	متن رایگان به عنوان مثال ، "اقامت شما از 12 دسامبر" اندازه متن توصیه شده: حداکثر 50 کاراکتر
زمان ورود	مورد نیاز	زمان سنجی دوره در میلی ثانیه که نشان دهنده بررسی زمان رزرو است.	زمان سنجی دوره در میلی ثانیه
زمان چک	مورد نیاز	زمان سنجی دوره در میلی ثانیه که نشان دهنده زمان چک برای رزرو است.	زمان سنجی دوره در میلی ثانیه
مکان - کشور	مورد نیاز	کشوری که اقامتگاه در آن قرار دارد.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - شهر	مورد نیاز	شهری که اقامتگاه در آن قرار دارد.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - آدرس نمایش	مورد نیاز	آدرس اقامتگاه که به کاربر نمایش داده می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) از اقامتگاه.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - ایالت	اختیاری	ایالت یا استان (در صورت وجود) که در آن اقامتگاه قرار دارد.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - کد پستی	اختیاری	کد پستی (در صورت کاربرد) اقامتگاه.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان - محله	اختیاری	محله (در صورت کاربرد) اقامتگاه.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
تصاویر پوستر	اختیاری	ما فقط در هنگام ارائه چندین تصویر فقط 1 تصویر را نشان خواهیم داد. نسبت ابعاد توصیه شده 16: 9 است توجه: اگر نشان ارائه شده است ، از فضای امن 24 dps در هر دو قسمت بالا و پایین تصویر اطمینان حاصل کنید	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف واحد برای توصیف موجودیت. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده: 180 بار
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس ، با هر زیرنویس یک خط متن. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
شناسه رزرو	اختیاری	شناسه رزرو برای رزرو اقامتگاه.	متن رایگان
رتبه بندی - مقدار حداکثر	اختیاری	حداکثر مقدار مقیاس رتبه بندی. اگر مقدار فعلی رتبه بندی نیز ارائه شود ، باید ارائه شود.	شماره> = 0.0
رتبه بندی - مقدار فعلی	اختیاری	مقدار فعلی مقیاس رتبه بندی. اگر حداکثر ارزش رتبه بندی نیز ارائه شود ، باید ارائه شود.	شماره> = 0.0
رتبه بندی - شمارش	اختیاری	تعداد رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما می خواهد نحوه نمایش این کار را به کاربران کنترل کند ، این قسمت را ارائه دهید. رشته مختصر را که می تواند برای کاربر نمایش داده شود فراهم کنید. به عنوان مثال ، اگر تعداد آنها 1،000،000 است ، استفاده از اختصارات مانند 1M را در نظر بگیرید تا در اندازه های صفحه نمایش کوچکتر کوتاه نشود.	رشته
رتبه بندی - مقدار شمارش	اختیاری	تعداد رتبه بندی برای اقامتگاه. توجه: اگر نمی خواهید منطق اختصاری نمایشگر را اداره کنید ، این قسمت را ارائه دهید. اگر هر دو مقدار شمارش و شمارش وجود داشته باشد ، ما از Count برای نمایش به کاربران استفاده خواهیم کرد	طولانی
قیمت - نسخه فعلی	به طور مشروط مورد نیاز است	قیمت فعلی اقامتگاه. در صورت ارائه قیمت Strikethrough باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی اقامتگاه ، که در UI مورد ضرب و شتم قرار می گیرد.	متن رایگان
فراخوان قیمت	اختیاری	در صورت وجود ، فراخوان قیمت برای ارائه یک تبلیغ ، رویداد ، تخفیف عضو.	متن رایگان اندازه متن توصیه شده: زیر 45 کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد)

`TransportationReservationEntity`

صفت	مورد نیاز	توضیحات	قالب
عمل	مورد نیاز	پیوند عمیق به نهاد در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای انتساب استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان موجودیت.	متن رایگان به عنوان مثال ، "SFO به SAN" اندازه متن توصیه شده: حداکثر 50 کاراکتر
نوع حمل و نقل	مورد نیاز	حالت/نوع حمل و نقل برای رزرو.	enum: پرواز ، قطار ، اتوبوس یا کشتی
زمان حرکت	مورد نیاز	زمان سنجی دوره در میلی ثانیه که نمایانگر زمان عزیمت است.	زمان سنجی دوره در میلی ثانیه
زمان ورود	مورد نیاز	زمان سنجی دوره در میلی ثانیه که نشان دهنده زمان ورود است.	زمان سنجی دوره در میلی ثانیه
مکان عزیمت - کشور	اختیاری	کشور عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان عزیمت - شهر	اختیاری	شهر عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان عزیمت - آدرس نمایش	اختیاری	محل عزیمت که به کاربر نمایش داده می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
محل عزیمت - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) محل عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
محل عزیمت - ایالت	اختیاری	ایالت یا استان (در صورت لزوم) محل عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
محل عزیمت - کد پستی	اختیاری	کد پستی (در صورت وجود) محل عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
محل عزیمت - محله	اختیاری	محله (در صورت وجود) محل عزیمت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - کشور	اختیاری	کشور ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - شهر	اختیاری	شهر ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - آدرس نمایش	اختیاری	محل ورود که به کاربر نمایش داده می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) از محل ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - ایالت	اختیاری	ایالت یا استان (در صورت وجود) از محل ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - کد پستی	اختیاری	کد پستی (در صورت وجود) از محل ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
مکان ورود - محله	اختیاری	محله (در صورت وجود) از محل ورود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
ارائه دهنده خدمات - نام	اختیاری	نام ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	متن رایگان به عنوان مثال ، نام هواپیمایی
ارائه دهنده خدمات - تصویر	اختیاری	آرم/تصویر ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
تصاویر پوستر	اختیاری	ما فقط در هنگام ارائه چندین تصویر فقط 1 تصویر را نشان خواهیم داد. نسبت ابعاد توصیه شده 16: 9 است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف واحد برای توصیف موجودیت. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده: 180 بار
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس ، با هر زیرنویس یک خط متن. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
شناسه رزرو	اختیاری	شناسه رزرو برای رزرو حمل و نقل.	متن رایگان
قیمت - نسخه فعلی	به طور مشروط مورد نیاز است	قیمت فعلی رزرو. در صورت ارائه قیمت Strikethrough باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی رزرو ، که در UI از بین می رود.	متن رایگان
فراخوان قیمت	اختیاری	در صورت وجود ، فراخوان قیمت برای ارائه یک تبلیغ ، رویداد ، تخفیف عضو.	متن رایگان اندازه متن توصیه شده: زیر 45 کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد)
شماره حمل و نقل	مورد نیاز	شماره پرواز ، شماره اتوبوس ، شماره قطار یا شماره کشتی/کروز.	متن رایگان
وقت شبانه روزی	مورد نیاز	Timestamp Epoch که نشان دهنده زمان شبانه روزی برای رزرو است (در صورت کاربرد)	زمان سنجی دوره در میلی ثانیه

`VehicleRentalReservationEntity`

صفت	مورد نیاز	توضیحات	قالب
عمل	مورد نیاز	پیوند عمیق به نهاد در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای انتساب استفاده کنید. به این سؤالات متداول مراجعه کنید	اوری
عنوان	مورد نیاز	عنوان موجودیت.	متن رایگان به عنوان مثال ، "Avis Union Square SF" اندازه متن توصیه شده: حداکثر 50 کاراکتر
زمان تحویل	مورد نیاز	زمان سنجی که نشان دهنده زمان انتخاب برای رزرو است.	زمان سنجی دوره در میلی ثانیه
زمان بازگشت	اختیاری	زمان سنجی که نشان دهنده زمان چک برای رزرو است.	زمان سنجی دوره در میلی ثانیه
آدرس وانت - کشور	اختیاری	کشور محل وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - شهر	اختیاری	شهر وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - آدرس نمایش	اختیاری	مکان وانت که به کاربر نمایش داده می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) از محل وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - حالت	اختیاری	ایالت یا استان (در صورت وجود) از محل وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - کد پستی	اختیاری	کد پستی (در صورت وجود) محل وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس وانت - محله	اختیاری	محله (در صورت وجود) از محل وانت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - کشور	اختیاری	محل بازگشت کشور.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - شهر	اختیاری	شهر بازگشت شهر.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - آدرس نمایش	اختیاری	مکان برگشتی که به کاربر نمایش داده می شود.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - آدرس خیابان	اختیاری	آدرس خیابان (در صورت وجود) از محل بازگشت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - ایالت	اختیاری	ایالت یا استان (در صورت وجود) از محل بازگشت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - کد پستی	اختیاری	کد پستی (در صورت وجود) از محل بازگشت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
آدرس بازگشت - محله	اختیاری	محله (در صورت وجود) از محل بازگشت.	متن رایگان اندازه متن توصیه شده: حداکثر 20 chars
ارائه دهنده خدمات - نام	اختیاری	نام ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	متن رایگان به عنوان مثال ، "اجاره ماشین Avis"
ارائه دهنده خدمات - تصویر	اختیاری	آرم/تصویر ارائه دهنده خدمات. توجه: برای ارائه دهنده خدمات یا متن یا تصویر لازم است.	برای راهنمایی به مشخصات تصویر مراجعه کنید.
تصاویر پوستر	اختیاری	ما فقط در هنگام ارائه چندین تصویر فقط 1 تصویر را نشان خواهیم داد. نسبت ابعاد توصیه شده 16: 9 است	برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات	اختیاری	یک پاراگراف واحد برای توصیف موجودیت. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده: 180 بار
لیست زیرنویس	اختیاری	حداکثر 3 زیرنویس ، با هر زیرنویس یک خط متن. توجه: یا لیست توضیحات یا زیرنویس به کاربر نمایش داده می شود ، نه هر دو.	متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر
شناسه تأیید	اختیاری	شناسه تأیید برای رزرو اجاره وسیله نقلیه.	متن رایگان
قیمت - نسخه فعلی	به طور مشروط مورد نیاز است	قیمت فعلی رزرو. در صورت ارائه قیمت Strikethrough باید ارائه شود.	متن رایگان
قیمت - StrikethroughPrice	اختیاری	قیمت اصلی رزرو ، که در UI از بین می رود.	متن رایگان
فراخوان قیمت	اختیاری	در صورت وجود ، فراخوان قیمت برای ارائه یک تبلیغ ، رویداد ، تخفیف عضو.	متن رایگان اندازه متن توصیه شده: زیر 45 کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد)

مشخصات تصویر

مشخصات لازم برای دارایی های تصویر در این جدول ذکر شده است:

نسبت ابعاد	حداقل پیکسل	پیکسل های توصیه شده
مربع (1x1) ترجیح داده شده است	300x300	1200x1200
چشم انداز (1.91x1)	600x314	1200x628
پرتره (4x5)	480x600	960x1200

نسبت ابعاد

حداقل پیکسل

پیکسل های توصیه شده

مربع (1x1)

ترجیح داده شده است

300x300

1200x1200

چشم انداز (1.91x1)

600x314

1200x628

پرتره (4x5)

480x600

960x1200

تصاویر لازم است در CDN های عمومی میزبانی شوند تا Google بتواند به آنها دسترسی پیدا کند.

فرمت های فایل

PNG ، JPG ، GIF استاتیک ، وب

حداکثر اندازه پرونده

5120 KB

توصیه های اضافی

منطقه ایمن تصویر: محتوای مهم خود را در مرکز 80 ٪ از تصویر قرار دهید.
از پس زمینه شفاف استفاده کنید تا تصویر به درستی در تنظیمات تم تاریک و سبک نمایش داده شود.

دسته محتوا

دسته محتوا به برنامه ها اجازه می دهد تا محتوای متعلق به چندین دسته را منتشر کنند. این محتوا را با برخی از دسته های از پیش تعریف شده یعنی:

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

تصاویر لازم است در CDN های عمومی میزبانی شوند تا Google بتواند به آنها دسترسی پیدا کند.

دستورالعمل های استفاده از دسته بندی های محتوا

برخی از نهادها مانند مقاله و GenericFeatureDentity واجد شرایط استفاده از هر یک از دسته های محتوا هستند. برای سایر موجودات مانند EventEntity ، EventReservationEntity ، PointOfindestEntity ، فقط زیر مجموعه ای از این دسته ها واجد شرایط هستند. قبل از جمع آوری لیست ، لیست دسته های واجد شرایط برای یک نوع موجودیت را بررسی کنید.
از نوع موجودیت خاص برای برخی از دسته های محتوا در ترکیبی از اشخاص عمومی و ContentCategration استفاده کنید:
- type_movies_and_tv_shows - قبل از استفاده از اشخاص عمومی ، از راهنمای ادغام Watch Curedition را بررسی کنید.
- type_books - قبل از استفاده از اشخاص عمومی ، کتاب الکترونیکی را بررسی کنید.
- Type_AudioBooks - قبل از استفاده از اشخاص عمومی ، کتاب صوتی را بررسی کنید.
- Type_Shopping - قبل از استفاده از اشخاص عمومی ، از خرید خود دیدن کنید.
- type_food_and_drink - قبل از استفاده از اشخاص عمومی ، از راهنمای ادغام مواد غذایی استفاده کنید.
اگر محتوا متعلق به هیچ یک از دسته های ذکر شده در ابتدا نباشد ، قسمت ContentCategory اختیاری است و باید خالی باقی بماند.
در صورت ارائه مقوله های متعدد محتوای ، آنها را به ترتیب مرتبط با محتوا با مهمترین دسته محتوا که در ابتدا در لیست قرار می گیرد ، ارائه دهید.

مرحله 2: داده های خوشه ای را ارائه دهید

توصیه می شود که محتوای انتشار شغل در پس زمینه اجرا شود (به عنوان مثال ، با استفاده از WorkManager ) و به طور منظم یا به صورت رویداد برنامه ریزی شده است (به عنوان مثال ، هر بار که کاربر برنامه را باز می کند یا وقتی کاربر فقط چیزی را به آن اضافه کرده است سبد خرید آنها).

AppEngagePublishClient مسئول انتشار خوشه ها است.

API های زیر برای انتشار خوشه ها در مشتری وجود دارد:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

از این API برای بررسی اینکه آیا این سرویس برای ادغام در دسترس است و آیا محتوا می تواند در دستگاه ارائه شود ، استفاده می شود.

کاتلین


client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

جاوا


client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

`publishRecommendationClusters`

از این API برای انتشار لیستی از اشیاء RecommendationCluster استفاده می شود.

کاتلین


client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

جاوا


client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

هنگامی که سرویس درخواست را دریافت می کند ، اقدامات زیر در یک معامله انجام می شود:

داده های RecommendationCluster موجود از شریک توسعه دهنده حذف می شوند.
داده های این درخواست در خوشه توصیه به روز شده تجزیه و ذخیره می شوند.

در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`publishFeaturedCluster`

از این API برای انتشار لیستی از اشیاء FeaturedCluster استفاده می شود.

کاتلین


client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

جاوا


client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

هنگامی که سرویس درخواست را دریافت می کند ، اقدامات زیر در یک معامله انجام می شود:

داده های FeaturedCluster موجود از شریک توسعه دهنده حذف می شود.
داده های حاصل از درخواست تجزیه و در خوشه برجسته به روز شده ذخیره می شود.

در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`publishContinuationCluster`

این API برای انتشار یک شیء ContinuationCluster استفاده می شود.

کاتلین


client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

جاوا


client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

هنگامی که سرویس درخواست را دریافت می کند ، اقدامات زیر در یک معامله انجام می شود:

داده های ContinuationCluster موجود از شریک توسعه دهنده حذف می شوند.
داده های حاصل از درخواست در خوشه ادامه به روز شده تجزیه و ذخیره می شوند.

در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`publishUserAccountManagementRequest`

این API برای انتشار یک علامت در کارت استفاده می شود. اقدام Signin کاربران را به صفحه ورود به سیستم هدایت می کند تا برنامه بتواند محتوا را منتشر کند (یا محتوای شخصی تر ارائه می دهد)

ابرداده زیر بخشی از علامت در کارت است -

صفت	مورد نیاز	توضیحات
عمل	مورد نیاز	Deeplink to Action (یعنی به سیستم ورود به سیستم وارد صفحه می شود)
تصویر	اختیاری - در صورت عدم ارائه ، عنوان باید ارائه شود	تصویر نشان داده شده روی کارت 16x9 تصاویر نسبت ابعاد با وضوح 1264x712
عنوان	اختیاری - در صورت عدم ارائه ، تصویر باید ارائه شود	عنوان روی کارت
متن عمل	اختیاری	متن نشان داده شده در CTA (یعنی ورود به سیستم)
زیرنویس	اختیاری	زیرنویس اختیاری روی کارت

کاتلین


var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

جاوا


SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

هنگامی که سرویس درخواست را دریافت می کند ، اقدامات زیر در یک معامله انجام می شود:

داده های موجود در مورد UserAccountManagementCluster از شریک توسعه دهنده حذف می شود.
داده های این درخواست در خوشه به روز شده UserAccountManagementCluster به روز شده و ذخیره می شوند.

در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`updatePublishStatus`

اگر به هر دلیل تجاری داخلی ، هیچ یک از خوشه ها منتشر نشده باشد ، ما اکیداً توصیه می کنیم وضعیت انتشار را با استفاده از API UpdatePublishStatus به روز کنید. این مهم است زیرا:

ارائه وضعیت در تمام سناریوها ، حتی در صورت انتشار محتوا (وضعیت == منتشر شده) ، برای جمع آوری داشبورد که از این وضعیت صریح برای انتقال سلامت و سایر معیارهای ادغام شما استفاده می کنند ، بسیار مهم است.
اگر هیچ محتوا منتشر نشده باشد اما وضعیت ادغام شکسته نشده است (وضعیت == not_published) ، Google می تواند از ایجاد هشدارها در داشبورد سلامت برنامه جلوگیری کند. این تأیید می کند که محتوا به دلیل وضعیت مورد انتظار از نظر ارائه دهنده منتشر نمی شود.
این به توسعه دهندگان کمک می کند تا بینش در مورد زمان انتشار داده ها در مقابل نه.
Google ممکن است از کدهای وضعیت استفاده کند تا کاربر را برای انجام اقدامات خاص در برنامه انجام دهد تا بتواند محتوای برنامه را ببیند یا بر آن غلبه کند.

لیست کدهای وضعیت انتشار واجد شرایط عبارتند از:

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

اگر محتوا به دلیل ورود به سیستم وارد نشده ، منتشر نشده باشد ، Google توصیه می کند که علامت کارت را منتشر کند. اگر به هر دلیلی ارائه دهندگان قادر به انتشار علامت در کارت نیستند ، توصیه می کنیم با کد وضعیت به روزرسانی updatepublishstatus با کد وضعیت not_published_requires_sign_in تماس بگیرید

کاتلین


client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

جاوا


client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

این API برای حذف محتوای خوشه های توصیه استفاده می شود.

کاتلین


client.deleteRecommendationClusters()

جاوا


client.deleteRecommendationClusters();

هنگامی که سرویس درخواست را دریافت می کند ، داده های موجود را از خوشه های توصیه حذف می کند. در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`deleteFeaturedCluster`

این API برای حذف محتوای خوشه برجسته استفاده می شود.

کاتلین


client.deleteFeaturedCluster()

جاوا


client.deleteFeaturedCluster();

هنگامی که سرویس درخواست را دریافت می کند ، داده های موجود را از خوشه برجسته حذف می کند. در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`deleteContinuationCluster`

این API برای حذف محتوای خوشه ادامه استفاده می شود.

کاتلین


client.deleteContinuationCluster()

جاوا


client.deleteContinuationCluster();

هنگامی که سرویس درخواست را دریافت می کند ، داده های موجود را از خوشه ادامه حذف می کند. در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`deleteUserManagementCluster`

از این API برای حذف محتوای خوشه UserAccountManagement استفاده می شود.

کاتلین


client.deleteUserManagementCluster()

جاوا


client.deleteUserManagementCluster();

هنگامی که سرویس درخواست را دریافت می کند ، داده های موجود را از خوشه UserAccountManagement حذف می کند. در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

`deleteClusters`

این API برای حذف محتوای یک نوع خوشه معین استفاده می شود.

کاتلین


client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

جاوا


client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

هنگامی که سرویس درخواست را دریافت می کند ، داده های موجود را از تمام خوشه های مطابق با انواع خوشه های مشخص شده حذف می کند. مشتریان می توانند یک یا بسیاری از انواع خوشه ها را تصویب کنند. در صورت بروز خطا ، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

رسیدگی به خطا

بسیار توصیه می شود که به نتیجه کار از API های انتشار گوش دهید به گونه ای که می توان یک اقدام پیگیری برای بازیابی و بازگرداندن یک کار موفق انجام داد.

کاتلین


client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

جاوا


client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

این خطا به عنوان یک AppEngageException با علت موجود به عنوان کد خطا بازگردانده می شود.

کد خطا	توجه داشته باشید
`SERVICE_NOT_FOUND`	این سرویس در دستگاه داده شده در دسترس نیست.
`SERVICE_NOT_AVAILABLE`	این سرویس در دستگاه داده شده در دسترس است ، اما در زمان تماس در دسترس نیست (به عنوان مثال ، صریحاً غیرفعال است).
`SERVICE_CALL_EXECUTION_FAILURE`	اجرای وظیفه به دلیل مشکلات مربوط به موضوعات انجام نشد. در این حالت ، می توان آن را مجدداً انجام داد.
`SERVICE_CALL_PERMISSION_DENIED`	تماس گیرنده مجاز به برقراری تماس خدمات نیست.
`SERVICE_CALL_INVALID_ARGUMENT`	این درخواست حاوی داده های نامعتبر است (به عنوان مثال ، بیش از تعداد خوشه مجاز).
`SERVICE_CALL_INTERNAL`	خطایی در سمت سرویس وجود دارد.
`SERVICE_CALL_RESOURCE_EXHAUSTED`	تماس خدمات بیش از حد مکرر انجام می شود.

مرحله 3: اهداف پخش را کنترل کنید

علاوه بر ایجاد تماس های API Publish Content از طریق یک کار ، همچنین لازم است که برای دریافت درخواست انتشار محتوا ، یک BroadcastReceiver را تنظیم کنید.

هدف از اهداف پخش عمدتاً برای فعال سازی مجدد برنامه و مجبور کردن همگام سازی داده ها است. اهداف پخش به گونه ای طراحی نشده است که به طور مکرر ارسال می شود. این تنها هنگامی ایجاد می شود که سرویس ENGAGE تعیین کند که محتوا ممکن است بی رنگ باشد (به عنوان مثال ، یک هفته). به این ترتیب ، اطمینان بیشتری وجود دارد که کاربر می تواند تجربه محتوای تازه ای داشته باشد ، حتی اگر برنامه برای مدت طولانی اجرا نشده باشد.

BroadcastReceiver باید به دو روش زیر تنظیم شود:

به صورت پویا نمونه ای از کلاس BroadcastReceiver را با استفاده از Context.registerReceiver() ثبت کنید. این امکان ارتباط از برنامه هایی را فراهم می کند که هنوز در حافظه زندگی می کنند.

کاتلین

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

جاوا

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}

به صورت آماری با برچسب <receiver> در پرونده AndroidManifest.xml خود یک اجرای را اعلام کنید. این امر به برنامه اجازه می دهد تا هنگام اجرا ، اهداف پخش را دریافت کند و همچنین به برنامه اجازه می دهد تا محتوا را منتشر کند.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

اهداف زیر توسط سرویس ارسال می شود:

com.google.android.engage.action.PUBLISH_RECOMMENDATION توصیه می شود هنگام دریافت این هدف ، تماس publishRecommendationClusters را شروع کنید.
com.google.android.engage.action.PUBLISH_FEATURED توصیه می شود هنگام دریافت این هدف ، یک تماس publishFeaturedCluster کنید.
com.google.android.engage.action.PUBLISH_CONTINUATION توصیه می شود هنگام دریافت این هدف ، یک تماس تلفنی publishContinuationCluster را شروع کنید.

گردش کار ادغام

برای یک راهنمای گام به گام در مورد تأیید ادغام خود پس از اتمام ، به گردش کار ادغام Engage Developer مراجعه کنید.

سوالات متداول

به Engage SDK که اغلب برای سؤالات متداول پرسیده می شود ، مراجعه کنید.

تماس بگیرید

در صورت وجود هرگونه سؤال در طی فرآیند ادغام ، با ingage-developers@google.com تماس بگیرید.

مراحل بعدی

پس از تکمیل این ادغام ، مراحل بعدی شما به شرح زیر است:

یک ایمیل برای Engage-develors@google.com ارسال کرده و APK یکپارچه خود را که آماده آزمایش توسط Google است ، ضمیمه کنید.
Google یک تأیید را انجام می دهد و در داخل کشور بررسی می کند تا اطمینان حاصل شود که ادغام همانطور که انتظار می رود کار می کند. در صورت نیاز به تغییرات ، Google با هرگونه جزئیات لازم با شما تماس می گیرد.
هنگامی که آزمایش کامل است و هیچ تغییری لازم نیست ، Google با شما تماس می گیرد تا به شما اطلاع دهد که می توانید APK به روز شده و یکپارچه را در فروشگاه Play شروع کنید.
بعد از اینکه گوگل تأیید کرد که APK به روز شده شما در فروشگاه Play منتشر شده است ، توصیه های شما ، برجسته و خوشه های ادامه ممکن است برای کاربران منتشر و قابل مشاهده باشد.