تتيح Google Ads API ربط حسابات "إعلانات Google" بحسابات منتجات أخرى. يشرح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لربط حساباتك.
طرق ربط الحسابات
عند ربط حساب على "إعلانات Google" بحساب منتج آخر، هناك طريقتان مختلفتان يمكن أن يتم من خلالهما الربط.
مسار الدعوة
يتم استخدام مسار الدعوة عندما يكون لديك إذن وصول إداري إلى حساب "إعلانات Google"، ولكن ليس إلى حساب المنتج. تعمل هذه العملية في سيناريوهَين:
- تريد ربط الحسابَين وإنشاء دعوة لأحد مشرفي حساب المنتج. يقبل مشرف حساب المنتج دعوة لإكمال عملية ربط الحساب.
- يريد مشرف حساب المنتج ربط الحسابَين، ولكن ليس لديه إذن بالوصول إلى حساب "إعلانات 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
.