שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן.
רשימה מלאה של השגיאות זמינה במאמר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
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. לאחר מכן, כדי למנוע את פקיעת התוקף של אסימון הרענון תוך 7 ימים, משנים את סטטוס הפרסום ל-In production לפי ההוראות האלה.
|
|---|
| טיפים למניעה |
מידע נוסף מופיע במאמר בנושא אפליקציות לא מאומתות.
|
|---|
|
|
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 היה שגוי.
|
|---|
| איך לטפל |
לא רלוונטי
|
|---|
| טיפים למניעה |
מוודאים שהעברתם את אסימון הגישה הנכון שמשויך לחשבון שלכם. לפעמים יש בלבול בינו לבין אסימוני רענון וקודי הרשאה. אם רוצים לקבל אמצעי אימות שיכול לגשת לכל חשבונות הלקוח שמשויכים לחשבון ניהול, צריך לוודא שמקבלים את אסימון הרענון של חשבון הניהול. פרטים נוספים זמינים במדריך שלנו בנושא אסימון גישה ואסימון רענון ובנושא OAuth2.
|
|---|
|
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 שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו.
|
|---|
| טיפים למניעה |
כדי לבדוק אם חשבון לקוח הושבת, אפשר לחפש את הסטטוס מבוטל.
|
|---|
|
DEVELOPER_TOKEN_NOT_APPROVED |
| סיכום | קוד המפתח אושר לשימוש רק בחשבונות בדיקה, והייתה ניסיון גישה לחשבון שלא מוגדר כחשבון בדיקה. |
|---|
| גורמים נפוצים |
נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שלא מוגדר כחשבון בדיקה.
|
|---|
| איך לטפל |
מוודאים שאתם רוצים לגשת לחשבון שאינו חשבון בדיקה. במקרה כזה, צריך לשלוח בקשה לשדרוג של אסימון המפתח לגישה רגילה או בסיסית.
|
|---|
| טיפים למניעה |
לא רלוונטי
|
|---|
|
DEVELOPER_TOKEN_PROHIBITED |
| סיכום | אין הרשאה להשתמש בקוד המפתח עם הפרויקט שנשלח בבקשה. |
|---|
| גורמים נפוצים |
כל פרויקט ב-Google API Console יכול להיות משויך לקוד מפתח רק מחשבון ניהול אחד. אחרי ששולחים בקשה ל-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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
