שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן.
רשימה מלאה של השגיאות זמינה במאמרי העזרה בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
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 ימים.
|
|---|
| טיפים למניעה |
מידע נוסף על אפליקציות לא מאומתות
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| סיכום | מזהה הלקוח לא מספר. |
|---|
| גורמים נפוצים |
השתמשתם במספר לקוח לא תקין.
|
|---|
| איך מטפלים |
לא רלוונטי
|
|---|
| טיפים למניעה |
הפורמט 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 כמו הפרויקט בענן ב-Google Cloud ששימש ליצירת הבקשות המקוריות.
|
|---|
| איך מטפלים |
אם כבר שלחתם בקשות API עם קוד המפתח, ודאו שמזהה הלקוח של OAuth משויך לפרויקטים ב-Google Cloud באותו ארגון ב-Google Cloud.
|
|---|
| טיפים למניעה |
חשוב לוודא שכל הפרויקטים ב-Google Cloud משויכים לאותו ארגון ב-Google Cloud. פרויקט ב-Google Cloud יכול להיות משויך רק לקוד מפתח אחד, אבל קוד מפתח יכול להיות משויך לכמה פרויקטים בארגון.
|
|---|
|
DEVELOPER_TOKEN_INVALID |
| סיכום | קוד המפתח לא תקין. |
|---|
| גורמים נפוצים |
סיבות נפוצות לשגיאה הזו כוללות שגיאות הקלדה בקוד המפתח או הגדרה שגויה של קוד המפתח בכותרת בקשה אחרת.
|
|---|
| איך מטפלים |
כדי להימנע משגיאות הקלדה, חשוב להעתיק את קוד המפתח ממרכז ה-API. המרכז ל-API נמצא בחשבון הניהול ב-Google Ads. בנוסף, חשוב לוודא שאתם מגדירים את קוד המפתח בכותרת הנכונה. לפעמים יש בלבול בין קוד מפתח לבין טוקנים של רענון של OAuth וקודי הרשאה. מידע נוסף על כותרות הבקשות השונות
|
|---|
| טיפים למניעה |
לא רלוונטי
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| סיכום | אי אפשר לגשת לחשבון הלקוח כי הוא לא במצב מופעל. |
|---|
| גורמים נפוצים |
המצב הזה קורה אם הלקוח לא סיים את ההרשמה לחשבון או שהחשבון שלו הושבת.
|
|---|
| איך מטפלים |
צריך להיכנס לממשק המשתמש של 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 כששולחים בקשה.
|
|---|
| איך מטפלים |
לא רלוונטי
|
|---|
| טיפים למניעה |
אם עוברים לשימוש בקוד מפתח בחשבון ניהול חדש, צריך ליצור פרויקט חדש ב-Google API Console בשביל בקשות ל-Google Ads API שמשתמשות בקוד המפתח של חשבון הניהול החדש.
|
|---|
|
USER_PERMISSION_DENIED |
| סיכום | ללקוח המורשה אין גישה ללקוח הפעיל. |
|---|
| גורמים נפוצים |
אימות כמשתמש עם גישה לחשבון ניהול, אבל לא מציינים את login-customer-id בבקשה.
|
|---|
| איך מטפלים |
לא רלוונטי
|
|---|
| טיפים למניעה |
מציינים את login-customer-id כמספר חשבון הניהול ללא מקפים (-). יש תמיכה מובנית בזה בספריות הלקוח.
|
|---|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-04-22 (שעון UTC).
[null,null,["עדכון אחרון: 2026-04-22 (שעון UTC)."],[],[]]
