تتيح 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 |