نمای کلی Merchant API

می توانید از Merchant API استفاده کنید

  • نحوه نمایش کسب و کار و محصولات خود را در Google مدیریت کنید.
  • دسترسی برنامه‌ای به داده‌ها، بینش‌ها و قابلیت‌های منحصربه‌فرد دریافت کنید.
  • کسب و کار خود را توسعه دهید و به مشتریان بیشتری در Google دسترسی پیدا کنید.

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

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

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

Merchant API طراحی مجدد Content API برای خرید است. این شامل چندین API فرعی است.

موارد جدید در Merchant API

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

قبل از شروع

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

  • یک حساب Merchant Center : این حسابی است که شما در حال جستجو، به‌روزرسانی و آپلود داده‌ها در آن هستید. مطمئن شوید که مجوزهای لازم را برای مدیریت محصولات و موجودی‌ها در این حساب دارید.

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

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

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

احراز هویت با Merchant API

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

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

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

Merchant API از نام منابع به جای شناسه برای شناسایی استفاده می کند. یک نام منبع مثال برای یک محصول می تواند 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. پاسخ به یک بافر پروتکل را غیراصولی کنید.
  4. نتایج را تفسیر کنید.
  1. بدنه درخواست را به عنوان یک شی JSON ایجاد کنید.
  2. آن را با استفاده از HTTP 1.1 به سرور ارسال کنید.
  3. پاسخ را به‌عنوان یک شی JSON از حالت سریال خارج کنید.
  4. نتایج را تفسیر کنید.

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

هر زیر API دارای کتابخانه های سرویس گیرنده است تا به شما در شروع کار کمک کند. نمونه کد می تواند به شما در شروع نوشتن کد در جاوا، پی اچ پی و پایتون کمک کند. برای اطلاعات بیشتر، Samples for Merchant API را ببینید.

کمک بگیرید

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

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

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

  • ویژگی های API: گزینه Send Feedback را در قسمت Issue/Question چیست انتخاب کنید؟ بخش فرم بازخورد
  • مستندات: از رتبه‌بندی انگشت شست درون صفحه و دکمه ارسال بازخورد استفاده کنید.
  • نمونه ها و کتابخانه ها: در مخزن GitHub برای نمونه کدها مشکلی ایجاد کنید .

بعدش چی

  • برای اطلاعات در مورد سازگاری به عقب، Content API for Shopping سازگاری .

  • برای اطلاعات بیشتر در مورد ویژگی‌های کلیدی Merchant API، به راهنماهای موجود در منوی پیمایش سمت چپ مراجعه کنید.

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

قبلی
Latest updates
بعدی
Design