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 des propriétés displayName
et description
de l'ensemble de données, ou les deux.
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 updateMask
dans la requête pour spécifier explicitement les champs à mettre à jour dans le corps de la requête.
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.