للإبلاغ عن علاقة مع حساب تاجر، على شريك Shopping استخدام طريقة accounts.link أولاً لإرسال طلب ربط الحساب.
يحتوي طلب ربط الحساب على linkedAccountId
تحدّد التاجر الذي يتلقّى الطلب، ونوع action
request. يجب أيضًا أن يحدّد كل رابط مجموعة من services
توضّح الميزات التي يقدّمها الشريك للتاجر. يمكن استخدام قيم services التالية.
| خدمة | الوصف |
|---|---|
shoppingAdsProductManagement |
إدارة بيانات المنتجات في إعلانات Shopping |
shoppingActionsProductManagement |
إدارة بيانات المنتجات في "الشراء على Google" (المعروفة سابقًا باسم Shopping Actions) |
shoppingActionsOrderManagement |
إدارة الطلبات لميزة "الشراء على Google" (المعروفة سابقًا باسم Shopping Actions) |
بالإضافة إلى ذلك، يجب أن يتضمّن الطلب أيضًا سمة linkType صالحة تصف نوع شريك Shopping الذي يقدّم الطلب. يتم تخصيص أحد التصنيفات التالية لشركاء
التسوّق ويجب أن يستخدموا التصنيف المخصّص لهم في الحقل linkType عند طلب البيانات من واجهة برمجة التطبيقات.
| linkTypes صالحة |
|---|
channelPartner |
eCommercePlatform |
مثال
عند الطلب التالي من واجهة برمجة التطبيقات، يتم إرسال طلب ربط حساب من حساب أحد الشركاء
123456789 إلى تاجر لديه رقم linkedAccountId من أصل "98765".
تحدّد linkType "eCommercePlatform" الشريك كمنصة للتجارة الإلكترونية. تشير قائمة 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"
}
يوضّح القسم التالي كيفية الحصول على قائمة بالروابط الحالية.