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 a um app instale o app em todos os dispositivos dele. Também é possível que um usuário tenha titularidade de um app sem instalá-lo em um dispositivo.

A API pode ser usada para criar um direito. Outra opção é usar a API para acionar a instalação de um app em todos os dispositivos gerenciados de um usuário ao mesmo tempo que o direito é criado.

Se o app for sem custo financeiro, a criação do direito também vai criar uma licença em grupo. Para apps pagos, a criação do direito consome uma licença, e essa licença permanecerá consumida até que o direito seja removido. Se a empresa não tiver comprado 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 que a empresa não aceitou.

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.

Os direitos para apps que um usuário paga em um perfil não gerenciado têm "userPurchase" como motivo. Esses direitos não podem ser removidos pela 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. Essa propriedade é temporária e será substituída pelo campo acquisition kind de licenças do grupo.

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

Métodos

delete
Remove um direito de app para um usuário. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
get
Recupera detalhes de um direito. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list
Lista todos os direitos do usuário especificado. Apenas o ID é definido. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update
Adiciona ou atualiza um direito de um app para um usuário. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.