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 "Produtos" representa um app na Google Play Store que está disponível para pelo menos alguns usuários da empresa. Alguns apps são restritos a uma única empresa, e nenhuma informação sobre eles é disponibilizada fora dessa empresa.

As informações fornecidas para cada produto (nome localizado, ícone, link para a página completa de detalhes do Google Play) visam permitir uma representação básica do produto em uma interface do usuário do 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ção de apps
`appRestrictionsSchema.kind`	`string`	Obsoleto.
`appRestrictionsSchema.restrictions[]`	`list`	O conjunto de restrições que compõem este 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 de 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 - só estará presente se o tipo for booleano.
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	O valor inteiro: só vai estar presente se o tipo for um número inteiro.
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	A lista de valores de string: só vai estar presente se o tipo for de seleção múltipla.
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	O valor da string: estará presente para os tipos string, choice 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 possíveis entradas legíveis por máquina. 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 possíveis entradas legíveis por humanos.
`appRestrictionsSchema.restrictions[].key`	`string`	A chave exclusiva que o produto usa para identificar a restrição. Por exemplo, "com.google.android.gm.nomedocampo".
`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`	O 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 não modificável. Esse identificador é o releaseTrackId no URL da página do Play Console que exibe as informações da faixa.
`appVersion[]`	`list`	Versões do aplicativo disponíveis atualmente para este produto.
`appVersion[].isProduction`	`boolean`	Verdadeiro se esta versão for um APK de produção.
`appVersion[].targetSdkVersion`	`integer`	É a versão do SDK que este app segmenta, conforme especificado no manifesto do APK. Consulte http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
`appVersion[].track`	`string`	obsoleto: use `trackId`. Os valores aceitáveis são os seguintes: "`alpha`" "`beta`" "`production`"
`appVersion[].trackId[]`	`list`	IDs das faixas 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 de aumento exclusivo para a 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 para este 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 (do consumidor).
`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 que é hospedado de forma privada. Os valores aceitáveis são os seguintes: "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	Características importantes do produto (se houver).
`fullDescription`	`string`	A descrição completa localizada da app store, se disponível.
`iarcGenericRating`	`string`	A classificação do conteúdo para este 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 um ícone do produto. Essa imagem é adequada para uso em até 512 x 512 pixels.
`kind`	`string`
`lastUpdatedTimestampMillis`	`long`	O tempo aproximado (dentro de 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 este 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 possa estar disponível para os proprietários. Os valores aceitáveis são: "`free`" "`freeWithInAppPurchase`" "`paid`"
`recentChanges`	`string`	Uma descrição das mudanças 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 este produto.
`signingCertificate.certificateHashSha1`	`string`	O hash SHA1 codificado em segurança de URL em base64 do certificado. Este campo está obsoleto e foi substituído pelo SHA2-256. Ela não deve ser usada e pode ser removida a qualquer momento.
`signingCertificate.certificateHashSha256`	`string`	O hash SHA2-256 codificado em segurança de URL em base64 do certificado.
`smallIconUrl`	`string`	Um link para uma imagem menor que pode ser usada como um ícone do produto. Essa imagem é adequada para uso em até 128 x 128 pixels.
`title`	`string`	O nome do produto.
`workDetailsUrl`	`string`	Um link para a página de detalhes do Google Play gerenciado do produto, para uso de um administrador corporativo.

Métodos

aprovar

Aprova o produto especificado e as permissões relevantes do app, se houver. 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 uma loja para exibir produtos aprovados aos usuários, consulte Design do layout da loja.

generateApprovalUrl

Gera um URL que pode ser renderizado em um iframe para exibir o as permissões (se houver) de um produto. Um administrador da empresa precisa acessar permissões e as aceitar em nome da organização para poder aprovar esse produto.

Os administradores devem aceitar as permissões exibidas interagindo com um elemento de interface separado no console de EMM, o que deve acionar o uso desse URL como o propriedade approvalUrlInfo.approvalUrl em um Products.approve para aprovar o produto. Esse URL só pode ser usado para mostrar permissões por até um dia.

get

Recupera detalhes de um produto para exibição a um administrador da empresa.

getAppRestrictionsSchema

Recupera o esquema que define as propriedades configuráveis para este produto. Todos os produtos têm um esquema, mas ele pode ficar vazio se não quando as configurações gerenciadas forem definidas. 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 este a API, consulte Configurações gerenciadas pelo Google Play.

getPermissions

Recupera as permissões do app Android exigidas pelo app.

list

Encontra produtos aprovados que correspondem a uma consulta ou todos os produtos aprovados se não houver consulta.

não aprovar

Não aprova o produto especificado (e as permissões do app relevantes, se houver)