อัปเดตชุดข้อมูล

อัปเดตข้อมูลเกี่ยวกับชุดข้อมูลโดยส่งคำขอ HTTP PATCH ไปยังปลายทางชุดข้อมูลแพตช์ ซึ่งมีรหัสของชุดข้อมูลด้วยเช่นกัน

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

คุณจะอัปเดตพร็อพเพอร์ตี้ displayName และ description ของชุดข้อมูลอย่างใดอย่างหนึ่งหรือทั้ง 2 อย่างก็ได้ เช่น

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 คือ * หมายความว่าอัปเดตช่องที่รองรับทั้งหมดที่ระบุไว้ในเนื้อหาคําขอ