עדכון מערך נתונים

מעדכנים את המידע על מערך נתונים על ידי שליחה של בקשת HTTP PATCH לנקודת הקצה של patch dataset, שכוללת גם את המזהה של מערך הנתונים:

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 הוא *, כלומר עדכון כל השדות הנתמכים שצוינו בגוף הבקשה.