Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play. En savoir plus

Cette page a été traduite par l'API Cloud Translation.

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 du Google Play Store qui est mise à la disposition d'au moins certains utilisateurs de l'entreprise. Certaines applications sont limitées à une seule entreprise, et aucune information les concernant n'est accessible en dehors de celle-ci.

Les informations fournies pour chaque produit (nom localisé, icône, lien vers la page d'informations complète de Google Play) sont destinées à offrir 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
`appRestrictionsSchema`	`nested object`	Schéma des 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 valeur fournie. Les valeurs possibles sont les suivantes : "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].defaultValue.valueBool`	`boolean`	Valeur booléenne (n'est présente que si le type est une valeur booléenne).
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	Valeur du nombre entier : elle n'est présente que si le type est entier.
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	Liste des valeurs de chaîne (n'est présente que si le type est à sélection multiple).
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	Valeur de la 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, pour plus de détails sur son impact.
`appRestrictionsSchema.restrictions[].entryValue[]`	`list`	Pour les restrictions `choice` ou `multiselect`, il s'agit de la liste des valeurs lisibles par l'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 `stringArray` pour une restriction `multiselect`.
`appRestrictionsSchema.restrictions[].entry[]`	`list`	Pour les restrictions `choice` ou `multiselect`, il s'agit de la 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`, la liste des restrictions imbriquées. Une restriction `bundle` est toujours imbriquée dans une restriction `bundleArray`, et une restriction `bundleArray` comporte au maximum deux niveaux de profondeur.
`appRestrictionsSchema.restrictions[].restrictionType`	`string`	Type de 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`	Canaux visibles par l'entreprise.
`appTracks[].trackAlias`	`string`	Nom modifiable pour une piste. Il s'agit du nom visible dans la Play Console.
`appTracks[].trackId`	`string`	Identifiant de canal unique et non modifiable. Cet identifiant correspond à la valeur releaseTrackId indiquée dans l'URL de la page Play Console qui affiche les informations sur le canal.
`appVersion[]`	`list`	Versions de l'application 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 application, 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 croissant unique associé à 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 ni localisée (par exemple, "1.4").
`authorName`	`string`	Nom de l'auteur du produit (par exemple, le développeur de l'application).
`availableCountries[]`	`list`	Pays dans lesquels cette application est disponible.
`availableTracks[]`	`list`	Obsolète, utilisez plutôt `appTracks`.
`category`	`string`	Catégorie de l'application (par exemple, RACING, SOCIAL, etc.)
`contentRating`	`string`	Classification du contenu de cette application. Valeurs acceptées : "`all`" "`mature`" "`preTeen`" "`teen`"
`description`	`string`	Description promotionnelle localisée, le cas échéant.
`detailsUrl`	`string`	Lien vers la page d'informations du produit sur Google Play (grand public).
`distributionChannel`	`string`	Comment et auprès de qui le package est-il mis à disposition ? La valeur `publicGoogleHosted` signifie que le package est disponible sur le Play Store et 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 qu'il est hébergé de manière privée. Les valeurs possibles sont les suivantes : "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	Caractéristiques notables de ce produit (le cas échéant)
`fullDescription`	`string`	Description complète localisée de l'application sur la plate-forme de téléchargement d'applications, si disponible.
`iarcGenericRating`	`string`	Classification du contenu de cette application. Valeurs acceptées : "`eighteenYears`" "`iarcGenericRatingUnspecified`" "`sevenYears`" "`sixteenYears`" "`threeYears`" "`twelveYears`"
`iconUrl`	`string`	Lien vers une image pouvant être utilisée comme icône pour le produit. Cette image peut mesurer jusqu'à 512 x 512 pixels.
`kind`	`string`
`lastUpdatedTimestampMillis`	`long`	Durée approximative (7 jours) de la dernière publication de l'application, exprimée en millisecondes écoulées depuis l'epoch.
`minAndroidSdkVersion`	`integer`	SDK Android minimal requis pour exécuter 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 si le produit est sans frais, sans frais avec des achats via l'application ou payant. Si le prix est inconnu, cela signifie que le produit n'est plus disponible pour tous les utilisateurs (même s'il est toujours proposé aux personnes qui le possèdent). Les valeurs possibles sont les suivantes : "`free`" "`freeWithInAppPurchase`" "`paid`"
`recentChanges`	`string`	Une 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 sécurisées. (Ce champ est obsolète et a été remplacé par SHA2-256. Il ne doit pas être utilisé et peut être supprimé à tout moment.)
`signingCertificate.certificateHashSha256`	`string`	Hachage SHA2-256 du certificat, encodé en base64 pour les URL sécurisées.
`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 de Google Play d'entreprise pour le produit, destiné à un administrateur de l'entreprise.

Méthodes

approuver

Apprend le produit spécifié et les autorisations d'application pertinentes, le cas échéant. Vous pouvez approuver jusqu'à 1 000 produits par client entreprise.

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

Remarque: Cet élément est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

generateApprovalUrl

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'interface utilisateur 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 maximum. Remarque: Cet élément est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

obtenir

Récupère les détails d'un produit pour les présenter à un administrateur d'entreprise.

getAppRestrictionsSchema

Récupère le schéma qui définit les propriétés configurables pour ce produit. Tous les produits ont 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 section Configurations gérées via Play.

getPermissions

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

list

Recherche les produits approuvés correspondant à une requête ou tous les produits approuvés en l'absence de requête. Remarque: Cet élément est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.

annuler l'approbation

Annule le produit spécifié (et les autorisations d'application pertinentes, le cas échéant). Remarque: Cet article est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent se référer à nos nouvelles recommandations.