בדף הזה מפורטות שגיאות נפוצות וטיפים למניעתן ולטיפול בהן.
רשימה מלאה של השגיאות מופיעה בהפניות לשגיאות. לקבלת תמיכה נוספת, אתם יכולים להיכנס לפורום שלנו.
google.auth.exceptions.RefreshError
|
invalid_grant |
סיכום | האסימון כבר לא בתוקף או בוטל. |
גורמים נפוצים |
לפרויקט ב-Google Cloud Platform עם מסך הסכמה מסוג OAuth שהוגדר לסוג משתמש חיצוני וסטטוס הפרסום Testing , יופק אסימון רענון שתוקפו יפוג בעוד 7 ימים.
|
איך מטפלים |
סטטוס הפרסום של פרויקט Google שלך הוא Testing , כך שתוקף אסימון הרענון פג כל 7 ימים ומקבל את השגיאה invalid_grant . עוברים אל Google API Console ועוברים למסך ההסכמה של OAuth. לאחר מכן, יש לשנות את סטטוס הפרסום ל-In production בהתאם להוראות הבאות, כדי שתוקף אסימון הרענון יפוג תוך 7 ימים.
|
טיפים למניעה |
ראו אפליקציות לא מאומתות.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
סיכום | לא ניתן להשתמש באופרטור הזה עם מחלקת משנה של מודעה. |
גורמים נפוצים |
מנסה לשנות מאפיינים שאינם 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.
|
|
|
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 בתור מספר חשבון הניהול ללא מקפים (- ). ספריות לקוח תומכות בכך.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
סיכום | ערך הצעת המחיר אינו מכפלה מדויקת של היחידה המינימלית של המטבע בחשבון. לדוגמה, הצעת מחיר לא חוקית בסך 0.015 דולר ארה"ב (15000 במיליוניות) |
גורמים נפוצים |
לא רלוונטי
|
איך מטפלים |
לא רלוונטי
|
טיפים למניעה |
ודא שהצעות המחיר הן כפולות של היחידה המינימלית עבור המטבע שמוגדר בחשבון.
|
|
BID_TOO_BIG |
|
|
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 לא פועל בצורה תקינה עקב באג.
|
איך מטפלים |
נסה שוב בקשות שנכשלו עם השגיאה הזו, באמצעות לוח זמנים של השהיה מעריכית לפני ניסיון חוזר.
|
טיפים למניעה |
לא רלוונטי
|
|
TRANSIENT_ERROR |
סיכום | אירעה שגיאה פנימית זמנית, וצריך לבצע ניסיון חוזר. |
גורמים נפוצים |
השגיאה הזו מתרחשת כשה-API נתקל בבעיה זמנית.
|
איך מטפלים |
נסה שוב בקשות שנכשלו עם השגיאה הזו, באמצעות לוח זמנים של השהיה מעריכית לפני ניסיון חוזר.
|
טיפים למניעה |
לא רלוונטי
|
|
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 |
סיכום | המחרוזת שמוקצית לשדה שצוין חורגת מהמגבלה. |
גורמים נפוצים |
כותרות או תיאורים של מודעות מכילים יותר מדי טקסט.
|
איך מטפלים |
צריך לזהות את המגבלה שבה המערכת נתקלה, לשנות את המחרוזת בהתאם ולשלוח מחדש את הבקשה.
|
טיפים למניעה |
שימו לב למגבלות של אורך מחרוזת.
|
|