Recupera uma lista paginada de todos os dispositivos móveis do usuário em uma conta. Para recuperar uma lista que inclua dispositivos da empresa, use a API Cloud Identity Devices. Esse método expira após 60 minutos. Para saber mais, consulte Resolver problemas com códigos de erro.
Solicitação HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
O ID exclusivo da conta do Google Workspace do cliente. Como administrador da conta, você também pode usar o alias |
Parâmetros de consulta
Parâmetros | |
---|---|
maxResults |
Número máximo de resultados a serem retornados. O valor máximo permitido é 100. |
orderBy |
Propriedade do dispositivo a ser usada para classificar resultados. |
pageToken |
Token para especificar a próxima página da lista |
projection |
Restringir informações retornadas a um conjunto de campos selecionados. |
query |
Pesquise string no formato fornecido em https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
Define se os resultados serão retornados em ordem crescente ou decrescente. Precisa ser usado com o parâmetro |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:
Representação JSON |
---|
{
"kind": string,
"etag": string,
"mobiledevices": [
{
object ( |
Campos | |
---|---|
kind |
Tipo de recurso em questão. |
etag |
ETag do recurso. |
mobiledevices[] |
Uma lista de objetos de dispositivo móvel. |
nextPageToken |
Token usado para acessar a próxima página deste resultado. |
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
https://www.googleapis.com/auth/admin.directory.device.mobile
https://www.googleapis.com/auth/admin.directory.device.mobile.action
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly
Para mais informações, consulte o Guia de autorização.
OrderBy
Enums | |
---|---|
DEVICE_ID |
O número de série de um dispositivo móvel do Google Sync. Para dispositivos Android, é um identificador exclusivo gerado por software. |
EMAIL |
O endereço de e-mail do proprietário do dispositivo. |
LAST_SYNC |
As configurações da última política sincronizam a data e a hora do dispositivo. |
MODEL |
O modelo do dispositivo móvel. |
NAME |
O nome de usuário do proprietário do dispositivo. |
OS |
O sistema operacional do dispositivo |
STATUS |
O status do dispositivo. |
TYPE |
Tipo de dispositivo. |
Projeção
Enums | |
---|---|
BASIC |
Inclui apenas os campos básicos de metadados (por exemplo, deviceId, modelo, status, tipo e status) |
FULL |
Inclui todos os campos de metadados |
SortOrder
Enums | |
---|---|
ASCENDING |
Ordem crescente. |
DESCENDING |
Ordem decrescente. |