Android Device Provisioning Partner API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 API를 사용하면 기기 리셀러가 제로터치 등록을 프로그래매틱 방식으로 관리할 수 있습니다.
서비스: androiddeviceprovision.googleapis.com
이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.
검색 문서
검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://androiddeviceprovisioning.googleapis.com
| 메서드 |
get |
GET /v1/{name=operations/**}
장기 실행 작업의 최신 상태를 가져옵니다. |
| 메서드 |
create |
POST /v1/{parent=partners/*}/customers(
)
제로터치 등록을 위한 고객을 만듭니다. |
list |
GET /v1/partners/{partnerId}/customers(
)
partnerId 인수로 식별되는 리셀러에 등록된 고객을 나열합니다. |
| 메서드 |
claim |
POST /v1/partners/{partnerId}/devices:claim(
)
고객의 기기 소유권을 주장하고 기기를 제로터치 등록에 추가합니다. |
claimAsync |
POST /v1/partners/{partnerId}/devices:claimAsync(
)
비동기식으로 고객의 기기 배치에 대한 소유권을 주장합니다. |
findByIdentifier |
POST /v1/partners/{partnerId}/devices:findByIdentifier(
)
IMEI와 같은 하드웨어 식별자로 기기를 찾습니다. |
findByOwner |
POST /v1/partners/{partnerId}/devices:findByOwner(
)
고객에게 소유권 주장이 제기된 기기를 찾습니다. |
get |
GET /v1/{name=partners/*/devices/*}(
)
기기를 가져옵니다. |
metadata |
POST /v1/partners/{metadataOwnerId}/devices/{deviceId}/metadata(
)
기기와 연결된 리셀러 메타데이터를 업데이트합니다. |
unclaim |
POST /v1/partners/{partnerId}/devices:unclaim(
)
고객으로부터 기기 소유권 주장을 취소하고 제로터치 등록에서 기기를 삭제합니다. |
unclaimAsync |
POST /v1/partners/{partnerId}/devices:unclaimAsync(
)
비동기식으로 고객의 기기 배치에 대한 소유권 주장을 취소합니다. |
updateMetadataAsync |
POST /v1/partners/{partnerId}/devices:updateMetadataAsync(
)
기기 배치에 연결된 리셀러 메타데이터를 업데이트합니다. |
| 메서드 |
list |
GET /v1/{parent=partners/*}/vendors(
)
파트너의 공급업체를 나열합니다. |
| 메서드 |
list |
GET /v1/{parent=partners/*/vendors/*}/customers(
)
공급업체의 고객을 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis API empowers device resellers to manage zero-touch enrollment programmatically.\u003c/p\u003e\n"],["\u003cp\u003eThe API's resources include operations, partners' customers, partners' devices, partners' vendors, and partners' vendors' customers, enabling management of various aspects of the enrollment process.\u003c/p\u003e\n"],["\u003cp\u003eThe API service endpoint is \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com\u003c/code\u003e, and all resource URIs are relative to this address.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports multiple methods like creating, listing, claiming, unclaiming, and finding devices or customers, all tailored for managing zero-touch enrollment.\u003c/p\u003e\n"],["\u003cp\u003eThis API offers a machine-readable specification for describing REST APIs, for building client libraries and other tools using the provided discovery document.\u003c/p\u003e\n"]]],["This API allows resellers to manage zero-touch enrollment for devices. Key actions include creating and listing customers, claiming and unclaimed devices, and finding devices by identifiers or owner. Resellers can also update device metadata. The API provides asynchronous options for batch device operations. It also allows listing a partner's vendors and a vendor's customers. Operations are available to get the latest state of long-running tasks. The service has a discovery document and a service endpoint.\n"],null,["# Android Device Provisioning Partner API\n\nThis API lets device resellers programmatically manage zero-touch enrollment.\n\n- [REST Resource: v1.operations](#v1.operations)\n- [REST Resource: v1.partners.customers](#v1.partners.customers)\n- [REST Resource: v1.partners.devices](#v1.partners.devices)\n- [REST Resource: v1.partners.vendors](#v1.partners.vendors)\n- [REST Resource: v1.partners.vendors.customers](#v1.partners.vendors.customers)\n\nService: androiddeviceprovisioning.googleapis.com\n-------------------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://androiddeviceprovisioning.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://androiddeviceprovisioning.googleapis.com`\n\nREST Resource: [v1.operations](/zero-touch/reference/reseller/rest/v1/operations)\n---------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------|-----------------------------------------------------------------------------------|\n| [get](/zero-touch/reference/reseller/rest/v1/operations/get) | `GET /v1/{name=operations/**}` Gets the latest state of a long-running operation. |\n\nREST Resource: [v1.partners.customers](/zero-touch/reference/reseller/rest/v1/partners.customers)\n-------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| [create](/zero-touch/reference/reseller/rest/v1/partners.customers/create) | `POST /v1/{parent=partners/*}/customers` Creates a customer for zero-touch enrollment. |\n| [list](/zero-touch/reference/reseller/rest/v1/partners.customers/list) | `GET /v1/partners/{partnerId}/customers` Lists the customers that are enrolled to the reseller identified by the `partnerId` argument. |\n\nREST Resource: [v1.partners.devices](/zero-touch/reference/reseller/rest/v1/partners.devices)\n---------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [claim](/zero-touch/reference/reseller/rest/v1/partners.devices/claim) | `POST /v1/partners/{partnerId}/devices:claim` Claims a device for a customer and adds it to zero-touch enrollment. |\n| [claimAsync](/zero-touch/reference/reseller/rest/v1/partners.devices/claimAsync) | `POST /v1/partners/{partnerId}/devices:claimAsync` Claims a batch of devices for a customer asynchronously. |\n| [findByIdentifier](/zero-touch/reference/reseller/rest/v1/partners.devices/findByIdentifier) | `POST /v1/partners/{partnerId}/devices:findByIdentifier` Finds devices by hardware identifiers, such as IMEI. |\n| [findByOwner](/zero-touch/reference/reseller/rest/v1/partners.devices/findByOwner) | `POST /v1/partners/{partnerId}/devices:findByOwner` Finds devices claimed for customers. |\n| [get](/zero-touch/reference/reseller/rest/v1/partners.devices/get) | `GET /v1/{name=partners/*/devices/*}` Gets a device. |\n| [metadata](/zero-touch/reference/reseller/rest/v1/partners.devices/metadata) | `POST /v1/partners/{metadataOwnerId}/devices/{deviceId}/metadata` Updates reseller metadata associated with the device. |\n| [unclaim](/zero-touch/reference/reseller/rest/v1/partners.devices/unclaim) | `POST /v1/partners/{partnerId}/devices:unclaim` Unclaims a device from a customer and removes it from zero-touch enrollment. |\n| [unclaimAsync](/zero-touch/reference/reseller/rest/v1/partners.devices/unclaimAsync) | `POST /v1/partners/{partnerId}/devices:unclaimAsync` Unclaims a batch of devices for a customer asynchronously. |\n| [updateMetadataAsync](/zero-touch/reference/reseller/rest/v1/partners.devices/updateMetadataAsync) | `POST /v1/partners/{partnerId}/devices:updateMetadataAsync` Updates the reseller metadata attached to a batch of devices. |\n\nREST Resource: [v1.partners.vendors](/zero-touch/reference/reseller/rest/v1/partners.vendors)\n---------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------|-------------------------------------------------------------------------|\n| [list](/zero-touch/reference/reseller/rest/v1/partners.vendors/list) | `GET /v1/{parent=partners/*}/vendors` Lists the vendors of the partner. |\n\nREST Resource: [v1.partners.vendors.customers](/zero-touch/reference/reseller/rest/v1/partners.vendors.customers)\n-----------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|\n| [list](/zero-touch/reference/reseller/rest/v1/partners.vendors.customers/list) | `GET /v1/{parent=partners/*/vendors/*}/customers` Lists the customers of the vendor. |"]]
