REST Resource: applications.deviceTierConfigs

Risorsa: DeviceTierConfig

Configurazione che descrive i criteri di targeting dei dispositivi per i contenuti di un'app.

Rappresentazione JSON
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
Campi
deviceTierConfigId

string (int64 format)

Solo output. L'ID di configurazione a livello di dispositivo.

deviceGroups[]

object (DeviceGroup)

Definizione dei gruppi di dispositivi per l'app.

deviceTierSet

object (DeviceTierSet)

Definizione del gruppo di livelli di dispositivi per l'app.

userCountrySets[]

object (UserCountrySet)

Definizione dei set di paesi degli utenti per l'app.

DeviceGroup

Un gruppo di dispositivi.

Un gruppo è definito da un insieme di selettori di dispositivi. Un dispositivo appartiene al gruppo se corrisponde a un selettore (OR logico).

Rappresentazione JSON
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
Campi
name

string

Il nome del gruppo.

deviceSelectors[]

object (DeviceSelector)

Selettori di dispositivi per questo gruppo. Un dispositivo che corrisponde a uno qualsiasi dei selettori è incluso in questo gruppo.

DeviceSelector

Selettore per un gruppo di dispositivi. Un selettore è costituito da un insieme di condizioni sul dispositivo che devono corrispondere (AND logico) per determinare l'idoneità di un gruppo di dispositivi.

Ad esempio, se un selettore specifica le condizioni della RAM, l'inclusione del modello di dispositivo e l'esclusione del modello di dispositivo, un dispositivo viene considerato corrispondente se: il dispositivo soddisfa le condizioni della RAM E il dispositivo corrisponde a uno dei modelli di dispositivo inclusi E il dispositivo non corrisponde ai modelli di dispositivo esclusi

Rappresentazione JSON
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
Campi
deviceRam

object (DeviceRam)

Condizioni della RAM del dispositivo.

includedDeviceIds[]

object (DeviceId)

Modelli di dispositivi inclusi in questo selettore.

excludedDeviceIds[]

object (DeviceId)

Modelli di dispositivo esclusi da questo selettore, anche se soddisfano tutte le altre condizioni.

requiredSystemFeatures[]

object (SystemFeature)

Un dispositivo deve disporre di tutte queste funzionalità di sistema per essere incluso nel selettore.

forbiddenSystemFeatures[]

object (SystemFeature)

Un dispositivo che dispone di una di queste funzionalità di sistema viene escluso da questo selettore, anche se soddisfa tutte le altre condizioni.

systemOnChips[]

object (SystemOnChip)

Facoltativo. I SoC inclusi in questo selettore. Funziona solo per i dispositivi Android S e versioni successive.

DeviceRam

Condizioni relative alle funzionalità della RAM di un dispositivo.

Rappresentazione JSON
{
  "minBytes": string,
  "maxBytes": string
}
Campi
minBytes

string (int64 format)

RAM minima in byte (limite incluso).

maxBytes

string (int64 format)

RAM massima in byte (limite escluso).

DeviceId

Identificatore di un dispositivo.

Rappresentazione JSON
{
  "buildBrand": string,
  "buildDevice": string
}
Campi
buildBrand

string

Valore di Build.BRAND.

buildDevice

string

Valore di Build.DEVICE.

SystemFeature

Rappresentazione di una funzionalità di sistema.

Rappresentazione JSON
{
  "name": string
}
Campi
name

string

Il nome della funzionalità.

SystemOnChip

Rappresentazione di un System-on-Chip (SoC) di un dispositivo Android. Può essere utilizzato per scegliere come target i dispositivi S+.

Rappresentazione JSON
{
  "manufacturer": string,
  "model": string
}
Campi
manufacturer

string

Obbligatorio. Il progettista del SoC, ad es. Valore "Google" della proprietà di build "ro.soc.manufacturer" https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER. Obbligatorio.

model

string

Obbligatorio. Il modello del SoC, ad es. Valore "Tensor" della proprietà di build "ro.soc.model" https://developer.android.com/reference/android/os/Build#SOC_MODEL. Obbligatorio.

DeviceTierSet

Un insieme di livelli di dispositivi.

Un insieme di livelli determina quale variante dei contenuti dell'app viene pubblicata su un dispositivo specifico per i contenuti mirati ai dispositivi.

Devi assegnare un livello di priorità a ogni livello, che determina l'ordine in cui vengono valutati da Google Play. Per ulteriori dettagli, consulta la documentazione di DeviceTier.level.

Rappresentazione JSON
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
Campi
deviceTiers[]

object (DeviceTier)

Livelli di dispositivi appartenenti al set.

DeviceTier

Un singolo livello di dispositivo.

I dispositivi che corrispondono a uno qualsiasi dei gruppi di dispositivi in deviceGroupNames vengono considerati corrispondenti al livello.

Rappresentazione JSON
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
Campi
deviceGroupNames[]

string

Gruppi di dispositivi inclusi in questo livello. Questi gruppi devono essere definiti in modo esplicito in deviceGroups in questa configurazione.

level

integer

Il livello di priorità del livello.

I livelli vengono valutati in ordine decrescente: il livello più alto ha la priorità più elevata. Per un determinato dispositivo viene selezionato il livello più alto corrispondente.

Devi utilizzare un intervallo contiguo di livelli per i tuoi livelli in un insieme di livelli; i livelli in un insieme di livelli devono essere univoci. Ad esempio, se il tuo insieme di livelli ha 4 livelli (incluso il fallback globale), devi definire i livelli 1, 2 e 3 in questa configurazione.

Nota: il livello 0 è definito implicitamente come fallback globale e selezionato per i dispositivi che non corrispondono a nessuno dei livelli definiti esplicitamente qui. Non devi definire esplicitamente il livello 0 in questa configurazione.

UserCountrySet

Un insieme di paesi degli utenti.

Un insieme di paesi determina quale variante dei contenuti dell'app viene pubblicata in una posizione specifica.

Rappresentazione JSON
{
  "name": string,
  "countryCodes": [
    string
  ]
}
Campi
name

string

Nome del set di paesi.

countryCodes[]

string

Elenco dei codici paese che rappresentano i paesi. Un codice paese è rappresentato nel formato ISO 3166 alpha-2. Ad esempio, "IT" per l'Italia, "GE" per la Georgia.

Metodi

create

Crea una nuova configurazione di livelli di dispositivi per un'app.

get

Restituisce una configurazione specifica del livello del dispositivo.

list

Restituisce le configurazioni dei livelli di dispositivo create, ordinate per data di creazione decrescente.

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Risoluzione
5xx Errore generico nel server Google Play. Riprova a inviare la richiesta.

Se il problema persiste, contatta il tuo Account Manager Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Play per eventuali interruzioni note.

409 Errore di aggiornamento della concorrenza.

È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento. Ad esempio, un acquisto viene confermato chiamando il metodo acknowledgePurchase() della libreria Fatturazione Play e chiamando contemporaneamente il metodo purchases.products.acknowledge dell'API Play Developer.

Riprova a inviare la richiesta.