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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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 chiamataProducts.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.