Thông số yêu cầu bắt buộc

Để đưa ra bất kỳ yêu cầu nào đối với API Quản lý bản đồ, bạn phải bao gồm:

  • Số hoặc mã dự án trên đám mây Google Cloud của bạn trong tiêu đề X-Goog-User-Project của yêu cầu. Giá trị này xác định dự án dùng để tính toán hạn mức sử dụng và lập hoá đơn.

  • Mã thông báo OAuth trong tiêu đề Authorization của yêu cầu. Để biết thêm thông tin về cách sử dụng OAuth với API Quản lý bản đồ, hãy xem bài viết Sử dụng OAuth.

  • Số hoặc mã dự án trên đám mây của Google Cloud trong URL yêu cầu. Giá trị này chỉ định dự án chứa tập dữ liệu. Mặc dù dự án này thường giống với dự án được chỉ định trong tiêu đề X-Goog-User-Project, nhưng không bắt buộc phải giống.

  • Mã tập dữ liệu trong URL yêu cầu. Bất cứ khi nào thực hiện một thao tác trên một tập dữ liệu cụ thể, bạn sẽ truyền mã của tập dữ liệu đó dưới dạng một phần của URL yêu cầu.

Ví dụ: để xoá một tập dữ liệu:

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

Lấy số dự án

Cách lấy PROJECT_NUMBER_OR_ID của dự án trên đám mây của Google Cloud:

  1. Chuyển đến trang Tổng quan của dự án trong bảng điều khiển Cloud.

  2. Nếu được nhắc, hãy chọn dự án của bạn.

  3. Số dự án và Mã dự án xuất hiện trong vùng Thông tin dự án của màn hình tổng quan.

Lấy mã thông báo OAuth

Để xác thực, yêu cầu API phải chứa mã thông báo OAuth trong tiêu đề Authorization. Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth.

Ví dụ: sử dụng lệnh gcloud sau để tạo mã thông báo:

gcloud auth application-default print-access-token

Bạn có thể đưa trực tiếp lệnh gcloud vào tiêu đề Authorization trong lệnh cURL để tạo mã thông báo mới trên mỗi yêu cầu, như trong ví dụ ở trên.

Ngoài ra, bạn có thể đặt một biến môi trường chứa mã thông báo, sau đó truyền biến môi trường đó dưới dạng một phần của yêu cầu:

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