تتيح Google Ads API ربط حسابات "إعلانات Google" بحسابات منتجات أخرى. يوضّح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لربط حساباتك.
طُرق ربط الحسابات
عند ربط حساب على "إعلانات Google" بحساب على منتج آخر، يمكن إجراء الربط بطريقتَين مختلفتَين.
مسار الدعوة
استخدِم مسار الدعوة عندما يكون لديك إذن وصول المشرف إلى حساب "إعلانات Google"، ولكن ليس إلى حساب المنتج. يعمل مسار العمل هذا في حالتين:
- تريد ربط الحسابَين وإنشاء دعوة لمشرف حساب المنتج. يقبل مشرف حساب المنتج الدعوة لإكمال عملية الربط مع حساب حالي.
- يريد مشرف حساب المنتج ربط الحسابَين، ولكن ليس لديه إذن الوصول إلى حساب "إعلانات Google". ينشئ مشرف حساب المنتج دعوة، ثم تقبلها وتكمل عملية الربط مع حساب حالي.
استخدِم الطرق التالية في هذا السيناريو:
| السيناريو | الإجراء | الملاحظات |
|---|---|---|
| السيناريو 1 | إنشاء دعوة | استخدِم طريقة
ProductLinkInvitationService.CreateProductLinkInvitation
لإنشاء دعوة. يجب عدم ضبط status
في
ProductLinkInvitation، لأنّ خادم Google Ads API سيضبطه على REQUESTED عند إكمال طلب البيانات من واجهة برمجة التطبيقات بنجاح. عند إنشاء دعوة لشريك إعلاني
(AdvertisingPartnerLinkInvitationIdentifier)،
يجب توفير advertising_partner_properties.allowed_domain
اعتبارًا من الإصدار 25 (وهو اختياري في الإصدار 24 والإصدارات الأقدم). |
| فحص حالة دعوة | استخدِم GoogleAdsService.Search
أو GoogleAdsService.SearchStream
لطلب البحث عن المورد product_link_invitation
وفحص حالته. |
|
| السيناريو 2 | استرداد دعوة | استخدِم GoogleAdsService.Search
أو GoogleAdsService.SearchStream
للاستعلام عن المرجع product_link_invitation. استخدِم الفلتر
status = PENDING_APPROVAL لقبول دعوة في انتظار المراجعة أو رفضها. |
| قبول دعوة أو رفضها | استخدِم طريقة
ProductLinkInvitationService.UpdateProductLinkInvitation لتعديل حالة
ProductLinkInvitation إلى ACCEPTED أو
REJECTED. |
|
| إلغاء دعوة | استخدِم طريقة
ProductLinkInvitationService.RemoveProductLinkInvitation لإبطال
ProductLinkInvitation حالي. |
يمكن أن تحدث الأخطاء الشائعة التالية في سير العمل هذا:
| رمز الخطأ | الشرح |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
ليس لدى العميل الإذن اللازم لتنفيذ هذا الإجراء. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
تعذّر إنشاء دعوة لأنّ المستخدم لديه إذن وصول إداري إلى الحساب المدعو. على المستخدم استخدام ProductLinkService لإنشاء رابط نشط مباشرةً. |
مسار الربط المباشر
استخدِم مسار الربط المباشر عندما يكون لديك إذن وصول المشرف إلى كلّ من حساب "إعلانات Google" وحساب المنتج. في هذه الحالة، اربط حساب "إعلانات Google" مباشرةً بحساب المنتج بدلاً من إرسال دعوة.
استخدِم الطرق التالية في هذا السيناريو:
| الإجراء | الملاحظات |
|---|---|
| إنشاء رابط نشط | استخدِموا
ProductLinkService.CreateProductLink لإنشاء
ProductLink. |
| إيقاف رابط نشط | استخدِم
ProductLinkService.RemoveProductLink لإزالة
ProductLink
نشط. |
| استرداد الروابط النشطة | استخدِم
GoogleAdsService.Search أو
GoogleAdsService.SearchStream
للاستعلام عن المرجع
product_link. |
قد تظهر الأخطاء الشائعة التالية في سير العمل هذا:
| رمز الخطأ | الشرح |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
تمت محاولة ربط حساب باستخدام مسار الرابط المباشر، ولكن هذا الإجراء غير متاح بسبب عدم توفّر الأذونات اللازمة. على المستخدم استخدام
ProductLinkInvitationService
لإجراء عملية الدعوة بدلاً من ذلك.
|
ProductLinkError.INVITATION_EXISTS |
لا يمكن إنشاء رابط لأنّه سبق إرسال دعوة معلّقة. |
استرداد روابط المنتجات الحالية
يمكنك استرداد جميع روابط المنتجات المرتبطة بحسابك على "إعلانات Google" باستخدام طلب بحث GAQL يستهدف المورد product_link.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
يشير الحقل product_link.type إلى نوع المنتج أو الخدمة المرتبطة.
استنادًا إلى type، سيتم ملء حقول أخرى ضمن المرجع product_link، ما يوفّر المزيد من التفاصيل حول الرابط. على سبيل المثال، إذا كان النوع
DATA_PARTNER، سيحتوي الحقل data_partner على معلومات حول
حساب شريك البيانات المرتبط.
يتيح لك ذلك الحصول على قائمة بالخدمات الخارجية وحسابات المنتجات المرتبطة مباشرةً بحسابك على "إعلانات Google"، مثل Merchant Center أو "إعلانات Google" أو "الشركاء الإعلانيون" أو شركاء البيانات.
التغييرات في AccountLinkService
إذا كنت تستخدم AccountLinkService لربط حساب على "إعلانات Google" بحساب منتج آخر، عليك نقل تطبيقك الحالي إلى إحدى سير العمل المذكورة سابقًا. بالنسبة إلى أنواع الروابط التالية، عليك إيقاف AccountLinkService واستخدام ProductLinkService:
بالنسبة إلى ThirdPartyAppAnalyticsLinkIdentifier، استمِر في استخدام
AccountLinkService.