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

اطلاعات مربوط به یک مجموعه داده را با ارسال یک درخواست 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 . با این حال، شما همچنین می توانید پارامتر query 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

مقدار پیش فرض پارامتر query updateMask * است به این معنی که تمام فیلدهای پشتیبانی شده مشخص شده در بدنه درخواست را به روز کنید.