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

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