ربط حسابك على Merchant Center بحسابك على "إعلانات Google"

قبل إنشاء "حملة Shopping"، عليك أولاً ربط حسابك على "إعلانات Google" بحسابك على Google Merchant Center باتّباع الخطوات التالية:

  1. أرسِل طلب ربط من حسابك على Merchant Center إلى حسابك على "إعلانات Google".
  2. وافِق على طلب ربط الحساب في حسابك على "إعلانات Google".

يمكنك إرسال طلب ربط بإحدى الطريقتَين التاليتَين:

  1. استخدِم واجهة الويب في Merchant Center لإرسال طلب ربط.
  2. استخدِم Content API for Shopping من أجل تعديل adsLinks Account.

يمكنك تغيير حالة روابط Merchant Center في حسابك على "إعلانات Google" من خلال استخدام واجهة مستخدم "إعلانات Google" على الويب للموافقة على دعوة أو رفضها. يمكنك أيضًا تعديل الدعوات أو إزالة الروابط الحالية باستخدام Google Ads API كما هو موضّح أدناه.

عرض جميع الدعوات في Merchant Center

يمكنك تنفيذ تقرير Google Ads API باستخدام طلب البحث التالي بلغة GAQL لاسترداد قائمة بجميع الدعوات المعلّقة لربط رقم تعريف عميل على "إعلانات Google" بحساب على Merchant Center.

SELECT
    product_link_invitation.merchant_center.merchant_center_id,
    product_link_invitation.type
FROM product_link_invitation
WHERE product_link_invitation.status = 'PENDING_APPROVAL'
    AND product_link_invitation.type = 'MERCHANT_CENTER'

لاسترداد جميع الدعوات، أزِل شرط الفلترة للحقل product_link_invitation.status في طلب البحث أعلاه.

قبول دعوة

يمكنك الموافقة على الربط من خلال ضبط الحالة product_link_invitation على ACCEPTED.

  1. أنشئ عنصر UpdateProductLinkInvitationRequest واضبط الحقل customer_id على رقم تعريف عميل "إعلانات Google".

  2. اضبط الحقل resource_name ليكون اسم المورد الخاص بـ product_link_invitation.

  3. اضبط السمة product_link_invitation_status على ACCEPTED.

  4. أرسِل طلب بيانات من واجهة برمجة التطبيقات UpdateProductLinkInvitation.

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

رفض دعوة

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

الربط المباشر بدون دعوة

إذا كان المستخدم الذي يحاول ربط حساب "إعلانات Google" بحساب Merchant Center مشرفًا على كلا الحسابَين، يمكنه تخطّي خطوة الدعوة وربط الحسابَين مباشرةً باستخدام Google Ads API.

  1. أنشئ عنصر CreateProductLinkRequest وضَع قيمة حقل customer_id على رقم تعريف عميل "إعلانات Google".

  2. أنشئ عنصر ProductLink جديدًا واضبط الحقل merchant_center_id على معرّف حساب Merchant Center.

  3. اضبط قيمة ProductLink على حقل product_link لكائن الطلب.

  4. أرسِل طلب بيانات من واجهة برمجة التطبيقات CreateProductLink

إذا حاول مستخدم لا يملك أذونات كافية استخدام ميزة الربط المباشر، سيظهر الخطأ CREATION_NOT_PERMITTED. يمكنك التحقّق من هذا الخطأ والرجوع إلى مسار الدعوة في مثل هذه الحالات.

يمكنك عرض تقرير Google Ads API باستخدام طلب البحث التالي بلغة GAQL لاسترداد قائمة بالروابط لرقم تعريف عميل على "إعلانات Google".

SELECT
    product_link.merchant_center.merchant_center_id,
    product_link.product_link_id
FROM product_link
WHERE product_link.type = 'MERCHANT_CENTER'

اتّبِع الخطوات التالية لإلغاء ربط حساب:

  1. أنشئ عنصر RemoveProductLinkRequest وضَع قيمة حقل customer_id على رقم تعريف عميل "إعلانات Google".

  2. اضبط resource_name كاسم المورد الخاص بـ product_link.

  3. أرسِل طلب بيانات من واجهة برمجة التطبيقات RemoveProductLink

أداة "إدارة النشاط التجاري" هي تمثيل موحّد لنشاط تجاري على Google. عند إدارة حسابك على "إعلانات Google" وحساباتك على Merchant Center باستخدام حساب على "مركز إدارة النشاط التجاري"، ينشئ مركز إدارة النشاط التجاري تلقائيًا روابط بين حسابك على "إعلانات Google" وحساب Merchant Center. يمكنك استرداد هذه الروابط باستخدام Google Ads API، ولكن لا يمكن تعديلها باستخدام Google Ads API.