Products

Per un elenco dei metodi utilizzati per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa Prodotti rappresenta un'app nel Google Play Store disponibile almeno per alcuni utenti dell'azienda. Alcune app sono limitate a una singola azienda e le relative informazioni non vengono rese disponibili al di fuori di quest'ultima.

Le informazioni fornite per ogni prodotto (nome localizzato, icona, link alla pagina completa dei dettagli di Google Play) hanno lo scopo di consentire una rappresentazione di base del prodotto all'interno di un'interfaccia utente 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 proprietà	Valore	Descrizione	Note
appRestrictionsSchema	nested object	Schema delle limitazioni dell'app
appRestrictionsSchema.kind	string	Obsoleto.
appRestrictionsSchema.restrictions[]	list	L'insieme di limitazioni che compongono questo schema.
appRestrictionsSchema.restrictions[].defaultValue	nested object	Il valore predefinito della limitazione. Le limitazioni bundle e bundleArray non hanno mai un valore predefinito.
appRestrictionsSchema.restrictions[].defaultValue.type	string	Il tipo di valore fornito. I valori accettati sono: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool	boolean	Il valore booleano: sarà presente solo se il tipo è bool.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger	integer	Il valore numerico: sarà presente solo se il tipo è un numero intero.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]	list	L'elenco dei valori delle stringhe: presente solo se il tipo è a selezione multipla.
appRestrictionsSchema.restrictions[].defaultValue.valueString	string	Il valore stringa: sarà presente per i tipi stringa, scelta e nascosto.
appRestrictionsSchema.restrictions[].description	string	Una descrizione più lunga della limitazione, con maggiori dettagli sulla sua influenza.
appRestrictionsSchema.restrictions[].entryValue[]	list	Per le limitazioni choice o multiselect, l'elenco di possibili valori leggibili dal computer delle voci. Questi valori devono essere utilizzati nella configurazione, come singolo valore string per una restrizione choice o in stringArray per una restrizione multiselect.
appRestrictionsSchema.restrictions[].entry[]	list	Per le limitazioni choice o multiselect, l'elenco di nomi leggibili dalle voci possibili.
appRestrictionsSchema.restrictions[].key	string	La chiave univoca utilizzata dal prodotto per identificare la limitazione, ad esempio "com.google.android.gm.fieldname".
appRestrictionsSchema.restrictions[].nestedRestriction[]	list	Per le limitazioni bundle o bundleArray, l'elenco delle limitazioni nidificate. Una restrizione bundle è sempre nidificata all'interno di una limitazione bundleArray e una restrizione bundleArray ha al massimo due livelli di profondità.
appRestrictionsSchema.restrictions[].restrictionType	string	Il tipo di limitazione. I valori accettati sono: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
appRestrictionsSchema.restrictions[].title	string	Il nome della restrizione.
appTracks[]	list	I canali visibili all'azienda.
appTracks[].trackAlias	string	Un nome modificabile di una traccia. Si tratta del nome visibile nella Play Console.
appTracks[].trackId	string	Identificatore univoco della traccia non modificabile. Questo identificatore è il releaseTrackId nell'URL della pagina della Play Developer Console in cui sono visualizzate le informazioni sulla traccia.
appVersion[]	list	Versioni dell'app attualmente disponibili per questo prodotto.
appVersion[].isProduction	boolean	True se questa versione è un APK di produzione.
appVersion[].targetSdkVersion	integer	La versione dell'SDK scelta come target per questa app, come specificato nel file manifest dell'APK. Consulta la pagina http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
appVersion[].track	string	Deprecata, utilizza trackId. I valori accettati sono: "alpha" "beta" "production"
appVersion[].trackId[]	list	Monitora gli ID in cui è pubblicata la versione dell'app. Sostituisce il campo track (deprecato), ma non include il canale di produzione (vedi isProduction).
appVersion[].versionCode	integer	Identificatore crescente univoco per la versione dell'app.
appVersion[].versionString	string	La stringa utilizzata nel Play Store dallo sviluppatore dell'app per identificare la versione. La stringa non è necessariamente univoca o localizzata (ad esempio, potrebbe essere "1.4").
authorName	string	Il nome dell'autore del prodotto (ad esempio, lo sviluppatore dell'app).
availableCountries[]	list	I paesi in cui è disponibile questa app.
availableTracks[]	list	Deprecata, utilizza appTracks.
category	string	La categoria dell'app (ad es. CORSE, SOCIAL e così via)
contentRating	string	La classificazione dei contenuti di questa app. I valori accettati sono: "all" "mature" "preTeen" "teen"
description	string	La descrizione promozionale localizzata, se disponibile.
detailsUrl	string	Un link alla pagina dei dettagli di Google Play (per il consumatore) relativa al prodotto.
distributionChannel	string	Come e a chi viene reso disponibile il pacchetto. Il valore publicGoogleHosted indica che il pacchetto è disponibile tramite il Play Store e non è limitato a una determinata azienda. Il valore privateGoogleHosted indica che il pacchetto è un'app privata (limitata a un'azienda), ma ospitata da Google. Il valore privateSelfHosted indica che il pacchetto è un'app privata (limitata a un'azienda) ospitata privatamente. I valori accettati sono: "privateGoogleHosted" "privateSelfHosted" "publicGoogleHosted"
features[]	list	Eventuali caratteristiche degne di nota del prodotto.
fullDescription	string	La descrizione completa localizzata dello store, se disponibile.
iarcGenericRating	string	La classificazione dei contenuti di questa app. I valori accettati sono: "eighteenYears" "iarcGenericRatingUnspecified" "sevenYears" "sixteenYears" "threeYears" "twelveYears"
iconUrl	string	Un link a un'immagine che può essere utilizzata come icona del prodotto. Questa immagine può essere utilizzata con una risoluzione massima di 512 x 512 pixel.
kind	string
lastUpdatedTimestampMillis	long	Il tempo approssimativo (entro 7 giorni) in cui l'app è stata pubblicata l'ultima volta, espresso in millisecondi dall'epoca.
minAndroidSdkVersion	integer	L'SDK Android minimo necessario per eseguire l'app.
permissions[]	list	Un elenco delle autorizzazioni richieste dall'app.
permissions[].permissionId	string	Una stringa opaca che identifica in modo univoco l'autorizzazione.
permissions[].state	string	Indica se l'autorizzazione è stata accettata o meno. I valori accettati sono: "accepted" "required"
productId	string	Una stringa nel formato app:<package name>. Ad esempio, app:com.google.android.gm rappresenta l'app Gmail.
productPricing	string	Indica se si tratta di un prodotto senza costi, senza costi con acquisti in-app o a pagamento. Se il prezzo non è noto, significa che il prodotto non è più disponibile a livello generale (anche se potrebbe essere ancora disponibile per i proprietari). I valori accettati sono: "free" "freeWithInAppPurchase" "paid"
recentChanges	string	Una descrizione delle modifiche recenti apportate all'app.
requiresContainerApp	boolean	Deprecato.
screenshotUrls[]	list	Un elenco di link di screenshot che rappresentano l'app.
signingCertificate	nested object	Il certificato utilizzato per firmare questo prodotto.
signingCertificate.certificateHashSha1	string	L'hash SHA1 con codifica urlsafe base64 del certificato. Questo campo è stato ritirato a favore di SHA2-256. Non deve essere utilizzato e può essere rimosso in qualsiasi momento.
signingCertificate.certificateHashSha256	string	L'hash SHA2-256 con codifica urlsafe base64 del certificato.
smallIconUrl	string	Un link a un'immagine più piccola che può essere utilizzata come icona del prodotto. Questa immagine può essere utilizzata con una risoluzione massima di 128 x 128 pixel.
title	string	Il nome del prodotto.
workDetailsUrl	string	Un link alla pagina dei dettagli della versione gestita di Google Play per il prodotto, che deve essere utilizzata da un amministratore aziendale.

Metodi

approvare

Approva il prodotto specificato e le eventuali autorizzazioni app pertinenti. Il numero massimo di prodotti che puoi approvare per ogni cliente aziendale è 1000.

Per scoprire come utilizzare la versione gestita di Google Play per progettare e creare un layout per lo store e mostrare i prodotti approvati agli utenti, consulta Progettazione del layout dello store.

Nota: questo articolo è stato ritirato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.

generateApprovalUrl

Genera un URL su cui è possibile eseguire il rendering in un iframe per visualizzare le eventuali autorizzazioni di un prodotto. Un amministratore aziendale deve visualizzare queste autorizzazioni e accettarle per conto della propria organizzazione per approvare il prodotto.

Gli amministratori dovrebbero accettare le autorizzazioni visualizzate interagendo con un elemento UI separato nella console EMM, che a sua volta dovrebbe attivare l'utilizzo di questo URL come proprietà approvalUrlInfo.approvalUrl in una chiamata Products.approve per approvare il prodotto. Questo URL può essere utilizzato soltanto per visualizzare le autorizzazioni per un massimo di 1 giorno. Nota: questo articolo è stato ritirato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.

prendi

Recupera i dettagli di un prodotto per mostrarli all'amministratore aziendale.

getAppRestrictionsSchema

Recupera lo schema che definisce le proprietà configurabili per questo prodotto. Tutti i prodotti hanno uno schema, ma questo schema potrebbe essere vuoto se non sono state definite configurazioni gestite. Questo schema può essere utilizzato per compilare un'interfaccia utente che consente a un amministratore di configurare il prodotto. Per applicare una configurazione gestita in base allo schema ottenuto utilizzando questa API, consulta Configurazioni gestite tramite Play.

getPermissions

Recupera le autorizzazioni app per Android richieste da questa app.

list

Trova i prodotti approvati che corrispondono a una query o tutti i prodotti approvati se non c'è alcuna query. Nota: questo articolo è stato ritirato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.

non approvare

Annulla l'approvazione del prodotto specificato (e delle eventuali autorizzazioni app pertinenti) Nota: questo elemento è stato ritirato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.