הפרדת הסכמות בממשקי API של Google Ads

יום חמישי, 20 בפברואר 2025

מה משתנה?
החל מהשבוע של 1 במאי 2025, נשיק את ההפרדה של בקשות ההסכמה לאימות משתמשים באמצעות OAuth בכל פרויקטים בענן של Google שנוצרו לפני 2019. אם יש לכם אפליקציה שמשתמשת ב-API שקשור ל-Google Ads דרך פרויקט בענן של Google שנוצר לפני 2019, יכול להיות שתצטרכו לעדכן את האפליקציה כדי לטפל בהסכמה מהמשתמש שלא מקובצת לפני 1 במאי 2025.

רקע
הפרדת ההסכמה בתהליך אימות המשתמשים של OAuth מאפשרת למשתמשים לבחור את היקפי ההרשאות הספציפיים של OAuth שהם רוצים לאשר לאפליקציה, במקום לאשר את כולם או לא לאשר אף אחד. התכונה הזו מופעלת בכל הפרויקטים במסוף Google Cloud שנוצרו מאז 2019, והיא מושבתת בכל הפרויקטים שנוצרו לפני 2019.

על מי השינוי הזה משפיע?
השינוי הזה ישפיע עליך אם כל התנאים הבאים מתקיימים:

1. האפליקציה שלכם ל-API משתמשת בפרויקט במסוף Google Cloud שנוצר לפני 2019.
2. האפליקציה שלכם מטמיעה את תהליך ההסכמה מהמשתמשים ב-OAuth 2.0 – תהליך אימות שבו המשתמשים מתחברים באמצעות חשבון Google שלהם ומעניקים הרשאה אחת או יותר שהאפליקציה מבקשת.
3. האפליקציה שלכם משתמשת ביותר מ-Google API אחד, ואחד מממשקי ה-API הוא API שקשור ל-Google Ads ומופיע ברשימה שבהמשך.

על מי השינוי הזה לא משפיע?

• טוקני רענון קיימים: השינוי הזה לא משפיע על אימותי המשתמשים שכבר קיימים. טוקני הרענון הקיימים ימשיכו לפעול ללא שינויים או אימות מחדש.
• אפליקציות עם היקף הרשאות יחיד: אם האפליקציה שלכם משתמשת רק בהיקף הרשאות אחד של Google API, היא לא מושפעת מהשינוי הזה, כי אין כמה היקפי הרשאות של OAuth שצריך להפריד.
• אפליקציות למשתמש יחיד / אפליקציות עם אימות ידני: באפליקציה שלכם לא מוטמע תהליך מפורש של אימות משתמשים באמצעות OAuth. במקום זאת, אתם משתמשים בסקריפט אימות ידני כמו GenerateUserCredentials, ה-CLI של gcloud או OAuth Playground כדי לאמת את המשתמש, ואז משתמשים בפרטי הכניסה האלה למשך תקופה ארוכה. בחרת את כל היקפי ההרשאות שהאפליקציה שלך דורשת במהלך האימות, ולכן האפליקציה לא מושפעת מהשינוי הזה.
• חשבונות שירות: אם האפליקציה שלכם משתמשת בחשבון שירות כדי לאמת את הקריאות ל-API, השינוי הזה לא ישפיע עליכם.

מה צריך לעשות?
אתם צריכים לוודא שהאפליקציה שלכם יכולה לטפל בהסכמה חלקית של המשתמשים. לשם כך,

1. כדי לבקש את רשימת היקפי ההרשאות ב-OAuth שהמשתמש הסכים להם, צריך לכלול את הפרמטר include_granted_scopes בתהליך OAuth.
2. בודקים את הרשימה בפועל של היקפי ההרשאות של OAuth שהמשתמש הסכים להם בתגובה של OAuth.
3. להטמיע הרשאה מצטברת באפליקציה.

במדריך בנושא הסכמה פרטנית של OAuth מוסבר על הדרישות והשיטות המומלצות לטיפול בהסכמה פרטנית.

איך בודקים את התכונה הזו?
יש שתי דרכים לבדוק את התכונה הזו:

1. יצירת פרויקט חדש ב-Google Cloud: בפרויקטים חדשים ב-Google Cloud, ההסכמה ל-OAuth מופרדת כברירת מחדל. לכן, אתם יכולים ליצור פרויקט חדש ב-Google Cloud ולהשתמש בו כדי לבדוק את האפליקציה.
2. להפעיל את ההסכמה המפורטת בפרויקט הקיים: אתם יכולים להגדיר את הפרמטר enable_granular_consent כ-true בבקשת ההרשאה של OAuth.

אילו היקפי הרשאות של API מושפעים?
השינוי הזה משפיע על ממשקי ה-API הבאים שקשורים ל-Google Ads.

API	היקף הרשאות OAuth
Google Ads API	https://adwords.google.com/api/adwords
‫Google Ad Manager API (SOAP API, בטא)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display and Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
Real-Time Bidding API	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

איך מקבלים עזרה
אם יש לכם שאלות או שאתם צריכים עזרה, אתם יכולים לפנות לצוות התמיכה של ה-API הרלוונטי.

 – Anash P. אומן, צוות Google Ads API

תוויות: authentication, oauth