Penyiapan OAuth dan aktivasi DV360 Exchange Reporting API

DV360 Exchange Reporting API ditampilkan sebagai daftar yang diizinkan berbasis Google Cloud API yang menggunakan OAuth. Proses pemberian izin ditangani oleh DV360 Exchange Reporting API.

Prosedur

Berikut adalah langkah-langkah aktivasi DV360 Exchange Reporting API:

  1. Mendaftar Akun Google di Google Cloud konsol.

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

  2. Hubungi Google DV360 dengan menyertakan informasi akun agar ditambahkan ke daftar yang disetujui.

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

  4. Login ke Konsol Google Cloud.

    Buka API & Layanan > Koleksi > Pribadi. Anda akan melihat kolom DV360 Exchange Reporting API tercantum sebagai salah satu API yang tersedia untuk Anda. Aktifkan DV360 Exchange Reporting API.

  5. Buka Credentials > Buat Kredensial > Kunci Akun Layanan. Ikuti petunjuk untuk membuat layanan menggunakan akun layanan.

Akun layanan

Akun layanan memungkinkan kode Anda mengirim kredensial aplikasi langsung ke API. Akun layanan, seperti akun pengguna, diwakili oleh email alamat IPv6 Tidak seperti akun pengguna, akun layanan hanya dimiliki oleh aplikasi, dan hanya dapat digunakan untuk mengakses API yang dibuatnya.

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

  1. Dari menu API Manager > halaman Credentials, 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 default untuk ID Akun layanan Anda, di sebelah kiri @ di kolom alamat ID akun layanan yang dibuat.

    Di bagian Jenis kunci, sebaiknya biarkan nilai ini sebagai JSON. Klik Buat untuk menghasilkan kunci JSON sebagai file teks .json. Saat diminta, download file ke komputer Anda dan dialog Service account created yang 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 dengan aman, karena file tersebut berisi kunci pribadi Anda, dan ini satu-satunya salinan dari kunci itu. 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. Ini adalah bagian dari proses daftar yang diizinkan untuk akses API.

Token akses

Setelah akun layanan diberi otorisasi untuk melakukan panggilan ke API, Anda dapat lanjutkan dengan contoh di panduan API. Untuk mendapatkan token akses secara manual, Anda dapat menggunakan alat seperti oauth2l; atau, gunakan salah satu dari klien kami library ke melakukan autentikasi secara terprogram.