الربط بملفك التجاري

لتوفير المنتجات المتوفرة داخل المتجر في Merchant Center، عليك أولاً تحديد الأنشطة التجارية التي سيكون Merchant Center مسؤولاً عنها. يمكنك الحصول على قائمة بمجموعات المؤسسات المحتملة من "الملف التجاري" عبر Content API، ولكن عليك أولاً طلب الوصول إلى "الملف التجاري".

طلب إذن الوصول إلى ملف تجاري

لطلب الوصول إلى ملفك التجاري، استخدِم طريقة liasettings.requestgmbaccess:

POST https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/requestgmbaccess?gmbEmail=admin@example.com

كما يوضّح هذا المثال، تحدّد مَعلمة طلب البحث gmbEmail عنوان البريد الإلكتروني للمشرف على الملف التجاري.

بعد استدعاء هذه الطريقة، سيتلقّى المشرف المحدّد رسالة إلكترونية تطلب منه قبول طلب الوصول أو رفضه. تنتهي صلاحية هذا الطلب بعد 7 أيام إذا لم يتّخذ المشرف أي إجراء.

عرض قائمة بمجموعات المواقع الجغرافية للنشاط التجاري المتاحة

بعد منح الإذن بالوصول، يمكنك الاطّلاع على الأنشطة التجارية المتاحة من خلال استدعاء طريقة liasettings.getaccessiblegmbaccounts:

GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/accessiblegmbaccounts

Response:
200 OK
{
  "kind": "content#liasettingsGetAccessibleGmbAccountsResponse",
  "accountId": 67890,
  "gmbAccounts": [{
    "type" : "user",
    "email" : "admin@example.com",
    "name" : "admin@example.com",
    "listingCount": 82
  },
  {
    "type" : "business",
    "email" : "california@example.com",
    "name" : "Golden-State",
    "listingCount" : 20
  },
  {
    "type" : "business",
    "email" : "florida@example.com",
    "name" : "Sunshine-State",
    "listingCount" : 15
  },
  {
    "type" : "business",
    "email" : "newyork@example.com",
    "name" : "Empire-State",
    "listingCount" : 25
  }]
}

تحديد مجموعة المواقع الجغرافية للنشاط التجاري لحساب Merchant Center

بعد أن أصبحت لديك قائمة بمجموعات المواقع الجغرافية المحتملة للنشاط التجاري، عليك ضبط الحقل googleMyBusinessLink في مرجع Accounts المرتبط بحساب Merchant Center على المجموعة المطلوبة. على سبيل المثال، إذا كان حساب Merchant Center 67890 سيحتوي على منتجات للأنشطة التجارية في كاليفورنيا، يمكنك استخدام Accounts.update لضبط هذه المعلومات:

PUT https://shoppingcontent.googleapis.com/content/v2/12345/accounts/67890
{
  "googleMyBusinessLink" : {
    "gmbEmail": "california@example.com"
  }
}

Response:
200 OK
{
  "kind": "content#account",
  "id": 67890,
  "googleMyBusinessLink" : {
    "gmbEmail": "california@example.com",
    "status" : "active"
  }
}

لا يتطلّب ضبط الحقل googleMyBusinessLink أي عملية إثبات ملكية يدوية، لذا ستظهر حالة الرابط على الفور.

إرسال بيانات المنتجات والمستودع

بعد ربط حساب Merchant Center بمجموعة مواقع جغرافية للنشاط التجاري، يمكنك تقديم بيانات المنتجات المحلية وبيانات المخزون المتوفر في المتجر لهذه الأنشطة التجارية. لإجراء ذلك، يمكنك استخدام الطرق نفسها، مثل products.insert التي تستخدمها لتحميل بيانات المنتجات والمستودع على الإنترنت. بالنسبة إلى products.insert، عليك تحديد قناة local بدلاً من online.