Search Ads 360 Reporting API versi sebelumnya akan dihentikan dan dinonaktifkan pada 30 Juni 2024. Perhatikan bahwa Search Ads 360 Conversion API tidak terpengaruh dan akan terus didukung. Semua pengembangan pelaporan baru harus menggunakan Search Ads 360 Reporting API versi baru.

Mulai April 2024, error supportedApiVersion akan ditampilkan saat meminta laporan. Lihat detailnya di sini.

Sebaiknya migrasikan juga penerapan Search Ads 360 yang ada ke API baru. Lihat Memulai dan Panduan Migrasi Search Ads 360 Reporting API versi baru untuk mendapatkan informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Siapkan Otorisasi

Search Ads 360 API memerlukan semua permintaan untuk menentukan token akses OAuth 2.0 untuk autentikasi. Anda dapat mengikuti alur kerja autentikasi OAuth 2.0 standar untuk membuat token dan meneruskannya ke Search Ads 360 API. Sebaiknya gunakan alur kerja yang dijelaskan di bawah karena cocok untuk upload konversi dan download laporan yang sepenuhnya otomatis.

Untuk alternatif alur kerja yang dijelaskan di bawah, lihat Menggunakan OAuth 2.0 untuk Aplikasi yang Diinstal atau Menggunakan OAuth 2.0 untuk Aplikasi Server ke Server. Jika Anda menggunakan alur kerja alternatif, tentukan nilai berikut sebagai parameter scope saat meminta kode otorisasi OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Jika Anda mengikuti rute server ke server, tambahkan akun layanan sebagai pengguna Search Ads 360.

Alur kerja otorisasi yang direkomendasikan

Buka Konsol API Google dan pilih project Anda.
Jika Anda belum membuat project Konsol API Google dan kredensial OAuth, ikuti petunjuk di Membuat project Konsol API Google dan kredensial OAuth untuk klien Anda.

Untuk menemukan rahasia dan client ID OAuth project Anda, lakukan hal berikut:
1. Buka halaman Kredensial.
2. Di kolom Nama, klik nama klien OAuth Anda.
3. Rahasia dan client ID dicantumkan di halaman.
Buka browser web dan login ke Google dengan Akun Google yang memiliki izin untuk mengakses data di Search Ads 360.
Ini adalah Akun Google yang akan digunakan klien API Anda untuk mengautentikasi dengan Search Ads 360. Jika pemegang Akun Google keluar dari perusahaan dan Anda menghapus akses Search Ads 360 dari akun, Anda harus mengulangi alur kerja otorisasi ini dan menentukan Akun Google yang berbeda.
Dapatkan token refresh dengan memanggil skrip utilitas Search Ads 360 sebagai berikut:
sa360Api.py --login

Skrip ini akan memandu Anda melalui proses penggunaan client ID dan rahasia Oauth untuk mendapatkan token refresh. Token refresh hanya valid untuk Akun Google yang Anda gunakan untuk login selama langkah sebelumnya.
Sebagai bagian dari proses ini, skrip membuat URL dan meminta Anda untuk mengunjungi URL di browser web.
Saat browser meminta Anda mengizinkan akses klien OAuth ke data Search Ads 360, pastikan Akun Google yang Anda gunakan untuk login sebelumnya muncul. (Jika login ke beberapa Akun Google, Anda mungkin akan melihat akun lain.)

Di akhir proses, skrip sa360Api.py menghasilkan string yang dipisahkan koma. Nilai pertama adalah client ID yang Anda berikan, nilai kedua adalah rahasia klien yang Anda berikan, dan nilai ketiga adalah token refresh. Dalam contoh output berikut, token refresh ditampilkan dalam teks tebal:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
Simpan client ID, rahasia klien, dan token refresh di database backend atau lokasi aman lainnya yang dapat diakses oleh aplikasi Anda.
Simpan seluruh string yang dipisahkan koma di lokasi yang sesuai jika Anda berencana menggunakan sa360Api.py untuk mengirim contoh permintaan JSON ke Search Ads 360 API. Anda akan meneruskan seluruh string sebagai parameter setiap kali Anda memanggil skrip.
Tambahkan kode ke aplikasi Anda yang melakukan hal berikut:
1. Gunakan client ID, rahasia klien, dan token refresh untuk mendapatkan token akses OAuth 2.0 yang baru.
2. Kirim permintaan ke Search Ads 360 API menggunakan token akses baru.
Jika Anda menggunakan library klien, bagian berikutnya, Menyiapkan Aplikasi, akan menjelaskan cara menambahkan kode otorisasi ini ke aplikasi Anda.

Jika Anda tidak menggunakan salah satu library klien, lihat Menggunakan OAuth 2.0 untuk Aplikasi yang Diinstal untuk mendapatkan saran tentang cara mendapatkan token akses baru.