يمكن أن تساعد المعلومات الواردة في هذا المستند في تحديد المشاكل التي قد تواجهها أثناء تنفيذ ميزة ربط الاشتراكات وحلّها.
عبارة الحث على اتخاذ إجراء في ميزة "ربط الاشتراكات" عالقة على شاشة التحميل
مثال على الخطأ:
الشكل 1: لا يتم تحميل عبارة الحث على اتخاذ إجراء في ميزة "ربط الاشتراكات".
لحلّ هذه المشكلة، تحقَّق مما يلي:
- تأكَّد من إضافة مصادر الصفحات، بما في ذلك النطاقات الفرعية للاختبار، كعناوين URL إضافية في إعدادات جهة النشر في Publisher Center.
- تأكَّد من أنّ حالة عنوان URL هي "تمّ التحقّق منه" بدلاً من "التحقّق".
- بالنسبة إلى عمليات تنفيذ ميزة "الوصول الموسّع" أو "Reader Revenue Manager Enterprise"، تأكَّد من إضافة مصادر الصفحات، بما في ذلك النطاقات الفرعية للاختبار، إلى مصادر JavaScript المفوَّضة لعميل OAuth 2.0 الذي ضبطته لعملية التنفيذ هذه. يجب إجراء ذلك في Google Cloud Console.
تعذّر ربط الحساب
مثال على الخطأ:
الشكل 2: مشكلة تعذّر ربط الحساب
لحلّ هذه المشكلة، تحقَّق مما يلي:
- تأكَّد من قبول بنود خدمة ربط الاشتراكات في Publisher Center. لإجراء ذلك، انتقِل إلى إعدادات ربط الاشتراكات وانقر على التوقيع على بنود الخدمة الخاصة بربط الاشتراكات.
- إذا تم ربط حساب Google من قبل، ستظهر لك رسالة خطأ عند إعادة محاولة ربط الاشتراك. عليك إلغاء ربط الاشتراك من خلال صفحة الاشتراكاتفي حساب Google قبل تكرار اختبار التكامل من جهة العميل.
خطأ في الأذونات عند استدعاء Subscription Linking API
مثال على الخطأ:
| الرمز | 403
|
| رسالة | 'readerrevenuesubscriptionlinking.readerEntitlements.update'
denied on resource |
لحلّ هذه المشكلة، تحقَّق مما يلي:
- تأكَّد من استخدام المشروع نفسه المحدّد في إعداد ميزة "ربط الاشتراكات". عند إعداد ميزة "ربط الاشتراكات" في Publisher Center، استخدِم رقم المشروع. يمكنك العثور على رقم المشروع من لوحة بيانات مشروعك.
- تأكَّد من تفعيل Subscription Linking API في مشروعك.
- في إدارة الهوية وإمكانية الوصول (IAM) للمشروع، تأكَّد من أن حساب الخدمة ممنوح دور **مشرف ربط الاشتراكات**. يُرجى العِلم أنّ نشر تغيير الدور في النظام قد يستغرق بعض الوقت. إذا ظهر لك الخطأ 403 عند إجراء طلبات إلى واجهة برمجة التطبيقات، حتى بعد التأكّد من أنّ حساب الخدمة لديه دور IAM الصحيح، انتظِر بضع لحظات ثم أعِد محاولة طلبك.
إذا لم تكن متأكدًا من حسابات الخدمة التي يجب استخدامها أو ما إذا كانت لديها دور IAM اللازم، استخدِم أداة "محلِّل السياسات" من المشروع الذي أعددته لميزة "ربط الاشتراكات". أنشئ طلب بحث مخصّصًا وشغِّله باستخدام معاملات طلب البحث التالية:
المَعلمة 1 الدور الدور مشرف ربط الاشتراكات تأكَّد من استخدام مفتاح حساب الخدمة الصحيح عند استدعاء Subscription Linking API. افحص الخصائص التالية في مفتاح حساب الخدمة (ملف JSON):
- النوع: يجب أن يكون service_account.
- project_id: يجب أن يكون رقم تعريف المشروع الخاص بـ رقم المشروع المحدّد في إعداد ميزة "ربط الاشتراكات".
- client_email: يجب أن يكون حساب الخدمة نفسه في إدارة الهوية وإمكانية الوصول (IAM) للمشروع الذي تم منحه دور مشرف ربط الاشتراكات.
إذا حصلت على رمز الدخول المميّز من خلال نقطة نهاية رمز Google OAuth 2.0 (https://oauth2.googleapis.com/token)، تأكَّد من أنّ الرمز المميّز صالح وغير منتهي الصلاحية عند استدعاء Subscription Linking APIs. إذا انتهت صلاحية الرمز المميّز، عليك الحصول على رمز جديد.
إذا كنت تستخدم 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
- ✅ استخدِم رقم تعريف جهة النشر الذي تم ضبطه فقط:
خطأ في الوسيطة غير الصالحة عند تعديل الاستحقاق
مثال على الخطأ:
| رسالة | Error: Request contains an invalid argument |
لحلّ هذه المشكلة، تحقَّق مما يلي:
- تأكَّد من تقديم عنصر
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).
إذا لم يسجّل المستخدِم الدخول، تستند اللغة إلى إعداد اللغة الأساسية في المتصفّح أو نظام التشغيل.
لا تتوافق عبارات الحث على اتخاذ إجراء في ميزة "ربط الاشتراكات" مع جميع اللغات. إذا لم تكن اللغة الأساسية للمستخدِم متوافقة، قد يتم ضبط عبارة الحث على اتخاذ إجراء على اللغة الإنجليزية تلقائيًا.