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	Observações
appRestrictionsSchema	nested object	Esquema de restrição de apps
appRestrictionsSchema.kind	string	Descontinuado.
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 valores legíveis por máquina das entradas possíveis. 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 das 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	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 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 (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 é 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 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 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

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

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

Se quiser aprender a usar o Google Play gerenciado para projetar e criar um layout de loja para mostrar produtos aprovados aos usuários, consulte Design do layout da loja.

generateApprovalUrl

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Gera um URL que pode ser renderizado em um iframe para mostrar as permissões (se houver) de um produto. Um administrador empresarial precisa ver e aceitar essas permissões em nome da organização para aprovar o produto.

Os administradores precisam aceitar as permissões exibidas interagindo com um elemento de interface separado no console de EMM, que, por sua vez, acionará o uso desse URL como a propriedade approvalUrlInfo.approvalUrl em uma chamada 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

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Recupera o esquema que define as propriedades configuráveis para este produto. Todos os produtos têm um esquema, mas ele pode estar vazio se nenhuma configuração gerenciada tiver sido definida. Esse esquema pode ser usado para preencher uma interface 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

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

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

list

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

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

não aprovar

Descontinuado:novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

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