데이터 세트 업데이트

HTTP PATCH 요청을 다음으로 전송하여 데이터 세트에 대한 정보를 업데이트합니다. 패치 데이터 세트 엔드포인트 데이터 세트의 ID도 포함됩니다.

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

displayNamedescription 속성 중 하나 또는 둘 다 업데이트할 수 있습니다. 데이터 세트입니다.

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

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"
  }
}

필드 마스크 지정

기본적으로 업데이트는 본문에 지정된 지원되는 모든 필드를 수정합니다. 즉, displayNamedescription를 의미합니다. 하지만 Cloud Shell에서 에는 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 쿼리 매개변수의 기본값은 *이며 다음을 의미합니다. 요청 본문에 지정된 모든 지원되는 필드를 업데이트합니다.