Playground OAuth

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

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

Mendapatkan client ID dan rahasia klien

Peringatan: Untuk menggunakan OAuth2 Playground, Anda perlu 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 Kredensial Konsol API Google.

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

3. Di halaman Kredensial, pilih Buat kredensial, lalu pilih ID klien OAuth.

4. Di bagian Application type, pilih Web application.

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 mana 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 bukan pengguna yang sama dengan saat Anda login saat mendapatkan client ID dan secret.

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

2. Klik ikon roda gigi di sudut kanan atas, lalu centang kotak berlabel Gunakan kredensial OAuth Anda sendiri (jika belum dicentang).

3. Pastikan:

   • Alur OAuth 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 dapatkan di atas.

   

5. Di bagian berlabel Langkah 1 - Pilih & otorisasi API, 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 saja mendapatkan client ID dan secret beberapa menit yang lalu, dan Anda mengalami 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 saat ini sedang diuji, Anda harus membuka halaman layar izin OAuth dalam project GCP dan melakukan salah satu tindakan berikut:

   • Publikasikan aplikasi.

   • Biarkan 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. Klik Setuju untuk melanjutkan.

8. Di tab berlabel Langkah 2 - Tukar kode otorisasi untuk token, Kode otorisasi 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 Langkah 2 - Tukar kode otorisasi untuk token):

   

10. Salin Refresh token ke dalam file konfigurasi untuk library klien pilihan Anda, beserta client ID dan client secret.

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

Menghapus OAuth2 Playground dari client ID Anda

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

1. Buka halaman Kredensial Konsol API Google.

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

3. Di halaman Kredensial, klik nama client ID yang ingin diedit.

4. Hapus https://developers.google.com/oauthplayground dari URI pengalihan yang Diizinkan. Perhatikan bahwa Anda harus mempertahankan setidaknya satu URI pengalihan.

5. Klik Simpan.