לאסימון הגישה מסוג 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 ימים.
ניסיון לשנות מאפיינים אחרים מלבד status של המודעה.
איך לטפל
לא רלוונטי
טיפים למניעה
אחרי שיוצרים מודעה, אי אפשר לשנות אותה. כדי לשנות את המודעה, צריך ליצור מודעה חדשה ואז להסיר את המודעה הישנה. עם זאת, אפשר לשנות את ה-status של המודעה באמצעות MutateAdGroupAds.
INVALID_INPUT
סיכום
אחד מהשדות במודעה מכיל תווים לא חוקיים.
גורמים נפוצים
שימוש בתווים מיוחדים בכתובות URL.
איך לטפל
לא רלוונטי
טיפים למניעה
לפני ששולחים את בקשת ה-API, מאמתים את כתובות ה-URL באפליקציה.
שתי פעולות בבקשה אחת מכילות פעולת יצירה של נכס עם אותם נתונים בינאריים.
גורמים נפוצים
בקשה לשינוי נתונים עם פעולות יצירה כפולות שמכילות את אותם נתונים בינאריים.
איך לטפל
יוצרים את הנכס בבקשה נפרדת, ואז מקשרים אליו בבקשה הבאה. לחלופין, משתמשים במזהה זמני באותה בקשה.
טיפים למניעה
לא רלוונטי
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
סיכום
מזהה המבצע של השותף משתמש בווריאציה של oneof (int_value או string_value) שלא נתמכת בשילוב המבצעים של החשבון.
גורמים נפוצים
הגדרת השדה promotion_asset.external_redeem_info.partner_promotion_id.int_value כשהאינטגרציה של מימוש ההטבות של הלקוח דורשת את הווריאנט string_value, או הגדרת השדה string_value כשהאינטגרציה דורשת את הווריאנט int_value.
לפני שיוצרים הודעת PromotionAsset עם השדה external_redeem_info, צריך לבדוק באיזה פורמט של מזהה מבצע (int_value או string_value) משתמשת האינטגרציה של מימוש המבצע בנקודת המכירה (POS).
123-456-7890 צריך להיות 1234567890. פרטים נוספים מופיעים במאמר על תחילת העבודה.
CLIENT_CUSTOMER_ID_IS_REQUIRED
סיכום
מספר הלקוח של לקוח הקצה לא צוין בכותרת ה-HTTP.
גורמים נפוצים
לא ציינתם מספר לקוח של לקוח קצה בכותרת ה-HTTP.
איך לטפל
לא רלוונטי
טיפים למניעה
מספר הלקוח המשלם ולקוח הקצה נדרש בכל הקריאות, לכן חשוב לציין אותו בכותרת ה-HTTP. כדאי להשתמש בספריות הלקוח שלנו, כי הן מטפלות בזה בשבילכם.
CUSTOMER_NOT_FOUND
סיכום
לא נמצא חשבון שמשויך למספר הלקוח שצוין בכותרת.
גורמים נפוצים
ניסיון לגשת לחשבון שנוצר ממש עכשיו, לפני שהחשבון הוגדר ב-backend.
איך לטפל
מחכים חמש דקות, ואז מנסים שוב כל 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 לא היה נכון.
איך לטפל
לא רלוונטי
טיפים למניעה
חשוב לוודא שהעברתם את טוקן הגישה הנכון שמשויך לחשבון שלכם. לפעמים מתבלבלים בין אסימון גישה לבין אסימון רענון וקוד הרשאה. אם אתם רוצים לקבל פרטי כניסה שמאפשרים גישה לכל חשבונות הלקוח שמשויכים לחשבון ניהול, ודאו שאתם מקבלים את טוקן הרענון של חשבון הניהול. למדריך לאימות משתמשים
לפרויקט ב-Google Cloud יש גישה לבדיקה בלבד, ואי אפשר להשתמש בו כדי לגשת לחשבונות בסביבת הייצור.
גורמים נפוצים
פרויקט ב-Google Cloud עם רמת גישה לבדיקה שימש לשליחת בקשה לחשבון Google Ads שאינו לבדיקה (ייצור). (בגרסאות API v24 וגרסאות קודמות, התנאי הזה מחזיר את הערך AuthorizationError.ACTION_NOT_PERMITTED.)
ערך הצעת המחיר הוא לא כפולה מדויקת של היחידה המינימלית של המטבע בחשבון. לדוגמה, הצעת מחיר של 0.015 דולר ארה"ב (15000 במיקרו-יחידות) היא לא הצעת מחיר חוקית.
גורמים נפוצים
לא רלוונטי
איך לטפל
לא רלוונטי
טיפים למניעה
מוודאים שהצעות המחיר הן כפולות של יחידת המינימום של המטבע בחשבון.
BID_TOO_BIG
סיכום
השגיאה מוחזרת גם אם הצעת המחיר היא במסגרת תקציב הקמפיין.
אתם מנסים להוסיף קמפיין או לשנות שם של קמפיין, אבל השם כבר נמצא בשימוש בקמפיין אחר.
גורמים נפוצים
יצירת קמפיין חדש עם שם של קמפיין קיים שפעיל או מושהה.
איך לטפל
מתעדים את השגיאה ומציגים הודעת שגיאה למשתמש. אפשר גם להציע שם ייחודי לקמפיין או להציג את רשימת השמות שכבר נמצאים בשימוש.
טיפים למניעה
לא רלוונטי
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
סיכום
ניסיון לשנות את ההגדרה של סוג ההתאמה למילות מפתח ברמת הקמפיין בקמפיין שמופעלת בו חבילת התכונות "AI למיקסום ביצועים".
גורמים נפוצים
כשמפעילים את "AI למיקסום ביצועים", ההגדרות של התאמה רחבה ברמת הקמפיין יוצאות משימוש כי כברירת מחדל, המערכת מתייחסת לכל מילות המפתח כהתאמה רחבה. ניסיון להגדיר או לשנות את השדה הזה יגרום לשגיאה.
איך לטפל
מומלץ למשתמש להשתמש בפרמטר disable_search_term_matching ברמת קבוצת המודעות במקום להגדיר התאמה רחבה ברמת הקמפיין.
טיפים למניעה
אם הערך של `ai_max_setting.enable_ai_max` הוא `true`, אל תגדירו את `keyword_match_type` כ-`BROAD` (או כל ערך אחר) בקמפיין. אתם יכולים להפעיל או להשבית את ההתאמה למונחי חיפוש ברמת קבוצת המודעות באמצעות `disable_search_term_matching`.
אי אפשר להפעיל קמפיין ליצירת ביקוש שהועבר לפני שמסירים את הקמפיין המקורי, או כשקמפיין אחר שהועבר מאותו קמפיין מקורי כבר פעיל.
גורמים נפוצים
עדכון הstatus של קמפיין ליצירת ביקוש שהועבר לENABLED, כשקמפיין המקור המקורי לא הוסר או כשקמפיין אחר ליצירת ביקוש שהועבר מאותו קמפיין מקורי כבר נמצא בסטטוס ENABLED. בגרסאות API v25 וגרסאות קודמות, התנאי הזה מחזיר את הערך RequestError.UNKNOWN.
איך לטפל
מסירים את קמפיין המקור באמצעות CampaignOperation.remove (לפני או באותה בקשה לשינוי נתונים) לפני שמפעילים את קמפיין ליצירת ביקוש שהועבר, ומוודאים שאין קמפיין פעיל אחר ליצירת ביקוש שהועבר מאותו קמפיין מקורי. פרטים נוספים זמינים במאמר הפעלת קמפיינים שהועברו.
טיפים למניעה
אם אתם עוקבים אחרי המזהים של קמפיינים המקור המקוריים ושל הקמפיינים ליצירת ביקוש שהועברו, צריך לשלוח שאילתה ל-campaign.status לפני שמגדירים את status ל-ENABLED בקמפיין שהועבר, או לכלול את CampaignOperation.remove בקמפיין המקורי באותה בקשה לשינוי נתונים.
נסו שוב לשלוח את הבקשות שנכשלו עם השגיאה הזו, באמצעות לוח זמנים של השהיה מעריכית לפני ניסיון חוזר (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"]],["עדכון אחרון: 2026-10-29 (שעון UTC)."],[],[]]