بلع دسته ای

فیدهای داده‌های شما به شما امکان می‌دهند رستوران، خدمات و منوی خود را در «سفارش سرتاسر» در دسترس قرار دهید.

این سند نحوه میزبانی جعبه ایمنی و موجودی‌های تولید و استفاده از انتقال دسته‌ای برای به‌روزرسانی موجودی خود را در «سفارش پایان به انتها» پوشش می‌دهد.

محیط های خوراک داده

سه محیط فید داده برای توسعه یکپارچه سازی شما وجود دارد:

محیط خوراک	توضیحات	بلع دسته ای
جعبه شنی	محیط آزمایشی برای توسعه فید شما.	مورد نیاز
تولید	محیط تولید برای موجودی شما که می خواهید راه اندازی کنید.	مورد نیاز

میزبانی فیدهای داده

برای اینکه Ordering End-to-End فیدهای داده‌های Sandbox و Production شما را به‌صورت دسته‌ای پردازش کند، باید فایل‌های فید داده خود را در Google Cloud Storage، Amazon S3 یا HTTPS با نقشه سایت میزبانی کنید.

توصیه می‌کنیم فیدهای داده را برای محیط‌های سندباکس و محیط‌های تولیدی خود به طور جداگانه میزبانی کنید. این رویکرد به شما امکان می‌دهد تا قبل از اعمال تغییرات در تولید، توسعه و آزمایش را در محیط خوراک sandbox خود انجام دهید.

به عنوان مثال، اگر از Google Cloud Storage به عنوان یک گزینه میزبانی استفاده می کنید، مسیرهای زیر را خواهید داشت:

• فید Sandbox: gs://foorestaurant-google-feed-sandbox/
• فید تولید: gs://foorestaurant-google-feed-prod/

برای میزبانی موجودی خود، موارد زیر را انجام دهید:

1. فایل های فید داده خود را ایجاد کنید.
2. راه حل میزبانی را انتخاب کنید.
3. فیدهای داده خود را میزبانی کنید.
4. اطمینان حاصل کنید که فایل های فید داده شما به طور منظم به روز می شوند. فیدهای داده تولید باید روزانه به روز شوند.

برای جزئیات در مورد نحوه ایجاد فید موجودی، به مستندات موجودیت‌های Restaurant ، Service ، و Menu و همچنین بخش ایجاد فید داده مراجعه کنید.

دستورالعمل های مربوط به فایل های فید داده

هر فایلی که می‌تواند شامل چندین نهاد باشد، نباید بیش از 200 مگابایت باشد. نهادهای سطح بالا Restaurant ، Service ، و Menu ، به همراه نهادهای فرزندشان، با هم نباید بیش از 4 مگابایت باشد.

توجه: توصیه می‌کنیم همه رستوران‌ها، سرویس‌ها و فهرست‌های مرتبط را با هم در یک فایل خوراک داده، با یک فایل برای هر مکان فروشنده، قرار دهید. برای مثال، اگر 8000 مکان تجاری دارید، 8000 فایل ایجاد کنید. یک فایل جداگانه برای هر مکان فروشنده می تواند اشکال زدایی و پشتیبانی از ادغام خود را برای شما آسان تر کند.

راه حل میزبانی را انتخاب کنید

جدول زیر گزینه های میزبانی فیدهای داده شما و نحوه کار آن هاست ها با Ordering End-to-End را فهرست می کند:

	آمازون S3	Google Cloud Storage	HTTPS با نقشه سایت
اعتبار و دسترسی	اطلاعات زیر را به گوگل ارائه دهید: دسترسی به شناسه کلید کلید دسترسی مخفی مسیرهای دایرکتوری های تولید و سندباکس S3 و فایل marker.txt . مسیر باید با s3:// شروع شود. سطل S3 باید شامل اطلاعات زیر باشد: فایل های خوراک برای موجودی شما. marker.txt ، که حاوی یک مهر زمانی است که برای واکشی استفاده می شود. نمونه فایل marker.txt : 2018-12-03T08:30:42.694Z	مسیرهای مربوط به دایرکتوری‌های تولید و سطل جعبه ایمنی و فایل marker.txt را به Google ارائه دهید. مسیرها باید با gs:// شروع شوند. حساب سرویس ارائه شده توسط مشاور Google خود را به عنوان خواننده سطل Google Cloud Storage خود اضافه کنید. برای اطلاعات بیشتر در مورد نحوه کنترل دسترسی به Google Cloud Storage (GCS)، به کنسول Google Cloud Platform مراجعه کنید: تنظیم مجوزهای سطل . سطل GCS باید شامل اطلاعات زیر باشد: فایل های خوراک برای موجودی شما. marker.txt ، که حاوی یک مهر زمانی است که برای واکشی استفاده می شود. نمونه فایل marker.txt : 2018-12-03T08:30:42.694Z	اطلاعات زیر را به گوگل ارائه دهید: مدارک اعتبار پایه شما. مسیر تولید شما و مسیرهای نقشه سایت سندباکس. مسیر باید با https:// شروع شود. پروتکل: شما باید فایل های فید خود را از طریق HTTPS در دسترس قرار دهید نه از طریق HTTP. امنیت: Google قویاً توصیه می کند که از فایل های فید میزبانی شده خود با احراز هویت اولیه محافظت کنید.
چگونه گوگل می داند کدام فایل ها باید واکشی شوند	فهرست دایرکتوری همه فایل‌های موجود در سطل.	فهرست دایرکتوری همه فایل‌های موجود در سطل.	URL های فردی فایل های فهرست شده در نقشه سایت .
چگونه گوگل می داند که فایل ها آماده واکشی هستند	پس از اتمام تولید فیدهای داده، فایل marker.txt را با آخرین مهر زمانی به‌روزرسانی کنید.	پس از اتمام تولید فیدهای داده، فایل marker.txt را با آخرین مهر زمانی به‌روزرسانی کنید.	پس از اتمام تولید فیدهای داده، سرصفحه پاسخ last-modified sitemap.xml خود را با آخرین مهر زمانی به‌روزرسانی کنید.
محدودیت های فایل	حداکثر تعداد فایل: 100000. شما باید در مجموع کمتر از 100000 فایل در سطل آمازون S3 خود داشته باشید.	حداکثر تعداد فایل: 100000. در مجموع باید کمتر از 100000 فایل در سطل Google Cloud Storage خود داشته باشید.	حداکثر تعداد فایل: 100000. تعداد مسیرهای فایل در فایل XML نقشه سایت شما باید کمتر از 100000 باشد.

فیدهای داده خود را برای انتقال دسته ای وصل کنید

پس از میزبانی فیدهای خود، باید آنها را به پروژه خود در Action Center متصل کنید. پیکربندی اولیه فیدهای تولید در صفحه Onboarding Tasks انجام می شود. بعداً، پیکربندی فیدهای تولید و جعبه ایمنی را می‌توان در هر زمانی از صفحه پیکربندی > فیدها توسط هر کاربر پورتال با نقش مدیریتی به‌روزرسانی کرد. محیط sandbox برای اهداف توسعه و آزمایش استفاده می شود، در حالی که فیدهای تولید به کاربران نمایش داده می شوند.

اگر فیدهای داده خود را با آمازون S3 میزبانی می کنید

1. در مرکز اقدامات ، به پیکربندی > فیدها بروید.

2. روی Edit کلیک کنید و فرم Update Feed را پر کنید:

   • روش تحویل خوراک: روی Amazon S3 تنظیم کنید.
   • نشانگر فایل: نشانی اینترنتی فایل marker.txt را ارائه دهید.
   • فایل های داده: URL را به سطل S3 که حاوی فیدهای داده است، ارائه دهید.
   • شناسه دسترسی: شناسه کلید دسترسی IAM را با مجوز خواندن از منابع S3 وارد کنید.
   • کلید دسترسی: کلید دسترسی مخفی IAM را با مجوز خواندن از منابع S3 وارد کنید.
3. روی ارسال کلیک کنید.
4. پس از یک تا دو ساعت، بررسی کنید که آیا مصرف دسته‌ای فایل‌های فید شما را واکشی می‌کند یا خیر.

اگر فیدهای داده خود را با Google Cloud Storage میزبانی می کنید

1. در مرکز اقدامات ، به پیکربندی > فیدها بروید.

2. روی Edit کلیک کنید و فرم Update Feed را پر کنید:

   • روش تحویل فید: روی Google Cloud Storage تنظیم کنید.
   • نشانگر فایل: نشانی اینترنتی فایل marker.txt را ارائه دهید.
   • فایل های داده: نشانی وب را به سطل GCS که حاوی فیدهای داده است، ارائه دهید.
3. روی ارسال کلیک کنید.
4. یک حساب سرویس برای دسترسی به سطل GCS شما ایجاد می شود. نام حساب را می‌توانید پس از تکمیل وظایف سوار شدن در پیکربندی > فیدها پیدا کنید. این حساب سرویس به نقش "Storage Legacy Object Reader" نیاز دارد. این نقش را می توان به حساب سرویس در صفحه IAM کنسول Google Cloud اعطا کرد.
5. پس از یک تا دو ساعت، بررسی کنید که آیا مصرف دسته‌ای فایل‌های فید شما را واکشی می‌کند یا خیر.

اگر فیدهای داده خود را با HTTPS میزبانی کنید

1. در مرکز اقدامات ، به پیکربندی > فیدها بروید.

2. روی Edit کلیک کنید و فرم Update Feed را پر کنید:

   • روش تحویل خوراک: روی HTTPS تنظیم کنید.
   • فایل نقشه سایت: آدرس فایل sitemap.xml را ارائه دهید.
   • نام کاربری: اعتبار نام کاربری را برای دسترسی به سرور HTTPS وارد کنید.
   • رمز عبور: رمز عبور را برای دسترسی به سرور HTTPS وارد کنید.
3. روی ارسال کلیک کنید.
4. پس از یک تا دو ساعت، بررسی کنید که آیا مصرف دسته‌ای فایل‌های فید شما را واکشی می‌کند یا خیر.

نمونه مسیرها

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

	آمازون S3	Google Cloud Storage	HTTPS با نقشه سایت
مسیر	s3://foorestaurant-google-feed-sandbox/	gs://foorestaurant-google-feed-sandbox/	https://sandbox-foorestaurant.com/sitemap.xml
فایل نشانگر	s3://foorestaurant-google-feed-sandbox/marker.txt	gs://foorestaurant-google-feed-sandbox/marker.txt	قابل اجرا نیست

نقشه های سایت برای میزبانی HTTPS

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

• لینک های موجود در نقشه سایت شما باید به خود فایل ها اشاره کنند.
• اگر نقشه سایت شما به جای نام دامنه شما، ارجاع به ارائه‌دهنده ابری دارد، مطمئن شوید که شروع URL‌ها، مانند https://www.yourcloudprovider.com/your_id ، ثابت و منحصر به کار دسته‌ای شما هستند.
• مراقب باشید نقشه های سایت جزئی را آپلود نکنید (مانند آپلود جزئی داده). انجام این کار باعث می‌شود Google فقط فایل‌های موجود در نقشه سایت را مصرف کند، که باعث می‌شود سطح موجودی شما پایین بیاید و ممکن است منجر به مسدود شدن جذب فید شما شود.
• اطمینان حاصل کنید که مسیرهای فایل های اشاره شده در نقشه سایت تغییر نمی کند. به عنوان مثال، امروز مرجع نقشه سایت خود را https://www.yourcloudprovider.com/your_id/10000.json نداشته باشید، اما فردا به https://www.yourcloudprovider.com/your_id/20000.json مراجعه کنید.

نمونه نقشه سایت

در اینجا نمونه ای از فایل sitemap.xml است که فایل های فید داده را ارائه می دهد:

مثال 1: نهادهای گروه بندی شده توسط بازرگانان (توصیه می شود).

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

مثال 2: موجودیت های گروه بندی شده بر اساس انواع.

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

توجه: تنها فیلد مورد نیاز برای سفارش نقشه سایت End-to-End، loc است.

فیدهای داده خود را به روز کنید

پس از اتصال فیدهای داده‌های شما، Google هر ساعت یک بار به‌روزرسانی‌ها را بررسی می‌کند، اما ما فقط زمانی همه فیدهای داده را دریافت می‌کنیم که فایل‌های marker.txt یا sitemap.xml اصلاح شده باشند. انتظار داریم روزی یک بار فیدهای داده خود را به روز کنید تا از موجودی قدیمی جلوگیری کنید.

برای مشخص کردن اینکه فیدهای داده اصلاح شده و برای دریافت دسته‌ای آماده هستند، فیلد ابرداده شیء last-modified فایل marker.txt (برای GCP و S3) یا سرصفحه پاسخ last-modified فایل sitemap.xml را به‌روزرسانی کنید. Google از این مقادیر برای تعیین تازه بودن فید داده استفاده می کند.

همانطور که خوراک دسته ای در حال بلعیده شدن است،

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

مهر زمانی یا سرصفحه پاسخ last-modified باید فقط پس از تولید و به‌روزرسانی همه فایل‌های خوراک داده به‌روزرسانی شود. کارهای دسته ای را که فیدهای داده شما را به روز می کنند محدود کنید تا فقط یک بار در روز اجرا شوند. از طرف دیگر، بین هر کار دسته ای حداقل سه ساعت فاصله داشته باشید. اگر این مراحل را انجام ندهید، ممکن است Google فایل‌های قدیمی را واکشی کند.

توجه: last-modified با نسخه‌سازی موجودیت متفاوت است. last-modified هنگامی که دسته دریافت می شود، راه اندازی می شود، و هیچ تاثیری بر نسخه موجودیت ندارد.