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

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