Ringkasan

Anda dapat membuat dan mengelola segmen data menggunakan Authorized Buyers Marketplace API, yang mengekspos resource curators.dataSegments. Ini adalah REST API dengan library klien yang dibuat yang dapat Anda gunakan untuk integrasi.

Menyiapkan autentikasi

Google API menggunakan protokol OAuth 2.0 untuk autentikasi dan otorisasi. Berikut cara menyiapkan Akun Layanan untuk mengakses Marketplace API.

  1. Jika belum melakukannya, buat Project Google Cloud yang menghosting kredensial Anda yang digunakan untuk mengakses API.
  2. Buka halaman API yang Diaktifkan di Konsol Google Cloud. Pilih project yang Anda buat sebelumnya.

  3. Anda akan melihat daftar API dan layanan yang diaktifkan. Untuk mengakses Marketplace API, Anda harus mengaktifkannya. Jika Marketplace API belum diaktifkan, klik +Aktifkan API dan layanan, lalu ikuti petunjuk berikut:

    1. Anda akan diarahkan ke halaman dengan kotak penelusuran. Cari Authorized Buyers Marketplace API.
    2. Pilih Authorized Buyers Marketplace API di halaman hasil.
    3. Klik Enable.
  4. Di menu navigasi, pilih Credentials.
  5. Klik +Buat kredensial, lalu di menu drop-down yang muncul, pilih Akun layanan.
  6. Masukkan Nama untuk akun layanan. ID akun layanan dibuat secara otomatis saat pembuatan – catat nilai ini karena akan diperlukan nanti di langkah 14. Masukkan deskripsi secara opsional. Klik Buat dan lanjutkan.
  7. Konfigurasi izin untuk akun layanan secara opsional, lalu klik Lanjutkan.
  8. Konfigurasi pengguna atau grup yang dapat melakukan tindakan sebagai akun layanan secara opsional, lalu klik Selesai.
  9. Akun layanan baru Anda tercantum di bagian Service Accounts. Temukan dan klik ID akun layanan yang baru saja Anda buat.
  10. Klik tab Kunci.
  11. Di menu drop-down Tambahkan kunci, pilih Buat kunci baru.
  12. Pilih JSON sebagai Key type, lalu klik Create.
  13. Download kunci ke direktori kerja Anda. Untuk mengetahui informasi selengkapnya tentang cara menyimpan kunci Anda dengan aman, lihat Mengelola kunci akun layanan. Kunci ini digunakan oleh aplikasi Anda untuk melakukan panggilan API.
  14. Bagikan ID akun layanan kepada Technical Account Manager Anda untuk menautkan akun layanan dengan akun Anda.

Cakupan API

Saat menelusuri alur OAuth 2.0 untuk menerima token akses yang digunakan untuk melakukan panggilan API, Anda harus menentukan API yang dapat diakses menggunakan token tersebut. Untuk Authorized Buyers Marketplace API, cakupan tersebut adalah https://www.googleapis.com/auth/authorized-buyers-marketplace.

Cara mengidentifikasi segmen data di API versus Seleksi Real-time

Di Marketplace API, segmen data diidentifikasi dengan nama resource khusus API seperti:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Saat mengidentifikasi segmen data yang relevan untuk peluang iklan dalam Kurasi Real-Time, tentukan nilai untuk ID resource DATA_SEGMENT_ID, bukan name resource lengkap yang digunakan oleh API.

Langkah Berikutnya