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

تتيح 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" باستخدام طلب بحث بلغة طلبات بحث Google Ads (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.

السابق
إدارة دعوات وصول المستخدمين
التالي
ربط YouTube