Grouplicenses

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

Representações de recursos

Com os objetos de licença de grupo, você pode acompanhar as licenças (chamadas de direitos) de apps sem custo financeiro e pagos. Uma licença em grupo é criada quando um administrador corporativo aprova o produto no Google Play pela primeira vez ou quando o primeiro direito do produto é criado para um usuário na API. Para apps pagos, um objeto de licença de grupo só é criado quando um administrador corporativo compra o produto no Google Play pela primeira vez.

Use a API para consultar licenças de grupos. Um recurso Grouplicenses inclui o número total de licenças compradas (somente apps pagos) e o número total de licenças em uso no momento. 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 esses objetos nunca são excluídos. Se o produto for reprovado, 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 esta licença de grupo foi adquirida. "bulkPurchase" significa que esse recurso de licenças de grupo foi criado porque a empresa comprou licenças para esse 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 ao qual esta licença de grupo se refere 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 empresarial no Google Play. Os produtos não aprovados não ficarão visíveis para os usuários finais nas coleções, e normalmente não é possível criar novos direitos para eles.

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 de permissão do produto. Este campo só será definido se o produto for aprovado. Estes são os estados possíveis:
  • "currentApproved", o conjunto atual de permissões foi aprovado, mas as outras permissões exigirão que o administrador aprove novamente o produto. Se o produto foi aprovado sem especificar a configuração de permissões aprovadas, este é o comportamento padrão.
  • "needsReapproval", o produto tem permissões não aprovadas. Nenhuma licença adicional do produto pode ser atribuída até que o produto seja aprovado novamente
  • "allCurrentAndFutureApproved", as permissões atuais são aprovadas, e as futuras atualizações delas serão aprovadas automaticamente, sem revisão do administrador.


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

Métodos

get
Recupera detalhes da licença de grupo de uma empresa para um produto. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list
Recupera IDs de todos os produtos para os quais a empresa tem uma licença de grupo. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.