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

במדריך הזה מפורטות שגיאות נפוצות ב-API ומוסבר איך למנוע אותן ולטפל בהן.

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

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
סיכוםלאסימון הגישה מסוג OAuth 2.0 אין את ההיקפים הנדרשים.
גורמים נפוצים הבקשה נדחית כי אסימון הגישה שסופק לא כולל את היקף ההרשאות של Google Ads API OAuth 2.0.
איך מטפלים בבעיה מוודאים שלטוקן הגישה יש את היקפי ההרשאות הנדרשים. סיבה נפוצה לשגיאה הזו היא שימוש חוזר באסימון גישה קיים שנוצר באמצעות קבוצה אחרת של היקפי OAuth. במאמר פרמטרים של הרשאת OAuth מוסבר איך ליצור אסימון גישה חדש עם ההיקפים הנדרשים.
טיפים למניעה מוודאים שלאסימון הגישה יש את היקפי ההרשאות הנדרשים. כדי לקבל גישה עם היקפי ההרשאות הנדרשים, צריך לאמת מחדש את המשתמש עם היקפי ההרשאות הנדרשים. אם האפליקציה שלכם משתמשת בכמה היקפי הרשאות של OAuth, יכול להיות שתצטרכו להטמיע הרשאות OAuth פרטניות.

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

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
סיכוםלפרויקט ב-Google Cloud יש גישה לבדיקה בלבד, ואי אפשר להשתמש בו כדי לגשת לחשבונות בסביבת הייצור.
גורמים נפוצים פרויקט ב-Google Cloud עם רמת גישה לבדיקה שימש לשליחת בקשה לחשבון Google Ads שאינו לבדיקה (ייצור). (בגרסאות API‏ v24 ומטה, התנאי הזה מחזיר AuthorizationError.ACTION_NOT_PERMITTED).
איך לטפל אם אתם מבצעים בדיקה, ודאו שהבקשה מיועדת לחשבון בדיקה. אם אתם רוצים לגשת לחשבון Google Ads פעיל, אתם צריכים לבדוק את רמת הגישה של פרויקט בענן ב-Google Cloud בדף הסקירה הכללית של Google Ads API ולשדרג את רמת הגישה של הפרויקט לגישת Explorer, לגישת Basic או להרשאת גישה רגילה.
טיפים למניעה לא רלוונטי
CUSTOMER_NOT_ENABLED
סיכוםאי אפשר לגשת לחשבון הלקוח כי הוא לא במצב פעיל.
גורמים נפוצים המצב הזה קורה אם הלקוח לא סיים את ההרשמה לחשבון או שהחשבון שלו הושבת.
איך מטפלים בבעיה נכנסים לממשק המשתמש של Google Ads ומוודאים שתהליך ההרשמה לחשבון הזה הושלם. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו.
טיפים למניעה כדי לבדוק באופן יזום אם חשבון של לקוח הושבת, אפשר לבדוק אם הסטטוס שלו הוא CANCELLED.
USER_PERMISSION_DENIED
סיכוםללקוח המורשה אין גישה ללקוח המפעיל.
גורמים נפוצים אימות כמשתמש עם גישה לחשבון ניהול, אבל לא מציינים את login-customer-id בבקשה.
איך מטפלים בבעיה לא רלוונטי
טיפים למניעה מציינים את login-customer-id כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בפעולה הזו.

הקודם
טיפול בשגיאות
הבא
השלבים הבאים