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 harus membuat client ID untuk aplikasi web. Ini adalah satu-satunya jenis aplikasi yang berfungsi dengan OAuth2 Playground. Lihat Memilih jenis aplikasi untuk 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 (hal 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. Lalu klik Authorize APIs:

   

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

   Jika Anda baru saja mendapatkan client ID dan secret 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 Anda, 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 hal berikut:

   • Publikasikan aplikasi.

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

7. Sebuah dialog 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, Refresh token dan Access token akan diisi untuk Anda (Anda mungkin harus meluaskan kembali Langkah 2 - Tukarkan 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 diberi otorisasi:

1. Buka halaman Kredensial Konsol API Google.

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

3. Pada halaman Credentials, klik client ID name untuk mengedit.

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

5. Klik Simpan.