קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות וטיפים למניעתן ולטיפול בהן.
רשימה מלאה של השגיאות מופיעה בחומר העזר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס אל הפורום שלנו.
google.auth.exceptions.RefreshError
invalid_grant
סיכום
תוקף הטוקן פג או שהוא בוטל.
גורמים נפוצים
לפרויקט ב-Google Cloud Platform עם מסך הסכמה של OAuth שהוגדר עבור סוג משתמש חיצוני וסטטוס פרסום Testing, הונפק טוקן רענון שתוקפו יפוג בעוד 7 ימים.
איך מטפלים בבעיה
סטטוס הפרסום של הפרויקט ב-Google הוא Testing, ולכן התוקף של אסימון הרענון פג כל 7 ימים והוא מקבל שגיאה מסוג invalid_grant. נכנסים למסוף Google API ועוברים למסך ההסכמה ל-OAuth. לאחר מכן, כדי למנוע את תפוגת התוקף של אסימון הרענון בעוד 7 ימים, צריך לשנות את סטטוס הפרסום ל-In production לפי ההוראות הבאות.
אחרי שיוצרים מודעה, אי אפשר לשנות אותה. אם רוצים לשנות את המודעה, צריך ליצור מודעה חדשה ואז להסיר את המודעה הישנה. עם זאת, אפשר לשנות את השדה status של המודעה באמצעות MutateAdGroupAds.
INVALID_INPUT
סיכום
אחד מהשדות במודעה מכיל תווים לא חוקיים.
גורמים נפוצים
שימוש בתווים מיוחדים בכתובות URL.
איך מטפלים בבעיה
לא רלוונטי
טיפים למניעה
מאמתים את כתובות ה-URL באפליקציה לפני שליחת הבקשה ל-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
סיכום
אסור להשתמש באסימון הפיתוח אלא בחשבונות בדיקה בלבד, ונעשתה ניסיון גישה לחשבון שאינו חשבון בדיקה.
גורמים נפוצים
נעשה שימוש באסימון פיתוח לבדיקה כדי לגשת לחשבון שאינו חשבון בדיקה.
איך מטפלים בבעיה
מוודאים שאתם רוצים לגשת לחשבון שאינו חשבון לבדיקה. אם כן, תצטרכו לשלוח בקשה לשדרוג אסימון המפתח לגישה ברמה Standard או Basic.
טיפים למניעה
לא רלוונטי
DEVELOPER_TOKEN_PROHIBITED
סיכום
אסור להשתמש בקוד המפתח של המפתח עם הפרויקט שנשלח בבקשה.
גורמים נפוצים
אפשר לשייך את קוד המפתח של כל פרויקט ב-Google API Console רק לחשבון ניהול אחד. אחרי ששולחים בקשה ל-Google Ads API, קוד המפתח משויך באופן סופי לפרויקט ב-Google API Console. אם לא משתמשים בפרויקט חדש ב-Google API Console, תופיע הודעת השגיאה 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-12-02 (שעון UTC)."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
