طلب الروابط

للإبلاغ عن علاقة بحساب تاجر، يجب أن يستخدم شريك 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".

يحدّد 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"
}

يوضّح القسم التالي كيفية الحصول على قائمة بالروابط الحالية.