درخواست لینک

برای پرچم‌گذاری رابطه با حساب تجاری، شریک خرید ابتدا باید از روش 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"
}

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