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

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

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

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

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

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

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

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

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