שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן.
רשימה מלאה של השגיאות זמינה במאמר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
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 לפי ההוראות האלה.
|
|---|
| טיפים למניעה |
מידע נוסף מופיע במאמר בנושא אפליקציות לא מאומתות.
|
|---|
|
|
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.
|
|---|
|
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 כמספר חשבון הניהול ללא מקפים (-). יש תמיכה מובנית בזה בספריות הלקוח.
|
|---|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
| סיכום | ערך הצעת המחיר לא מהווה כפולה מדויקת של היחידה המינימלית של המטבע בחשבון. לדוגמה, הצעת מחיר של 0.015 דולר ארה"ב (15000 במיקרו) היא לא תקינה. |
|---|
| גורמים נפוצים |
לא רלוונטי
|
|---|
| איך לטפל |
לא רלוונטי
|
|---|
| טיפים למניעה |
מוודאים שהצעות המחיר הן מכפלות של יחידת המינימום במטבע של החשבון.
|
|---|
|
BID_TOO_BIG |
| סיכום | השגיאה מוחזרת גם אם הצעת המחיר נמצאת במסגרת תקציב הקמפיין. |
|---|
| גורמים נפוצים |
לא רלוונטי
|
|---|
| איך לטפל |
לא רלוונטי
|
|---|
| טיפים למניעה |
בודקים אם החשבון משתתף בתוכנית המענקים של Google לעמותות. אם כן, צריך להגביל את הצעות המחיר לקליק למקסימום שנקבע בתוכנית.
|
|---|
|
|
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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 2025-09-05 (שעון UTC)."],[[["\u003cp\u003eThe Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting.\u003c/p\u003e\n"],["\u003cp\u003eCommon causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines.\u003c/p\u003e\n"],["\u003cp\u003eSuggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them.\u003c/p\u003e\n"]]],[],null,[]]
