نمای کلی Merchant API

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

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

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

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

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

Merchant API بازطراحی Content API ویژه Shopping است. این میانای برنامه‌سازی کاربردی از چند زیرمیانای برنامه‌سازی کاربردی تشکیل شده است.

ویژگی‌های جدید Merchant API

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

قبل‌از شروع

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

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

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

  • پیوندی از حساب 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 شناسه یکتای محصول است.

قالب نشانی وب درخواست

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

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

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

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

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

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

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. نتایج را تفسیر کنید.

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

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

دریافت راهنمایی

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

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

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

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

قدم بعدی چیست

  • برای کسب اطلاعات درباره سازگاری با نسخه قدیمی، به سازگاری Content API ویژه Shopping مراجعه کنید.

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

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

بعدی
Merchant API terms and conditions