שגיאות נפוצות

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

google.auth.exceptions.RefreshError

invalid_grant
סיכוםתוקף הטוקן פג או שהוא בוטל.
גורמים נפוצים לפרויקט ב-Google Cloud Platform עם מסך הסכמה של OAuth שהוגדר עבור סוג משתמש חיצוני וסטטוס פרסום Testing, הונפק טוקן רענון שתוקפו יפוג בעוד 7 ימים.
איך מטפלים בבעיה סטטוס הפרסום של הפרויקט ב-Google הוא Testing, ולכן התוקף של אסימון הרענון פג כל 7 ימים והוא מקבל שגיאה מסוג invalid_grant. נכנסים למסוף Google API ועוברים למסך ההסכמה ל-OAuth. לאחר מכן, כדי למנוע את תפוגת התוקף של אסימון הרענון בעוד 7 ימים, צריך לשנות את סטטוס הפרסום ל-In production לפי ההוראות הבאות.
טיפים למניעה אפליקציות לא מאומתות

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
סיכוםמספר הלקוח של הלקוח הוא לא מספר.
גורמים נפוצים שימוש במזהה לקוח לא תקין.
איך מטפלים בבעיה לא רלוונטי
טיפים למניעה 123-456-7890 צריך להיות 1234567890. פרטים נוספים זמינים במאמר תחילת העבודה.
CLIENT_CUSTOMER_ID_IS_REQUIRED
סיכוםמספר הלקוח של הלקוח לא צוין בכותרת ה-HTTP.
גורמים נפוצים לא צוין מספר לקוח של לקוח בכותרת ה-HTTP.
איך מטפלים בבעיה לא רלוונטי
טיפים למניעה מזהה הלקוח נדרש בכל הקריאות, לכן חשוב לציין אותו בכותרת ה-HTTP. מומלץ להשתמש בספריות הלקוח שלנו, כי הן מטפלות בזה בשבילכם.
CUSTOMER_NOT_FOUND
סיכוםלא נמצא חשבון למזהה הלקוח שצוין בכותרת.
גורמים נפוצים ניסיון לגשת לחשבון שנוצר זה עתה לפני שהחשבון הוקם בקצה העורפי.
איך מטפלים בבעיה מחכים חמש דקות ראשוניות, ואז מנסים שוב כל 30 שניות.
טיפים למניעה אחרי יצירת החשבון, צריך להמתין כמה דקות לפני שליחת בקשות נגדו.
סיכוםטוקן הגישה בכותרת הבקשה לא תקין או שתוקפו פג.
גורמים נפוצים טוקן הגישה לא תקף.
איך מטפלים בבעיה מבקשים טוקן חדש. אם אתם משתמשים באחת מספריות הלקוח שלנו, כדאי לעיין במסמכי התיעוד שלה כדי לרענן את האסימון.
טיפים למניעה אחסון אסימוני גישה ושימוש חוזר בהם עד שתוקפם יפוג.
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.

AuthorizationError

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 כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בכך.