عیب یابی

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

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

مثال خطا:

نماد بارگیری

شکل 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' (یا ممکن است وجود نداشته باشد)."

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

  • مطمئن شوید که از همان پروژه ای استفاده می کنید که در تنظیمات پیوند اشتراک مشخص شده است. وقتی پیوند اشتراک را در مرکز ناشران راه‌اندازی می‌کنید، از شماره پروژه استفاده کنید. می توانید شماره پروژه را از داشبورد پروژه خود پیدا کنید.
  • اطمینان حاصل کنید که Subscription Linking API در پروژه شما فعال است.
  • در پروژه مدیریت هویت و دسترسی (IAM)، مطمئن شوید که حساب سرویس با نقش مدیریت پیوند اشتراک اشتراک اعطا شده است. توجه داشته باشید که انتشار تغییر نقش در سیستم ممکن است زمان ببرد. اگر هنگام برقراری تماس‌های API، خطای 403 دریافت کردید، حتی پس از اینکه تأیید کردید که حساب سرویس شما دارای نقش IAM صحیح است، چند لحظه صبر کنید و سپس درخواست خود را دوباره امتحان کنید.

  • اگر مطمئن نیستید که از کدام حساب‌های سرویس استفاده کنید یا نقش IAM لازم را دارند، از تحلیل‌گر سیاست پروژه‌ای که برای پیوند اشتراک راه‌اندازی کرده‌اید استفاده کنید. یک پرس و جو سفارشی با پارامترهای پرس و جو زیر ایجاد و اجرا کنید:

    پارامتر 1 نقش
    نقش مدیریت پیوند اشتراک

  • هنگام تماس با API پیوند اشتراک، مطمئن شوید که از کلید حساب سرویس صحیح استفاده می کنید. ویژگی های زیر را در کلید حساب سرویس خود (فایل JSON) بررسی کنید:

    • نوع: باید service_account باشد.
    • project_id: باید شناسه پروژه از شماره پروژه مشخص شده در تنظیمات پیوند اشتراک باشد.
    • client_email: باید همان حساب سرویس در پروژه IAM باشد که نقش مدیریت پیوند اشتراک را به آن اختصاص داده است.

  • اگر رمز دسترسی را از طریق نقطه پایانی نشانه Google OAuth 2.0 (https://oauth2.googleapis.com/token) دریافت کرده‌اید، مطمئن شوید که هنگام تماس با APIهای پیوند اشتراک اشتراک، این رمز معتبر است و منقضی نشده است. اگر توکن منقضی شود، باید یک توکن جدید تهیه کنید.

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