تفکیک رضایت در Ads API

پنجشنبه، ۲۰ فوریه ۲۰۲۵

چه چیزی تغییر می‌کند؟
از هفته ۱ مه ۲۰۲۵، تفکیک رضایت برای اصالت‌سنجی کاربر OAuth را برای همه پروژه‌های Google Cloud که قبل‌از ۲۰۱۹ ایجاد شده‌اند عرضه خواهیم کرد. اگر مالک برنامه‌ای هستید که از میانای برنامه‌سازی کاربردی مرتبط با Ads ازطریق پروژه Google Cloud ایجادشده قبل‌از ۲۰۱۹ استفاده می‌کند، ممکن است لازم باشد برنامه‌تان را به‌روز کنید تا قبل‌از ۱ مه ۲۰۲۵ رضایت کاربر را به‌صورت مجزا دریافت کند.

پس‌زمینه
تفکیک رضایت برای جریان اصالت‌سنجی کاربر OAuth به کاربران اجازه می‌دهد تا به‌جای رویکرد «همه یا هیچ»، دامنه‌های OAuth خاصی را که می‌خواهند برای برنامه شما مجاز کنند سفارشی‌سازی کنند. این ویژگی برای همه پروژه‌های کنسول Google Cloud که از سال ۲۰۱۹ ایجاد شده‌اند روشن است، درحالی‌که برای همه پروژه‌هایی که قبل‌از سال ۲۰۱۹ ایجاد شده‌اند خاموش است.

چه کسانی تحت تأثیر این تغییر قرار می‌گیرند؟
اگر همه شرایط زیر برقرار باشد، این تغییر بر شما تأثیر خواهد گذاشت:

1. برنامه API شما از پروژه «کنسول Google Cloud» استفاده می‌کند که قبل‌از ۲۰۱۹ ایجاد شده است.
2. برنامه شما جریان رضایت کاربر OAuth 2.0 را پیاده‌سازی می‌کند – یک گردش کار اصالت‌سنجی که در آن کاربر با حساب Google خود وارد سیستم می‌شود و یک یا چند اجازه را که برنامه شما درخواست می‌کند اعطا می‌کند.
3. برنامه شما از بیش‌از یک Google API استفاده می‌کند و یکی از این APIها، API مرتبط با Ads است که در زیر فهرست شده است.

چه کسانی تحت تأثیر این تغییر قرار نمی‌گیرند؟

• ژتون‌های بازآوری موجود: این تغییر بر اصالت‌سنجی‌های کاربری که ازقبل در جای خود دارید تأثیر نمی‌گذارد. ژتون‌های بازآوری موجود شما بدون هیچ‌گونه تغییر یا اصالت‌سنجی مجدد به کار خود ادامه خواهند داد.
• برنامه‌های با یک دامنه: اگر برنامه شما فقط از یک دامنه Google API استفاده می‌کند، برنامه شما تحت تأثیر این تغییر قرار نمی‌گیرد، زیرا چندین دامنه OAuth برای جداسازی وجود ندارد.
• برنامه‌های تک‌کاربره / برنامه‌های اصالت‌سنجی‌شده به‌صورت دستی: برنامه شما جریان اصالت‌سنجی کاربر OAuth صریحی را پیاده‌سازی نکرده است. درعوض، از یک اسکریپت اصالت‌سنجی دستی مانند GenerateUserCredentials،‏ gcloud CLI یا 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 را در درخواست مجوز OAuth روی true تنظیم کنید.

کدام دامنه‌های میانای برنامه‌سازی کاربردی تحت‌تأثیر قرار گرفته‌اند؟
میاناهای برنامه‌سازی کاربردی زیر که مربوط به Ads هستند تحت تأثیر این تغییر قرار می‌گیرند.

میانای برنامه‌سازی کاربردی	حوزه OAuth
Google Ads API	https://adwords.google.com/api/adwords
Google Ad Manager API (SOAP API, Beta)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
میانای برنامه‌سازی کاربردی محتوا برای خرید	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
میانای برنامه‌سازی کاربردی پیشنهاد قیمت هم‌زمان	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. Oommen، تیم Google Ads API

برچسب‌ها: اصالت‌سنجی، oauth