Aby zaktualizować informacje o zbiorze danych, wyślij żądanie HTTP PATCH do punktu końcowego patch dataset, który zawiera również identyfikator zbioru danych:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Możesz zaktualizować właściwości displayName i description w danych zbiorów.
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ślanie maski pola
Domyślnie aktualizacja modyfikuje wszystkie obsługiwane pola określone w ciele żądania, czyli zarówno displayName, jak i description. Możesz też dodać parametr zapytania updateMask, aby wprost określić pola w treści żądania, które mają zostać zaktualizowane.
Użyj parametru updateMask, aby podać listę oddzieloną przecinkami pełnych i jednoznacznych nazw pól, które mają zostać zaktualizowane. 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"
Domyślna wartość parametru zapytania updateMask to *, co oznacza zaktualizowanie wszystkich obsługiwanych pól określonych w ciele żądania.