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

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