Playground OAuth

Salah satu opsi untuk membuat kredensial OAuth2 adalah menggunakan OAuth2 Playground. OAuth2 Playground, bersama dengan konsol Google Ads API, memungkinkan Anda membuat token OAuth2 secara manual.

OAuth2 Playground ditujukan bagi pengguna yang hanya perlu mengakses akun untuk satu akun pengelola atau pengguna Google Ads. Jika Anda perlu meminta kredensial dari beberapa pengguna, sebaiknya konfigurasikan library klien untuk OAuth di Search Ads 360.

Mendapatkan client ID dan rahasia klien

Peringatan: Untuk menggunakan OAuth2 Playground, Anda harus membuat client ID untuk aplikasi web. Ini adalah satu-satunya jenis aplikasi yang berfungsi dengan OAuth2 Playground. Lihat Memilih jenis aplikasi untuk mengetahui informasi selengkapnya.

Jika Anda belum memiliki project cloud:

1. Buka halaman Credentials di Konsol API Google.

2. Dari drop-down project, pilih project yang ada atau buat project baru.

3. Di halaman Credentials, pilih Create credentials, lalu pilih OAuth client ID.

4. Di bagian Jenis aplikasi, pilih aplikasi web.

5. Di bagian Authorized redirect URIs, tambahkan baris dengan: https://developers.google.com/oauthplayground

6. Klik Buat.

7. Di halaman Client ID, catat client ID dan client secret. Anda akan memerlukannya di langkah berikutnya.

Jika sudah memiliki project cloud, Anda dapat menggunakannya kembali dengan menetapkan URI pengalihan yang diizinkan seperti di atas.

Membuat token

Peringatan: Pengguna Search Ads 360 yang Anda gunakan untuk login di browser menentukan akun yang dapat Anda akses dengan kredensial OAuth2 yang Anda buat. Oleh karena itu, sebaiknya lakukan langkah-langkah ini di jendela samaran atau saat Anda tidak login ke akun Search Ads 360, karena kemungkinan pengguna yang kredensialnya ingin Anda gunakan bukanlah pengguna yang sama dengan yang Anda gunakan untuk login saat mendapatkan client ID dan rahasia klien.

1. Buka OAuth2 Playground, (menggunakan link ini akan mengisi otomatis beberapa nilai kunci untuk Anda).

2. Klik ikon roda gigi di sudut kanan atas dan centang kotak berlabel Use your own OAuth credentials (jika belum dicentang).

3. Pastikan:

   • OAuth flow ditetapkan ke sisi server.
   • Jenis akses ditetapkan ke Offline (ini memastikan Anda mendapatkan token refresh dan token akses, bukan hanya token akses).

4. Masukkan Client ID OAuth2 dan rahasia klien OAuth2 yang Anda peroleh di atas.

   

5. Di bagian berlabel Step 1 - Select & authorize APIs, klik Search Ads 360 Reporting API dari daftar dan pilih cakupannya, https://www.googleapis.com/auth/doubleclicksearch. Kemudian, klik Authorize APIs:

   

6. Jika diminta, login ke akun yang ingin Anda beri akses dan otorisasi. Jika tidak, pastikan pengguna saat ini di sudut kanan atas adalah akun klien atau pengelola yang kredensialnya ingin Anda dapatkan.

   Jika Anda baru mendapatkan client ID dan rahasia klien beberapa menit yang lalu, dan Anda mendapatkan error seperti Error: redirect_uri_mismatch, perubahan yang Anda buat mungkin belum diterapkan. Klik tombol kembali di browser, tunggu beberapa menit, lalu coba klik Authorize APIs lagi.
   Jika Anda mendapatkan error bahwa Anda belum diberi akses oleh developer dan aplikasi sedang diuji, Anda harus membuka halaman layar izin OAuth dalam project GCP Anda dan melakukan salah satu hal berikut:

   • Publikasikan aplikasi.

   • Pertahankan aplikasi dalam status Pengujian, dan tambahkan diri Anda sebagai pengguna pengujian.

7. Perintah akan muncul yang menunjukkan bahwa aplikasi Anda ingin Mengelola kampanye Search Ads 360 Anda. Klik Accept untuk melanjutkan.

8. Di tab berlabel Step 2 - Exchange authorization code for tokens, Authorization code akan muncul. Klik Exchange authorization code for tokens.

   

9. Jika semuanya berjalan lancar, token refresh dan token akses akan diisi untuk Anda (Anda mungkin harus meluaskan kembali Step 2 - Exchange authorization code for tokens):

   

10. Salin Token refresh ke file konfigurasi untuk library klien pilihan Anda, bersama dengan client ID dan rahasia klien.

11. Konfigurasi library klien untuk OAuth di Search Ads 360 Reporting API.

Menghapus OAuth2 Playground dari client ID Anda

Setelah memiliki token refresh, Anda tidak lagi memerlukan OAuth2 Playground untuk menjadi URI pengalihan yang diizinkan. Untuk menghapusnya dari daftar URI pengalihan yang diizinkan:

1. Buka halaman Credentials di Konsol API Google.

2. Dari drop-down project, pilih project Anda.

3. Di halaman Credentials, klik nama client ID yang akan diedit.

4. Hapus https://developers.google.com/oauthplayground dari Authorized redirect URIs. Perhatikan bahwa Anda harus menyisakan setidaknya satu URI pengalihan.

5. Klik Simpan.