שגיאות נפוצות

בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן. רשימה מלאה של שגיאות מופיעה בהפניית השגיאות, במדריך להבנת שגיאות ב-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. עוברים אל מסך ההסכמה ל-OAuth ב-Google API Console. לאחר מכן, משנים את סטטוס הפרסום לIn production כדי למנוע את פקיעת התוקף של אסימון הרענון תוך 7 ימים. טיפים למניעה מידע נוסף מופיע במאמר בנושא אפליקציות לא מאומתות.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	סיכום אי אפשר להשתמש באופרטור הזה עם מחלקת משנה של Ad. גורמים נפוצים ניסיון לשנות מאפיינים אחרים של המודעה מלבד status. איך מטפלים בבעיה לא רלוונטי טיפים למניעה אחרי שיוצרים מודעה, אי אפשר לשנות אותה. כדי לשנות את המודעה, צריך ליצור מודעה חדשה ואז להסיר את המודעה הישנה. עם זאת, אפשר לשנות את status של המודעה באמצעות MutateAdGroupAds.
INVALID_INPUT	סיכום אחד מהשדות במודעה מכיל תווים לא חוקיים. גורמים נפוצים שימוש בתווים מיוחדים בכתובות URL. איך מטפלים בבעיה לא רלוונטי טיפים למניעה כדאי לאמת את כתובות ה-URL באפליקציה לפני ששולחים את בקשת ה-API.
LINE_TOO_WIDE	סיכום אחד מהשדות במודעה היה ארוך יותר מהאורך המקסימלי המותר. מידע נוסף על מודעות טקסט גורמים נפוצים שורה ארוכה מדי של טקסט. איך מטפלים בבעיה לא רלוונטי טיפים למניעה לפני ששולחים את בקשת ה-API, צריך לוודא שאורך השורה תקין.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	סיכום התווית הזו כבר משויכת לחלק מהמודעות. גורמים נפוצים ניסית לשייך את התווית למודעות שכבר שויכו. איך מטפלים בבעיה לא רלוונטי טיפים למניעה קודם בודקים אם התווית שרוצים להוסיף כבר משויכת למודעות.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	סיכום פעולה ניסתה לעדכן מודעה שהוסרה. גורמים נפוצים אחרי שמסירים מודעה, אי אפשר לעדכן אותה יותר – כולל שינויים בסטטוס שלה. איך מטפלים בבעיה לא רלוונטי טיפים למניעה מוודאים שהקוד לא מנסה לעדכן מודעות שהוסרו.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	סיכום הטקסט של מילת המפתח מכיל תווים לא חוקיים. כך מוסיפים מילות מפתח גורמים נפוצים הטקסט של מילת המפתח מכיל תווים לא חוקיים. איך מטפלים בבעיה לא רלוונטי טיפים למניעה לפני ששולחים בקשה ל-API, צריך לאמת את הטקסט של מילת המפתח באפליקציה.

AdGroupError
DUPLICATE_ADGROUP_NAME	סיכום מנסים להוסיף קבוצת מודעות או לשנות את השם שלה, אבל השם כבר נמצא בשימוש בקבוצת מודעות אחרת. גורמים נפוצים יצירת קבוצת מודעות חדשה עם השם של קבוצת מודעות קיימת שפעילה או מושהית. איך מטפלים בבעיה לרשום את השגיאה ביומן ולהציג הודעת שגיאה למשתמש, ואפשר גם להציע שם ייחודי לקבוצת המודעות או להציג את רשימת השמות שנמצאים בשימוש. טיפים למניעה לא רלוונטי

AssetError
DUPLICATE_ASSET	סיכום שתי פעולות בבקשה אחת מכילות פעולת יצירה של נכס עם אותם נתונים בינאריים. גורמים נפוצים בקשה לשינוי נתונים עם פעולות יצירה כפולות שמכילות את אותם נתונים בינאריים. איך מטפלים בבעיה יוצרים את הנכס בבקשה נפרדת, ואז מקשרים אליו בבקשה הבאה, או משתמשים במזהה זמני באותה בקשה. טיפים למניעה לא רלוונטי

AuthenticationError
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 לא היה תקין. איך מטפלים בבעיה לא רלוונטי טיפים למניעה מוודאים שהעברתם את אסימון הגישה הנכון שמשויך לחשבון שלכם. לפעמים יש בלבול בינו לבין אסימוני רענון וקודי הרשאה. אם אתם רוצים לקבל אמצעי אימות שמאפשר גישה לכל חשבונות הלקוח שמשויכים לחשבון ניהול, אתם צריכים לוודא שאתם מקבלים את טוקן הרענון של חשבון הניהול. אפשר לעיין במדריך לאימות משתמשים.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	סיכום לפרויקט בענן ב-Google Cloud יש גישה לבדיקה בלבד, ואי אפשר להשתמש בו כדי לגשת לחשבונות פעילים. גורמים נפוצים נעשה שימוש בפרויקט בענן של Google עם רמת גישה לבדיקה כדי לשלוח בקשה לחשבון Google Ads שאינו חשבון בדיקה (חשבון הפקה). (בגרסאות API‏ v24 ומטה, התנאי הזה מחזיר AuthorizationError.ACTION_NOT_PERMITTED). איך מטפלים בבעיה אם אתם מבצעים בדיקה, ודאו שהבקשה מיועדת לחשבון בדיקה. אם אתם רוצים לגשת לחשבון Google Ads פעיל, אתם צריכים לבדוק את רמת הגישה של פרויקט Google Cloud בדף הסקירה הכללית של Google Ads API ולשדרג את רמת הגישה של הפרויקט לגישת Explorer, לגישה בסיסית או להרשאת גישה רגילה. טיפים למניעה לא רלוונטי
CUSTOMER_NOT_ENABLED	סיכום אין אפשרות לגשת לחשבון הלקוח כי הוא לא במצב מופעל. גורמים נפוצים המצב הזה קורה אם הלקוח לא סיים את ההרשמה לחשבון או שהחשבון שלו הושבת. איך מטפלים בבעיה צריך להיכנס לממשק המשתמש של Google Ads ולוודא שהשלמתם את תהליך ההרשמה לחשבון הזה. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו. טיפים למניעה כדי לבדוק אם חשבון לקוח הושבת, אפשר לבדוק אם הסטטוס שלו הוא מבוטל.
USER_PERMISSION_DENIED	סיכום ללקוח המורשה אין גישה ללקוח הפעיל. גורמים נפוצים אימות כמשתמש עם גישה לחשבון ניהול, אבל לא מציינים את login-customer-id בבקשה. איך מטפלים בבעיה לא רלוונטי טיפים למניעה מציינים את login-customer-id כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בפעולה הזו.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	סיכום ערך הצעת המחיר הוא לא מכפלה מדויקת של יחידת הסכום המינימלית במטבע של החשבון. לדוגמה, הצעת מחיר של 0.015 דולר ארה"ב (15000 במיקרו) היא לא תקינה. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה מוודאים שהצעות המחיר הן מכפלות של יחידת הסכום המינימלית במטבע של החשבון.
BID_TOO_BIG	סיכום השגיאה מוחזרת גם אם הצעת המחיר נמצאת במסגרת תקציב הקמפיין. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה בודקים אם החשבון משתתף בתוכנית המענקים של Google לעמותות. אם כן, צריך להגביל את הצעות המחיר לקליק למקסימום שנקבע בתוכנית.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	סיכום סכום התקציב קטן מדי. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה מוודאים שסכום התקציב גדול או שווה ליחידה המינימלית במטבע של החשבון.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	סיכום כשממירים סכום מיקרו לסכום במטבע של החשבון, יכול להיות שיהיו יותר מדי ספרות משמעותיות אחרי הנקודה העשרונית בסכום התקציב. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה מוודאים שסכום התקציב מתחלק ביחידה המינימלית של המטבע בחשבון.

CampaignError
DUPLICATE_CAMPAIGN_NAME	סיכום קמפיין נוסף או משנה את השם שלו, אבל השם כבר נמצא בשימוש בקמפיין אחר. גורמים נפוצים יצירת קמפיין חדש עם השם של קמפיין פעיל או מושהה קיים. איך מטפלים בבעיה מתעדים את השגיאה ומציגים למשתמש הודעת שגיאה, ואפשר גם להציע שם קמפיין ייחודי או להציג את רשימת השמות שבשימוש. טיפים למניעה לא רלוונטי
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	סיכום ניסיון לשנות את ההגדרה של סוג ההתאמה למילות מפתח ברמת הקמפיין בקמפיין שמופעל בו AI למיקסום ביצועים. גורמים נפוצים כשמפעילים את AI למיקסום ביצועים, ההגדרות של התאמה רחבה ברמת הקמפיין יוצאות משימוש כי כברירת מחדל כל מילות המפתח מטופלות כהתאמה רחבה. ניסיון להגדיר או לשנות את השדה הזה יגרום להפעלת השגיאה. איך מטפלים בבעיה מומלץ להשתמש בפרמטר `disable_search_term_matching` ברמת קבוצת המודעות במקום בהתאמה רחבה ברמת הקמפיין. טיפים למניעה אם הערך של `ai_max_setting.enable_ai_max` הוא `true`, אל תגדירו את `keyword_match_type` כ-`BROAD` (או כערך אחר) בקמפיין. כדי להפעיל או להשבית את ההתאמה למונחי חיפוש ברמת קבוצת המודעות, משתמשים ב-`disable_search_term_matching`.

CriterionError
KEYWORD_HAS_INVALID_CHARS	סיכום הוספה או עריכה של מילות מפתח שמכילות תווים לא חוקיים. גורמים נפוצים להשתמש בתווים מיוחדים כמו ! @ % * במילות המפתח. איך מטפלים בבעיה לא רלוונטי טיפים למניעה חשוב לוודא שלא משתמשים בתווים אסורים במילות המפתח. כך מוסיפים מילות מפתח

DistinctError
DUPLICATE_ELEMENT	סיכום הבקשה מכילה שני פרמטרים זהים ומיותרים. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה לפני ששולחים את הבקשה, צריך להסיר כפילויות (פעולות, פרמטרים, רכיבי רשימה). מחפשים שדות עם האילוץ DistinctElements.

InternalError
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, ומבטל את כל טוקני הגישה שנוצרו באמצעות טוקן הרענון. טיפים למניעה כדי להימנע מהצורך ליצור מחדש את טוקן הרענון, חשוב לשמור אותו במיקום מאובטח.

MutateError

RESOURCE_NOT_FOUND

סיכום הבקשה התייחסה למשאב שלא נמצא. גורמים נפוצים הבקשה ניסתה לשנות משאב או להפנות אליו בדרך אחרת, אבל המשאב לא קיים או שהוא הוסר. או ששם המשאב שצוין עבור המשאב הוא לא תקין. איך מטפלים בבעיה כדאי להשתמש בבקשת חיפוש כדי לאחזר את שם המשאב של משאב קיים לפני ששולחים בקשה לשינוי נתונים. כדאי לעיין במדריכים שלנו בנושא ספריית לקוחות, שכוללים תיעוד בנושא יצירת שמות משאבים תקינים בכל שפה נתמכת טיפים למניעה אל תיצרו שמות משאבים באופן ידני. אפשר להשתמש באחת משיטות העזר שמוצעות בספריות הלקוח שלנו.

NotEmptyError
EMPTY_LIST	סיכום רשימת חובה ריקה. גורמים נפוצים העברה של רשימת פעולות ריקה לשיטה mutate. איך מטפלים בבעיה לא רלוונטי טיפים למניעה לא רלוונטי

QuotaError
RESOURCE_EXHAUSTED	סיכום הייתה חריגה ממגבלת התדירות של המערכת. גורמים נפוצים לא רלוונטי איך מטפלים בבעיה לא רלוונטי טיפים למניעה כדאי להגדיר השהיות קצרות בין הבקשות או לשלב יותר פעולות בפחות בקשות.

RangeError
TOO_LOW	סיכום הערך היה נמוך מהערך המינימלי המותר. גורמים נפוצים שוכחים לציין מזהה, וכתוצאה מכך מועבר ערך של 0. איך מטפלים בבעיה לא רלוונטי טיפים למניעה חשוב לשים לב למגבלות הטווח שמתועדות במאמרי העזרה של ה-API.

RequestError
INVALID_INPUT	סיכום הבקשה לא תקינה. גורמים נפוצים כתובת ה-URL או התוכן של הבקשה הם בפורמט שגוי. איך מטפלים בבעיה לא רלוונטי טיפים למניעה לא רלוונטי
REQUIRED_FIELD_MISSING	סיכום בבקשה חסר מידע נדרש. גורמים נפוצים חסרים שדות חובה כשמנסים להוסיף ישות. איך מטפלים בבעיה לרשום את השגיאה ביומן ולהציג הודעת שגיאה למשתמש. המאפיין fieldPath של השגיאה מציין איזה שדה חסר. טיפים למניעה כדי לדעת אילו שדות הם שדות חובה, אפשר לעיין במאמרי העזרה של ה-API.

ResourceCountLimitExceededError
RESOURCE_LIMIT	סיכום הבקשה מנסה ליצור משאב שיגרום למספר הכולל של המשאבים האלה לחרוג ממגבלה שצוינה. גורמים נפוצים יש כמה הגבלות על מספר המשאבים שיכולים להתקיים בהקשרים מסוימים. איך מטפלים בבעיה כדי לזהות את המגבלה שאליה הגעתם, אפשר לעיין במגבלות המערכת. אפשר להשתמש מחדש במשאב קיים או להסיר משאבים כדי לפנות מקום למשאבים חדשים. טיפים למניעה אפשר להשתמש בשאילתות חיפוש כדי לעקוב אחרי מספר המשאבים שיש להם מגבלות.

StringLengthError
TOO_LONG	סיכום המחרוזת שהוקצתה לשדה שצוין ארוכה יותר מהמגבלה. גורמים נפוצים הכותרות או התיאורים של המודעות מכילים יותר מדי טקסט. איך מטפלים בבעיה צריך לזהות את המגבלה שנתקלים בה, לשנות את המחרוזת בהתאם ולשלוח מחדש את הבקשה. טיפים למניעה שימו לב למגבלות על אורך המחרוזת.