تتيح Google Ads API ربط حسابات "إعلانات Google" بحسابات منتجات أخرى. يشرح هذا الدليل كيفية استخدام الإصدار 16 من واجهة برمجة التطبيقات لربط حساباتك.
طرق ربط الحسابات
عند ربط حساب "إعلانات 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 وMerchantCenterLinkService
إذا كنت قد استخدمت MerchantCenterLinkService أو AccountLinkService في السابق لربط حساب "إعلانات Google" بحساب منتج آخر، عليك نقل تطبيقك الحالي إلى إحدى مهام سير العمل المذكورة سابقًا. يعرض الجدول التالي حالة النقل:
| نوع الرابط | هل تتوفّر في الخدمات الجديدة؟ | يتوفّر الدعم اعتبارًا من | الملاحظات |
|---|---|---|---|
DataPartnerIdentifier |
نعم | v15 | نقل البيانات من MerchantCenterLinkService |
GoogleAdsIdentifier |
نعم | v16 | إيقاف خدمة AccountLinkService |
MerchantCenterIdentifier |
نعم | v16 | إيقاف خدمة AccountLinkService |
AdvertisingPartnerIdentifier |
نعم | v16 | إيقاف خدمة AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
لا | – | المتابعة باستخدام AccountLinkService |