Parameter permintaan yang diperlukan

Untuk membuat permintaan ke Maps Datasets API, Anda harus menyertakan:

• Nomor atau ID project Google Cloud Anda di header X-Goog-User-Project permintaan. Nilai ini menentukan project yang digunakan untuk penghitungan kuota penagihan dan penggunaan.

  Catatan: Jika menggunakan akun layanan untuk autentikasi, Anda dapat menghilangkan header X-Goog-User-Project. Untuk mengetahui informasi selengkapnya tentang akun layanan, baca artikel Authentication di Google.

• Token OAuth di header Authorization permintaan. Untuk informasi selengkapnya tentang penggunaan OAuth dengan Maps Datasets API, lihat Menggunakan OAuth.

• Nomor atau ID project Google Cloud di URL permintaan. Nilai ini menentukan project yang berisi set data. Meskipun project ini biasanya sama dengan project yang ditentukan dalam header X-Goog-User-Project, namun tidak harus sama.

• ID set data di URL permintaan. Setiap kali Anda melakukan tindakan pada set data tertentu, Anda akan meneruskan ID set data sebagai bagian dari URL permintaan.

Catatan: Beberapa permintaan memerlukan parameter tambahan yang dijelaskan dalam dokumentasi tentang permintaan tersebut.

Misalnya, untuk menghapus set data:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Mendapatkan nomor project

Untuk mendapatkan PROJECT_NUMBER_OR_ID project Google Cloud Anda:

1. Buka halaman Overview project di Konsol Cloud.

2. Jika diminta, pilih project Anda.

3. Project number dan Project ID muncul di area Project info pada layar ringkasan.

Mendapatkan token OAuth

Catatan: Prosedur di bawah untuk membuat token OAuth tidak dimaksudkan untuk digunakan dalam lingkungan produksi. Gunakan prosedur ini hanya untuk lingkungan pengembangan atau pengujian.

Untuk autentikasi, permintaan API Anda harus berisi token OAuth di header Authorization. Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth.

Misalnya, gunakan perintah gcloud berikut untuk membuat token:

gcloud auth application-default print-access-token

Anda dapat menyertakan perintah gcloud langsung di header Authorization dalam perintah cURL untuk membuat token baru di setiap permintaan, seperti ditunjukkan dalam contoh di atas.

Atau, Anda dapat menetapkan variabel lingkungan yang berisi token, lalu meneruskan variabel lingkungan sebagai bagian dari permintaan:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID