Menyiapkan Auth

Orientasi Display &Video 360 Seller API

Ada beberapa langkah utama untuk melakukan orientasi dengan Display &Video 360 Seller API. DV360 Seller API adalah Google Cloud API berbasis daftar yang diizinkan dan menggunakan OAuth 2.0 untuk autentikasi dan otorisasi.

Proses daftar yang diizinkan ditangani oleh tim Display &Video 360 Seller API.

Catatan: Jika aplikasi Anda mengakses DV360 Seller API, aplikasi tersebut harus lulus tinjauan verifikasi OAuth. Jika Anda melihat aplikasi yang belum diverifikasi di layar saat menguji aplikasi, Anda harus mengirimkan permintaan verifikasi untuk menghapusnya. Pelajari lebih lanjut tentang aplikasi yang belum diverifikasi atau dapatkan jawaban atas pertanyaan umum tentang verifikasi aplikasi.

Langkah-langkah orientasi:

1. Daftar Akun Google dengan membuka https://console.cloud.google.com/.
   • Akun ini akan digunakan untuk mengelola token akses untuk klien produksi Anda. Jangan gunakan Akun Gmail pribadi.
   • Akun tidak boleh berupa Grup Google.
   • Jika Anda menggunakan project Google Cloud yang sudah ada: Akun harus menjadi administrator project.
2. Hubungi tim Google DV360 dengan detail akun Anda agar akun tersebut ditambahkan ke daftar yang diizinkan.
3. Tunggu konfirmasi bahwa akun Anda telah diaktifkan.
4. Opsional dan tidak memblokir: Kirim permintaan tinjauan verifikasi OAuth untuk aplikasi Anda guna mengakses cakupan https://www.googleapis.com/auth/doubleclickbidmanager.
5. Di Konsol Google Cloud, buka APIs & Services > Library > Private. Anda akan melihat DV360 Seller API tersedia untuk project Anda.
6. Aktifkan DV360 Seller API.
7. Buka APIs & Services > Credentials > Create Credentials > Service Account Key. Ikuti petunjuk penyiapan dalam dokumentasi Akun Layanan OAuth 2.0.

   Menyiapkan akun layanan:

   Catatan: Beri tahu kami jika Anda ingin menggunakan kembali akun layanan yang sudah ada, seperti akun yang digunakan untuk DV360 Reporting API.

   Autentikasi dan otorisasi Google Cloud API (biasanya dikelompokkan sebagai "auth") biasanya dilakukan menggunakan akun layanan. Akun layanan memungkinkan kode Anda mengirim kredensial aplikasi langsung ke Cloud API. Akun layanan, seperti akun pengguna, diwakili oleh alamat email. Namun, tidak seperti akun pengguna, akun layanan hanya dimiliki oleh aplikasi, dan hanya dapat digunakan untuk mengakses API yang dibuat untuknya. Sebagai contoh, kami akan menunjukkan cara membuat kredensial akun layanan menggunakan Konsol Google Cloud Platform.

   Menggunakan Konsol Google Cloud

   Dari halaman Konsol Google Cloud API Manager→Kredensial, pilih "Buat kredensial→Kunci akun layanan".

   

   Selanjutnya, pilih "New akun layanan" dari menu drop-down "akun layanan".

   

   Ketik "Name" untuk akun layanan ini. Nama ini akan digunakan sebagai nama default untuk "Service account ID" Anda (di sebelah kiri "@" di alamat ID akun layanan yang dibuat), tetapi Anda dapat mengubah nama ID akun layanan ini jika mau. Nama-nama ini dapat bersifat arbitrer; yang penting adalah Anda mengingatnya. Di bagian "Key type", sebaiknya biarkan nilai ini sebagai "JSON". Klik "Create", dan Konsol GCP akan membuat kunci JSON (sebagai file teks .json), meminta Anda mendownload file ke komputer, dan menampilkan kotak dialog Akun layanan dibuat.

   

   Kunci JSON yang dibuat akan mirip dengan contoh kunci JSON berikut:

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   Simpan file JSON ini dengan aman, karena berisi kunci pribadi Anda (dan file ini adalah satu-satunya salinan kunci tersebut). Anda harus merujuk ke file kunci akun layanan ini dalam kode saat ingin mengirim kredensial ke Google Cloud Platform API.

8. Hubungi tim DV360 dengan informasi akun layanan yang Anda buat (khususnya, alamat email akun layanan). Ini adalah langkah kedua daftar yang diizinkan untuk otorisasi.
9. Setelah akun layanan Anda diotorisasi untuk memanggil API, Anda dapat merujuk ke dokumentasi DV360 Seller API. Untuk mendapatkan token autentikasi secara manual, lihat petunjuk di repositori alat oauth2l (menggunakan kunci akun layanan JSON yang didownload). Petunjuk mendetail tentang cara mendapatkan token OAuth secara terprogram tersedia dalam dokumentasi Autentikasi Google Cloud.

Penting: Cakupan OAuth harus berupa https://www.googleapis.com/auth/doubleclickbidmanager