פתרון בעיות

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

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

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

סמל הטעינה

איור 1. ה-CTA לקישור מינויים לא נטען.

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

  • חשוב להוסיף את המקורות של הדפים, כולל תת-דומיינים לבדיקה, ככתובות URL נוספות בהגדרות אתר החדשות ב-Publisher Center.
    • מוודאים שהסטטוס של כתובת ה-URL הוא 'מאומת' ולא 'אימות'.
  • ביישומים של Extended Access או 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
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (or it may not exist)."

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

  • חשוב לוודא שאתם משתמשים באותו פרויקט שצוין בהגדרת קישור המינויים. כשמגדירים קישור מינויים ב-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

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

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

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

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

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

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

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

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

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

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

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

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

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

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