Importante: não aceitamos mais novos registros para a API Play EMM. Saiba mais.

Esta página foi traduzida pela API Cloud Translation.

Products

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

Representações de recursos

Um recurso de produtos representa um app na Google Play Store que está disponível para pelo menos alguns usuários na empresa. Alguns apps são restritos a uma única empresa, e nenhuma informação sobre eles é disponibilizada fora dela.

As informações fornecidas para cada produto (nome traduzido, ícone, link para a página de detalhes completa do Google Play) permitem uma representação básica do produto na interface do usuário de EMM.

{
  "kind": "androidenterprise#product",
  "productId": string,
  "title": string,
  "authorName": string,
  "iconUrl": string,
  "smallIconUrl": string,
  "detailsUrl": string,
  "workDetailsUrl": string,
  "requiresContainerApp": boolean,
  "appVersion": [
    {
      "versionString": string,
      "versionCode": integer,
      "track": string,
      "targetSdkVersion": integer,
      "trackId": [
        string
      ],
      "isProduction": boolean
    }
  ],
  "distributionChannel": string,
  "productPricing": string,
  "signingCertificate": {
    "certificateHashSha256": string,
    "certificateHashSha1": string
  },
  "availableTracks": [
    string
  ],
  "appTracks": [
    {
      "trackId": string,
      "trackAlias": string
    }
  ],
  "description": string,
  "fullDescription": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": string,
  "lastUpdatedTimestampMillis": long,
  "permissions": [
    {
      "permissionId": string,
      "state": string
    }
  ],
  "availableCountries": [
    string
  ],
  "features": [
    string
  ],
  "iarcGenericRating": string,
  "appRestrictionsSchema": {
    "kind": string,
    "restrictions": [
      {
        "key": string,
        "title": string,
        "restrictionType": string,
        "description": string,
        "entry": [
          string
        ],
        "entryValue": [
          string
        ],
        "defaultValue": {
          "type": string,
          "valueBool": boolean,
          "valueString": string,
          "valueInteger": integer,
          "valueMultiselect": [
            string
          ]
        },
        "nestedRestriction": [
          (AppRestrictionsSchemaRestriction)
        ]
      }
    ]
  }
}

Nome da propriedade	Valor	Descrição
`appRestrictionsSchema`	`nested object`	Esquema de restrições de apps
`appRestrictionsSchema.kind`	`string`	Obsoleto.
`appRestrictionsSchema.restrictions[]`	`list`	O conjunto de restrições que compõem esse esquema.
`appRestrictionsSchema.restrictions[].defaultValue`	`nested object`	O valor padrão da restrição. As restrições `bundle` e `bundleArray` nunca têm um valor padrão.
`appRestrictionsSchema.restrictions[].defaultValue.type`	`string`	O tipo do valor que está sendo fornecido. Os valores aceitáveis são: "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].defaultValue.valueBool`	`boolean`	O valor booleano - estará presente apenas se o tipo for booleano.
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	O valor inteiro, que só estará presente se o tipo for inteiro.
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	A lista de valores de string. Ela só estará presente se o tipo for de seleção múltipla.
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	O valor da string: estará presente em tipos de string, opção e oculto.
`appRestrictionsSchema.restrictions[].description`	`string`	Uma descrição mais longa da restrição, com mais detalhes sobre o que ela afeta.
`appRestrictionsSchema.restrictions[].entryValue[]`	`list`	Para restrições `choice` ou `multiselect`, a lista de valores legíveis por máquina das possíveis entradas. Esses valores precisam ser usados na configuração como um único valor `string` para uma restrição `choice` ou em um `stringArray` para uma restrição `multiselect`.
`appRestrictionsSchema.restrictions[].entry[]`	`list`	Para restrições `choice` ou `multiselect`, a lista de nomes legíveis de entradas possíveis.
`appRestrictionsSchema.restrictions[].key`	`string`	A chave exclusiva que o produto usa para identificar a restrição, por exemplo, "com.google.android.gm.fieldname".
`appRestrictionsSchema.restrictions[].nestedRestriction[]`	`list`	Para restrições `bundle` ou `bundleArray`, a lista de restrições aninhadas. Uma restrição `bundle` é sempre aninhada em uma restrição `bundleArray`, e uma restrição `bundleArray` tem, no máximo, dois níveis de profundidade.
`appRestrictionsSchema.restrictions[].restrictionType`	`string`	Tipo de restrição. Os valores aceitáveis são: "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].title`	`string`	O nome da restrição.
`appTracks[]`	`list`	As faixas visíveis para a empresa.
`appTracks[].trackAlias`	`string`	Um nome modificável para uma faixa. Esse é o nome que aparece no Play Console.
`appTracks[].trackId`	`string`	Identificador de faixa exclusivo e inalterável. Esse identificador é o launchTrackId no URL da página do Play Console que mostra as informações da faixa.
`appVersion[]`	`list`	Versões do app disponíveis para este produto no momento.
`appVersion[].isProduction`	`boolean`	Verdadeiro se a versão for um APK de produção.
`appVersion[].targetSdkVersion`	`integer`	É a versão do SDK de destino do app, conforme especificado no manifesto do APK. Consulte http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
`appVersion[].track`	`string`	obsoleto: use `trackId`. Estes são os valores aceitáveis: "`alpha`" "`beta`" "`production`"
`appVersion[].trackId[]`	`list`	Códigos de acompanhamento em que a versão do app foi publicada. Substitui o campo `track` (descontinuado), mas não inclui a faixa de produção. Consulte `isProduction`.
`appVersion[].versionCode`	`integer`	Identificador crescente exclusivo da versão do app.
`appVersion[].versionString`	`string`	É a string usada na Play Store pelo desenvolvedor do app para identificar a versão. A string não é necessariamente única ou localizada (por exemplo, pode ser "1,4").
`authorName`	`string`	O nome do autor do produto (por exemplo, o desenvolvedor do app).
`availableCountries[]`	`list`	São os países em que o app está disponível.
`availableTracks[]`	`list`	obsoleto: use `appTracks`.
`category`	`string`	A categoria do app (por exemplo, CORRIDA, REDES SOCIAIS etc.)
`contentRating`	`string`	É a classificação do conteúdo desse app. Os valores aceitáveis são os seguintes: "`all`" "`mature`" "`preTeen`" "`teen`"
`description`	`string`	A descrição promocional localizada, se disponível.
`detailsUrl`	`string`	Um link para a página de detalhes do produto no Google Play (para consumidores).
`distributionChannel`	`string`	Como e para quem o pacote é disponibilizado. O valor `publicGoogleHosted` significa que o pacote está disponível na Play Store e não é restrito a uma empresa específica. O valor `privateGoogleHosted` significa que o pacote é um app particular (restrito a uma empresa), mas hospedado pelo Google. O valor `privateSelfHosted` significa que o pacote é um app particular (restrito a uma empresa) e é hospedado de maneira particular. Estes são os valores aceitáveis: "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	Características importantes (se houver) desse produto.
`fullDescription`	`string`	A descrição completa da app store localizada, se disponível.
`iarcGenericRating`	`string`	É a classificação do conteúdo desse app. Os valores aceitáveis são os seguintes: "`eighteenYears`" "`iarcGenericRatingUnspecified`" "`sevenYears`" "`sixteenYears`" "`threeYears`" "`twelveYears`"
`iconUrl`	`string`	Um link para uma imagem que pode ser usada como ícone do produto. Esta imagem é adequada para uso em até 512 px x 512 px.
`kind`	`string`
`lastUpdatedTimestampMillis`	`long`	O tempo aproximado (em até sete dias) em que o app foi publicado pela última vez, expresso em milissegundos desde o período.
`minAndroidSdkVersion`	`integer`	O SDK do Android mínimo necessário para executar o app.
`permissions[]`	`list`	Uma lista de permissões exigidas pelo app.
`permissions[].permissionId`	`string`	Uma string opaca que identifica exclusivamente a permissão.
`permissions[].state`	`string`	Se a permissão foi aceita ou não. Os valores aceitáveis são: "`accepted`" "`required`"
`productId`	`string`	Uma string no formato `app:<package name>`. Por exemplo, `app:com.google.android.gm` representa o app Gmail.
`productPricing`	`string`	Se o produto é sem custo financeiro, sem custo financeiro com compras no app ou pago. Se o preço for desconhecido, isso significa que o produto não está mais disponível para o público geral, mesmo que ainda esteja disponível para os proprietários. Os valores aceitáveis são: "`free`" "`freeWithInAppPurchase`" "`paid`"
`recentChanges`	`string`	Uma descrição das alterações recentes feitas no app.
`requiresContainerApp`	`boolean`	Obsoleto.
`screenshotUrls[]`	`list`	Uma lista de links de capturas de tela que representam o app.
`signingCertificate`	`nested object`	O certificado usado para assinar o produto.
`signingCertificate.certificateHashSha1`	`string`	O hash SHA1 do certificado codificado em Base64 e seguro para URL. O uso desse campo foi descontinuado e substituído pelo SHA2-256. Ele não deve ser usado e poderá ser removido a qualquer momento.
`signingCertificate.certificateHashSha256`	`string`	O hash SHA2-256 codificado em Base64 urlsafe do certificado.
`smallIconUrl`	`string`	Um link para uma imagem menor que pode ser usada como ícone do produto. Esta imagem é adequada para uso em até 128 px x 128 px.
`title`	`string`	É o nome do produto.
`workDetailsUrl`	`string`	Um link para a página de detalhes do Google Play gerenciado do produto, que pode ser usada por um administrador do Enterprise.

Métodos

aprovar

Aprova o produto especificado e as permissões de apps relevantes, se houver. O número máximo de produtos que podem ser aprovados por cliente corporativo é 1.000.

Para aprender a usar o Google Play gerenciado para projetar e criar um layout de loja e exibir produtos aprovados para seus usuários, consulte Design do layout da loja.

Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem ser consultadas pelas novas recomendações.

generateApprovalUrl

Gera um URL que pode ser renderizado em um iframe para mostrar as permissões (se houver) de um produto. Um administrador corporativo precisa visualizar essas permissões e aceitá-las em nome da organização para aprovar o produto.

Os administradores precisam aceitar as permissões exibidas interagindo com um elemento da IU separado no console de EMM, o que, por sua vez, acionará o uso desse URL como a propriedade approvalUrlInfo.approvalUrl em uma chamada Products.approve para aprovar o produto. Este URL só pode ser usado para exibir permissões por até 1 dia. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem ser consultadas pelas novas recomendações.

get

Recupera detalhes de um produto para exibição para um administrador corporativo.

getAppRestrictionsSchema

Recupera o esquema que define as propriedades configuráveis para este produto. Todos os produtos têm um esquema, mas ele poderá ficar vazio se nenhuma configuração gerenciada tiver sido definida. Esse esquema pode ser usado para preencher uma IU que permite que um administrador configure o produto. Para aplicar uma configuração gerenciada com base no esquema recebido usando essa API, consulte Configurações gerenciadas pelo Google Play.

getPermissions

Recupera as permissões necessárias para o app Android.

list

Encontra produtos aprovados que correspondem a uma consulta ou todos os produtos aprovados se não houver consulta. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem ser consultadas pelas novas recomendações.

remover aprovação

O produto especificado foi reprovado e as permissões relevantes do app, se houver. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem ser consultadas pelas novas recomendações.