Installs

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

A existência de um recurso de instalações indica que um app está instalado em um dispositivo específico (ou que uma instalação está pendente).

A API pode ser usada para criar um recurso de instalação usando o método update. Isso aciona a instalação real do app no dispositivo. Se o usuário ainda não tiver a titularidade do app, será feita uma tentativa de criar um. Se isso falhar (por exemplo, porque o app não é sem custo financeiro e não há licença disponível), a criação da instalação vai falhar.

A API também pode ser usada para atualizar um app instalado. Se o método update for usado em uma instalação já existente, o app será atualizado para a versão mais recente disponível.

Não é possível forçar a instalação de uma versão específica de um app, porque o código da versão é somente leitura.

Se o próprio usuário instalar um app (conforme permitido pela empresa), um recurso de instalação e, possivelmente, um recurso de direito serão criados automaticamente.

A API também pode ser usada para excluir um recurso de instalação, o que aciona a remoção do app do dispositivo. A exclusão de uma instalação não remove automaticamente o direito correspondente, mesmo que não haja mais instalações. O recurso de instalação também será excluído se o usuário desinstalar o app.

{
  "kind": "androidenterprise#install",
  "productId": string,
  "versionCode": integer,
  "installState": string
}
Nome da propriedade Valor Descrição Observações
installState string Estado de instalação. O estado "installPending" significa que uma solicitação de instalação foi feita recentemente e que o download no dispositivo está em andamento. O estado "installed" significa que o app foi instalado. Este campo é somente leitura.

Os valores aceitáveis são os seguintes:
  • "installPending"
  • "installed"
kind string
productId string O ID do produto referente à instalação. Por exemplo, "app:com.google.android.gm".
versionCode integer A versão do produto instalado. É garantido que seja definido apenas se o estado de instalação for "installed".

Métodos

excluir
Solicita a remoção de um app de um dispositivo. Uma chamada para get ou list ainda vai mostrar o app como instalado no dispositivo até que ele seja realmente removido.
get
Recupera detalhes da instalação de um app em um dispositivo.
list
Recupera os detalhes de todos os apps instalados no dispositivo especificado.
update
Solicita a instalação da versão mais recente de um app em um dispositivo. Se o app já estiver instalado, ele será atualizado para a versão mais recente, se necessário.