פתרון בעיות

המידע במסמך הזה יכול לעזור לכם לפתור בעיות שעשויות להופיע בזמן ההטמעה של Subscription Linking.

ההודעה לקישור מינוי נתקעה במסך הטעינה

דוגמה לשגיאה:

הסמל של הטעינה

איור 1. הבקשה לקישור מינויים לא נטענת.

כדי לפתור את הבעיה, אפשר לבצע את הפעולות הבאות:

  • חשוב לוודא שהוספתם את מקורות הדפים, כולל בדיקה של תת-דומיינים, ככתובות URL נוספות בהגדרות אתר החדשות ב-Publisher Center.
  • בהטמעות של Extended Access או Reader Revenue Manager Enterprise, חשוב להוסיף את מקורות הדפים, כולל בדיקה של תת-דומיינים, למקורות JavaScript מורשים של לקוח OAuth 2.0 שהגדרתם להטמעה כזו. צריך לעשות זאת במסוף Google Cloud.

לא ניתן לקשר את החשבון

דוגמה לשגיאה:

לא ניתן לקשר את החשבון

איור 2. בעיה בקישור החשבון.

כדי לפתור את הבעיה, אפשר לבצע את הפעולות הבאות:

  • חשוב לאשר את התנאים וההגבלות של קישור המינויים ב-Publisher Center. לשם כך, נכנסים להגדרות של קישור מינויים ולוחצים על חתימה על התנאים וההגבלות של קישור המינויים.
  • אם חשבון Google כבר קושר, תקבלו הודעת שגיאה כשתנסו שוב לקשר את המינוי. יש לבטל את הקישור של המינוי דרך הדף 'מינויים' בחשבון Google, לפני שחוזרים על בדיקת השילוב בצד הלקוח.

שגיאת הרשאות בקריאה ל-Subscription Linking API

דוגמה לשגיאה:

קוד 403
מסר 'readerrevenuesubscriptionlinking.readerEntitlements.update' נדחה במשאב
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (או שייתכן שהוא לא קיים)."

כדי לפתור את הבעיה, אפשר לבצע את הפעולות הבאות:

  • חשוב לוודא שמשתמשים באותו פרויקט שציינתם בהגדרה של קישור מינויים. כשמגדירים קישור מינויים ב-Publisher Center, צריך להשתמש במספר הפרויקט. אפשר למצוא את מספר הפרויקט במרכז השליטה של הפרויקט.
  • ודאו ש-Subscription Linking API מופעל בפרויקט.
  • בניהול הזהויות והרשאות הגישה (IAM) של הפרויקט, מוודאים שלחשבון השירות מוקצית התפקיד אדמין של קישור מינויים. הערה: הפצת שינוי התפקידים במערכת עשויה להימשך זמן מה. אם מופיעה שגיאה 403 כשמבצעים קריאות ל-API, גם אחרי שמוודאים שלחשבון השירות יש תפקיד IAM הנכון, צריך להמתין כמה דקות ואז לנסות שוב לשלוח את הבקשה.

  • לא בטוחים באילו חשבונות שירות להשתמש או אם יש להם את תפקיד ה-IAM שנדרש, תוכלו להשתמש בכלי הניתוח למדיניות בפרויקט שהגדרתם לקישור מינויים. יצירה והרצה של שאילתה מותאמת אישית עם הפרמטרים הבאים של השאילתה:

    פרמטר 1 תפקיד
    תפקיד אדמין של קישור מינויים

  • חשוב לוודא שאתם משתמשים במפתח הנכון של חשבון השירות כשמפעילים את Subscriptions Linking API. בודקים את המאפיינים הבאים במפתח חשבון השירות (קובץ JSON):

    • type:הערך חייב להיות service_account.
    • project_id: עליו להיות מזהה הפרויקט של מספר הפרויקט שצוין בהגדרה של קישור המינויים.
    • client_email: עליו להיות אותו חשבון שירות בפרויקט IAM שמוקצה לו התפקיד Subscription Linking Admin.

  • אם קיבלתם את אסימון הגישה דרך נקודת הקצה של אסימון OAuth 2.0 של Google (https://oauth2.googleapis.com/token), צריך לוודא שהאסימון תקין ותוקפו לא פג כשקוראים לממשקי ה-API של קישור המינויים. אם תוקף האסימון יפוג, תצטרכו להשיג אסימון חדש.

  • אם אתם משתמשים ב-API ל-REST, חשוב לוודא שאתם משתמשים במזהה אתר החדשות שסיפקתם בהגדרה Subscription Linking. לדוגמה, אם מזהה אתר החדשות הוא 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"

לא רואים מאמרים המודגשים בתוצאות החיפוש

כדי לפתור את הבעיה, אפשר לבצע את הפעולות הבאות: