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

Để đưa ra yêu cầu cho Map Management API, bạn phải thêm:

• Số hoặc mã nhận dạng dự án 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 được dùng để tính toán hạn mức sử dụng và lập hoá đơn.

  Lưu ý: Nếu đang sử dụng tài khoản dịch vụ để xác thực, bạn có thể bỏ qua tiêu đề X-Goog-User-Project. Để biết thêm thông tin về tài khoản dịch vụ, hãy xem phần Xác thực tại Google.

• 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 Map Management API, hãy xem phần Sử dụng OAuth.

• Số dự án hoặc mã dự án trên 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 bạn không bắt buộc phải sử dụng cùng một dự án.

• Mã nhận dạng tập dữ liệu trong URL yêu cầu. Bất cứ khi nào bạn 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ã nhận dạng của tập dữ liệu đó trong URL yêu cầu.

Lưu ý: Một số yêu cầu cần có các tham số bổ sung được mô tả trong tài liệu về những yêu cầu đó.

Ví dụ: cách 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 Google Cloud:

1. Chuyển đến trang Tổng quan của dự án trong Cloud Console.

2. Nếu thấy lời 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 phần Thông tin dự án của màn hình tổng quan.

Nhận mã thông báo OAuth

Lưu ý: Quy trình bên dưới để tạo mã thông báo OAuth không dành cho việc sử dụng trong môi trường phát hành chính thức. Chỉ sử dụng quy trình này cho môi trường phát triển hoặc kiểm thử.

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

Ví dụ: hãy dùng lệnh gcloud sau đây để tạo mã thông báo:

gcloud auth application-default print-access-token

Bạn có thể đưa lệnh gcloud trực tiếp vào tiêu đề Authorization trong lệnh cURL để tạo mã thông báo mới cho mỗi yêu cầu, như minh hoạ 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 đó trong 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