Ringkasan

Anda dapat membuat dan mengelola segmen data menggunakan Curation Partners API, yang mengekspos curators.dataSegments resource. Ini adalah REST API dengan library klien yang dibuatyang 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 Curation Partners API.

  1. Jika belum melakukannya, buat Project Google Cloud yang menghosting kredensial yang digunakan untuk mengakses API.

  2. Buka halaman Google Cloud Console API yang Diaktifkan. Pilih project yang Anda buat sebelumnya.

  3. Tinjau daftar API dan layanan yang diaktifkan. Untuk mengakses Curation Partners API, Anda harus mengaktifkannya. Jika Curation Partners API tidak diaktifkan, klik +Aktifkan API dan layanan , lalu ikuti petunjuk berikut:

    1. Telusuri Curation Partners API menggunakan kotak penelusuran.
    2. Pilih Curation Partners API di halaman hasil.
    3. Klik Aktifkan.

    Ada masalah umum yang menyebabkan Anda mungkin tidak dapat menemukan Curation Partners API dengan kotak penelusuran Google Cloud Console. Sebagai alternatif, Anda dapat menggunakan Google Cloud CLI untuk mengaktifkan API. Setelah menginstal gcloud CLI, Anda dapat mengaktifkan Curation Partners API dengan perintah berikut:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. Di menu navigasi, pilih Credentials.

  5. Klik +Create credentials, lalu pilih Service account di menu drop-down yang muncul.

  6. Masukkan Name untuk akun layanan. Service account ID dibuat secara otomatis saat pembuatan – catat nilai ini karena akan diperlukan nanti di langkah 14. Anda dapat memasukkan deskripsi. Klik Create and continue.

  7. Anda dapat mengonfigurasi izin untuk akun layanan, lalu klik Continue.

  8. Anda dapat mengonfigurasi pengguna atau grup yang dapat melakukan tindakan sebagai akun layanan, lalu klik Done.

  9. Akun layanan baru Anda akan tercantum di bagian Service Accounts. Temukan dan klik ID akun layanan yang baru saja Anda buat.

  10. Klik tab Keys.

  11. Di menu drop-down Add key, pilih Create new key.

  12. Pilih JSON sebagai Key type, lalu klik Create.

  13. Download kunci ke direktori kerja Anda. Untuk mengetahui informasi selengkapnya tentang cara menyimpan kunci 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 mengikuti 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 Curation Partners API, cakupannya adalah https://www.googleapis.com/auth/curation-partners.

Cara mengidentifikasi segmen data di API versus Seleksi Real-time

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Saat mengidentifikasi segmen data yang relevan untuk peluang iklan di Seleksi Real-time Curation, tentukan nilai untuk ID resource DATA_SEGMENT_ID, bukan nama resource lengkap yang diberikan oleh API di kolom name.

Langkah Berikutnya