Method: partners.devices.findByOwner
Находит устройства, заявленные для клиентов. Результаты содержат только устройства, зарегистрированные у торгового посредника, определенного аргументом partnerId
. Устройства клиента, приобретенные у других реселлеров, не отображаются в результатах.
HTTP-запрос
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
partnerId | string ( int64 format) Необходимый. Идентификатор партнера-посредника. |
Тело запроса
Тело запроса содержит данные следующей структуры:
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) Список идентификаторов клиентов для поиска. |
googleWorkspaceCustomerId[] | string Список идентификаторов аккаунтов Google Workspace для поиска. |
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
Ответ, содержащий найденные устройства.
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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-09 UTC.
[null,null,["Последнее обновление: 2024-11-09 UTC."],[[["This API endpoint finds devices claimed by customers, specifically those registered to the reseller identified by the `partnerId`."],["The HTTP request is a `POST` method to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner`, utilizing gRPC Transcoding syntax."],["The request body requires parameters such as `limit`, and `sectionType`, and includes optional fields for filtering by `customerId` and `googleWorkspaceCustomerId`."],["The response body returns a list of `devices`, and information about pagination through `nextPageToken`, along with the `totalSize`."],["Authorization for this API requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope."]]],["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"]]