Mettez à jour les informations d'un ensemble de données en envoyant une requête HTTP PATCH au point de terminaison ensemble de données de correctif, qui inclut également l'ID de l'ensemble de données:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Vous pouvez mettre à jour l'une ou les deux propriétés displayName et description de l'ensemble de données.
Exemple :
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"La requête renvoie des informations sur l'ensemble de données mis à jour:
{
"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"
}
}
Spécifier un masque de champ
Par défaut, la mise à jour modifie tous les champs compatibles spécifiés dans le corps de la requête, c'est-à-dire displayName et description. Toutefois, vous pouvez également inclure le paramètre de requête updateMask dans la requête pour spécifier explicitement les champs du corps de la requête à mettre à jour.
Utilisez updateMask pour spécifier une liste de noms de champs complets, séparés par une virgule, à mettre à jour. Par exemple, pour ne mettre à jour que le champ 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"La valeur par défaut du paramètre de requête updateMask est *, ce qui signifie que tous les champs compatibles spécifiés dans le corps de la requête sont mis à jour.