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

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

google.auth.exceptions.RefreshError

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

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 שבוטל.
טיפים למניעה כדי לבדוק באופן יזום אם חשבון של לקוח מושבת, אפשר לבדוק את הסטטוס CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
סיכוםקוד המפתח מאושר לשימוש רק בחשבונות בדיקה ומתבצע ניסיון לגשת לחשבון שאינו חשבון בדיקה.
גורמים נפוצים נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
איך מטפלים ודאו שאתם אכן רוצים לגשת לחשבון שאינו חשבון בדיקה. אם כן, עליכם להגיש בקשה לשדרוג קוד המפתח שלכם לגישה רגילה או בסיסית.
טיפים למניעה לא רלוונטי
DEVELOPER_TOKEN_PROHIBITED
סיכוםלא ניתן להשתמש בקוד המפתח יחד עם הפרויקט שצוין בבקשה.
גורמים נפוצים ניתן לשייך כל פרויקט במסוף Google API לקוד המפתח מחשבון ניהול אחד בלבד. אחרי ששולחים בקשה ל-Google Ads API, קוד המפתח מותאם באופן קבוע לפרויקט במסוף Google API. אם לא ייעשה שימוש בפרויקט חדש במסוף Google API, תתקבל הודעת השגיאה DEVELOPER_TOKEN_PROHIBITED בזמן שליחת הבקשה.
איך מטפלים לא רלוונטי
טיפים למניעה אם תעברו לקוד מפתח בחשבון ניהול חדש, תצטרכו ליצור פרויקט חדש במסוף Google API עבור בקשות של Google Ads API שמשתמשות בקוד הניהול החדש.
USER_PERMISSION_DENIED
סיכוםללקוח המורשה אין גישה ללקוח התפעול.
גורמים נפוצים אימות כמשתמש עם גישה לחשבון ניהול בלי לציין login-customer-id בבקשה.
איך מטפלים לא רלוונטי
טיפים למניעה צריך לציין את login-customer-id בתור מספר חשבון הניהול ללא מקפים (-). ספריות לקוח תומכות בכך.