필수 요청 매개변수

Maps Datasets API에 요청하려면 다음을 포함해야 합니다.

  • 요청의 X-Goog-User-Project 헤더에 있는 Google Cloud 프로젝트의 번호 또는 ID입니다. 이 값은 결제 및 사용량 할당량 계산에 사용되는 프로젝트를 결정합니다.

  • 요청의 Authorization 헤더에 있는 OAuth 토큰입니다. Maps Datasets API에서 OAuth를 사용하는 방법에 관한 자세한 내용은 OAuth 사용을 참고하세요.

  • 요청 URL의 Google Cloud 프로젝트 번호 또는 ID입니다. 이 값은 데이터 세트가 포함된 프로젝트를 지정합니다. 이 프로젝트는 일반적으로 X-Goog-User-Project 헤더에 지정된 프로젝트와 동일하지만 동일할 필요는 없습니다.

  • 요청 URL의 데이터 세트 ID입니다. 특정 데이터 세트에서 작업을 실행할 때마다 데이터 세트의 ID를 요청 URL의 일부로 전달합니다.

예를 들어 데이터 세트를 삭제하려면 다음 단계를 따르세요.

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

프로젝트 번호 가져오기

Google Cloud 프로젝트의 PROJECT_NUMBER_OR_ID를 가져오는 방법은 다음과 같습니다.

  1. Cloud 콘솔에서 프로젝트의 개요 페이지로 이동합니다.

  2. 메시지가 나타나면 프로젝트를 선택합니다.

  3. 프로젝트 번호프로젝트 ID는 개요 화면의 프로젝트 정보 영역에 표시됩니다.

OAuth 토큰 가져오기

인증을 위해 API 요청의 Authorization 헤더에 OAuth 토큰이 포함되어야 합니다. 자세한 내용은 OAuth 사용을 참고하세요.

예를 들어 다음 gcloud 명령어를 사용하여 토큰을 생성합니다.

gcloud auth application-default print-access-token

위 예와 같이 cURL 명령어의 Authorization 헤더에 gcloud 명령어를 직접 포함하여 각 요청에서 새 토큰을 생성할 수 있습니다.

또는 토큰이 포함된 환경 변수를 설정한 후 환경 변수를 요청의 일부로 전달할 수 있습니다.

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