عیب یابی

اطلاعات موجود در این سند می‌تواند به عیب‌یابی مشکلاتی که ممکن است هنگام اجرای پیوند اشتراک با آن‌ها مواجه شوید، کمک کند.

درخواست پیوند اشتراک در صفحه بارگیری گیر کرده است

مثال خطا:

نماد بارگیری

شکل 1. درخواست پیوند اشتراک بارگیری نمی شود.

برای حل این مشکل موارد زیر را بررسی کنید:

  • اطمینان حاصل کنید که مبدا صفحات، از جمله زیر دامنه‌های آزمایشی، را به‌عنوان نشانی‌های اینترنتی اضافی در تنظیمات انتشارات مرکز ناشران اضافه کرده‌اید.
  • برای پیاده‌سازی‌های Extended Access یا Reader Revenue Manager Enterprise، مطمئن شوید که مبدا صفحات، از جمله زیر دامنه‌های آزمایشی، را به مبداهای مجاز جاوا اسکریپت مشتری OAuth 2.0 که برای چنین پیاده‌سازی پیکربندی کرده‌اید، اضافه کنید. این باید در Google Cloud Console انجام شود.

حساب را نمی توان پیوند داد

مثال خطا:

حساب را نمی توان پیوند داد

شکل 2. مشکل مرتبط با حساب نیست.

برای حل این مشکل موارد زیر را بررسی کنید:

  • مطمئن شوید که شرایط خدمات را برای پیوند اشتراک در مرکز ناشران می‌پذیرید. برای انجام این کار، به تنظیمات پیوند اشتراک بروید و روی امضای شرایط خدمات پیوند اشتراک کلیک کنید.
  • اگر حساب Google قبلاً مرتبط شده باشد، هنگام تلاش مجدد برای پیوند دادن اشتراک، یک پیام خطایی دریافت خواهید کرد. قبل از تکرار تست ادغام سمت مشتری، باید اشتراک را از طریق صفحه اشتراک در حساب Google لغو پیوند کنید.

خطای مجوز هنگام تماس با API پیوند اشتراک

مثال خطا:

کد 403
پیام 'readerrevenuesubscriptionlinking.readerEntitlements.update' در منبع رد شد
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (یا ممکن است وجود نداشته باشد)."

برای حل این مشکل موارد زیر را بررسی کنید:

  • مطمئن شوید که از همان پروژه GCP که در تنظیمات پیوند اشتراک مشخص شده است استفاده می کنید.
  • مطمئن شوید که API پیوند اشتراک در پروژه GCP شما فعال است.
  • در GCP IAM، مطمئن شوید که حساب سرویس دارای نقش مدیریت پیوند اشتراک است.
  • اگر از 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 معتبر در داده‌های ساختاریافته قرار داده‌اید که با مجموعه‌ای از شناسه‌های محصول که برای به‌روزرسانی حق خواننده استفاده می‌کنید، مطابقت دارد.
  • از یک گزارش نتیجه غنی برای «محتوای مشترک» در «کنسول جستجو » استفاده کنید تا مشکلات مربوط به داده‌های ساختاریافته‌تان را ببینید.
،

اطلاعات موجود در این سند می‌تواند به عیب‌یابی مشکلاتی که ممکن است هنگام اجرای پیوند اشتراک با آن‌ها مواجه شوید، کمک کند.

درخواست پیوند اشتراک در صفحه بارگیری گیر کرده است

مثال خطا:

نماد بارگیری

شکل 1. درخواست پیوند اشتراک بارگیری نمی شود.

برای حل این مشکل موارد زیر را بررسی کنید:

  • اطمینان حاصل کنید که مبدا صفحات، از جمله زیر دامنه‌های آزمایشی، را به‌عنوان نشانی‌های اینترنتی اضافی در تنظیمات انتشارات مرکز ناشران اضافه کرده‌اید.
  • برای پیاده‌سازی‌های Extended Access یا Reader Revenue Manager Enterprise، مطمئن شوید که مبدا صفحات، از جمله زیر دامنه‌های آزمایشی، را به مبداهای مجاز جاوا اسکریپت مشتری OAuth 2.0 که برای چنین پیاده‌سازی پیکربندی کرده‌اید، اضافه کنید. این باید در Google Cloud Console انجام شود.

حساب را نمی توان پیوند داد

مثال خطا:

حساب را نمی توان پیوند داد

شکل 2. مشکل مرتبط با حساب نیست.

برای حل این مشکل موارد زیر را بررسی کنید:

  • مطمئن شوید که شرایط خدمات را برای پیوند اشتراک در مرکز ناشران می‌پذیرید. برای انجام این کار، به تنظیمات پیوند اشتراک بروید و روی امضای شرایط خدمات پیوند اشتراک کلیک کنید.
  • اگر حساب Google قبلاً مرتبط شده باشد، هنگام تلاش مجدد برای پیوند دادن اشتراک، یک پیام خطایی دریافت خواهید کرد. قبل از تکرار تست ادغام سمت مشتری، باید اشتراک را از طریق صفحه اشتراک در حساب Google لغو پیوند کنید.

خطای مجوز هنگام تماس با API پیوند اشتراک

مثال خطا:

کد 403
پیام 'readerrevenuesubscriptionlinking.readerEntitlements.update' در منبع رد شد
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (یا ممکن است وجود نداشته باشد)."

برای حل این مشکل موارد زیر را بررسی کنید:

  • مطمئن شوید که از همان پروژه GCP که در تنظیمات پیوند اشتراک مشخص شده است استفاده می کنید.
  • مطمئن شوید که API پیوند اشتراک در پروژه GCP شما فعال است.
  • در GCP IAM، مطمئن شوید که حساب سرویس دارای نقش مدیریت پیوند اشتراک است.
  • اگر از 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 معتبر در داده‌های ساختاریافته قرار داده‌اید که با مجموعه‌ای از شناسه‌های محصول که برای به‌روزرسانی حق خواننده استفاده می‌کنید، مطابقت دارد.
  • از یک گزارش نتیجه غنی برای «محتوای مشترک» در «کنسول جستجو » استفاده کنید تا مشکلات مربوط به داده‌های ساختاریافته‌تان را ببینید.