La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
Une ressource Products représente une application sur le Google Play Store qui est disponible pour au moins certains utilisateurs dans l'entreprise. (Certaines applications sont limitées à une seule entreprise, et aucune information les concernant n'est rendue disponible en dehors de cette entreprise.)
Les informations fournies pour chaque produit (nom localisé, icône, lien vers la page d'informations complète de Google Play) sont destinées à permettre une représentation de base du produit dans une interface utilisateur 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) ] } ] } }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
appRestrictionsSchema |
nested object |
Schéma de restrictions d'application | |
appRestrictionsSchema.kind |
string |
Obsolète. |
|
appRestrictionsSchema.restrictions[] |
list |
Ensemble des restrictions qui composent ce schéma. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
Valeur par défaut de la restriction. Les restrictions bundle et bundleArray n'ont jamais de valeur par défaut. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
Type de la valeur fournie.
Les valeurs possibles sont les suivantes:
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
Valeur booléenne : elle ne sera présente que si le type est bool. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
Valeur entière : elle ne sera présente que si le type est un entier. | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
Liste des valeurs de chaîne (elle ne s'affiche que si le type est sélectionné en mode multi-sélection). | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
Valeur de chaîne : elle sera présente pour les types "string", "choice" et "hidden". | |
appRestrictionsSchema.restrictions[].description |
string |
Description plus détaillée de la restriction, donnant plus de détails sur ce qu'elle affecte. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
Pour les restrictions choice ou multiselect , la liste des entrées possibles exploitables par un ordinateur. Ces valeurs doivent être utilisées dans la configuration, soit en tant que valeur string unique pour une restriction choice , soit en tant que valeur stringArray pour une restriction multiselect . |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
Pour les restrictions choice ou multiselect , la liste des entrées possibles noms lisibles par l'homme. |
|
appRestrictionsSchema.restrictions[].key |
string |
Clé unique utilisée par le produit pour identifier la restriction, par exemple "com.google.android.gm.fieldname". | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
Pour les restrictions bundle ou bundleArray , il s'agit de la liste des restrictions imbriquées. Une restriction bundle est toujours imbriquée dans une restriction bundleArray , et une restriction bundleArray peut avoir deux niveaux de profondeur au maximum. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
Type de la restriction.
Les valeurs possibles sont les suivantes:
|
|
appRestrictionsSchema.restrictions[].title |
string |
Nom de la restriction. | |
appTracks[] |
list |
Les parcours visibles par l'entreprise. | |
appTracks[].trackAlias |
string |
Nom modifiable d'une piste. Il s'agit du nom visible dans la Play Console. | |
appTracks[].trackId |
string |
Identifiant de piste unique non modifiable. Cet identifiant correspond au releaseTrackId qui se trouve dans l'URL de la page de la Play Console qui affiche les informations sur le canal. | |
appVersion[] |
list |
Versions de l'appli actuellement disponibles pour ce produit. | |
appVersion[].isProduction |
boolean |
"True" si cette version est un APK de production. | |
appVersion[].targetSdkVersion |
integer |
Version du SDK ciblée par cette appli, comme indiqué dans le fichier manifeste de l'APK. Voir http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
Obsolète, utilisez plutôt trackId .
Les valeurs possibles sont les suivantes:
|
|
appVersion[].trackId[] |
list |
ID de suivi dans lesquels la version de l'application est publiée. Remplace le champ track (obsolète), mais n'inclut pas le canal de production (voir isProduction à la place). |
|
appVersion[].versionCode |
integer |
Identifiant unique croissant pour la version de l'application. | |
appVersion[].versionString |
string |
Chaîne utilisée sur le Play Store par le développeur de l'application pour identifier la version. La chaîne n'est pas nécessairement unique ou localisée (par exemple, la chaîne peut être "1.4"). | |
authorName |
string |
Nom de l'auteur du produit (le développeur de l'application, par exemple). | |
availableCountries[] |
list |
Pays dans lesquels l'application est disponible. | |
availableTracks[] |
list |
Obsolète, utilisez plutôt appTracks . |
|
category |
string |
La catégorie de l'application (par exemple, RACING, SOCIAL, etc.) | |
contentRating |
string |
Classification du contenu de cette application.
Les valeurs possibles sont les suivantes:
|
|
description |
string |
Description promotionnelle localisée, si disponible. | |
detailsUrl |
string |
Lien vers la page d'informations Google Play (grand public) du produit. | |
distributionChannel |
string |
Comment et à qui le package est mis à disposition La valeur publicGoogleHosted signifie que le package est disponible sur le Play Store et qu'il n'est pas limité à une entreprise spécifique. La valeur privateGoogleHosted signifie que le package est une application privée (limitée à une entreprise), mais hébergée par Google. La valeur privateSelfHosted signifie que le package est une application privée (limitée à une entreprise) et hébergée de manière privée.
Les valeurs possibles sont les suivantes:
|
|
features[] |
list |
Caractéristiques intéressantes (le cas échéant) de ce produit. | |
fullDescription |
string |
Description complète de la plate-forme de téléchargement d'applications localisée, si disponible. | |
iarcGenericRating |
string |
Classification du contenu de cette application.
Les valeurs possibles sont les suivantes:
|
|
iconUrl |
string |
Lien vers une image pouvant servir d'icône pour le produit. Cette image peut mesurer jusqu'à 512 x 512 pixels. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Heure approximative (dans les sept jours) à laquelle l'application a été publiée pour la dernière fois, exprimée en millisecondes depuis l'epoch. | |
minAndroidSdkVersion |
integer |
SDK Android minimal nécessaire à l'exécution de l'application. | |
permissions[] |
list |
Liste des autorisations requises par l'application. | |
permissions[].permissionId |
string |
Chaîne opaque identifiant de manière unique l'autorisation. | |
permissions[].state |
string |
Indique si l'autorisation a été acceptée ou non.
Les valeurs possibles sont les suivantes:
|
|
productId |
string |
Chaîne au format app:<package name> . Par exemple, app:com.google.android.gm représente l'application Gmail. |
|
productPricing |
string |
Indique s'il s'agit d'un produit sans frais, payant ou sans frais avec des achats via l'application. Si le prix est inconnu, cela signifie que le produit n'est plus en disponibilité générale (même s'il peut encore être proposé aux personnes qui le possèdent).
Les valeurs possibles sont les suivantes:
|
|
recentChanges |
string |
Description des modifications récentes apportées à l'application. | |
requiresContainerApp |
boolean |
Obsolète. | |
screenshotUrls[] |
list |
Liste de liens vers des captures d'écran représentant l'application. | |
signingCertificate |
nested object |
Certificat utilisé pour signer ce produit. | |
signingCertificate.certificateHashSha1 |
string |
Hachage SHA1 du certificat, encodé en base64 pour les URL. (Ce champ est obsolète et a été remplacé par SHA2-256. Elle ne doit pas être utilisée et peut être supprimée à tout moment.) |
|
signingCertificate.certificateHashSha256 |
string |
Hachage SHA2-256 du certificat, encodé en base64 pour les URL. | |
smallIconUrl |
string |
Lien vers une image plus petite pouvant servir d'icône pour le produit. Cette image peut mesurer jusqu'à 128 x 128 pixels. | |
title |
string |
Nom du produit. | |
workDetailsUrl |
string |
Lien vers la page d'informations du produit Google Play d'entreprise, destiné aux administrateurs de l'entreprise. |
Méthodes
- approuver
-
Approuve le produit spécifié et les autorisations de l'application concernée, le cas échéant. Nombre maximal de produits que vous pouvez approuver par client de la version Enterprise est de 1 000.
Découvrir comment utiliser Google Play d'entreprise pour concevoir et créer une plate-forme de téléchargement d'applications pour présenter les produits approuvés à vos utilisateurs, consultez la page Conception de la mise en page du magasin.
- generateApprovalUrl
-
Génère une URL qui peut être affichée dans un iFrame pour afficher le
autorisations (le cas échéant) d'un produit. Un administrateur de l'entreprise doit les consulter
autorisations et les accepter au nom de leur organisation afin de
d’approuver ce produit.
Les administrateurs doivent accepter les autorisations affichées d'ici le interagissant avec un élément d'interface utilisateur distinct de la console EMM, doit déclencher l'utilisation de cette URL PropriétéapprovalUrlInfo.approvalUrl
dans unProducts.approve
pour approuver le produit. Cette URL ne peut être utilisée pour afficher les autorisations que pendant 1 jour. - get
- Récupère les informations détaillées d'un produit afin de les présenter aux administrateurs de l'entreprise.
- getAppRestrictionsSchema
- Récupère le schéma qui définit les propriétés configurables pour cet produit. Tous les produits ont un schéma, mais celui-ci peut être vide si aucun les configurations gérées ont été définies. Ce schéma peut être utilisé pour remplir une UI permettant à un administrateur de configurer le produit. Pour appliquer une configuration gérée basée sur le schéma obtenu à l'aide de cette API, consultez Configurations gérées via Play.
- getPermissions
- Récupère les autorisations d'application Android requises par cette application.
- liste
- Recherche les produits approuvés correspondant à une requête ou tous les produits approuvés s'il n'y a pas de requête.
- annuler l'approbation
- Annule l'approbation pour le produit spécifié (et les autorisations de l'application concernée, le cas échéant)