Importante:non accettiamo più nuove registrazioni per l'API Play EMM. Scopri di più.

Questa pagina è stata tradotta dall'API Cloud Translation.

Products

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
`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: "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`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 dei valori leggibili dal computer delle possibili voci. 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 dei nomi leggibili da una persona delle 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 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: "`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 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: "`alpha`" "`beta`" "`production`"
`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 per 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 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: "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`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 per 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 è 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: "`accepted`" "`required`"
`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: "`free`" "`freeWithInAppPurchase`" "`paid`"
`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 un layout del negozio per mostrare i prodotti approvati agli utenti, consulta Progettazione del layout dello store.

generateApprovalUrl

Genera un URL che può essere visualizzato 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 al fine di approvare il prodotto.

Gli amministratori devono 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 l'approvazione del 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 questo prodotto. Tutti i prodotti hanno uno schema, ma questo potrebbe essere vuoto se non sono state definite configurazioni gestite. Questo schema può essere utilizzato per compilare una UI che consente a un amministratore di configurare il prodotto. Per applicare una configurazione gestita basata sullo 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 oppure tutti i prodotti approvati se non esiste una query.

annullare l'approvazione

Annulla l'approvazione del prodotto specificato (e delle eventuali autorizzazioni app pertinenti)