Menyiapkan akses API

Berikut cara menyiapkan akses ke Data Manager API dengan SDK atau REST.

Pilih jenis proses penyiapan yang ingin Anda ikuti:

Prasyarat

Sebelum dapat menggunakan Data API, pastikan Anda memiliki hal berikut:

Project Google Cloud.
Akun Google yang memiliki izin serviceusage.services.enable di project Google Cloud Anda, atau memiliki peran yang mencakup izin tersebut. Misalnya, roles/owner dan roles/serviceusage.serviceUsageAdmin keduanya mencakup izin serviceusage.services.enable. Untuk memeriksa izin Anda, lihat Melihat akses saat ini.
Antarmuka command line Google Cloud terinstal.

Mengaktifkan API

Jika belum melakukannya, aktifkan Data Manager API dengan mengklik Aktifkan Data Manager API atau ikuti petunjuk untuk melakukan langkah ini secara manual.

Jika Anda tidak dapat menemukan Data Manager API atau Enable the Data Manager API gagal, pastikan Akun Google Anda memenuhi prasyarat.

Menyiapkan autentikasi

Anda dapat menggunakan salah satu Metode autentikasi di Google selain kunci API. Sebaiknya tinjau cara Memilih metode autentikasi yang tepat untuk kasus penggunaan Anda untuk memutuskan pendekatan mana yang sesuai untuk kasus penggunaan Anda.

Dua metode autentikasi umum adalah akun pengguna dan akun layanan:

Akun pengguna: Mewakili orang yang berinteraksi langsung dengan Google API dan layanan Google.
Akun layanan: Mewakili aplikasi, bukan orang, sebagai pengguna. Mereka memungkinkan aplikasi Anda mengelola autentikasi dan otorisasi. Misalnya, jika aplikasi perlu mengakses resource Google Cloud.

Integrasi Anda dapat menggunakan Kredensial Default Aplikasi (ADC) untuk menemukan kredensial secara otomatis dari lingkungan sehingga Anda tidak perlu mengubah kode klien untuk mengautentikasi.

Pilih Akun pengguna atau Peniruan akun layanan untuk menyiapkan ADC:

Berikut adalah langkah-langkah untuk mengautentikasi dengan kredensial akun pengguna:

Konfigurasi setelan Google Auth Platform untuk project Anda.

Penting: Aplikasi Google Cloud apa pun yang digunakan untuk mendapatkan kredensial pengguna untuk cakupan Data Manager API harus menjalani verifikasi OAuth Google untuk menghindari layar UI yang tidak terverifikasi bagi penggunanya. Verifikasi OAuth Google tidak diperlukan untuk akun layanan.
1. Buka halaman Branding di Konsol Google Cloud.
2. Pilih project Anda.
3. Isi formulir, lalu klik Buat.
Karena cakupan Data Manager API adalah cakupan sensitif, langkah-langkah berikut diperlukan:
1. Buka setelan Akses Data untuk project Anda.
2. Klik Tambahkan atau hapus cakupan.
3. Centang kotak di samping Data Manager API dalam daftar cakupan, lalu klik Perbarui.
4. Klik Simpan.
5. Buka Audience di Konsol Google Cloud, lalu perbarui Publishing status dan User type. Pelajari lebih lanjut setelan ini di Mengelola Audiens Aplikasi.
Klik Buat klien OAuth2 untuk membuat klien OAuth2 di project, atau ikuti petunjuk untuk membuat klien OAuth2 Desktop. Anda dapat melewati langkah ini jika sudah memiliki klien OAuth2 Desktop yang ingin digunakan untuk Data Manager API.

Jika Anda mengklik Create OAuth2 client, pilih Desktop app saat diminta untuk Configure your OAuth client agar Anda dapat menggunakan klien di langkah-langkah selanjutnya.

Buat klien OAuth2
Pada langkah terakhir, klik DOWNLOAD KONFIGURASI KLIEN dan catat lokasi download yang Anda pilih.

Buat file ADC lokal dengan menjalankan perintah berikut. Perintah ini meluncurkan alur web tempat Anda diminta untuk login ke Akun Google yang Anda gunakan dengan API.

Ganti PATH_TO_CLIENT_JSON dengan nama file JSON yang Anda download.

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Jika Anda ingin menggunakan kredensial yang sama untuk Data Manager API dan Google Ads API, sertakan cakupan Google Ads API dalam daftar --scopes:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Jika Anda ingin menggunakan kredensial yang sama untuk Data Manager API dan Display & Video 360 API, sertakan cakupan Display & Video 360 API dalam daftar --scopes berikut:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Pastikan kredensial disiapkan dengan benar menggunakan perintah berikut. Jika berhasil, perintah akan mencetak token akses ke konsol.
```
gcloud auth application-default print-access-token
```

Untuk mempelajari lebih lanjut autentikasi dan kredensial untuk aplikasi Anda, lihat Metode autentikasi di Google dan Cara kerja Kredensial Default Aplikasi.

Menyiapkan akses akun

Beri alamat email yang terkait dengan akun pengguna Anda akses ke Destination.

Jika menggunakan akun Google Ads, ikuti petunjuk untuk menambahkan email pengguna ke akun Google Ads atau akun pengelola Google Ads induk.
Jika menggunakan akun Display & Video 360, ikuti petunjuk untuk menambahkan email pengguna ke akun.
Jika menggunakan properti Google Analytics, ikuti petunjuk untuk menambahkan email pengguna ke akun.

Langkah berikutnya

Instal library klien dan jalankan contoh kode untuk mencoba permintaan Data Manager API pertama Anda.

Berikutnya

Menginstal library klien