קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות שגיאות נפוצות ומופיעים טיפים למניעה ולטיפול בהן.
רשימה מלאה של השגיאות זמינה במאמר בנושא שגיאות. לקבלת תמיכה נוספת, אפשר להיכנס לפורום שלנו.
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 לפי ההוראות האלה.
המספר 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.
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 וקודי הרשאה. מידע נוסף על כותרות הבקשות השונות
המצב הזה קורה אם הלקוח לא סיים את ההרשמה לחשבון או שהחשבון שלו הושבת.
איך לטפל
צריך להיכנס לממשק המשתמש של Google Ads ולוודא שהשלמתם את תהליך ההרשמה לחשבון הזה. במאמר הפעלה מחדש של חשבון Google Ads שבוטל מוסבר איך להפעיל מחדש חשבונות שהושבתו.
טיפים למניעה
כדי לבדוק אם חשבון לקוח הושבת, אפשר לחפש את הסטטוס מבוטל.
DEVELOPER_TOKEN_NOT_APPROVED
סיכום
קוד המפתח אושר לשימוש רק בחשבונות בדיקה, והייתה ניסיון גישה לחשבון שלא מוגדר כחשבון בדיקה.
גורמים נפוצים
נעשה שימוש בקוד מפתח לבדיקה כדי לגשת לחשבון שלא מוגדר כחשבון בדיקה.
אין הרשאה להשתמש בקוד המפתח עם הפרויקט שנשלח בבקשה.
גורמים נפוצים
כל פרויקט ב-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 כמספר חשבון הניהול ללא מקפים (-). יש תמיכה מובנית בזה בספריות הלקוח.
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2025-09-05 (שעון UTC)."],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
