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

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

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

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