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

Để gửi bất kỳ yêu cầu nào đến API Tập dữ liệu Maps, bạn phải cung cấp:

• Số lượng hoặc mã dự án của bạn trên Google Cloud 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 để thanh toán và tính toán hạn mức sử dụng.

  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ề các tài khoản dịch vụ, xem 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 API Tập dữ liệu Maps, hãy xem phần Sử dụng OAuth.

• Mã hoặc số 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 đã chỉ định trong tiêu đề X-Goog-User-Project, không bắt buộc phải giống nhau.

• Mã 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 hành động trên một tập dữ liệu cụ thể, bạn truyền mã nhận dạng của tập dữ liệu dưới dạng một phần của URL yêu cầu.

Lưu ý: Một số yêu cầu cần có thêm tham số được mô tả trong tài liệu về các 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 tải PROJECT_NUMBER_OR_ID của dự án Google Cloud:

1. Chuyển đến Trang tổng quan trong Cloud Console.

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 khu vực 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 dưới đây để tạo mã thông báo OAuth không nhằm mục đích sử dụng trong môi trường sản xuất. Sử dụng quy trình này cho quá trình phát triển hoặc kiểm thử môi trường.

Để 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 bài viết Sử dụng OAuth.

Ví dụ: hãy sử 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 đó vào 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