Method: mobiledevices.list

Recupera uma lista paginada de todos os dispositivos móveis de usuários 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. Saiba mais em 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 conta. O customerId também é retornado como parte do recurso 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 a ser usada para classificar os resultados.

pageToken

string

Token para especificar a próxima página na lista

projection

enum (Projection)

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

query

string

String de pesquisa no formato fornecido em https://developers.google.com/admin-sdk/directory/v1/search-operators

sortOrder

enum (SortOrder)

Define 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 em questão.

etag

string

ETag do recurso.

mobiledevices[]

object (MobileDevice)

Uma lista de objetos de dispositivos móveis.

nextPageToken

string

Token usado para acessar a próxima página deste 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, é um identificador exclusivo gerado por software.
EMAIL Endereço de e-mail do proprietário do dispositivo.
LAST_SYNC Data e hora de sincronização das últimas 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, modelo, status, tipo e status)
FULL Inclui todos os campos de metadados

SortOrder

Enums
ASCENDING Ordem crescente.
DESCENDING Ordem decrescente.