يمكن أن تساعد المعلومات الواردة في هذا المستند في تحديد المشاكل التي قد تواجهها أثناء تنفيذ ربط الاشتراكات وحلّها.
عبارة الحث على اتّخاذ إجراء لربط الاشتراكات عالقة على شاشة التحميل
مثال على الخطأ:
الشكل 1. لا يتم تحميل عبارة الحث على اتخاذ إجراء لربط الاشتراكات.
لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:
- تأكَّد من إضافة مصادر الصفحات، بما في ذلك النطاقات الفرعية الخاصة بالاختبار، كـ عناوين URL إضافية في إعدادات جهة النشر في Publisher Center.
- تأكَّد من أنّ حالة عنوان URL هي "تم التحقّق منه" بدلاً من "التحقّق".
- بالنسبة إلى عمليات تنفيذ Extended Access أو Reader Revenue Manager Enterprise، احرص على إضافة مصادر الصفحات، بما في ذلك النطاقات الفرعية للاختبار، إلى صفحات JavaScript الأصلية المعتمَدة لعميل OAuth 2.0 الذي أعددته لعملية التنفيذ هذه. يجب إجراء ذلك في Google Cloud Console.
تعذّر ربط الحساب
مثال على الخطأ:
الشكل 2. مشكلة تعذُّر ربط الحساب
لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:
- تأكَّد من قبول بنود الخدمة الخاصة بميزة ربط الاشتراكات في مركز الناشرين. لإجراء ذلك، انتقِل إلى إعدادات ربط الاشتراكات وانقر على توقيع بنود الخدمة الخاصة بربط الاشتراكات.
- إذا كان حساب Google مرتبطًا من قبل، ستتلقّى رسالة خطأ عند إعادة محاولة ربط الاشتراك. يجب إلغاء ربط الاشتراك من خلال صفحة الاشتراكات في حساب Google قبل إعادة اختبار عملية الدمج من جهة العميل.
خطأ في الأذونات عند طلب بيانات من واجهة Subscription Linking API
مثال على الخطأ:
| الرمز | 403
|
| الرسالة | 'readerrevenuesubscriptionlinking.readerEntitlements.update'
تم رفض إذن الوصول إلى المورد |
لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:
- تأكَّد من استخدام المشروع نفسه المحدّد في إعداد ربط الاشتراكات. عند إعداد ميزة "ربط الاشتراكات" في "مركز الناشرين"، استخدِم رقم المشروع. يمكنك العثور على رقم المشروع من لوحة بيانات المشروع.
- تأكَّد من تفعيل Subscription Linking API في مشروعك.
- في قسم "إدارة الهوية وإمكانية الوصول" (IAM) الخاص بالمشروع، تأكَّد من منح حساب الخدمة الدور مشرف ربط الاشتراكات. يُرجى العِلم أنّ نشر التغيير في الدور على مستوى النظام قد يستغرق بعض الوقت. إذا تلقّيت الخطأ 403 عند إجراء طلبات بيانات من واجهة برمجة التطبيقات، حتى بعد التأكّد من أنّ حساب الخدمة لديه دور IAM الصحيح، انتظِر بضع لحظات ثم أعِد محاولة طلبك.
إذا لم تكن متأكدًا من حسابات الخدمة التي يجب استخدامها أو ما إذا كانت تتضمّن دور إدارة الهوية وإمكانية الوصول اللازم، استخدِم أداة تحليل السياسات من المشروع الذي أعددته لربط الاشتراكات. أنشئ طلب بحث مخصّصًا ونفِّذه باستخدام مَعلمات طلب البحث التالية:
المَعلمة 1 الدور الدور مشرف ميزة "ربط الاشتراكات" تأكَّد من استخدام مفتاح حساب الخدمة الصحيح عند استدعاء واجهة برمجة التطبيقات Subscription Linking API. افحص الخصائص التالية في مفتاح حساب الخدمة (ملف JSON):
- type: يجب أن تكون القيمة service_account.
- يجب أن يكون project_id: هو رقم تعريف المشروع لرقم المشروع المحدّد في إعداد ربط الاشتراكات.
- client_email: يجب أن يكون حساب الخدمة نفسه في "إدارة الهوية وإمكانية الوصول" في المشروع الذي تمّ تعيين دور مشرف ربط الاشتراكات له.
إذا حصلت على رمز الدخول من خلال نقطة نهاية الرمز المميز لبروتوكولات Google OAuth 2.0 (https://oauth2.googleapis.com/token)، تأكَّد من أنّ الرمز المميز صالح ولم تنتهِ صلاحيته عند طلب واجهات برمجة التطبيقات الخاصة بربط الاشتراكات. إذا انتهت صلاحية الرمز المميّز، عليك الحصول على رمز جديد.
إذا كنت تستخدم واجهة REST API، تأكَّد من استخدام معرّف جهة النشر الذي قدّمته في عملية إعداد ربط الاشتراكات. على سبيل المثال، إذا كان معرّف الناشر هو
example.com، يجب أن يتضمّن عنوان URL للطلب هذا المعرّف.- ✅ استخدام رقم تعريف جهة النشر الذي تم إعداده فقط:
publications/example.com/readers/10078823/entitlements - ❌ لا تستخدِم معرّف جهة النشر غير المعرّف المحدّد في إعدادات
ربط الاشتراكات:
publications/example-staging.com/readers/10078823/entitlements - ❌ لا تُدرِج منتج النشر في الطلب:
publications/example.com:premium/readers/10078823/entitlements
- ✅ استخدام رقم تعريف جهة النشر الذي تم إعداده فقط:
حدث خطأ في الوسيطة غير الصالحة أثناء تعديل الإذن
مثال على الخطأ:
| الرسالة | خطأ: يحتوي الطلب على وسيطة غير صالحة |
لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:
- تأكَّد من تقديم العنصر
entitlementsبالتنسيق الصحيح. اطّلِع على هذا المثال. - تأكَّد من أنّ
product_idبالتنسيقpublication_id:product.- ✅ مثال صالح:
"product_id":"example.com:basic" - ❌ مثال غير صالح:
"product_id":"example.com"
- ✅ مثال صالح:
عدم ظهور المقالات المميّزة في نتائج البحث
لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:
- احرص على إضافة البيانات المنظَّمة إلى جميع مقالاتك. استخدِم اختبار النتائج الغنية بصريًا للتحقّق من صحة بياناتك المنظَّمة.
- تأكَّد من إدراج
productIDصالح في البيانات المنظَّمة يتوافق مع مجموعة من معرّفات المنتجات التي تستخدمها لتعديل إذن القراءة. - استخدِم تقرير النتائج الغنية بصريًا الخاص بـ "المحتوى المحمي باشتراك" في Search Console للاطّلاع على أي مشاكل متعلّقة ببياناتك المنظَّمة.
يتعذّر تغيير لغة رسالة عبارة الحث على اتّخاذ إجراء في ميزة "ربط الاشتراكات"
يتم تحديد لغة عبارة الحث على اتّخاذ إجراء في ميزة "ربط الاشتراكات" استنادًا إلى إعدادات المستخدم. لا يمكن إلغاؤه على مستوى العالم.
يتم تحديد اللغة على النحو التالي:
إذا كان المستخدم مسجّلاً الدخول باستخدام حسابه على Google، سيتم استخدام اللغة الأساسية المحدّدة في إعدادات حسابه على Google (https://myaccount.google.com/language).
إذا لم يكن المستخدم مسجّلاً الدخول، تستند اللغة إلى إعداد اللغة الأساسية في المتصفّح أو نظام التشغيل.
لا تتوافق عبارات الحث على اتّخاذ إجراء في ميزة "ربط الاشتراكات" مع بعض اللغات. إذا لم تكن اللغة الأساسية للمستخدم متاحة، قد يتم ضبط عبارة الحث على اتّخاذ إجراء تلقائيًا على اللغة الإنجليزية.