Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.
Rappresentazioni delle risorse
Una risorsa Products rappresenta un'app nel Google Play Store disponibile per almeno alcuni utenti dell'azienda. Alcune app sono limitate a una singola impresa e nessuna informazione su di esse viene resa disponibile al di fuori di quest'ultima.
Le informazioni fornite per ogni prodotto (nome localizzato, icona, link alla pagina dei dettagli completa 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 |
Obsoleta. |
|
appRestrictionsSchema.restrictions[] |
list |
L'insieme di restrizioni 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 |
Valore booleano, presente solo se il tipo è bool. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
Il valore intero, presente solo se il tipo è un numero intero. | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
L'elenco di valori di stringa - questo sarà presente solo se il tipo è a selezione multipla. | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
Il valore della stringa - Presente per i tipi string, options e Hidden. | |
appRestrictionsSchema.restrictions[].description |
string |
Una descrizione più lunga della limitazione, con maggiori dettagli su ciò che influisce. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
Per le limitazioni choice o multiselect , l'elenco delle voci possibili e leggibili dalle macchine. Questi valori devono essere utilizzati nella configurazione, come singolo valore string per una restrizione choice o in un stringArray per una restrizione multiselect . |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
Per le limitazioni choice o multiselect , l'elenco delle voci possibili con nomi leggibili da una persona. |
|
appRestrictionsSchema.restrictions[].key |
string |
La chiave univoca utilizzata dal prodotto per identificare la limitazione, ad esempio "com.google.android.gm.nomecampo". | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
Per le limitazioni bundle o bundleArray , l'elenco delle limitazioni nidificate. Una restrizione bundle è sempre nidificata all'interno di una restrizione bundleArray , mentre una restrizione bundleArray ha una profondità massima di due livelli. |
|
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 per una traccia. Questo è il nome visibile in Play Console. | |
appTracks[].trackId |
string |
Identificatore di traccia univoco non modificabile. Questo identificatore è il releaseTrackId nell'URL della pagina Play Developer Console in cui vengono visualizzate le informazioni sul brano. | |
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 da questa app, come specificato nel file manifest dell'APK. Vedi http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
Deprecato, usa trackId al suo posto.
I valori accettati sono:
|
|
appVersion[].trackId[] |
list |
ID monitoraggio 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 univoco crescente 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 |
Deprecato, usa appTracks al suo posto. |
|
category |
string |
La categoria dell'app (ad es. RACING, 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 consumatori) relativa al prodotto. | |
distributionChannel |
string |
Come e per chi viene reso disponibile il pacchetto. Il valore publicGoogleHosted indica che il pacchetto è disponibile tramite il Play Store e non è limitato a un'azienda specifica. 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) con hosting privato.
I valori accettati sono:
|
|
features[] |
list |
Funzionalità degne di nota (se presenti) di questo 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 è adatta per un massimo di 512 x 512 px. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Il tempo approssimativo (entro sette giorni) in cui l'app è stata pubblicata per l'ultima volta, espressa in millisecondi dall'epoca. | |
minAndroidSdkVersion |
integer |
L'SDK Android minimo necessario per eseguire l'app. | |
permissions[] |
list |
Un elenco di autorizzazioni richieste dall'app. | |
permissions[].permissionId |
string |
Una stringa opaca che identifica in modo univoco l'autorizzazione. | |
permissions[].state |
string |
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 |
Se il 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 a screenshot che rappresentano l'app. | |
signingCertificate |
nested object |
Il certificato utilizzato per firmare questo prodotto. | |
signingCertificate.certificateHashSha1 |
string |
L'hash SHA1 codificato in base64 urlsafe del certificato. Questo campo è stato ritirato a favore di SHA2-256. Non deve essere utilizzato e potrebbe 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 è adatta per un massimo di 128 x 128 px. | |
title |
string |
Il nome del prodotto. | |
workDetailsUrl |
string |
Un link alla pagina dei dettagli della versione gestita di Google Play per il prodotto, destinata all'utilizzo da parte di un amministratore aziendale. |
Metodi
- approva
-
Approva il prodotto specificato e le eventuali autorizzazioni app pertinenti. Il numero massimo di prodotti che puoi approvare per cliente aziendale è 1000.
Per scoprire come utilizzare la versione gestita di Google Play per progettare e creare uno store per mostrare i prodotti approvati agli utenti, consulta Design Layout del negozio.
- generateApprovalUrl
-
Genera un URL che può essere visualizzato in un iframe per visualizzare
autorizzazioni (se presenti) di un prodotto. Deve essere visualizzato da un amministratore aziendale
autorizzazioni e accettarle per conto della propria organizzazione al fine
approvare quel prodotto.
Gli amministratori devono accettare le autorizzazioni visualizzate entro il interagendo con un elemento UI separato nella console EMM, che a sua volta dovrebbe attivare l'utilizzo di questo URL comeapprovalUrlInfo.approvalUrl
proprietà in unaProducts.approve
per approvare il prodotto. Questo URL può essere utilizzato soltanto per visualizzare le autorizzazioni per un massimo di un giorno. - trova
- Recupera i dettagli di un prodotto per mostrarli all'amministratore aziendale.
- getAppRestrictionsSchema
- Recupera lo schema che definisce le proprietà configurabili per l'elemento prodotto. Tutti i prodotti hanno uno schema, ma questo potrebbe essere vuoto in caso contrario sono state definite le configurazioni gestite. Questo schema può essere utilizzato compilare una UI che consente a un amministratore di configurare il prodotto. Applicare una configurazione gestita in base allo schema ottenuto utilizzando questa sull'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 ci sono query.
- annullare l'approvazione
- Annulla l'approvazione del prodotto specificato (e delle eventuali autorizzazioni app pertinenti)