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

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

google.auth.exceptions.RefreshError

invalid_grant

סיכום תוקף הטוקן פג או שהוא בוטל. גורמים נפוצים לפרויקט ב-Google Cloud Platform עם מסך הסכמה של OAuth שהוגדר עבור סוג משתמש חיצוני וסטטוס פרסום Testing, הונפק טוקן רענון שתוקפו יפוג בעוד 7 ימים. איך מטפלים בבעיה סטטוס הפרסום של הפרויקט ב-Google הוא Testing, ולכן התוקף של אסימון הרענון פג כל 7 ימים והוא מקבל שגיאה מסוג invalid_grant. נכנסים למסוף Google API ועוברים למסך ההסכמה ל-OAuth. לאחר מכן, כדי למנוע את תפוגת התוקף של אסימון הרענון בעוד 7 ימים, צריך לשנות את סטטוס הפרסום ל-In production לפי ההוראות הבאות. טיפים למניעה אפליקציות לא מאומתות

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

AuthorizationError
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 כמספר חשבון הניהול ללא מקפים (-). בספריות הלקוח יש תמיכה מובנית בכך.

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

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