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 menghapus header X-Goog-User-Project. Untuk informasi selengkapnya tentang akun layanan, lihat Autentikasi 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 di header X-Goog-User-Project, project ini 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 Ringkasan project di Cloud Console.

2. Jika diminta, pilih project Anda.

3. Nomor project dan Project ID muncul di area Project info di layar ringkasan.

Mendapatkan token OAuth

Catatan: Prosedur di bawah untuk membuat token OAuth tidak dimaksudkan untuk digunakan di 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 pada setiap permintaan, seperti yang 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