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

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

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

הקודם
ביצוע קריאה ל-API
הבא
השלבים הבאים