Penyiapan OAuth dan aktivasi DV360 Exchange Reporting API

DV360 Exchange Reporting API memberi partner Exchange Pihak Ketiga (3PE) akses terprogram ke laporan performa dari Display & Video 360.

DV360 Exchange Reporting API diekspos sebagai Google Cloud API berbasis daftar yang diizinkan yang menggunakan OAuth. Proses daftar yang diizinkan ditangani oleh tim DV360 Exchange Reporting API.

Prosedur

Berikut langkah-langkah aktivasi DV360 Exchange Reporting API:

  1. Daftarkan Akun Google di konsol Google Cloud.

    Perhatikan bahwa akun ini akan digunakan untuk mengelola token akses untuk klien produksi Anda, jadi jangan gunakan akun Gmail pribadi Anda.

  2. Hubungi Google DV360 dengan informasi akun untuk menambahkannya ke daftar yang diizinkan.

  3. Setelah Anda diberi tahu bahwa Anda berada dalam daftar yang diizinkan, minta peninjauan verifikasi OAuth untuk mendapatkan akses aplikasi Anda ke cakupan doubleclickbidmanager.

  4. Login di konsol Google Cloud.

    Buka API & Services > Library > Private. Anda akan melihat DV360 Exchange Reporting API tercantum sebagai salah satu API yang tersedia untuk Anda. Aktifkan DV360 Exchange Reporting API.

  5. Buka Credentials > Create a Credential > Service Account Key. Ikuti petunjuk untuk membuat akun layanan.

Akun layanan

Akun layanan memungkinkan kode Anda mengirim kredensial aplikasi langsung ke 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.

Berikut langkah-langkah untuk membuat kredensial akun layanan menggunakan Konsol Google Cloud:

  1. Dari halaman API Manager > Kredensial, pilih Buat kredensial→Kunci akun layanan.

  2. Pilih New service account dari drop-down Service account.

    Masukkan Nama untuk akun layanan ini. Nama ini digunakan sebagai nama default untuk ID akun layanan Anda, di sebelah kiri @ dalam alamat ID akun layanan yang dibuat.

    Di bagian Jenis kunci, sebaiknya biarkan nilai ini sebagai JSON. Klik Create untuk membuat kunci JSON sebagai file teks .json. Saat diminta, download file ke komputer Anda dan dialog Akun layanan dibuat akan ditampilkan.

    Berikut adalah contoh kunci JSON:

    {
  "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>api@project-id.iam.gserviceaccount.com",
  "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"
}

  3. Simpan file JSON Anda dengan aman, karena file tersebut berisi kunci pribadi Anda, dan file ini adalah satu-satunya salinan kunci tersebut. Kredensial dalam file ini diperlukan saat kode Anda melakukan panggilan ke API.

  4. Hubungi DV360 dengan informasi akun layanan yang Anda buat, khususnya alamat email akun layanan. Hal ini merupakan bagian dari proses daftar yang diizinkan untuk akses API.

Token akses

Setelah akun layanan Anda diizinkan untuk melakukan panggilan ke API, Anda dapat melanjutkan dengan contoh dalam panduan API. Untuk mendapatkan token akses secara manual, Anda dapat menggunakan alat seperti oauth2l; atau, gunakan salah satu library klien kami untuk mengautentikasi secara terprogram.