Parameter permintaan yang diperlukan

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

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

  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 selengkapnya informasi tentang cara menggunakan OAuth dengan Maps Datasets API, lihat Gunakan 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, project ini tidak harus sama.

• ID set data di URL permintaan. Setiap kali Anda melakukan tindakan pada {i>dataset<i} tertentu, Anda meneruskan ID {i>dataset<i} sebagai bagian dari URL permintaan.

Catatan: Beberapa permintaan memerlukan parameter tambahan yang dijelaskan dalam dokumentasi terkait 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 dokumen Halaman Ringkasan di Konsol Cloud.

2. Jika diminta, pilih project Anda.

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

Mendapatkan token OAuth

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

Untuk autentikasi, permintaan API Anda harus berisi token OAuth di bagian 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 menghasilkan token baru di setiap permintaan, seperti yang ditunjukkan pada 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