Method: partners.devices.findByOwner
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
고객에게 소유권 주장이 제기된 기기를 찾습니다. 결과에는 partnerId 인수로 식별되고 리셀러에게 등록된 기기만 포함됩니다. 다른 리셀러에서 구매한 고객의 기기는 결과에 표시되지 않습니다.
HTTP 요청
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
partnerId |
string (int64 format)
필수 항목입니다. 리셀러 파트너의 ID입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| JSON 표현 |
{
"pageToken": string,
"limit": string,
"sectionType": enum (DeviceProvisioningSectionType),
"customerId": [
string
],
"googleWorkspaceCustomerId": [
string
]
} |
| 필드 |
pageToken |
string
반환할 결과 페이지를 지정하는 토큰입니다.
|
limit |
string (int64 format)
필수 항목입니다. 검색결과 페이지에 표시할 최대 기기 수입니다. 1~100(포함) 사이여야 합니다.
|
sectionType |
enum (DeviceProvisioningSectionType)
필수 항목입니다. 기기 프로비저닝 레코드의 섹션 유형입니다.
|
customerId[] |
string (int64 format)
검색할 고객 ID 목록입니다.
|
googleWorkspaceCustomerId[] |
string
검색할 Google Workspace 계정의 ID 목록입니다.
|
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
| JSON 표현 |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| 필드 |
devices[] |
object (Device)
고객의 기기
|
nextPageToken |
string
결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. 추가 결과가 없으면 생략됩니다.
|
totalSize |
integer
페이지로 나누기와 상관없이 목록에 포함된 전체 항목 수입니다.
|
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidworkprovisioning
자세한 내용은 OAuth 2.0 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 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 endpoint finds devices claimed by customers, specifically those registered to the reseller identified by the \u003ccode\u003epartnerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e method to \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner\u003c/code\u003e, utilizing gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires parameters such as \u003ccode\u003elimit\u003c/code\u003e, and \u003ccode\u003esectionType\u003c/code\u003e, and includes optional fields for filtering by \u003ccode\u003ecustomerId\u003c/code\u003e and \u003ccode\u003egoogleWorkspaceCustomerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response body returns a list of \u003ccode\u003edevices\u003c/code\u003e, and information about pagination through \u003ccode\u003enextPageToken\u003c/code\u003e, along with the \u003ccode\u003etotalSize\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes an API endpoint to find devices claimed by customers, specifically those registered to a given reseller. The API uses a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner`, with `partnerId` specifying the reseller. The request body requires a page limit, section type, and optional customer IDs and/or google workspace id to search by. The response contains a list of devices, a next page token if more results are available, and total size. OAuth scope `https://www.googleapis.com/auth/androidworkprovisioning` is needed.\n"],null,["# Method: partners.devices.findByOwner\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 - [JSON representation](#body.FindDevicesByOwnerResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nFinds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the `partnerId` argument. The customer's devices purchased from other resellers don't appear in the results.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner`\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 ID of the reseller partner. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pageToken\": string, \"limit\": string, \"sectionType\": enum (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType), \"customerId\": [ string ], \"googleWorkspaceCustomerId\": [ string ] } ``` |\n\n| Fields ||\n|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageToken` | `string` A token specifying which result page to return. |\n| `limit` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive. |\n| `sectionType` | `enum (`[DeviceProvisioningSectionType](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType)`)` Required. The section type of the device's provisioning record. |\n| `customerId[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The list of customer IDs to search for. |\n| `googleWorkspaceCustomerId[]` | `string` The list of IDs of Google Workspace accounts to search for. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse containing found devices.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.devices#Device) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/zero-touch/reference/reseller/rest/v1/partners.devices#Device)`)` The customer's devices. |\n| `nextPageToken` | `string` A token used to access the next page of results. Omitted if no further results are available. |\n| `totalSize` | `integer` The total count of items in the list irrespective of pagination. |\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)."]]
