للإشارة إلى علاقة مع حساب تاجر، يجب أن يستخدم شريك Shopping أولاً طريقة accounts.link لإرسال طلب ربط.
يحتوي طلب الربط على linkedAccountId
الذي يحدّد التاجر الذي يتلقّى الطلب، وله نوع action
يساوي request. يجب أن يحدّد كل رابط أيضًا مجموعة من services
توضّح الميزات التي يقدّمها الشريك للتاجر. يمكن استخدام قيم
services التالية.
| الخدمة | الوصف |
|---|---|
shoppingAdsProductManagement |
إدارة بيانات المنتجات في إعلانات Shopping |
shoppingActionsProductManagement |
إدارة بيانات المنتجات لبرنامج "الشراء على Google" (المعروف سابقًا باسم Shopping Actions) |
shoppingActionsOrderManagement |
إدارة الطلبات لبرنامج "الشراء على Google" (المعروف سابقًا باسم Shopping Actions) |
بالإضافة إلى ذلك، يجب أن يتضمّن الطلب أيضًا linkType صالحًا يصف نوع شريك Shopping الذي يقدّم الطلب. يتم تعيين إحدى التصنيفات التالية لشركاء Shopping، ويجب استخدام التصنيف المحدّد في الحقل linkType عند طلب البيانات من واجهة برمجة التطبيقات.
| أنواع الروابط الصالحة |
|---|
channelPartner |
eCommercePlatform |
مثال
يرسل طلب الربط التالي من خلال طلب بيانات من واجهة برمجة التطبيقات من حساب شريك (123456789) إلى تاجر لديه linkedAccountId بقيمة "98765".
يحدّد "eCommercePlatform" linkType الشريك كمنصة للتجارة الإلكترونية. تشير القائمة services إلى أنّ الشريك يوفّر ميزات "shoppingAdsProductManagement" (إدارة بيانات المنتجات في "إعلانات Shopping") و"shoppingActionsOrderManagement" (إدارة الطلبات في "الشراء على Google"، المعروفة سابقًا باسم Shopping Actions).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
يوضّح القسم التالي كيفية الحصول على قائمة بالروابط الحالية.