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

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

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