REST Resource: applications.deviceTierConfigs

Ressource : DeviceTierConfig

Configuration décrivant les critères de ciblage des appareils pour le contenu d'une application.

Représentation JSON
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
Champs
deviceTierConfigId

string (int64 format)

Uniquement en sortie. ID de configuration du niveau d'appareil.

deviceGroups[]

object (DeviceGroup)

Définition des groupes d'appareils pour l'application.

deviceTierSet

object (DeviceTierSet)

Définition de l'ensemble des niveaux d'appareil pour l'application.

userCountrySets[]

object (UserCountrySet)

Définition des ensembles de pays des utilisateurs pour l'application.

DeviceGroup

Groupe d'appareils.

Un groupe est défini par un ensemble de sélecteurs d'appareils. Un appareil appartient au groupe s'il correspond à au moins un sélecteur (opérateur logique OU).

Représentation JSON
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
Champs
name

string

Nom du groupe.

deviceSelectors[]

object (DeviceSelector)

Sélecteurs d'appareils pour ce groupe. Un appareil correspondant à l'un des sélecteurs est inclus dans ce groupe.

DeviceSelector

Sélecteur pour un groupe d'appareils. Un sélecteur se compose d'un ensemble de conditions sur l'appareil qui doivent toutes correspondre (opérateur logique ET) pour déterminer l'éligibilité d'un groupe d'appareils.

Par exemple, si un sélecteur spécifie des conditions de RAM, l'inclusion de modèles d'appareils et l'exclusion de modèles d'appareils, un appareil est considéré comme correspondant si : l'appareil répond aux conditions de RAM ET l'appareil correspond à l'un des modèles d'appareils inclus ET l'appareil ne correspond pas aux modèles d'appareils exclus.

Représentation JSON
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
Champs
deviceRam

object (DeviceRam)

Conditions concernant la RAM de l'appareil.

includedDeviceIds[]

object (DeviceId)

Modèles d'appareils inclus dans ce sélecteur.

excludedDeviceIds[]

object (DeviceId)

Modèles d'appareils exclus par ce sélecteur, même s'ils remplissent toutes les autres conditions.

requiredSystemFeatures[]

object (SystemFeature)

Un appareil doit disposer de toutes ces fonctionnalités système pour être inclus dans le sélecteur.

forbiddenSystemFeatures[]

object (SystemFeature)

Un appareil qui possède l'une de ces fonctionnalités système est exclu par ce sélecteur, même s'il répond à toutes les autres conditions.

systemOnChips[]

object (SystemOnChip)

Facultatif. SoC inclus par ce sélecteur. Ne fonctionne que pour les appareils Android S et versions ultérieures.

DeviceRam

Conditions concernant les capacités de RAM d'un appareil.

Représentation JSON
{
  "minBytes": string,
  "maxBytes": string
}
Champs
minBytes

string (int64 format)

RAM minimale en octets (limite incluse).

maxBytes

string (int64 format)

RAM maximale en octets (limite exclue).

DeviceId

Identifiant d'un appareil.

Représentation JSON
{
  "buildBrand": string,
  "buildDevice": string
}
Champs
buildBrand

string

Valeur de Build.BRAND.

buildDevice

string

Valeur de Build.DEVICE.

SystemFeature

Représentation d'une fonctionnalité système.

Représentation JSON
{
  "name": string
}
Champs
name

string

Nom de la fonctionnalité.

SystemOnChip

Représentation d'un système sur puce (SoC) d'un appareil Android. Peut être utilisé pour cibler les appareils S+.

Représentation JSON
{
  "manufacturer": string,
  "model": string
}
Champs
manufacturer

string

Obligatoire. Concepteur du SoC, par exemple "Google" Valeur de la propriété de compilation "ro.soc.manufacturer" https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER Obligatoire.

model

string

Obligatoire. Modèle du SoC, par exemple Valeur "Tensor" de la propriété de compilation "ro.soc.model" https://developer.android.com/reference/android/os/Build#SOC_MODEL obligatoire.

DeviceTierSet

Ensemble de niveaux d'appareils.

Un ensemble de niveaux détermine la variante du contenu de l'application qui est diffusée sur un appareil spécifique, pour le contenu ciblé sur les appareils.

Vous devez attribuer un niveau de priorité à chaque niveau, ce qui détermine l'ordre dans lequel ils sont évalués par Play. Pour en savoir plus, consultez la documentation sur DeviceTier.level.

Représentation JSON
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
Champs
deviceTiers[]

object (DeviceTier)

Niveaux d'appareils appartenant à l'ensemble.

DeviceTier

Un seul niveau d'appareil.

Les appareils correspondant à l'un des groupes d'appareils dans deviceGroupNames sont considérés comme correspondant au niveau.

Représentation JSON
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
Champs
deviceGroupNames[]

string

Groupes d'appareils inclus dans ce niveau. Ces groupes doivent être définis explicitement sous "deviceGroups" dans cette configuration.

level

integer

Niveau de priorité du niveau.

Les niveaux sont évalués par ordre décroissant : le niveau le plus élevé a la priorité la plus haute. Le niveau le plus élevé correspondant à un appareil donné est sélectionné pour cet appareil.

Vous devez utiliser une plage de niveaux contigus pour vos niveaux dans un ensemble de niveaux. Les niveaux d'un ensemble de niveaux doivent être uniques. Par exemple, si votre ensemble de niveaux comporte quatre niveaux (y compris le niveau de remplacement global), vous devez définir les niveaux 1, 2 et 3 dans cette configuration.

Remarque : Le niveau 0 est implicitement défini comme un niveau de secours global et est sélectionné pour les appareils qui ne correspondent à aucun des niveaux explicitement définis ici. Vous ne devez pas définir explicitement le niveau 0 dans cette configuration.

UserCountrySet

Ensemble de pays des utilisateurs.

Un ensemble de pays détermine la variante de contenu d'application diffusée dans un lieu spécifique.

Représentation JSON
{
  "name": string,
  "countryCodes": [
    string
  ]
}
Champs
name

string

Nom de l'ensemble de pays.

countryCodes[]

string

Liste des codes pays représentant les pays. Un code pays est représenté au format ISO 3166 alpha-2. Par exemple : "IT" pour l'Italie, "GE" pour la Géorgie.

Méthodes

create

Crée une configuration de niveau d'appareil pour une application.

get

Renvoie une configuration de niveau d'appareil spécifique.

list

Renvoie les configurations de niveau d'appareil créées, classées par ordre décroissant de date de création.

Codes d'erreur

Les opérations de cette ressource renvoient les codes d'erreur HTTP suivants :

Code d'erreur Motif Description Solution
400 invalidValue Une valeur incorrecte a été fournie dans la demande. Cette erreur est souvent renvoyée pour un jeton d'achat mal formé ou non valide. Corrigez la valeur de champ non valide dans le corps ou les paramètres de la requête en vous basant sur la documentation de référence de l'API.
400 required Un champ ou un paramètre obligatoire est manquant dans la requête. Consultez la documentation de l'API pour vous assurer d'inclure tous les champs et paramètres obligatoires.
403 userInsufficientPermission L'utilisateur ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée. Assurez-vous que l'utilisateur authentifié dispose des autorisations nécessaires dans la Google Play Console. Pour en savoir plus, consultez Utiliser un compte de service.
404 notFound La ressource demandée est introuvable. Vérifiez que les identifiants (par exemple, le jeton d'achat, le nom du package, l'ID du produit ou l'ID de l'abonnement) sont corrects.
409 concurrentUpdate Une tentative de mise à jour d'un objet en cours de mise à jour simultanée a été effectuée. Réessayez la requête avec un intervalle exponentiel entre les tentatives. Évitez de modifier simultanément la même ressource.
5xx Generic error Erreur générique sur le serveur Google Play. Réessayez d'envoyer votre demande.

Si le problème persiste, contactez votre responsable de compte Google Play ou envoyez une demande d'assistance. Consultez le tableau de bord d'état Play pour connaître les éventuelles interruptions de service.