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

تتيح 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	لا يمكن إنشاء رابط لأنّه سبق إرسال دعوة معلّقة.

استرداد روابط المنتجات الحالية

يمكنك استرداد جميع روابط المنتجات المرتبطة بحسابك على "إعلانات Google" باستخدام طلب بحث GAQL يستهدف المورد product_link.

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

يشير الحقل product_link.type إلى نوع المنتج أو الخدمة المرتبطة. استنادًا إلى type، سيتم ملء الحقول الأخرى ضمن مورد product_link، ما يوفّر المزيد من التفاصيل حول الرابط. على سبيل المثال، إذا كان النوع THIRD_PARTY_APP_ANALYTICS، سيتضمّن الحقل third_party_app_analytics معلومات حول مقدّم خدمة الإحصاءات.

يتيح لك ذلك الحصول على قائمة بالخدمات والتطبيقات الخارجية المرتبطة مباشرةً بحسابك على "إعلانات Google"، مثل Google Play أو شركاء البيانات أو منصات إحصاءات التطبيقات التابعة لجهات خارجية.

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

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

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

بالنسبة إلى ThirdPartyAppAnalyticsLinkIdentifier، واصِل استخدام AccountLinkService.