با Merchant API شروع کنید

برای شروع، Merchant API را در پروژه Cloud خود فعال کنید.

در اینجا نحوه استفاده از Merchant API آورده شده است:

از کتابخانه های مشتری استفاده کنید

Merchant API از چندین API فرعی ساخته شده است.

هر زیر API دارای نمونه کد و کتابخانه های سرویس گیرنده است تا به شما در شروع کار کمک کند.

اگر قبلاً از Content API برای خرید استفاده می‌کنید، Content API for Shopping سازگاری را ببینید.

درخواست ها را ارسال کنید

Merchant API از نام منابع به جای شناسه برای شناسایی استفاده می کند. یک نام منبع مثال برای یک محصول می تواند accounts/123/products/online~en~US~sku123 باشد، که در آن 123 شناسه منحصر به فرد حساب و online~en~US~sku123 شناسه منحصر به فرد محصول است.

برای کار بر روی یک منبع، درخواست ها را به URL ها در قالب زیر ارسال کنید:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

به عنوان مثال، این درخواست موجودی منطقه ای را حذف می کند:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

برای ایجاد یک منبع جدید، می توانید از نام منبع منبع اصلی و آدرس زیر استفاده کنید

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

به عنوان مثال، به این صورت است که یک منطقه جدید برای account/123 ایجاد می کنید

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

برای جزئیات بیشتر در مورد خدمات خاص، به مستندات مرجع Merchant API مراجعه کنید.

از gRPC یا REST استفاده کنید

Merchant API از gRPC و REST پشتیبانی می کند. در اینجا دو راه برای برقراری تماس Merchant API وجود دارد:

gRPC (توصیه می شود) استراحت
  1. بدنه درخواست را به عنوان بافر پروتکل ایجاد کنید.
  2. متن درخواست را با HTTP/2 به سرور ارسال کنید.
  3. پاسخ به یک بافر پروتکل را غیراصولی کنید.
  4. نتایج را تفسیر کنید.
  1. بدنه درخواست را به عنوان یک شی JSON ایجاد کنید.
  2. آن را با استفاده از HTTP 1.1 به سرور ارسال کنید.
  3. پاسخ را به‌عنوان یک شی JSON از حالت سریال خارج کنید.
  4. نتایج را تفسیر کنید.

کمک بگیرید

برای کسب اطلاعات در مورد دریافت پشتیبانی، به دریافت راهنمایی با Merchant API مراجعه کنید.

بازخورد بدهید

دوره بتا این فرصت را به ما می دهد تا قبل از انتشار در دسترس عمومی، بازخورد شما را جمع آوری و بررسی کنیم. برای ارائه بازخورد، یکی از موارد زیر را ارسال کنید:

  • ویژگی های API: فرم بازخورد را ارسال کنید
  • مستندات: از رتبه‌بندی انگشت شست درون صفحه و دکمه ارسال بازخورد استفاده کنید.
  • نمونه ها و کتابخانه ها: از دکمه شماره جدید در GitHub استفاده کنید.

برای ارائه بازخورد کلی پس از اجرای هر کار، از فرم بازخورد استفاده کنید.

قبلی
وضعیت راه اندازی
بعدی
نمای کلی