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

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

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
סיכוםאסימון הגישה מסוג OAuth 2.0 לא כולל את היקפי ההרשאות הנדרשים.
גורמים נפוצים הבקשה נדחתה כי אסימון הגישה שסיפקת לא כולל את היקף ההרשאות OAuth 2.0 של Google Ads API.
איך לטפל צריך לוודא שאסימון הגישה כולל את ההיקפים הנדרשים. סיבה נפוצה לשגיאה הזו היא שימוש חוזר באסימון גישה קיים שנוצר באמצעות קבוצה אחרת של היקפי הרשאות 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
סיכוםלא ניתן להשתמש באופרטור הזה עם מחלקה משנית של מודעה.
גורמים נפוצים ניסיון לשנות מאפיינים שאינם 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 שניות.
טיפים למניעה צריך להמתין כמה דקות לאחר יצירת החשבון לפני ששולחים בקשות נגדו.
סיכוםאסימון הגישה בכותרת הבקשה אינו חוקי או שתוקפו פג.
גורמים נפוצים אסימון הגישה לא תקף.
איך לטפל מבקשים אסימון חדש. אם אתם משתמשים באחת מספריות הלקוח שלנו, כדאי לעיין במסמכי התיעוד של האפליקציה כדי ללמוד איך לרענן את האסימון.
טיפים למניעה לאחסן אסימוני גישה ולהשתמש בהם שוב עד שהתוקף שלהם יפוג.
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
סיכוםקוד המפתח מאושר לשימוש רק בחשבונות בדיקה, ולאחר ניסיון לגשת לחשבון שאינו חשבון בדיקה.
גורמים נפוצים נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
איך לטפל מוודאים שאתם אכן רוצים לגשת לחשבון שאינו חשבון בדיקה. במקרה כזה, צריך להגיש בקשה לשדרוג של קוד המפתח לגישה רגילה או בסיסית.
טיפים למניעה לא רלוונטי
DEVELOPER_TOKEN_PROHIBITED
סיכוםלא ניתן להשתמש בקוד המפתח יחד עם הפרויקט שנשלח בבקשה.
גורמים נפוצים ניתן לשייך כל פרויקט במסוף Google API לקוד המפתח מחשבון ניהול אחד בלבד. אחרי ששולחים בקשה ל-Google Ads API, קוד המפתח מותאם באופן קבוע לפרויקט במסוף Google API. אם לא משתמשים בפרויקט חדש במסוף Google API, תוצג השגיאה DEVELOPER_TOKEN_PROHIBITED כששולחים בקשה.
איך לטפל לא רלוונטי
טיפים למניעה אם עוברים אל קוד מפתח דרך חשבון ניהול חדש, צריך ליצור פרויקט חדש ב-Google API Console לבקשות של 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
סיכוםיש רשימת חובה ריקה.
גורמים נפוצים מתבצעת העברה עם רשימת פעולות ריקה ל-method mutate.
איך לטפל לא רלוונטי
טיפים למניעה לא רלוונטי

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

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

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

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

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