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 penagihan dan penghitungan kuota penggunaan.

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

  • ID atau nomor 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, project tersebut tidak harus sama.

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

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 Cloud Console.

  2. Jika diminta, pilih project Anda.

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

Mendapatkan token OAuth

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 secara langsung di header Authorization dalam perintah cURL untuk membuat token baru pada setiap permintaan, seperti yang ditunjukkan dalam contoh di atas.

Atau, Anda dapat menetapkan variabel lingkungan yang berisi token, lalu meneruskan variabel lingkungan tersebut 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