برای علامتگذاری یک رابطه با یک حساب تجاری، شریک خرید ابتدا باید از متد accounts.link برای ارسال درخواست لینک استفاده کند.
درخواست لینک شامل یک linkedAccountId است که فروشندهی دریافتکنندهی درخواست را شناسایی میکند و نوع request آن action type است. هر لینک همچنین باید مجموعهای از services مشخص کند که ویژگیهایی را که شریک به فروشنده ارائه میدهد، فهرست میکند. مقادیر services زیر پشتیبانی میشوند.
| خدمات | توضیحات |
|---|---|
shoppingAdsProductManagement | مدیریت دادههای محصول برای تبلیغات خرید |
shoppingActionsProductManagement | مدیریت دادههای محصول برای خرید در گوگل (که قبلاً با نام Shopping Actions شناخته میشد) |
shoppingActionsOrderManagement | مدیریت سفارش برای خرید در گوگل (که قبلاً با نام Shopping Actions شناخته میشد) |
علاوه بر این، یک درخواست باید شامل یک linkType معتبر نیز باشد که نوع شریک خرید درخواستکننده را توصیف کند. به شرکای خرید یکی از برچسبهای زیر اختصاص داده میشود و باید هنگام فراخوانی API از برچسب تعیینشده خود در فیلد linkType استفاده کنند.
| انواع لینک معتبر |
|---|
channelPartner |
eCommercePlatform |
مثال
فراخوانی API زیر یک درخواست لینک از حساب همکار با 123456789 به یک فروشنده با linkedAccountId برابر با "98765" ارسال میکند.
linkType "eCommercePlatform" شریک را به عنوان یک پلتفرم تجارت الکترونیک معرفی میکند. فهرست services نشان میدهد که شریک، ویژگیهای "shoppingAdsProductManagement" (مدیریت دادههای محصول برای تبلیغات Shopping) و "shoppingActionsOrderManagement" (مدیریت سفارش برای خرید در گوگل، که قبلاً با نام Shopping Actions شناخته میشد) را ارائه میدهد.
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
بخش بعدی نحوه دریافت لیستی از لینکهای موجود را شرح میدهد.