قبل إنشاء "حملة 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 باستخدام 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
.
أنشئ عنصرًا من نوع
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.