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