יום חמישי, 10 בספטמבר 2026
כדי לשפר את חוויית השימוש וההצטרפות של המפתחים, יצרנו דף בית חדש ל-Google Ads API במסוף Google Cloud. מפתחים שהשלימו את אימות המותג יכולים עכשיו להגיש בקשות לגישה בסיסית באופן אוטומטי. בפוסט הזה בבלוג נסביר על כמה שינויים קשורים שנתחיל להשיק היום. כדי להבטיח מעבר חלק, המפתחים צריכים לעיין בקטע נדרשת פעולה בפוסט הזה.
שינויים בניהול הרשאות גישה ל-API
אנחנו מעדכנים את האופן שבו נרשמים ל-Google Ads API ומנהלים את הגישה אליו.
תהליך חדש להצטרפות ל-Google Ads API: עכשיו אתם יכולים להירשם כדי לקבל גישה ל-Google Ads API ישירות במסוף Google Cloud, בלי צורך בחשבון ניהול ב-Google Ads. אנחנו מוציאים משימוש את כל הפונקציונליות של ההרשמה החדשה וניהול הרשאות הגישה ל-API בדף מרכז ה-API בחשבונות הניהול, ועוברים לדף הסקירה הכללית של Google Ads API במסוף Google Cloud. אתם עדיין יכולים להיכנס לדף מרכז ה-API כדי לעיין בפרטי המפתח הישנים שלכם. בעתיד נוציא את הדף הזה משימוש באופן מלא.
רמות הגישה ל-API משויכות לפרויקטים בענן של Google: אנחנו מוציאים משימוש את קודי המפתחים. רמת הגישה הנוכחית והפעילה של קוד המפתח שלכם מועברת באופן אוטומטי לפרויקטים שלכם ב-Google Cloud על סמך הפעילות האחרונה ב-API. אתם יכולים להמשיך לשלוח קודי מפתח בכותרות של הקריאות ל-API, אבל זה אופציונלי והשרתים של ה-API מתעלמים מהם. הקוד הקיים ימשיך לפעול בלי שינויים. רמות הגישה ל-API נקבעות עכשיו לפי פרויקט בענן של Google שבו השתמשתם כדי ליצור את פרטי הכניסה ל-OAuth. מידע נוסף על השינוי הזה ופתרונות לבעיות שעלולות לצוץ מופיעים בדף השאלות הנפוצות.
קוד שגיאה חדש: בגרסה v25 של Google Ads API, אם תנסו להשתמש בפרויקט ב-Google Cloud עם רמת גישה של חשבון בדיקה כדי לשלוח קריאות לחשבון בסביבת ייצור, תופיע השגיאה CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. בגרסאות ישנות יותר של ה-API תוצג במקום זאת השגיאה ACTION_NOT_PERMITTED. אם נתקלתם בשגיאה הזו, עברו אל דף הסקירה הכללית של Google Ads API בפרויקט בענן שלכם ב-Google Cloud והגישו בקשה לגישה ברמת Explorer.
שינויים בתהליך הבדיקה של ה-API
נדרש אימות מותג כדי לקבל גישה בסיסית ורגילה: כדי להגיש בקשות חדשות לגישה בסיסית ורגילה, צריך להשלים את אימות המותג בפרויקט ב-Google Cloud . משתמשים שכבר יש להם גישה לא נדרשים להשלים את תהליך אימות המותג, אבל מומלץ לעשות זאת.
אישורים אוטומטיים של גישה בסיסית: הבקשות לגישה בסיסית מטופלות עכשיו באופן אוטומטי, והן ייבדקו תוך כמה דקות אחרי אימות המותג ושליחת הבקשה.
דחייה חד-פעמית של בקשות בהמתנה לגישה בסיסית: בגלל העדכונים בתהליך, כל הבקשות בהמתנה לגישה בסיסית ל-API ייסגרו כחלק מהמעבר הזה. מגישי בקשות שהושפעו מהשינוי יקבלו אימייל עם פרטים, ויצטרכו להגיש בקשה חוזרת לגישה ל-API דרך דף הסקירה הכללית של Google Ads API.
נדרשת פעולה
מאמתים את הגישה ל-API: מוודאים שרמת הגישה של הפרויקט ל-API תואמת לקוד המפתח הקיים:
- רמת הגישה של קוד המפתח מופיעה במרכז ה-API בחשבון הניהול ב-Google Ads.
- בדף הסקירה הכללית של Google Ads API, מוודאים שלפרויקט בענן ב-Google Cloud יש את אותה רמת גישה.
- אם רמות הגישה לא תואמות, צריך להגיש בקשה חוזרת לגישה ל-API דרך דף הסקירה הכללית של Google Ads API. אם אתם צריכים עזרה, אתם יכולים לפנות לתמיכה של Google Ads API.
עדכון כתובת האימייל ליצירת קשר בנושאי API: נכנסים לדף IAM (ניהול זהויות והרשאות גישה) בפרויקט ב-Cloud. מוודאים שרשימת המשתמשים בתפקידי הבעלים והעריכה מעודכנת. נתחיל לשלוח לכתובות האימייל האלה הודעות שירות חיוניות (MSA) כדי להודיע לכם על שינויים עתידיים ב-Google Ads API.
שינויים בקוד: כדי להפסיק לשלוח קודי מפתח כחלק מהקריאות ל-API, מומלץ לעדכן את קוד האפליקציה. פרסמנו גרסאות חדשות של ספריות הלקוח שמאפשרות לבצע קריאות ל-API בלי להגדיר קוד מפתח. בגרסה ראשית עתידית של Google Ads API, נתחיל לדחות קודי מפתח בקריאות ל-API.
אם צריך, מגישים בקשה חדשה לגישה ל-API: אם הבקשה שלכם לגישה בסיסית ל-API נסגרה במסגרת המעבר הזה, אתם צריכים להגיש בקשה חדשה לגישה ל-API בדף הסקירה הכללית של Google Ads API במסוף Google Cloud.
פרסמנו מסמכים מעודכנים שיעזרו לכם להתמודד עם השינויים האלה. לבעיות שקשורות לתמיכה טכנית, אפשר לעיין בדף השאלות הנפוצות או לפנות אל התמיכה ב-Google Ads API. אם יש לכם שאלות או שאתם רוצים לדון בפוסט הזה, אתם יכולים לפנות אלינו בשרת ה-Discord של קהילת הפרסום והמדידה של Google.
– Anash P. אומן, צוות Google Ads API
תוויות: google-ads-api, release