Menyiapkan Auth

Orientasi DV360 seller API

Ada beberapa langkah utama untuk melakukan aktivasi API untuk DV360 Seller API. DV360 Seller API diekspos sebagai Google Cloud API berbasis daftar yang diizinkan, dan menggunakan OAuth untuk Autentikasi.

Proses daftar yang diizinkan akan ditangani dengan menghubungi tim DV360 Seller API.

Langkah-langkah aktivasi:

  1. Daftarkan 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 Anda.
    • Akun tidak boleh berupa Google Grup.
    • Jika Anda menggunakan project Google Cloud yang sudah ada: Akun harus merupakan administrator project.
  2. Hubungi Google DV360 dengan informasi akun yang Anda gunakan untuk mendaftar agar ditambahkan ke daftar yang diizinkan.
  3. Tunggu hingga akun Anda ditambahkan ke daftar yang diizinkan.
  4. Opsional dan tidak memblokir: Kirim permintaan peninjauan verifikasi OAuth untuk aplikasi Anda guna mengakses cakupan(doubleclickbidmanager).
  5. Buka https://console.cloud.google.com/. Buka API & Layanan -> Library -> Pribadi. Anda akan dapat melihat DV360 Seller API tercantum sebagai salah satu API yang tersedia untuk Anda.
  6. Mengaktifkan DV360 Seller API
  7. Buka Kredensial -> Buat Kredensial -> Kunci Akun Layanan. Ikuti petunjuk di sini: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    Menyiapkan akun layanan:

    Catatan: Beri tahu kami jika Anda ingin menggunakan kembali akun layanan yang ada, seperti 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 dibuatnya. Sebagai contoh, kami akan menunjukkan cara membuat kredensial akun layanan menggunakan Konsol Google Cloud Platform.

    Menggunakan Konsol Google Cloud

    Dari halaman API Manager→Credentials Konsol Google Cloud, pilih "Create credentials→Service account key".

    alt_text

    Selanjutnya, pilih "New service account" dari menu drop-down "Service account".

    alt_text

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

    alt_text

    Kunci JSON yang dihasilkan 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>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"
}

    Simpan file JSON ini dengan aman, karena file ini 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 DV360 dengan informasi akun layanan yang Anda buat. Secara khusus, kita memerlukan email untuk akun layanan ini. Ini adalah proses daftar yang diizinkan lainnya untuk Otorisasi.
  9. Setelah akun layanan Anda diberi otorisasi untuk memanggil API, Anda dapat melihat https://developers.google.com/display-video/seller untuk melihat dokumentasi API. Untuk mendapatkan token autentikasi secara manual, lihat petunjuk di sini: https://github.com/google/oauth2l. (Anda harus sudah mendownload kunci akun layanan versi JSON). Ada juga petunjuk mendetail tentang cara mendapatkan Token Oauth secara terprogram di sini: https://cloud.google.com/docs/authentication/production.

Penting: Cakupan OAuth harus 'doubleclickbidmanager'

Sebelumnya
Ringkasan
Berikutnya
Library Klien