Method: mobiledevices.list

Recupera uma lista paginada de todos os dispositivos móveis de um usuário de uma conta. Para recuperar uma lista que inclui dispositivos da empresa, use a API Devices do Cloud Identity. Esse método expira após 60 minutos. Para mais informações, 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

string

O ID exclusivo da conta do Google Workspace do cliente. Como administrador da conta, você também pode usar o alias my_customer para representar o customerId da sua conta. O customerId também é retornado como parte do recurso de usuários.

Parâmetros de consulta

Parâmetros
maxResults

integer

Número máximo de resultados a serem retornados. O valor máximo permitido é 100.
orderBy

enum (OrderBy)

Propriedade do dispositivo que será usada para classificar os resultados.
pageToken

string

Token para especificar a próxima página da lista
projection

enum (Projection)

Restringir informações retornadas a um conjunto de campos selecionados.
query

string

String de pesquisa no formato indicado em https://developers.google.com/workspace/admin/directory/v1/search-operators
sortOrder

enum (SortOrder)

Se os resultados serão retornados em ordem crescente ou decrescente. Precisa ser usado com o parâmetro orderBy.

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 (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Tipo de recurso.
etag

string

ETag do recurso.
mobiledevices[]

object (MobileDevice)

Uma lista de objetos de dispositivo móvel.
nextPageToken

string

Token usado para acessar a próxima página desse resultado.

Escopos de autorização

Requer um dos seguintes escopos do 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, esse é um identificador exclusivo gerado por software.
EMAIL O endereço de e-mail do proprietário do dispositivo.
LAST_SYNC Data e hora da última sincronização das configurações da política 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 de metadados básicos (por exemplo, deviceId, model, status, type e status)
FULL Inclui todos os campos de metadados

SortOrder

Enums
ASCENDING Ordem crescente.
DESCENDING Ordem decrescente.