Method: customers.configurations.patch
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مقادیر فیلد پیکربندی را به روز می کند.
درخواست HTTP
PATCH https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
configuration.name | string فقط خروجی نام منبع API در قالب customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] . توسط سرور اختصاص داده شده است. |
پارامترهای پرس و جو
| مولفه های |
|---|
updateMask | string ( FieldMask format) ضروری. قبل از به‌روزرسانی فیلدها، ماسک فیلد روی Configuration هدف اعمال می‌شود. برای کسب اطلاعات بیشتر در مورد استفاده از فیلد ماسک، FieldMask را در مستندات Protocol Buffers بخوانید. این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
درخواست بدن
بدنه درخواست شامل نمونه ای از Configuration است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Configuration است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidworkzerotouchemm
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis endpoint updates a configuration's field values using a PATCH request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires the \u003ccode\u003econfiguration.name\u003c/code\u003e as a path parameter in the format \u003ccode\u003ecustomers/*/configurations/*\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes \u003ccode\u003eupdateMask\u003c/code\u003e as a required query parameter to specify which fields of the \u003ccode\u003eConfiguration\u003c/code\u003e should be updated, following FieldMask format.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eConfiguration\u003c/code\u003e, and a successful response will also return an instance of \u003ccode\u003eConfiguration\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes updating configuration field values via a PATCH request to a specific URL: `https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}`. The `configuration.name` in the URL is a required path parameter. The `updateMask` query parameter, using FieldMask format, is required to specify which fields to update. The request and response bodies use the `Configuration` resource. Authorization requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nUpdates a configuration's field values.\n\nHTTP request\n\n`PATCH https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `configuration.name` | `string` Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server. |\n\nQuery parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The field mask applied to the target `Configuration` before updating the fields. To learn more about using field masks, read [FieldMask](/protocol-buffers/docs/reference/google.protobuf#fieldmask) in the Protocol Buffers documentation. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\nRequest body\n\nThe request body contains an instance of [Configuration](/zero-touch/reference/customer/rest/v1/customers.configurations#Configuration).\n\nResponse body\n\nIf successful, the response body contains an instance of [Configuration](/zero-touch/reference/customer/rest/v1/customers.configurations#Configuration).\n\nAuthorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
