REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Um token para iniciar a migração de um dispositivo gerenciado por um DPC de terceiros para a API Android Management. Um token de migração é válido apenas para um dispositivo. Para mais detalhes, consulte o guia.

Representação JSON 
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
Campos
name

string

Apenas saída. O nome do token de migração, que é gerado pelo servidor durante a criação, no formato enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Apenas saída. O valor do token de migração.
createTime

string (Timestamp format)

Apenas saída. Hora em que esse token de migração foi criado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
userId

string

Obrigatório. Imutável. O ID do usuário da conta do Google Play gerenciado no dispositivo, como na API Play EMM. Isso corresponde ao parâmetro userId na chamada Devices.get da API Play EMM.
deviceId

string

Obrigatório. Imutável. O código do dispositivo, como na API Play EMM. Isso corresponde ao parâmetro deviceId na chamada Devices.get da API Play EMM.
managementMode

enum (ManagementMode)

Obrigatório. Imutável. O modo de gerenciamento do dispositivo ou perfil que está sendo migrado.
policy

string

Obrigatório. Imutável. O nome da política aplicado inicialmente ao dispositivo registrado, no formato enterprises/{enterprise}/policies/{policy}.
additionalData

string

Imutável. Outros dados opcionais especificados pelo EMM Depois que o dispositivo for migrado, isso será preenchido no campo migrationAdditionalData do recurso "Dispositivo". Precisa ter no máximo 1.024 caracteres.
device

string

Apenas saída. Depois que esse token for usado para migrar um dispositivo, o nome do recurso Device resultante será preenchido aqui, no formato enterprises/{enterprise}/devices/{device}.

Campo de união expiration.

expiration pode ser apenas de um dos tipos a seguir:
expireTime

string (Timestamp format)

Imutável. A hora em que esse token de migração expira. Esse período pode ser de, no máximo, sete dias a partir do momento da criação. O token de migração é excluído sete dias depois de expirar.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Apenas entrada. O horário de validade deste token de migração. É apenas para entrada. Para retornar um token de migração, o servidor vai preencher o campo expireTime. Esse período pode ser no máximo sete dias. O padrão é sete dias.

Uma duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

ManagementMode

O modo de gerenciamento do dispositivo ou perfil que está sendo migrado.

Enums
MANAGEMENT_MODE_UNSPECIFIED Esse valor não pode ser usado.
WORK_PROFILE_PERSONALLY_OWNED Um perfil de trabalho em um dispositivo pessoal Compatível apenas com dispositivos que executam o Android 9 e versões mais recentes.
WORK_PROFILE_COMPANY_OWNED Um perfil de trabalho em um dispositivo da empresa Com suporte apenas em dispositivos com Android 11 e versões mais recentes.
FULLY_MANAGED Um dispositivo totalmente gerenciado Compatível apenas com dispositivos que executam o Android 9 e versões mais recentes.

Métodos

create

 Cria um token de migração para migrar um dispositivo que já é gerenciado pelo controlador de política de dispositivo (DPC) do EMM para o gerenciamento da API Android Management.

get

 Recebe um token de migração.

list

 Lista os tokens de migração.