Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.
שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדריך הזה מפורטות שגיאות נפוצות ב-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 ימים.
|
|---|
| טיפים למניעה |
מידע נוסף על אפליקציות לא מאומתות
|
|---|
|
|
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 לא היה נכון.
|
|---|
| איך לטפל |
לא רלוונטי
|
|---|
| טיפים למניעה |
חשוב לוודא שהעברתם את טוקן הגישה הנכון שמשויך לחשבון שלכם. לפעמים יש בלבול בינו לבין טוקני רענון וקודי הרשאה. אם אתם רוצים לקבל אמצעי אימות שמאפשר גישה לכל חשבונות הלקוח שמשויכים לחשבון ניהול, אתם צריכים לוודא שאתם מקבלים את טוקן הרענון של חשבון הניהול. אפשר לעיין במדריך לאימות משתמשים.
|
|---|
|
|
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 כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בפעולה הזו.
|
|---|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-10-14 (שעון UTC).
[null,null,["עדכון אחרון: 2026-10-14 (שעון UTC)."],[],[]]
