نمای کلی Merchant API

شما می‌توانید از API فروشگاه استفاده کنید

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

رابط برنامه‌نویسی کاربردی فروشنده می‌تواند حساب‌های مرکز فروشنده بزرگ یا پیچیده را مدیریت کند. موارد استفاده معمول شامل موارد زیر است:

  • مدیریت خودکار حساب
  • مدیریت خودکار محصول
  • مدیریت خودکار موجودی
  • مدیریت خودکار گزارش‌ها در مورد عملکرد و بینش‌های بازار

Merchant API به شما امکان می‌دهد چندین منبع داده ایجاد و مدیریت کنید و سازماندهی بهتری از اطلاعات مربوط به محصولات، تبلیغات و نظرات را فراهم کنید. با Merchant API، می‌توانید محصولات را به گونه‌ای مدیریت کنید که مکمل سایر روش‌های آپلود داده‌های محصول مانند فایل‌ها و autofeed باشد. Merchant API همچنین به شما امکان می‌دهد چندین درخواست جداگانه را به صورت موازی اجرا کنید .

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) یک طراحی مجدد از رابط برنامه‌نویسی کاربردی محتوا برای خرید است. این رابط شامل چندین زیر-رابط برنامه‌نویسی کاربردی (sub-API) است.

چه چیزهایی در رابط برنامه‌نویسی کاربردی فروشنده جدید است؟

در اینجا چند دلیل برای ارتقا به API فروشگاه آورده شده است:

قبل از شروع

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

  • حساب مرکز فروشندگان : این حسابی است که شما در آن جستجو، به‌روزرسانی و بارگذاری داده‌ها را انجام خواهید داد. مطمئن شوید که مجوزهای لازم برای مدیریت محصولات و موجودی‌ها را در این حساب دارید.

  • یک پروژه گوگل کلود: از این پروژه برای دسترسی API به حساب کاربری خود استفاده کنید.

  • لینکی از حساب مرکز فروشندگان شما به پروژه گوگل کلود. با فراخوانی روش ثبت نام توسعه‌دهندگان، لینک را ایجاد کنید. شما از این حساب و این کاربران برای ارتباط در مورد ادغام API، نظرسنجی‌ها و فرصت‌ها استفاده خواهید کرد.

  • با ثبت نام به عنوان توسعه دهنده، حساب مرکز فروشندگان خود را به پروژه Google Cloud متصل کنید. کاربرانی که نقش توسعه دهنده API را دارند، ارتباطات API، از جمله اطلاعیه‌های اجباری خدمات، نظرسنجی‌های توسعه دهندگان و فرصت‌ها را دریافت خواهند کرد.

احراز هویت با API فروشنده

برای احراز هویت می‌توانید از گزینه‌های زیر استفاده کنید:

  • شما می‌توانید یک شناسه و رمز کلاینت OAuth 2.0 برای برنامه خود ایجاد کنید. سپس می‌توان از این شناسه و رمز برای تولید اعتبارنامه‌های OAuth 2.0 مورد نیاز در فراخوانی‌های API به حساب مرکز فروشندگان استفاده کرد.
  • شما می‌توانید یک حساب کاربری سرویس ایجاد کنید و کلید خصوصی آن را برای برقراری تماس‌های API دانلود کنید.

شناسه‌های حساب و محصول

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) به جای شناسه (ID) از نام منابع برای شناسایی استفاده می‌کند. یک نام منبع برای یک محصول می‌تواند accounts/123456/products/en~US~sku123 باشد، که در آن 123456 شناسه منحصر به فرد حساب و en~US~sku123 شناسه منحصر به فرد محصول است.

فرمت URL درخواستی

برای کار بر روی یک منبع، درخواست‌ها را به آدرس‌های اینترنتی (URL) با فرمت زیر ارسال کنید:

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

بخش :{METHOD} برای متدهای استاندارد مانند list و get حذف شده است.

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

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

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

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

برای مثال، درخواست زیر نشان می‌دهد که چگونه می‌توانید یک منطقه برای accounts/123456 ایجاد کنید:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

شروع به استفاده از رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) کنید

برای مشاهده سریع نحوه کار Merchant API و آپلود یک نمونه محصول، به بخش شروع به کار با Merchant API مراجعه کنید.

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

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) از gRPC و REST پشتیبانی می‌کند. در اینجا دو روش برای برقراری تماس‌های رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) آورده شده است:

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

استفاده از کتابخانه‌های کلاینت و نمونه‌های کد

هر زیر-API دارای کتابخانه‌های کلاینت است که به شما در شروع کار کمک می‌کند. نمونه‌های کد می‌توانند به شما در شروع نوشتن کد در جاوا، PHP و پایتون کمک کنند. برای اطلاعات بیشتر، به نمونه‌هایی برای Merchant API مراجعه کنید.

کمک بگیرید

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

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

برای ارائه بازخورد، یکی از موارد زیر را ارسال کنید:

  • ویژگی‌های API: گزینه ارسال بازخورد را در بخش «مسئله/سوال چیست؟» در فرم بازخورد انتخاب کنید.
  • مستندات: از رتبه‌بندی‌های بندانگشتی درون‌صفحه‌ای و دکمه ارسال بازخورد استفاده کنید.
  • نمونه‌ها و کتابخانه‌ها: برای نمونه‌های کد، یک issue در مخزن GitHub ایجاد کنید .

قدم بعدی چیست؟

قبلی
Latest updates
بعدی
Design