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, 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:
  • "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 possibles 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 à 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:
  • "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 possibles 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

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 un 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
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)