ربط حسابك على 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 باستخدام QUERY التالي في "إعلانات Google" لاسترداد قائمة بجميع الدعوات المعلّقة لربط رقم تعريف عميل على "إعلانات 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.