Products

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 : "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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, liste des valeurs lisibles par un ordinateur des entrées possibles. 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, liste des noms lisibles des entrées possibles.
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 : "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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 : "alpha" "beta" "production"
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 acceptées sont les suivantes : "all" "mature" "preTeen" "teen"
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 aux entreprises), 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 : "privateGoogleHosted" "privateSelfHosted" "publicGoogleHosted"
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 acceptées sont les suivantes : "eighteenYears" "iarcGenericRatingUnspecified" "sevenYears" "sixteenYears" "threeYears" "twelveYears"
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 : "accepted" "required"
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 : "free" "freeWithInAppPurchase" "paid"
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

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Approuve le produit spécifié et les autorisations de l'application concernée, le cas échéant. Le nombre maximal de produits que vous pouvez approuver par entreprise cliente est de 1 000.

Pour découvrir comment utiliser Google Play d'entreprise pour concevoir et créer une mise en page de magasin afin de présenter les produits approuvés à vos utilisateurs, consultez Mise en page de la boutique.

generateApprovalUrl

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Génère une URL qui peut être affichée dans un iFrame pour afficher les autorisations (le cas échéant) d'un produit. Un administrateur d'entreprise doit afficher ces autorisations et les accepter au nom de son organisation afin d'approuver ce produit.

Les administrateurs doivent accepter les autorisations affichées en interagissant avec un élément d'UI distinct dans la console EMM, ce qui devrait déclencher l'utilisation de cette URL en tant que propriété approvalUrlInfo.approvalUrl dans un appel Products.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

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Récupère le schéma qui définit les propriétés configurables pour ce produit. Tous les produits disposent d'un schéma, mais celui-ci peut être vide si aucune configuration gérée n'a été définie. Ce schéma peut être utilisé pour renseigner 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 la page Configurations gérées via Play.

getPermissions

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Récupère les autorisations d'application Android requises par cette application.

liste

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Recherche les produits approuvés qui correspondent à une requête, ou tous les produits approuvés s'il n'y a pas de requête.

annuler l'approbation

Obsolète:les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

Annule l'approbation du produit spécifié (et des autorisations de l'application concernée, le cas échéant)