به‌روزرسانی مجموعه داده

با ارسال درخواست HTTP PATCH به نقطه پایانی مجموعه داده وصله که شامل شناسه مجموعه داده نیز می‌شود، اطلاعات مربوط به مجموعه داده را به‌روز کنید:

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‏ * است، یعنی همه فیلدهای پشتیبانی‌شده مشخص‌شده در بدنه درخواست به‌روزرسانی شوند.