تحديد المشاكل وحلّها

يمكن أن تساعدك المعلومات الواردة في هذا المستند في تحديد المشاكل التي قد تواجهها أثناء تنفيذ ميزة ربط الاشتراكات وحلّها.

رسالة المطالبة بربط الاشتراكات لا تظهر إلا على شاشة التحميل

مثال على الخطأ:

رمز التحميل

الشكل 1: لا يتم تحميل طلب ربط الاشتراكات.

لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:

  • احرص على إضافة مصادر الصفحات، بما في ذلك اختبار النطاقات الفرعية، على أن تكون عناوين URL إضافية في إعدادات النشر في "مركز الناشرين".
  • بالنسبة إلى عمليات تنفيذ "إمكانية الوصول الموسّعة" أو Reader Revenue Manager Enterprise، احرص على إضافة مصادر الصفحات، بما في ذلك اختبار النطاقات الفرعية، إلى صفحات JavaScript الأصلية المعتمَدة لبرنامج OAuth 2.0 الذي أعددته لتنفيذ ذلك. يجب تنفيذ ذلك في Google Cloud Console.

تعذّر ربط الحساب

مثال على الخطأ:

تعذّر ربط الحساب

الشكل 2: مشكلة تعذُّر ربط الحساب

لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:

  • احرص على قبول بنود خدمة ربط الاشتراكات في مركز الناشرين. لإجراء ذلك، انتقِل إلى إعدادات ربط الاشتراكات وانقر على التوقيع على بنود الخدمة الخاصة بربط الاشتراكات.
  • إذا سبق ربط حساب Google، ستظهر لك رسالة خطأ عند إعادة محاولة ربط الاشتراك. يجب إلغاء ربط الاشتراك من خلال صفحة الاشتراكات في حساب Google، قبل تكرار اختبار الدمج من جهة العميل.

خطأ في الأذونات عند الاتصال بواجهة برمجة التطبيقات Subscription Linking API

مثال على الخطأ:

الرمز 403
الرسالة 'readerrevenuesubscriptionlinking.readerEntitlements.update' تم رفضه في المورد
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (أو قد لا يكون متوفّرًا)."

لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:

  • تأكَّد من استخدام المشروع نفسه المحدّد في إعداد ربط الاشتراكات. عند إعداد ميزة "ربط الاشتراكات" في "مركز الناشرين"، استخدِم رقم المشروع. يمكنك العثور على رقم المشروع من لوحة بيانات المشروع.
  • تأكَّد من تفعيل 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"

عدم ظهور المقالات التي تم تمييزها في نتائج البحث

لحلّ هذه المشكلة، يُرجى التحقّق مما يلي:

لا يمكن تغيير لغة رسالة طلب ربط الاشتراك

عبارة الحث على اتّخاذ إجراء في ميزة "ربط الاشتراكات"

يتم تحديد لغة عبارة "ربط الاشتراك" للحث على اتّخاذ إجراء حسب إعدادات المستخدم. ولا يمكن إلغاء هذا الإعداد على مستوى الحساب.

يتم تحديد اللغة على النحو التالي:

  1. إذا سجّل المستخدم الدخول باستخدام حسابه على Google، يتم استخدام اللغة الأساسية التي تم ضبطها في إعدادات حسابه على Google (https://myaccount.google.com/language).

  2. إذا لم يكن المستخدم مسجّلاً الدخول، تستند اللغة إلى إعداد اللغة الأساسي في المتصفّح أو نظام التشغيل.

لا تتوفّر عبارات الحث على اتّخاذ إجراء في ميزة "ربط الاشتراكات" ببعض اللغات. إذا لم تكن اللغة الأساسية للمستخدم متاحة، قد يتم عرض عبارة المطالبة بالإجراء تلقائيًا باللغة الإنجليزية.