데이터 세트 업데이트

데이터 세트의 ID도 포함하는 patch dataset 엔드포인트에 HTTP PATCH 요청을 전송하여 데이터 세트에 관한 정보를 업데이트합니다.

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

데이터 세트의 displayName 및 description 속성 중 하나 또는 둘 다를 업데이트할 수 있습니다.

예를 들면 다음과 같습니다.

curl -X PATCH -d '{
    "displayName": "My Updated Dataset",
    "description": "This is an updated description"
  }' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  "https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46"

요청은 업데이트된 데이터 세트에 관한 정보를 반환합니다.

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
  "displayName": "My Updated Dataset",
  "description": "This is an updated description",
  "versionId": "5fb3b84e-1405-4ecd-8f81-9183631f1c07",
  "usage": [
    "USAGE_DATA_DRIVEN_STYLING"
  ],
  "gcsSource": {
    "inputUri": "gs://mybucket/my.csv",
    "fileFormat": "FILE_FORMAT_CSV"
  },
  "createTime": "2023-03-24T14:47:37.308977Z",
  "updateTime": "2023-03-28T15:17:17.919351Z",
  "versionCreateTime": "2023-03-24T14:48:05.053114Z",
  "status": {
    "state": "STATE_COMPLETED"
  }
}

필드 마스크 지정

기본적으로 업데이트는 요청 본문에 지정된 지원되는 모든 필드(displayName 및 description 모두)를 수정합니다. 하지만 요청에 updateMask 쿼리 매개변수를 포함하여 업데이트할 요청 본문의 필드를 명시적으로 지정할 수도 있습니다.

updateMask를 사용하여 업데이트할 필드의 정규화된 이름을 쉼표로 구분한 목록을 지정합니다. 예를 들어 displayName 필드만 업데이트하려면 다음을 실행합니다.

curl -X PATCH -d '{
    "displayName": "My Updated Dataset",
    "description": "This is an updated description"
  }' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  "https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46?updateMask=displayName"

updateMask 쿼리 매개변수의 기본값은 *입니다. 즉, 요청 본문에 지정된 지원되는 모든 필드를 업데이트합니다.