שגיאות נפוצות
בדף הזה מפורטות שגיאות נפוצות וטיפים למניעתן ולטיפול בהן.
רשימה מלאה של השגיאות מופיעה בחומר העזר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס אל הפורום שלנו.
google.auth.exceptions.RefreshError
|
invalid_grant |
סיכום | תוקף הטוקן פג או שהוא בוטל. |
גורמים נפוצים |
לפרויקט ב-Google Cloud Platform עם מסך הסכמה של OAuth שהוגדר עבור סוג משתמש חיצוני וסטטוס פרסום Testing , הונפק טוקן רענון שתוקפו יפוג בעוד 7 ימים.
|
איך מטפלים בבעיה |
סטטוס הפרסום של הפרויקט ב-Google הוא Testing , ולכן התוקף של אסימון הרענון פג כל 7 ימים והוא מקבל שגיאה מסוג invalid_grant . נכנסים למסוף Google API ועוברים למסך ההסכמה ל-OAuth. לאחר מכן, כדי למנוע את תפוגת התוקף של אסימון הרענון בעוד 7 ימים, צריך לשנות את סטטוס הפרסום ל-In production לפי ההוראות הבאות.
|
טיפים למניעה |
אפליקציות לא מאומתות
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
סיכום | לא ניתן להשתמש באופרטור הזה עם קבוצת משנה של Ad. |
גורמים נפוצים |
ניסיון לשנות מאפיינים שאינם status של המודעה.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
אחרי שיוצרים מודעה, אי אפשר לשנות אותה. אם רוצים לשנות את המודעה, צריך ליצור מודעה חדשה ואז להסיר את המודעה הישנה. עם זאת, אפשר לשנות את השדה status של המודעה באמצעות MutateAdGroupAds.
|
|
INVALID_INPUT |
סיכום | אחד מהשדות במודעה מכיל תווים לא חוקיים. |
גורמים נפוצים |
שימוש בתווים מיוחדים בכתובות URL.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מאמתים את כתובות ה-URL באפליקציה לפני שליחת הבקשה ל-API.
|
|
LINE_TOO_WIDE |
סיכום | אחד מהשדות במודעה היה ארוך מהאורך המקסימלי המותר. מידע על מודעות טקסט |
גורמים נפוצים |
שורת טקסט ארוכה מדי.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מוודאים את אורך השורה לפני שליחת בקשת ה-API.
|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
סיכום | התווית הזו כבר משויכת לחלק מהמודעות. |
גורמים נפוצים |
ניסיתם לשייך את התווית למודעות שכבר שויכו.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
קודם בודקים אם התווית שרוצים להוסיף כבר משויכת למודעות.
|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
סיכום | בוצע ניסיון לעדכן מודעה שהוסרה. |
גורמים נפוצים |
אחרי שמסירים מודעה, אי אפשר לעדכן אותה יותר – כולל שינויים בסטטוס שלה.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מוודאים שהקוד לא מנסה לעדכן מודעות שהוסרו.
|
|
|
INVALID_KEYWORD_TEXT |
סיכום | הטקסט של מילת המפתח מכיל תווים לא חוקיים. הוספת מילות מפתח |
גורמים נפוצים |
הטקסט של מילת המפתח מכיל תווים לא חוקיים.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
לפני שליחת בקשה ל-API, צריך לאמת את טקסט מילת המפתח באפליקציה.
|
|
|
DUPLICATE_ADGROUP_NAME |
סיכום | מוסיפים קבוצת מודעות או משנים את השם שלה, אבל השם הזה כבר נמצא בשימוש בקבוצת מודעות אחרת. |
גורמים נפוצים |
יצירת קבוצת מודעות חדשה בשם של קבוצת מודעות קיימת, פעילת או מושהית.
|
איך מטפלים בבעיה |
מתעדים את השגיאה ומציגים הודעת שגיאה למשתמש, עם אפשרות להציע שם ייחודי לקבוצת המודעות או להציג את רשימת השמות שבשימוש.
|
טיפים למניעה |
לא רלוונטי
|
|
|
DUPLICATE_ASSET |
סיכום | שתי פעולות בבקשה אחת מכילות פעולת יצירה של נכס עם אותם נתונים בינאריים. |
גורמים נפוצים |
בקשת שינוי עם פעולות יצירה כפולות שמכילות את אותם נתונים בינאריים.
|
איך מטפלים בבעיה |
יוצרים את הנכס בבקשה נפרדת, ולאחר מכן מקשרים אליו בבקשה הבאה. לחלופין, משתמשים במזהה זמני באותה בקשה.
|
טיפים למניעה |
לא רלוונטי
|
|
|
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.
|
|
|
CUSTOMER_NOT_ENABLED |
סיכום | לא ניתן לגשת לחשבון הלקוח כי הוא לא במצב מופעל. |
גורמים נפוצים |
המצב הזה מתרחש אם תהליך ההרשמה לחשבון הלקוח לא הושלם או אם החשבון הושבת.
|
איך מטפלים בבעיה |
נכנסים לממשק המשתמש של Google Ads ומוודאים שהשלמתם את תהליך ההרשמה לחשבון הזה. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך מפעילים מחדש חשבונות שהושבתו.
|
טיפים למניעה |
כדי לבדוק באופן יזום אם חשבון לקוח מושבת, אפשר לחפש סטטוס מבוטל.
|
|
DEVELOPER_TOKEN_NOT_APPROVED |
סיכום | אסור להשתמש באסימון הפיתוח אלא בחשבונות בדיקה בלבד, ונעשתה ניסיון גישה לחשבון שאינו חשבון בדיקה. |
גורמים נפוצים |
נעשה שימוש באסימון פיתוח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
|
איך מטפלים בבעיה |
מוודאים שאתם רוצים לגשת לחשבון שאינו חשבון לבדיקה. אם כן, תצטרכו לשלוח בקשה לשדרוג אסימון המפתח לגישה ברמה Standard או Basic.
|
טיפים למניעה |
לא רלוונטי
|
|
DEVELOPER_TOKEN_PROHIBITED |
סיכום | אסור להשתמש בקוד המפתח של המפתח עם הפרויקט שנשלח בבקשה. |
גורמים נפוצים |
אפשר לשייך את קוד המפתח של כל פרויקט ב-Google API Console רק לחשבון ניהול אחד. אחרי ששולחים בקשה ל-Google Ads API, קוד המפתח משויך באופן סופי לפרויקט ב-Google API Console. אם לא משתמשים בפרויקט חדש ב-Google API Console, תופיע הודעת השגיאה DEVELOPER_TOKEN_PROHIBITED כששולחים בקשה.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
אם עוברים לקוד מפתח בחשבון ניהול חדש, צריך ליצור פרויקט חדש במסוף Google API לבקשות ל-Google Ads API שמשתמשות בקוד של החשבון החדש.
|
|
USER_PERMISSION_DENIED |
סיכום | ללקוח המורשה אין גישה ללקוח המפעיל. |
גורמים נפוצים |
אימות כמשתמש עם גישה לחשבון ניהול, בלי לציין את login-customer-id בבקשה.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מציינים את login-customer-id כמספר חשבון הניהול ללא מקפים (- ). בספריות הלקוח יש תמיכה מובנית בכך.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
סיכום | ערך הצעת המחיר הוא לא כפולה מדויקת של היחידה המינימלית של המטבע בחשבון. לדוגמה, הצעת מחיר של 0.015$ (15000 מיקרו-ש"ח) היא לא הצעת מחיר חוקית. |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מוודאים שהצעות המחיר הן מכפילים של היחידה המינימלית במטבע של החשבון.
|
|
BID_TOO_BIG |
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
סיכום | סכום התקציב נמוך מדי. |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מוודאים שסכום התקציב גדול או שווה ליחידה המינימלית במטבע של החשבון.
|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
סיכום | סכום התקציב יכלול יותר מדי ספרות עשרוניות משמעותיות במהלך ההמרה מסכום מיקרו לסכום במטבע של החשבון. |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
מוודאים שסכום התקציב ניתן לחלוקה ביחידת המינימום של המטבע של החשבון.
|
|
|
DUPLICATE_CAMPAIGN_NAME |
סיכום | מוסיפים קמפיין או משנים את שמו, אבל קמפיין אחר כבר משתמש בשם הזה. |
גורמים נפוצים |
יצירת קמפיין חדש עם השם של קמפיין קיים פעיל או מושהה.
|
איך מטפלים בבעיה |
מתעדים את השגיאה ומציגים למשתמש הודעת שגיאה, עם אפשרות להציע שם ייחודי לקמפיין או להציג את רשימת השמות שבשימוש.
|
טיפים למניעה |
לא רלוונטי
|
|
|
KEYWORD_HAS_INVALID_CHARS |
סיכום | הוספה או עריכה של מילות מפתח שמכילות תווים לא חוקיים. |
גורמים נפוצים |
להשתמש בתווים מיוחדים כמו ! @ % * במילות המפתח.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
חשוב לוודא שלא משתמשים בתווים אסורים במילות המפתח. הוספת מילות מפתח
|
|
|
DUPLICATE_ELEMENT |
סיכום | הבקשה מכילה שני פרמטרים זהים ומיותרים. |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
לפני שליחת הבקשה, צריך להסיר כפילויות (פעולות, פרמטרים, רכיבי רשימה). מחפשים שדות עם האילוץ DistinctElements .
|
|
|
DEADLINE_EXCEEDED |
סיכום | הזמן הקצוב לטיפול בבקשה פג ולא ניתן היה להשלים אותה במהירות מספקת כדי להחזיר תשובה. |
גורמים נפוצים |
נשלחה בקשת חיפוש שהתקבלה אליה תגובה גדולה מדי, או שבקשת שינוי הייתה גדולה מדי לעיבוד.
|
איך מטפלים בבעיה |
ממתינים כ-30 שניות ואז מנסים לשלוח שוב את הבקשה. אם השגיאה ממשיכה להופיע, נסו לפצל את הבקשה לכמה בקשות קטנות יותר שאפשר להשלים במהירות רבה יותר.
|
טיפים למניעה |
כדאי לעיין במאמר בנושא פילוח כדי להבין איך הוא יכול להשפיע על גודל התגובה. חשוב לדעת מהן המגבלות של שכבת התעבורה של gRPC.
|
|
INTERNAL_ERROR |
סיכום | קרה משהו לא צפוי במהלך עיבוד הבקשה. |
גורמים נפוצים |
ה-API לא פועל כראוי בגלל באג.
|
איך מטפלים בבעיה |
מנסים שוב את כל הבקשות שנכשלו עם השגיאה הזו, באמצעות לוח זמנים של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) לניסיונות החוזרים.
|
טיפים למניעה |
לא רלוונטי
|
|
TRANSIENT_ERROR |
סיכום | אירעה שגיאה פנימית זמנית, וצריך לנסות שוב. |
גורמים נפוצים |
השגיאה הזו מתרחשת כשה-API נתקל בבעיה זמנית באופן פנימי.
|
איך מטפלים בבעיה |
מנסים שוב את כל הבקשות שנכשלו עם השגיאה הזו, באמצעות לוח זמנים של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) לניסיונות החוזרים.
|
טיפים למניעה |
לא רלוונטי
|
|
InvalidGrantError
|
invalid_grant (malformed auth code) |
סיכום | קוד ההרשאה שהוחלף באסימוני OAuth היה בפורמט שגוי. |
גורמים נפוצים |
המצב הזה מתרחש כשמנסים ליצור אסימון רענון למשתמש שכבר קיבל גישה לאפליקציה המבקשת. לדוגמה, זה יכול לקרות כשמריצים את הדוגמה ליצירת פרטי כניסה של משתמש יותר מפעם אחת עבור אותם פרטי כניסה של לקוח OAuth והמשתמש המבצע הרשאה.
|
איך מטפלים בבעיה |
כדי ליצור מחדש אסימון רענון לשילוב נתונים נתון של משתמש המאשר ופרטי כניסה של לקוח OAuth, צריך לבטל אסימון רענון קיים. חשוב לזכור: ביטול של אסימון גורם לכך שלא ניתן יהיה להשתמש בו כדי לגשת ל-Google Ads API, וגורם לביטול של כל אסימוני הגישה שנוצרו באמצעות אסימון הרענון.
|
טיפים למניעה |
חשוב לשמור את אסימון הרענון במיקום מאובטח כדי להימנע מהצורך ליצור אותו מחדש.
|
|
|
RESOURCE_NOT_FOUND |
סיכום | הבקשה התייחסה למשאב שלא נמצא. |
גורמים נפוצים |
הבקשה ניסתה לבצע מוטציה למשאב שלא קיים או להפנות אליו בדרך אחרת, או שהמשאב הוסר. לחלופין, שם המשאב שצוין לא תקין.
|
איך מטפלים בבעיה |
לפני שליחת בקשת שינוי, אפשר להשתמש בבקשת חיפוש כדי לאחזר את שם המשאב של משאב קיים. כדאי לעיין במדריכים שלנו בנושא ספריית הלקוח, שכוללים מסמכי תיעוד בנושא בניית שמות תקינים של משאבים בכל שפה נתמכת.
|
טיפים למניעה |
אין ליצור שמות של משאבים באופן ידני. להשתמש באחת משיטות העזרה שמוצעות בספריות הלקוח שלנו.
|
|
|
EMPTY_LIST |
סיכום | רשימה חובה ריקה. |
גורמים נפוצים |
העברה של רשימת פעולות ריקה לשיטה mutate .
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
לא רלוונטי
|
|
|
RESOURCE_EXHAUSTED |
סיכום | חרגתם ממגבלת התדירות של המערכת. |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
אפשר להגדיר עיכובים קצרים בין בקשות או לשלב יותר פעולות בפחות בקשות.
|
|
|
TOO_LOW |
סיכום | ערך היה נמוך מהערך המינימלי המותר. |
גורמים נפוצים |
שכחה לציין מזהה, וכתוצאה מכך מועבר ערך של 0 .
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
חשוב לשים לב למגבלות הטווח שמפורטות במסמך העזרה של ה-API.
|
|
|
INVALID_INPUT |
סיכום | הבקשה לא תקינה. |
גורמים נפוצים |
כתובת ה-URL או התוכן של הבקשה בפורמט שגוי.
|
איך מטפלים בבעיה |
לא רלוונטי
|
טיפים למניעה |
לא רלוונטי
|
|
REQUIRED_FIELD_MISSING |
סיכום | בבקשה חסר מידע נדרש. |
גורמים נפוצים |
חסרים שדות חובה כשמנסים להוסיף ישות.
|
איך מטפלים בבעיה |
מתעדים את השגיאה ומציגים הודעת שגיאה למשתמש. המאפיין fieldPath של השגיאה מציין איזה שדה חסר.
|
טיפים למניעה |
כדי לבדוק אילו שדות חובה, אפשר לעיין במסמך העזרה של ה-API.
|
|
|
RESOURCE_LIMIT |
סיכום | הבקשה מנסה ליצור משאב שיגרום למספר הכולל של המשאבים האלה לחרוג ממגבלה מסוימת. |
גורמים נפוצים |
יש כמה מגבלות על מספר המשאבים שיכולים להתקיים בהקשרים מסוימים.
|
איך מטפלים בבעיה |
כדי לזהות את המגבלה שנתקלת בה, אפשר לעיין במגבלות המערכת. אפשר לעשות שימוש חוזר במשאב קיים או להסיר משאבים כדי לפנות מקום למשאבים חדשים.
|
טיפים למניעה |
אתם יכולים להשתמש בשאילתות חיפוש כדי לעקוב אחרי מספר המשאבים שיש להם מגבלות.
|
|
|
TOO_LONG |
סיכום | המחרוזת שהוקצה לשדה שצוין ארוכה מהמגבלה. |
גורמים נפוצים |
הכותרות או התיאורים של המודעות מכילים יותר מדי טקסט.
|
איך מטפלים בבעיה |
מזהים את המגבלה שנתקלת בה, משנים את המחרוזת בהתאם ושולחים מחדש את הבקשה.
|
טיפים למניעה |
חשוב לשים לב למגבלות האורך של מחרוזות.
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-12-02 (שעון UTC).
[null,null,["עדכון אחרון: 2024-12-02 (שעון UTC)."],[[["This document provides solutions to common errors encountered when using the Google Ads API, focusing on issues related to authentication, authorization, and various Google Ads components."],["Many errors stem from invalid inputs, missing information, or exceeding limits, requiring careful validation of requests and adherence to API guidelines."],["Authentication and authorization errors often involve incorrect credentials, token expiration, or insufficient permissions, necessitating project setup adjustments and access verification."],["Several errors can be mitigated by ensuring unique names, validating inputs, and respecting resource limits, preventing duplication and exceeding system constraints."],["Server-side and transient errors might require retries with exponential backoff, while quota issues necessitate request throttling or combining operations to reduce frequency."]]],[]]