פתרון בעיות

המידע במסמך הזה יכול לעזור לכם לפתור בעיות שעשויות לצוץ במהלך ההטמעה של קישור מינויים.

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

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

סמל הטעינה

איור 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' נדחתה במשאב
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (או שהוא לא קיים)."

כדי לפתור את הבעיה, צריך לבדוק את הפרטים הבאים:

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

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

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

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

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

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

  • אם אתם משתמשים ב-API ל-REST, חשוב לוודא שאתם משתמשים במזהה אתר החדשות שסיפקתם בהגדרה של קישור המינויים. לדוגמה, אם מזהה אתר החדשות שלכם הוא example.com, כתובת ה-URL של הבקשה חייבת לכלול אותו.

    • ✅ משתמשים רק במזהה אתר החדשות שהוגדר: publications/example.com/readers/10078823/entitlements
    • ❌ אין להשתמש במזהה אתר חדשות שאינו המזהה שצוין בהגדרה של קישור מינויים: publications/example-staging.com/readers/10078823/entitlements
    • ❌ לא לכלול את מוצר אתר החדשות בבקשה: publications/example.com:premium/readers/10078823/entitlements

שגיאה ב-Invalid argument בזמן עדכון ההרשאה

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

הודעה שגיאה: הבקשה מכילה ארגומנט לא חוקי

כדי לפתור את הבעיה, צריך לבדוק את הפרטים הבאים:

  • חשוב לוודא שהאובייקט entitlements מסופק בפורמט הנכון. לדוגמה
  • מוודאים ש-product_id בפורמט של publication_id:product.
    • ✅ דוגמה תקינה: "product_id":"example.com:basic"
    • ❌ דוגמה לא חוקית: "product_id":"example.com"

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

כדי לפתור את הבעיה, צריך לבדוק את הפרטים הבאים:

אי אפשר לשנות את השפה של הודעת הקריאה לפעולה בקישור המינוי

קריאה לפעולה בנושא קישור מינויים

השפה של הקריאה לפעולה לקישור המינוי נקבעת לפי ההגדרות של המשתמש. אי אפשר לשנות אותו באופן גלובלי.

השפה נקבעת באופן הבא:

  1. אם המשתמש מחובר באמצעות חשבון Google, המערכת משתמשת בשפה הראשית שמוגדרת בהגדרות של חשבון Google שלו (https://myaccount.google.com/language).

  2. אם המשתמש לא מחובר, השפה מבוססת על הגדרת השפה הראשית של הדפדפן או של מערכת ההפעלה שלו.

קריאות לפעולה לקישור מינויים לא נתמכות בכל השפות. אם השפה הראשית של המשתמש לא נתמכת, ייתכן שהקריאה לפעולה תוצג באנגלית כברירת מחדל.

##