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

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

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