שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן.
רשימה מלאה של השגיאות זמינה במאמרי העזרה בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
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 ימים.
הפורמט 123-456-7890 צריך להיות 1234567890. פרטים נוספים מופיעים במאמר בנושא תחילת העבודה.
CLIENT_CUSTOMER_ID_IS_REQUIRED
סיכום
לא צוין מספר לקוח בכותרת ה-HTTP.
גורמים נפוצים
לא מציינים מספר לקוח בכותרת ה-HTTP.
איך לטפל
לא רלוונטי
טיפים למניעה
חובה לציין מזהה לקוח בכל הקריאות, לכן חשוב לוודא שציינתם מזהה לקוח בכותרת ה-HTTP. מומלץ להשתמש בספריות הלקוח שלנו, כי הן מטפלות בזה בשבילכם.
CUSTOMER_NOT_FOUND
סיכום
לא נמצא חשבון עם מספר הלקוח שצוין בכותרת.
גורמים נפוצים
ניסיון לגשת לחשבון שנוצר ממש עכשיו לפני שהחשבון נוצר בשרת העורפי.
איך לטפל
מחכים חמש דקות ואז מנסים שוב כל 30 שניות.
טיפים למניעה
אחרי שיוצרים את החשבון, צריך לחכות כמה דקות לפני ששולחים בקשות לגביו.
GOOGLE_ACCOUNT_COOKIE_INVALID
סיכום
אסימון הגישה בכותרת הבקשה לא תקין או שתוקפו פג.
גורמים נפוצים
טוקן הגישה בוטל.
איך לטפל
מבקשים טוקן חדש. אם אתם משתמשים באחת מספריות הלקוח שלנו, תוכלו לעיין במסמכי התיעוד שלה כדי להבין איך לרענן את האסימון.
טיפים למניעה
אחסון אסימוני גישה ושימוש חוזר בהם עד שהתוקף שלהם יפוג.
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 לא היה נכון.
איך לטפל
לא רלוונטי
טיפים למניעה
חשוב לוודא שהעברתם את אסימון הגישה הנכון שמשויך לחשבון שלכם. לפעמים יש בלבול בינו לבין אסימוני רענון וקודי הרשאה. אם אתם רוצים לקבל אמצעי אימות שיאפשר לכם לגשת לכל חשבונות הלקוח שמשויכים לחשבון ניהול, אתם צריכים לוודא שאתם מקבלים את טוקן הרענון של חשבון הניהול. אפשר לעיין במדריך לאימות משתמשים.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
סיכום
קוד המפתח כבר משויך לארגון ב-Google Cloud, ואי אפשר לשייך אותו לארגון אחר.
גורמים נפוצים
הטוקן למפתחים לא משויך לפרויקט בענן באותו ארגון ב-Google Cloud כמו הפרויקט ב-Google Cloud ששימש ליצירת הבקשות המקוריות.
איך לטפל
אם כבר שלחתם בקשות API עם קוד המפתח, ודאו שמזהה לקוח OAuth משויך לפרויקטים ב-Google Cloud באותו ארגון ב-Google Cloud.
טיפים למניעה
חשוב לוודא שכל הפרויקטים שלכם ב-Google Cloud משויכים לאותו ארגון ב-Google Cloud. אפשר לשייך פרויקט ב-Google Cloud רק לקוד מפתח אחד, אבל אפשר לשייך קוד מפתח לכמה פרויקטים בארגון.
DEVELOPER_TOKEN_INVALID
סיכום
קוד המפתח לא תקין.
גורמים נפוצים
סיבות נפוצות לשגיאה הזו כוללות שגיאות הקלדה בקוד המפתח או הגדרה שגויה של קוד המפתח בכותרת בקשה אחרת.
איך לטפל
כדי להימנע משגיאות הקלדה, חשוב להעתיק את קוד המפתח ממרכז ה-API. המרכז ל-API נמצא בחשבון הניהול ב-Google Ads. בנוסף, חשוב לוודא שאתם מגדירים את קוד המפתח בכותרת הנכונה. לפעמים יש בלבול בין קוד מפתח לבין טוקנים של רענון של OAuth וקודי הרשאה. מידע נוסף על כותרות הבקשות השונות
המצב הזה קורה אם הלקוח לא סיים את ההרשמה לחשבון או שהחשבון שלו הושבת.
איך לטפל
צריך להיכנס לממשק המשתמש של Google Ads ולוודא שהשלמתם את תהליך ההרשמה לחשבון הזה. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו.
טיפים למניעה
כדי לבדוק אם חשבון לקוח הושבת, אפשר לחפש את הסטטוס CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
סיכום
קוד המפתח אושר לשימוש רק בחשבונות בדיקה, והייתה ניסיון גישה לחשבון שלא מוגדר כחשבון בדיקה.
גורמים נפוצים
נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שלא מוגדר כחשבון בדיקה.
איך לטפל
חשוב לוודא שאתם רוצים לגשת לחשבון שאינו חשבון בדיקה. במקרה כזה, צריך לשלוח בקשה לשדרוג קוד המפתח לגישה רגילה או בסיסית.
טיפים למניעה
לא רלוונטי
DEVELOPER_TOKEN_PROHIBITED
סיכום
אין הרשאה להשתמש בקוד המפתח עם הפרויקט שנשלח בבקשה.
גורמים נפוצים
כל פרויקט ב-Google API Console יכול להיות משויך לקוד מפתח רק מחשבון ניהול אחד. אחרי ששולחים בקשת API ל-Google Ads API, קוד המפתח משויך באופן קבוע לפרויקט ב-Google API Console. אם לא משתמשים בפרויקט חדש ב-Google API Console, מקבלים שגיאה DEVELOPER_TOKEN_PROHIBITED כששולחים בקשה.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2026-06-30 (שעון UTC)."],[],[]]
