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 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)