בדף הזה מפורטות שגיאות נפוצות וטיפים למניעתן ולטיפול בהן.
רשימה מלאה של השגיאות מופיעה בחומר העזר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס אל הפורום שלנו.
google.auth.exceptions.RefreshError
|
invalid_grant |
| סיכום | תוקף הטוקן פג או שהוא בוטל. |
|---|
| גורמים נפוצים |
לפרויקט ב-Google Cloud Platform עם מסך הסכמה של OAuth שהוגדר עבור סוג משתמש חיצוני וסטטוס פרסום Testing, הונפק טוקן רענון שתוקפו יפוג בעוד 7 ימים.
|
|---|
| איך מטפלים בבעיה |
סטטוס הפרסום של הפרויקט ב-Google הוא Testing, ולכן התוקף של אסימון הרענון פג כל 7 ימים והוא מקבל שגיאה מסוג invalid_grant. נכנסים למסוף Google API ועוברים למסך ההסכמה ל-OAuth. לאחר מכן, כדי למנוע את תפוגת התוקף של אסימון הרענון בעוד 7 ימים, צריך לשנות את סטטוס הפרסום ל-In production לפי ההוראות הבאות.
|
|---|
| טיפים למניעה |
אפליקציות לא מאומתות
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| סיכום | מספר הלקוח של הלקוח הוא לא מספר. |
|---|
| גורמים נפוצים |
שימוש במזהה לקוח לא תקין.
|
|---|
| איך מטפלים בבעיה |
לא רלוונטי
|
|---|
| טיפים למניעה |
123-456-7890 צריך להיות 1234567890. פרטים נוספים זמינים במאמר תחילת העבודה.
|
|---|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
| סיכום | מספר הלקוח של הלקוח לא צוין בכותרת ה-HTTP. |
|---|
| גורמים נפוצים |
לא צוין מספר לקוח של לקוח בכותרת ה-HTTP.
|
|---|
| איך מטפלים בבעיה |
לא רלוונטי
|
|---|
| טיפים למניעה |
מזהה הלקוח נדרש בכל הקריאות, לכן חשוב לציין אותו בכותרת ה-HTTP. מומלץ להשתמש בספריות הלקוח שלנו, כי הן מטפלות בזה בשבילכם.
|
|---|
|
CUSTOMER_NOT_FOUND |
| סיכום | לא נמצא חשבון למזהה הלקוח שצוין בכותרת. |
|---|
| גורמים נפוצים |
ניסיון לגשת לחשבון שנוצר זה עתה לפני שהחשבון הוקם בקצה העורפי.
|
|---|
| איך מטפלים בבעיה |
מחכים חמש דקות ראשוניות, ואז מנסים שוב כל 30 שניות.
|
|---|
| טיפים למניעה |
אחרי יצירת החשבון, צריך להמתין כמה דקות לפני שליחת בקשות נגדו.
|
|---|
|
GOOGLE_ACCOUNT_COOKIE_INVALID |
| סיכום | טוקן הגישה בכותרת הבקשה לא תקין או שתוקפו פג. |
|---|
| גורמים נפוצים |
טוקן הגישה לא תקף.
|
|---|
| איך מטפלים בבעיה |
מבקשים טוקן חדש. אם אתם משתמשים באחת מספריות הלקוח שלנו, כדאי לעיין במסמכי התיעוד שלה כדי לרענן את האסימון.
|
|---|
| טיפים למניעה |
אחסון אסימוני גישה ושימוש חוזר בהם עד שתוקפם יפוג.
|
|---|
|
NOT_ADS_USER |
| סיכום | חשבון Google ששימש ליצירת אסימון הגישה לא משויך לאף חשבון Google Ads. |
|---|
| גורמים נפוצים |
פרטי ההתחברות שציינת תואמים לחשבון Google שלא מופעל בו Google Ads.
|
|---|
| איך מטפלים בבעיה |
חשוב להיכנס לחשבון Google Ads תקין (בדרך כלל חשבון הניהול) בתהליך ה-OAuth. אפשר גם להזמין את חשבון Google לגשת לחשבון Google Ads קיים. לשם כך, נכנסים לחשבון הניהול, בוחרים את חשבון הלקוח או חשבון הניהול הרלוונטי, עוברים אל Tools and Settings > Access and security ומוסיפים את כתובת האימייל של חשבון Google.
|
|---|
| טיפים למניעה |
לא רלוונטי
|
|---|
|
OAUTH_TOKEN_INVALID |
| סיכום | אסימון הגישה של OAuth בכותרת לא תקין. |
|---|
| גורמים נפוצים |
טוקן הגישה שהוענק עם כותרת ה-HTTP היה שגוי.
|
|---|
| איך מטפלים בבעיה |
לא רלוונטי
|
|---|
| טיפים למניעה |
מוודאים שהעברתם את אסימון הגישה הנכון שמשויך לחשבון שלכם. לפעמים הוא מתבלבל עם אסימוני רענון וקודי הרשאה. אם רוצים לקבל פרטי כניסה עם גישה לכל חשבונות הלקוח שמקושרים לחשבון ניהול, צריך לקבל את אסימון הרענון של חשבון הניהול. פרטים נוספים זמינים במדריך שלנו בנושא אסימון גישה ואסימון רענון ובנושא OAuth2.
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| סיכום | לא ניתן לגשת לחשבון הלקוח כי הוא לא במצב מופעל. |
|---|
| גורמים נפוצים |
המצב הזה מתרחש אם תהליך ההרשמה לחשבון הלקוח לא הושלם או אם החשבון הושבת.
|
|---|
| איך מטפלים בבעיה |
נכנסים לממשק המשתמש של Google Ads ומוודאים שהשלמתם את תהליך ההרשמה לחשבון הזה. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך מפעילים מחדש חשבונות שהושבתו.
|
|---|
| טיפים למניעה |
כדי לבדוק באופן יזום אם חשבון לקוח מושבת, אפשר לחפש סטטוס מבוטל.
|
|---|
|
DEVELOPER_TOKEN_NOT_APPROVED |
| סיכום | אסור להשתמש באסימון הפיתוח אלא בחשבונות בדיקה בלבד, ונעשתה ניסיון גישה לחשבון שאינו חשבון בדיקה. |
|---|
| גורמים נפוצים |
נעשה שימוש באסימון פיתוח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
|
|---|
| איך מטפלים בבעיה |
מוודאים שאתם רוצים לגשת לחשבון שאינו חשבון לבדיקה. אם כן, תצטרכו לשלוח בקשה לשדרוג אסימון המפתח לגישה ברמה Standard או Basic.
|
|---|
| טיפים למניעה |
לא רלוונטי
|
|---|
|
DEVELOPER_TOKEN_PROHIBITED |
| סיכום | אסור להשתמש בקוד המפתח של המפתח עם הפרויקט שנשלח בבקשה. |
|---|
| גורמים נפוצים |
אפשר לשייך את קוד המפתח של כל פרויקט ב-Google API Console רק לחשבון ניהול אחד. אחרי ששולחים בקשה ל-Google Ads API, קוד המפתח משויך באופן סופי לפרויקט ב-Google API Console. אם לא משתמשים בפרויקט חדש ב-Google API Console, תופיע הודעת השגיאה DEVELOPER_TOKEN_PROHIBITED כששולחים בקשה.
|
|---|
| איך מטפלים בבעיה |
לא רלוונטי
|
|---|
| טיפים למניעה |
אם עוברים לקוד מפתח בחשבון ניהול חדש, צריך ליצור פרויקט חדש במסוף Google API לבקשות ל-Google Ads API שמשתמשות בקוד של החשבון החדש.
|
|---|
|
USER_PERMISSION_DENIED |
| סיכום | ללקוח המורשה אין גישה ללקוח המפעיל. |
|---|
| גורמים נפוצים |
אימות כמשתמש עם גישה לחשבון ניהול, בלי לציין את login-customer-id בבקשה.
|
|---|
| איך מטפלים בבעיה |
לא רלוונטי
|
|---|
| טיפים למניעה |
מציינים את login-customer-id כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בכך.
|
|---|
|
