قبل إنشاء "حملة Shopping"، عليك أولاً ربط حسابك على "إعلانات Google" بحسابك على Google Merchant Center باتّباع الخطوات التالية:
- أرسِل طلب ربط من حسابك على Merchant Center إلى حسابك على "إعلانات Google".
- وافِق على طلب ربط الحساب في حسابك على "إعلانات Google".
إرسال طلبات الربط من حسابك على Merchant Center
يمكنك إرسال طلب ربط بإحدى الطريقتَين التاليتَين:
- استخدِم واجهة الويب في Merchant Center لإرسال طلب ربط.
- استخدِم Content API for Shopping من أجل تعديل
adsLinks
Account
.
إدارة طلبات الربط في حسابك على "إعلانات Google"
يمكنك تغيير حالة روابط 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
.
أنشئ عنصر
UpdateProductLinkInvitationRequest
واضبط الحقلcustomer_id
على رقم تعريف عميل "إعلانات Google".اضبط الحقل
resource_name
ليكون اسم المورد الخاص بـproduct_link_invitation
.اضبط السمة
product_link_invitation_status
علىACCEPTED
.أرسِل طلب بيانات من واجهة برمجة التطبيقات
UpdateProductLinkInvitation
.
إذا حاول مستخدم لديه إذن مشرف في كلا الحسابين اتّباع خطوات الدعوة، سيظهر خطأ NO_INVITATION_REQUIRED
. يمكنك التحقّق من هذا الخطأ والرجوع إلى مسار الرابط المباشر في مثل هذه الحالات.
رفض دعوة
تشبه عملية رفض دعوة عملية قبول دعوة، إلا أنّه يتم ضبط الحقل product_link_invitation_status
على REJECTED
. إذا تم رفض دعوة، ستبقى في الحالة REJECTED
ولا يمكن قبولها. عليك بعد ذلك إنشاء دعوة جديدة إذا لزم الأمر.
الربط المباشر بدون دعوة
إذا كان المستخدم الذي يحاول ربط حساب "إعلانات Google" بحساب Merchant Center مشرفًا على كلا الحسابَين، يمكنه تخطّي خطوة الدعوة وربط الحسابَين مباشرةً باستخدام Google Ads API.
أنشئ عنصر
CreateProductLinkRequest
وضَع قيمة حقلcustomer_id
على رقم تعريف عميل "إعلانات Google".أنشئ عنصر
ProductLink
جديدًا واضبط الحقلmerchant_center_id
على معرّف حساب Merchant Center.اضبط قيمة
ProductLink
على حقلproduct_link
لكائن الطلب.أرسِل طلب بيانات من واجهة برمجة التطبيقات
CreateProductLink
إذا حاول مستخدم لا يملك أذونات كافية استخدام ميزة الربط المباشر، سيظهر الخطأ CREATION_NOT_PERMITTED
. يمكنك التحقّق من هذا الخطأ والرجوع إلى مسار الدعوة في مثل هذه الحالات.
عرض جميع روابط Merchant Center
يمكنك عرض تقرير 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'
إلغاء ربط رابط
اتّبِع الخطوات التالية لإلغاء ربط حساب:
أنشئ عنصر
RemoveProductLinkRequest
وضَع قيمة حقلcustomer_id
على رقم تعريف عميل "إعلانات Google".اضبط
resource_name
كاسم المورد الخاص بـproduct_link
.أرسِل طلب بيانات من واجهة برمجة التطبيقات
RemoveProductLink
مركز إدارة النشاط التجاري
أداة "إدارة النشاط التجاري" هي تمثيل موحّد لنشاط تجاري على Google. عند إدارة حسابك على "إعلانات Google" وحساباتك على Merchant Center باستخدام حساب على "مركز إدارة النشاط التجاري"، ينشئ مركز إدارة النشاط التجاري تلقائيًا روابط بين حسابك على "إعلانات Google" وحساب Merchant Center. يمكنك استرداد هذه الروابط باستخدام Google Ads API، ولكن لا يمكن تعديلها باستخدام Google Ads API.