درخواست لینک

برای پرچم‌گذاری رابطه با حساب تجاری، شریک خرید ابتدا باید از روش accounts.link برای ارسال درخواست پیوند استفاده کند.

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

درخواست پیوند حاوی یک linkedAccountId است که تاجر دریافت کننده درخواست را شناسایی می کند و یک نوع action از request دارد. هر پیوند همچنین باید مجموعه‌ای از services مشخص کند که ویژگی‌هایی را که شریک به تاجر ارائه می‌دهد برمی‌شمارد. مقادیر services زیر پشتیبانی می شوند.

سرویس	شرح
shoppingAdsProductManagement	مدیریت داده های محصول برای تبلیغات خرید
shoppingActionsProductManagement	مدیریت داده‌های محصول برای خرید در Google (که قبلاً Shopping Actions نامیده می‌شد)
shoppingActionsOrderManagement	مدیریت سفارش برای خرید در Google (که قبلاً Shopping Actions نام داشت)

علاوه بر این، یک درخواست همچنین باید حاوی یک linkType معتبر باشد که نوع شریک خرید درخواست را توصیف می کند. به شرکای خرید یکی از برچسب های زیر اختصاص داده شده است و باید هنگام فراخوانی API از برچسب تعیین شده خود در قسمت linkType استفاده کنند.

انواع پیوندهای معتبر
channelPartner
eCommercePlatform

مثال

تماس API زیر یک درخواست پیوند از حساب شریک 123456789 به تاجری با linkedAccountId "98765" ارسال می کند.

"eCommercePlatform" linkType شریک را به عنوان یک پلت فرم تجارت الکترونیکی شناسایی می کند. فهرست services نشان می‌دهد که شریک ویژگی‌های "shoppingAdsProductManagement" (مدیریت داده‌های محصول برای تبلیغات خرید) و "shoppingActionsOrderManagement" (مدیریت سفارش برای خرید در Google، که قبلاً به عنوان «اقدامات خرید» شناخته می‌شد) را ارائه می‌کند.

POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
  "linkedAccountId": "98765",
  "linkType": "eCommercePlatform",
  "services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
  "action": "request"
}

بخش بعدی نحوه دریافت لیستی از پیوندهای موجود را شرح می دهد.