Entitlements

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

Representações de recursos

A presença de um recurso de direitos indica que um usuário tem o direito de usar um app específico. Os direitos são específicos do usuário, não do dispositivo. Isso permite que um usuário com direito de acesso ao app o instale em todos os dispositivos. Também é possível que um usuário tenha direito de acesso a um app sem instalá-lo em qualquer dispositivo.

A API pode ser usada para criar um direito. Como opção, também é possível usar a API para acionar a instalação de um app em todos os dispositivos gerenciados do usuário ao mesmo tempo em que o direito é criado.

Se o app for sem custo financeiro, a criação do direito também criará uma licença de grupo para ele. No caso de apps pagos, a criação do direito consome uma licença, que permanece consumida até que o direito seja removido. Se a empresa não tiver adquirido licenças suficientes, nenhum direito será criado e a instalação falhará. Um direito também não será criado para um app se ele exigir permissões não aceitas pela empresa.

Se um direito for excluído, o app poderá ser desinstalado do dispositivo do usuário. Como prática recomendada, desinstale o app chamando Installs.delete() antes de excluir o direito de acesso.

Os direitos de apps pagos por um usuário em um perfil não gerenciado têm "userPurchase" como motivo do direito. Esses direitos não podem ser removidos usando a API.

{
  "kind": "androidenterprise#entitlement",
  "productId": string,
  "reason": string
}
Nome da propriedade Valor Descrição Observações
kind string
productId string O ID do produto relacionado ao direito. Por exemplo, "app:com.google.android.gm".
reason string O motivo do direito. Por exemplo, "free" para apps sem custo financeiro. Esta propriedade é temporária: ela será substituída pelo campo acquisition kind de licenças de grupo.

Os valores aceitáveis são os seguintes:
  • "free"
  • "groupLicense"
  • "userPurchase"

Métodos

delete
Remove o direito de um usuário a um app.
get
Recupera detalhes de um direito.
list
Lista todos os direitos do usuário especificado. Apenas o ID é definido.
update
Adiciona ou atualiza um direito de um app para um usuário.