طراحی Merchant API

ما Merchant API را طوری طراحی کردیم که با Content API برای توسعه دهندگان خرید آشنا باشد، اما ساده تر و انعطاف پذیرتر باشد. در اینجا اطلاعات دقیقی در مورد طراحی Merchant API وجود دارد.

API های فرعی

Merchant API مجموعه ای از API های فرعی است. APIهای فرعی گروهی از خدمات و منابع مرتبط هستند. این طراحی به این معنی است که شما می توانید فقط از زیرمجموعه های API مورد نیاز برای یکپارچه سازی منحصر به فرد خود استفاده کنید.

Merchant API شامل زیرمجموعه های زیر است:

  • حساب‌ها : حساب‌های Merchant Center را در مقیاس مدیریت کنید.
  • محصولات : داده‌های محصول، مانند قیمت و در دسترس بودن را مدیریت کنید.
  • منابع داده : منابع داده را برای محصولات خود مشاهده و مدیریت کنید.
  • موجودی ها : محصولات خود را بر اساس فروشگاه یا منطقه در Google به نمایش بگذارید.
  • گزارش‌ها : داده‌های مربوط به محصولات، عملکرد و فضای رقابتی خود را در سراسر Google مشاهده کنید.
  • تبلیغات : برای نمایش پیشنهادات ویژه برای محصولات خود، تبلیغات را ایجاد و مدیریت کنید.
  • مشارکت فیدهای محلی : فید موجودی محصول محلی خود را آپلود کنید.
  • منابع تبدیل : منابع تبدیل حساب خود را مدیریت کنید.
  • اعلان ها : اشتراک های اعلان ها را مدیریت کنید.
  • سهمیه : سهمیه API حساب های خود را بررسی کنید.

حمل و نقل

مکانیسم انتقال پیش‌فرض Merchant API gRPC است. شما همچنین می توانید از REST استفاده کنید.

برای اطلاعات بیشتر به راهنمای شروع سریع مراجعه کنید.

Enums

فیلدهای Enum در میان Merchant API ممکن است مقادیر جدیدی را در آینده نشان دهند. ساختار کد شما باید به گونه ای باشد که بتواند مقادیر ناشناخته را به خوبی مدیریت کند. شما باید بر وقوع مقادیر enum ناشناخته نظارت کنید و برای به روز نگه داشتن کد مداخله کنید.

نسخه سازی

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

نسخه‌هایی که به «بتا» ختم می‌شوند ممکن است تغییر یا حذف شوند.