Method: partners.devices.updateMetadataAsync
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis page details how to asynchronously update reseller metadata for a batch of devices using the Android Device Provisioning Partner API.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePOST\u003c/code\u003e request is made to a specific URL with a required \u003ccode\u003epartnerId\u003c/code\u003e in the path, using gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a JSON object that specifies the list of metadata updates to be applied using the \u003ccode\u003eUpdateMetadataArguments\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003eUpdateMetadataArguments\u003c/code\u003e entry must include the \u003ccode\u003edeviceMetadata\u003c/code\u003e to be updated, as well as a device identifier, whether through a \u003ccode\u003edeviceIdentifier\u003c/code\u003e object or a \u003ccode\u003edeviceId\u003c/code\u003e string.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e OAuth scope for authorization, and a successful response returns an \u003ccode\u003eOperation\u003c/code\u003e instance to monitor the progress.\u003c/p\u003e\n"]]],["This describes an asynchronous API method for updating reseller metadata on multiple devices. It uses a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:updateMetadataAsync`, requiring a `partnerId` path parameter. The request body needs an array of `updates`, each with device-specific metadata, identified by either `deviceIdentifier` or `deviceId`. The `Operation` object tracks progress for these metadata modifications, which requires the `https://www.googleapis.com/auth/androidworkprovisioning` authorization scope.\n"],null,["# Method: partners.devices.updateMetadataAsync\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [UpdateMetadataArguments](#UpdateMetadataArguments)\n - [JSON representation](#UpdateMetadataArguments.SCHEMA_REPRESENTATION)\n\nUpdates the reseller metadata attached to a batch of devices. This method updates devices asynchronously and returns an `Operation` that can be used to track progress. Read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:updateMetadataAsync`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The reseller partner ID. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"updates\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.devices/updateMetadataAsync#UpdateMetadataArguments) } ] } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updates[]` | `object (`[UpdateMetadataArguments](/zero-touch/reference/reseller/rest/v1/partners.devices/updateMetadataAsync#UpdateMetadataArguments)`)` Required. The list of metadata updates. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/zero-touch/reference/reseller/rest/v1/operations#Operation).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nUpdateMetadataArguments\n-----------------------\n\nIdentifies metadata updates to one device.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"deviceMetadata\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceMetadata) }, // Union field `device` can be only one of the following: \"deviceIdentifier\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier) }, \"deviceId\": string // End of list of possible types for union field `device`. } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|---|\n| `deviceMetadata` | `object (`[DeviceMetadata](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceMetadata)`)` Required. The metadata to update. |\n| Union field `device`. Required. The device to update. `device` can be only one of the following: |||\n| `deviceIdentifier` | `object (`[DeviceIdentifier](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier)`)` Required. Device identifier. |\n| `deviceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. Device ID of the device. |"]]
