Aby zaktualizować informacje o zbiorze danych, wyślij żądanie HTTP PATCH do punktu końcowego zbioru danych poprawki, który zawiera też identyfikator zbioru danych:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Możesz zaktualizować jedną lub obie właściwości zbioru danych: displayName i description.
Na przykład:
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
Żądanie zwraca informacje o zaktualizowanym zbiorze danych:
{
"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"
}
}
Określ maskę pola
Domyślnie aktualizacja modyfikuje wszystkie obsługiwane pola określone w treści żądania, czyli zarówno displayName, jak i description. Możesz jednak uwzględnić w żądaniu parametr zapytania updateMask, aby jednoznacznie określić pola w treści żądania, które mają zostać zaktualizowane.
Użyj updateMask, aby podać oddzieloną przecinkami listę w pełni kwalifikowanych nazw pól do zaktualizowania. Aby na przykład zaktualizować tylko pole 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
Wartość domyślna parametru zapytania updateMask to *. Oznacza to, że zaktualizuj wszystkie obsługiwane pola określone w treści żądania.