Grouplicenses

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

Representações de recursos

Os objetos de licença de grupo permitem que você monitore as licenças (chamadas de direitos) de apps pagos e sem custo financeiro. Para um app sem custo financeiro, uma licença de grupo é criada quando um administrador da empresa aprova o produto pela primeira vez no Google Play ou quando o primeiro direito do produto é criado para um usuário pela API. Para um app pago, um objeto de licença de grupo só é criado quando um administrador corporativo compra o produto no Google Play pela primeira vez.

Usar a API para consultar as licenças de grupo. Um recurso do Grouplicenses inclui o número total de licenças compradas (somente apps pagos) e o número total de licenças em uso atualmente. Em outras palavras, o número total de Entitlements que existem para o produto.

Apenas um objeto de licença de grupo é criado por produto, e os objetos de licença de grupo nunca são excluídos. Se um produto não for aprovado, a licença de grupo dele será mantida. Isso permite que os administradores corporativos acompanhem os direitos restantes do produto.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
Nome da propriedade Valor Descrição Observações
acquisitionKind string Como a licença do grupo foi adquirida. "bulkPurchase" significa que este recurso Grouplicenses foi criado porque a empresa comprou licenças para o produto. Caso contrário, o valor será "free" (para produtos sem custo financeiro).

Os valores aceitáveis são os seguintes:
  • "bulkPurchase"
  • "free"
approval string Se o produto relacionado a essa licença de grupo foi aprovado pela empresa. Os produtos são aprovados quando uma licença de grupo é criada pela primeira vez, mas essa aprovação pode ser revogada por um administrador corporativo no Google Play. Os produtos não aprovados não ficarão visíveis para os usuários finais nas coleções, e novos direitos a eles não devem ser criados normalmente.

Os valores aceitáveis são:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer O número total de licenças provisionadas deste produto. Retornado por operações de leitura, mas ignorado em operações de gravação.
numPurchased integer O número de licenças compradas (possivelmente em várias compras). Se esse campo for omitido, não haverá limite para o número de licenças que podem ser provisionadas (por exemplo, se o tipo de aquisição for "free").
permissions string O status de aprovação da permissão do produto. Esse campo só será definido se o produto for aprovado. Os estados possíveis são:
  • "currentApproved", o conjunto atual de permissões foi aprovado, mas permissões adicionais exigirão que o administrador aprove o produto novamente. Se o produto foi aprovado sem especificar a configuração de permissões aprovadas, esse é o comportamento padrão.
  • "needsReapproval", o produto tem permissões não aprovadas. Nenhuma licença adicional pode ser atribuída até que o produto seja aprovado novamente.
  • "allCurrentAndFutureApproved", as permissões atuais foram aprovadas, e as futuras atualizações de permissão serão automaticamente aprovadas sem análise do administrador.
.

Os valores aceitáveis são os seguintes:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string O ID do produto referente à licença. Por exemplo, "app:com.google.android.gm".

Métodos

get
Recupera detalhes da licença de grupo de uma empresa para um produto.
list
Recupera IDs de todos os produtos para os quais a empresa tem uma licença de grupo.