نمای کلی Merchant API

این صفحه مقدمه‌ای برای Merchant API ارائه می‌کند و توضیح می‌دهد که چگونه می‌توانید از آن برای خودکارسازی گردش‌های کاری مختلف مرتبط با مدیریت حساب‌ها، محصولات و موجودی‌ها در Merchant Center استفاده کنید.

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

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

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

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

خرده فروشان مسئول پیروی از سیاست های تبلیغات خرید و لیست رایگان هستند. Google Shopping این حق را برای خود محفوظ می‌دارد که این خط‌مشی‌ها را اجرا کند و در صورت مشاهده محتوا یا رفتاری که این خط‌مشی‌ها را نقض می‌کند، به آن پاسخ مناسب بدهد.

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

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

برای اطلاعات بیشتر، ویژگی‌های جدید معرفی شده در Merchant API Beta را ببینید.

قبل از شروع

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

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

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

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

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

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

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

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

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

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/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/v1beta/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: فرم بازخورد را ارسال کنید
  • مستندات: از رتبه‌بندی انگشت شست درون صفحه و دکمه ارسال بازخورد استفاده کنید.
  • نمونه ها و کتابخانه ها: در مخزن GitHub برای نمونه کدها مشکلی ایجاد کنید .

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

بعدش چی

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

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

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

بعدی
طرح