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

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

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	סיכום טוקן הגישה ב-request header לא תקין או שהתוקף שלו פג. גורמים נפוצים טוקן הגישה לא תקף. איך מטפלים בבעיה מבקשים טוקן חדש. אם אתם משתמשים באחת מספריות הלקוח שלנו, עיינו במסמכי התיעוד שלה כדי לדעת איך לרענן את האסימון. טיפים למניעה אחסון אסימוני גישה ושימוש חוזר בהם עד שהתוקף שלהם יפוג.
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 Cloud עם רמת גישה לבדיקה שימש לשליחת בקשה לחשבון Google Ads שאינו לבדיקה (ייצור). (בגרסאות API‏ v24 ומטה, התנאי הזה מחזיר AuthorizationError.ACTION_NOT_PERMITTED). איך לטפל אם אתם מבצעים בדיקה, ודאו שהבקשה מיועדת לחשבון בדיקה. אם אתם רוצים לגשת לחשבון Google Ads פעיל, בדקו את רמת הגישה של הפרויקט ב-Google Cloud בדף הסקירה הכללית של Google Ads API ושדרגו את רמת הגישה של הפרויקט לגישת Explorer, גישה בסיסית או גישה רגילה. טיפים למניעה לא רלוונטי
CUSTOMER_NOT_ENABLED	סיכום אי אפשר לגשת לחשבון הלקוח כי הוא לא במצב פעיל. גורמים נפוצים זה קורה כשחשבון הלקוח לא סיים את ההרשמה או הושבת. איך לטפל נכנסים לממשק המשתמש של Google Ads ומוודאים שתהליך ההרשמה לחשבון הזה הושלם. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו. טיפים למניעה כדי לבדוק באופן יזום אם חשבון של לקוח הושבת, אפשר לבדוק אם הסטטוס שלו הוא CANCELLED.
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	סיכום המחרוזת שהוקצתה לשדה שצוין ארוכה יותר מהמגבלה. גורמים נפוצים הכותרות או התיאורים של המודעות מכילים יותר מדי טקסט. איך מטפלים בבעיה מזהים את המגבלה שבה נתקלתם, משנים את המחרוזת בהתאם ושולחים מחדש את הבקשה. טיפים למניעה שימו לב למגבלות על אורך המחרוזת.