ربط حسابات المنتجات

تتيح Google Ads API ربط حسابات "إعلانات Google" بحسابات منتجات أخرى. يشرح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لربط حساباتك.

طرق ربط الحسابات

عند ربط حساب إعلانات Google بحساب منتج آخر، هناك طريقتان مختلفتان يمكن أن يحدث من خلالهما الربط.

مسار الدعوة

يُستخدم تدفق الدعوة عندما يكون لديك إذن وصول المشرف إلى حساب "إعلانات Google"، ولكن ليس حساب المنتج. يعمل هذا التدفق في سيناريوهين:

1. وتريد ربط الحسابين وإنشاء دعوة لمشرف حساب المنتج. يقبل مشرف حساب المنتج دعوة لإكمال عملية ربط الحساب.
2. يريد مشرف حساب المنتج ربط الحسابَين، ولكنّه لا يملك إذن الوصول إلى حساب "إعلانات Google". ينشئ مسؤول حساب المنتج دعوة، وتقبل الدعوة وتكمل عملية الربط.

تُستخدم الطرق التالية في هذا السيناريو:

السيناريو	الإجراء	الملاحظات
السيناريو 1	إنشاء دعوة	استخدِم الطريقة ProductLinkInvitationService.CreateProductLinkInvitation لإنشاء دعوة. يجب عدم ضبط status في ProductLinkInvitation، بل سيضبط خادم Google Ads API القيمة على REQUESTED عند إكمال طلب البيانات من واجهة برمجة التطبيقات بنجاح.
	التحقّق من حالة دعوة	استخدِم 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	لا يملك العميل الإذن بتنفيذ هذا الإجراء.
ProductLinkError.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	لا يمكن إنشاء رابط بسبب وجود دعوة في انتظار المراجعة فعلاً.

التغييرات في AccountLinkService

إذا كنت تستخدم AccountLinkService لربط حساب "إعلانات Google" بحساب منتج آخر، عليك نقل تطبيقك الحالي إلى أحد إجراءات سير العمل المذكورة سابقًا. بالنسبة إلى أنواع الروابط التالية، عليك نقل البيانات من AccountLinkService واستخدام ProductLinkService:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

بالنسبة إلى ThirdPartyAppAnalyticsLinkIdentifier، يُرجى مواصلة استخدام AccountLinkService.