فید آماده است

فیدها داده‌های موجودی شما را در اختیار مرکز اقدامات قرار می‌دهند. این آپلود روزانه پروتکل انتقال فایل امن (SFTP) همه تاجران، سرویس‌ها و داده‌های اسلات موجود را به‌روزرسانی می‌کند. فیدها مشخص می‌کنند که از کدام بازرگانان پشتیبانی می‌کنید، در دسترس بودن آن‌ها و هر ویژگی خاصی که برای تأیید اینکه Google موجودی شما را به درستی نمایش می‌دهد، مورد نیاز است. فیدها در دراپ باکس های SFTP آپلود می شوند که با ارائه کلید SSH خود در راه اندازی پیکربندی می شوند.

قبل از اینکه به سرور رزرو بروید، باید کارهای آماده Feeds زیر را تکمیل کنید:

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

برای عملکرد مناسب ادغام سرتاسر رزروهای غذاخوری ، باید به طور خودکار فید تاجر، فید خدمات و فید دسترسی را ارائه دهید. زیرساخت فید خودکار شما باید موجودی کامل شما را فراهم کند.

انواع خوراک

رزروهای غذاخوری ادغام های سرتاسری به فیدهای زیر و فرکانس بارگذاری آنها نیاز دارد:

خوراک توضیحات فرکانس نمونه
بازرگان بازرگانان شما را توصیف می کند. هر 24 ساعت یکبار نمونه خوراک تاجر
خدمات خدمات بازرگانان خود را شرح دهید. هر 24 ساعت یکبار خدمات نمونه خوراک
در دسترس بودن اسلات های موجود برای خدمات تاجران شما را شرح می دهد. حداقل 30 روز پوشش باید ارائه شود. برای تمدید پوشش تا 90 روز، از طریق فرم تماس با «Action Center» با پشتیبانی Google تماس بگیرید. هر 24 ساعت یکبار نمونه خوراک در دسترس بودن

قالب‌های فید با دستور پروتکل بافر 3 توضیح داده شده‌اند، اما می‌توانید فیدهای خود را در قالب JSON مربوطه آپلود کنید. برای قالب JSON به نمونه های فید مراجعه کنید. توصیه می کنیم فیدها را با فرمت JSON آپلود کنید.

قراردادهای نامگذاری و فراداده

نام فایل ها

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

ساختار : {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json

مثال : availability_feed_1574117613_001_of_002.json.gz

شناسه ها را تعریف کنید

هنگامی که برای تاجران خود شناسه تعریف می کنید یا سایر ویژگی هایی که نیاز به شناسه دارند، اکیداً توصیه می کنیم از UID یا UUID استفاده کنید. تا زمانی که شناسه ها در پلتفرم شما متمایز باشند، می توانید راه حل الفبایی عددی خود را ارائه دهید.

فراداده

هنگامی که فیدها را ایجاد می‌کنید، generation_timestamp باید زمانی را که داده‌ها از پایگاه داده استخراج می‌شوند منعکس کند. استفاده مجدد از این مقدار در فیدها می تواند منجر به خطاهای پردازش شود.

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

اندازه فایل فید

اشتراک گذاری فایل های فید

بر اساس موجودی شما، ممکن است به اشتراک گذاری یا تقسیم فیدها به چندین فایل ضروری باشد. فیدهای شما ممکن است در شرایط زیر نیاز به اشتراک گذاری داشته باشند:

  • فید فشرده gzip بیش از 200 مگابایت برای یک فایل است.
    • مثال : فید دسترسی تولید شده 1 گیگابایت است. این باید به پنج یا بیشتر خرده جدا شود.
  • موجودی شریک در بین سیستم ها یا مناطق توزیع می شود که منجر به مشکل در تطبیق موجودی می شود.
    • مثال : شریک دارای موجودی ایالات متحده و اتحادیه اروپا است که در سیستم های جداگانه زندگی می کنند. فید ممکن است با دو قطعه تولید شود. یکی برای ایالات متحده و یکی برای اتحادیه اروپا با همان nonce و generation_timestamp .

برای اطلاعات بیشتر، به آموزش فایل‌های فید Shard و بهترین روش‌ها مراجعه کنید.

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

  • اشتراک گذاری خوراک پیشنهادی:
    • خوراک تاجر : یک تکه
    • خوراک خدمات : یک قطعه.
    • در دسترس بودن خوراک : کمتر از 20 خرده. اگر توجیه تجاری دارید که بیش از مقدار مشخص شده نیاز دارد، برای آموزش بیشتر با پشتیبانی تماس بگیرید .
  • اندازه فایل های فید و اشتراک گذاری:
    • پس از فشرده سازی، حجم فایل خرد شده را کمتر از 200 مگابایت نگه دارید. در صورت نیاز از چند خرده استفاده کنید.
    • رکوردهای فردی که در یک قطعه ارسال می شوند نیازی به ارسال در همان قطعه در فیدهای بعدی ندارند.
    • برای عملکرد بهتر، داده ها را به طور مساوی بین خرده ها تقسیم کنید تا همه فایل های خرد شده از نظر اندازه مشابه باشند.
    • در صورت لزوم، از gzip برای فشرده سازی فیدهای JSON متن ساده برای هر قطعه فید جداگانه استفاده کنید.

فشرده سازی فایل های فید

هر فایل JSON یا PB3 را می توان قبل از آپلود با gzip فشرده کرد. این می تواند اندازه بایت فیدهای روزانه را به میزان قابل توجهی کاهش دهد.

هر فایل شارد باید gzip'd و به صورت جداگانه آپلود شود، مانند gzip*.json. قطعات فید فشرده باید به .json.gz یا pb3.gz. ختم شوند.

فیدها را در SFTP dropbox خود آپلود کنید

پس از ایجاد فیدهای Merchant ، Service و Availability ، می توانید فیدهای خود را از طریق dropbox SFTP در Sandbox یا محیط تولید آپلود کنید. وقتی کلید SSH خود را در راه اندازی ارائه می کنید، دراپ باکس SFTP پیکربندی می شود. سرور SFTP Google در sftp://partnerupload.google.com در پورت 19321 موجود است.

Google فایل‌های فیدها را به محض آپلود در دراپ باکس SFTP بررسی و تأیید می‌کند. اگر فید در چندین فایل به اشتراک گذاشته شود، پس از آپلود آخرین فایل، آنها پردازش می شوند. اگر فید شما حاوی خطا باشد، یک ایمیل با کدهای خطای فید برای شما ارسال می‌شود. خطاها مانع از جذب تاجران، خدمات یا در دسترس بودن تعریف شده می‌شوند. پس از تأیید اعتبار فیدها، ممکن است تا 24 ساعت طول بکشد تا فیدها در قسمت جلویی ظاهر شوند.