Pemisahan izin di Ads API

Kamis, 20 Februari 2025

Apa yang berubah?
Mulai pekan ke-1 Mei 2025, kami akan meluncurkan pemisahan izin untuk autentikasi pengguna OAuth ke semua project Google Cloud yang dibuat sebelum tahun 2019. Jika Anda memiliki aplikasi yang menggunakan API terkait Google Ads melalui project Google Cloud yang dibuat sebelum tahun 2019, Anda mungkin perlu mengupdate aplikasi untuk menangani izin pengguna yang tidak dipaketkan sebelum 1 Mei 2025.

Latar belakang
Pemisahan izin untuk alur autentikasi pengguna OAuth memungkinkan pengguna menyesuaikan cakupan OAuth tertentu yang ingin mereka izinkan untuk aplikasi Anda, bukan pendekatan semua atau tidak sama sekali. Semua project Konsol Google Cloud yang dibuat sejak tahun 2019 mengaktifkan fitur ini, sedangkan semua project yang dibuat sebelum tahun 2019 menonaktifkan fitur ini.

Siapa yang terpengaruh oleh perubahan ini?
Anda akan terpengaruh oleh perubahan ini jika SEMUA kondisi berikut terpenuhi:

  1. Aplikasi API Anda menggunakan project Konsol Google Cloud yang dibuat sebelum tahun 2019.
  2. Aplikasi Anda menerapkan alur izin pengguna OAuth 2.0 – alur kerja autentikasi tempat pengguna login dengan Akun Google mereka dan memberikan satu atau beberapa izin yang diminta aplikasi Anda.
  3. Aplikasi Anda menggunakan lebih dari satu Google API, dan salah satu API tersebut adalah API terkait Google Ads yang tercantum di bawah.

Siapa yang tidak terpengaruh oleh perubahan ini?

  • Token refresh yang ada: Perubahan ini tidak memengaruhi autentikasi pengguna yang sudah Anda miliki. Token refresh yang ada akan terus berfungsi tanpa perubahan atau autentikasi ulang.
  • Aplikasi cakupan tunggal: Jika aplikasi Anda hanya menggunakan satu cakupan Google API, aplikasi Anda tidak akan terpengaruh oleh perubahan ini, karena tidak ada beberapa cakupan OAuth yang perlu dipisahkan.
  • Aplikasi pengguna tunggal/Aplikasi yang diautentikasi secara manual: Aplikasi Anda tidak menerapkan alur autentikasi pengguna OAuth yang eksplisit. Sebagai gantinya, Anda menggunakan skrip autentikasi manual seperti GenerateUserCredentials, gcloud CLI, atau OAuth Playground untuk mengautentikasi pengguna, lalu menggunakan kredensial tersebut untuk jangka waktu yang lama. Karena Anda memilih semua cakupan yang diperlukan aplikasi saat melakukan autentikasi, aplikasi Anda tidak terpengaruh oleh perubahan ini.
  • Akun layanan: Jika aplikasi Anda menggunakan akun layanan untuk mengautentikasi panggilan API, Anda tidak akan terpengaruh oleh perubahan ini

Apa yang harus saya lakukan?
Anda harus memastikan bahwa aplikasi Anda dapat menangani izin pengguna parsial. Untuk melakukannya,

  1. Minta daftar cakupan OAuth yang disetujui pengguna dengan menyertakan parameter include_granted_scopes dalam alur OAuth Anda.
  2. Periksa daftar cakupan OAuth yang sebenarnya yang diizinkan pengguna dalam respons OAuth.
  3. Terapkan otorisasi inkremental di aplikasi Anda.

Tinjau panduan izin terperinci OAuth kami untuk mempelajari persyaratan dan praktik terbaik dalam menangani izin terperinci.

Bagaimana cara menguji fitur ini?
Ada dua cara untuk menguji fitur ini:

  1. Buat project Google Cloud baru: Project Google Cloud baru telah mengaktifkan pemisahan izin OAuth. Jadi, Anda dapat membuat project Google Cloud baru, dan menggunakannya untuk menguji aplikasi Anda.
  2. Mengaktifkan pemisahan izin di project yang ada: Anda dapat menetapkan parameter enable_granular_consent ke true dalam permintaan otorisasi OAuth Anda.

Cakupan API mana yang terpengaruh?
API berikut yang terkait dengan Iklan terpengaruh oleh perubahan ini.

API Cakupan 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
Content API for Shopping https://www.googleapis.com/auth/content
Display & 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
API bidding real-time 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

Cara mendapatkan bantuan
Jika Anda memiliki pertanyaan atau memerlukan bantuan, hubungi tim dukungan API masing-masing.

Potret penulis - , Tim Google Ads API

Label: authentication, oauth