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

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

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

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