데이터 세트의 ID도 포함된 패치 데이터 세트 엔드포인트에 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 쿼리 매개변수의 기본값은 *이며 요청 본문에 지정된 모든 지원 필드를 업데이트합니다.