קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות וטיפים למניעתן ולטיפול בהן.
רשימה מלאה של השגיאות מופיעה במאמרי העזרה לשגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
google.auth.exceptions.RefreshError
invalid_grant
סיכום
האסימון כבר לא בתוקף או שהוא בוטל.
גורמים נפוצים
לפרויקט ב-Google Cloud Platform עם מסך הסכמה ל-OAuth שהוגדר לסוג משתמש חיצוני וסטטוס הפרסום של Testing, יועבר אסימון רענון למשך 7 ימים.
איך לטפל
סטטוס הפרסום של הפרויקט ב-Google הוא Testing, כך שתוקף אסימון הרענון יפוג כל 7 ימים ויתקבל השגיאה invalid_grant. עוברים אל Google API Console ועוברים למסך ההסכמה של OAuth. לאחר מכן צריך לשנות את סטטוס הפרסום ל-In production בהתאם להוראות האלה כדי שתוקף אסימון הרענון יפוג בעוד 7 ימים.
לא ניתן להשתמש באופרטור הזה עם מחלקה משנית של מודעה.
גורמים נפוצים
ניסיון לשנות מאפיינים שאינם status של המודעה.
איך לטפל
לא רלוונטי
טיפים למניעה
לאחר יצירת מודעה, לא ניתן לשנות אותה. כדי לשנות את המודעה, צריך ליצור מודעה חדשה ולהסיר את המודעה הישנה. עם זאת, ניתן לשנות את השדה status של המודעה באמצעות MutateAdGroupAds.
INVALID_INPUT
סיכום
אחד מהשדות במודעה מכיל תווים לא חוקיים.
גורמים נפוצים
שימוש בתווים מיוחדים בכתובות URL.
איך לטפל
לא רלוונטי
טיפים למניעה
לאמת את כתובות ה-URL באפליקציה לפני שליחת בקשת ה-API.
LINE_TOO_WIDE
סיכום
אחד מהשדות במודעה היה ארוך מהאורך המקסימלי המותר. מידע נוסף זמין במאמר מידע על מודעות טקסט.
גורמים נפוצים
שורת הטקסט ארוכה מדי.
איך לטפל
לא רלוונטי
טיפים למניעה
צריך לבדוק את אורך השורה לפני ששולחים את בקשת ה-API.
המספר 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.
מצב כזה קורה אם ההרשמה של חשבון הלקוח לא הסתיימה או אם החשבון הושבת.
איך לטפל
צריך להיכנס לממשק המשתמש של Google Ads ולוודא שהשלמת את תהליך ההרשמה לחשבון הזה. מידע לגבי חשבונות מושבתים זמין במאמר הפעלה מחדש של חשבון Google Ads שבוטל.
טיפים למניעה
כדי לבדוק באופן יזום אם חשבון לקוח מושבת, אפשר לבדוק את הסטטוס בוטל.
DEVELOPER_TOKEN_NOT_APPROVED
סיכום
קוד המפתח מאושר לשימוש רק בחשבונות בדיקה, ולאחר ניסיון לגשת לחשבון שאינו חשבון בדיקה.
גורמים נפוצים
נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
איך לטפל
מוודאים שאתם אכן רוצים לגשת לחשבון שאינו חשבון בדיקה. במקרה כזה, צריך להגיש בקשה לשדרוג של קוד המפתח לגישה רגילה או בסיסית.
טיפים למניעה
לא רלוונטי
DEVELOPER_TOKEN_PROHIBITED
סיכום
לא ניתן להשתמש בקוד המפתח יחד עם הפרויקט שנשלח בבקשה.
גורמים נפוצים
ניתן לשייך כל פרויקט במסוף Google API לקוד המפתח מחשבון ניהול אחד בלבד. לאחר ששולחים בקשה ל-Google Ads API, קוד המפתח מותאם באופן קבוע לפרויקט במסוף Google API. אם לא משתמשים בפרויקט חדש במסוף Google API, תוצג השגיאה DEVELOPER_TOKEN_PROHIBITED כששולחים בקשה.
ניסיון חוזר של כל בקשה שנכשלו עם השגיאה הזו, תוך שימוש בלוח זמנים של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) עבור הניסיונות החוזרים.
טיפים למניעה
לא רלוונטי
TRANSIENT_ERROR
סיכום
אירעה שגיאה פנימית זמנית, ויש לבצע ניסיון חוזר.
גורמים נפוצים
השגיאה הזו מתרחשת כאשר ה-API נתקל בבעיה זמנית באופן פנימי.
איך לטפל
ניסיון חוזר של כל בקשה שנכשלו עם השגיאה הזו, תוך שימוש בלוח זמנים של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) עבור הניסיונות החוזרים.
טיפים למניעה
לא רלוונטי
InvalidGrantError
invalid_grant (malformed auth code)
סיכום
קוד ההרשאה שהוחלף באסימוני OAuth שגוי.
גורמים נפוצים
הפעולה הזאת מתרחשת כשמנסים ליצור אסימון רענון עבור משתמש שכבר קיבל גישה לאפליקציה המבקשת. למשל, מצב כזה יכול לקרות כשמריצים את הדוגמה ליצירת פרטי כניסה של משתמש יותר מפעם אחת עבור אותו פרטי כניסה של לקוח OAuth ומתן הרשאה למשתמש.
איך לטפל
כדי ליצור מחדש אסימון רענון עבור שילוב נתון של הרשאת פרטי כניסה של משתמש ולקוח OAuth, צריך לבטל אסימון רענון קיים. לתשומת ליבכם, ביטול של אסימון גורם לכך שלא ניתן יהיה להשתמש בו לגישה ל-Google Ads API, וכל אסימוני הגישה ששימשו ליצירה של אסימון הרענון מתבטלים.
טיפים למניעה
חשוב לאחסן את אסימון הרענון במיקום מאובטח כדי שלא יהיה צורך בהפקה מחדש.
הבקשה ניסתה לבצע שינויים או להפנות באופן אחר למשאב שלא קיים או שהוסר. לחלופין, הפורמט של שם המשאב חסר.
איך לטפל
לפני ששולחים בקשת שינוי, אפשר להשתמש בבקשת חיפוש כדי לאחזר את שם המשאב של משאב קיים. לעיין במדריכים שלנו בנושא ספריית לקוח, שכוללים תיעוד ליצירת שמות חוקיים של משאבים בכל שפה נתמכת
טיפים למניעה
אין ליצור שמות משאבים באופן ידני. להשתמש באחת מהשיטות המסייעות שספריות הלקוח שלנו מציעות.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-06-26 (שעון UTC)."],[],[]]