REST Resource: applications.deviceTierConfigs

Ressource: DeviceTierConfig

Konfiguration, die die Kriterien für das Gerätetargeting für die Inhalte einer App beschreibt.

JSON-Darstellung 
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
Felder
deviceTierConfigId

string (int64 format)

Nur Ausgabe. Die Geräte-Tier-Konfigurations-ID.
deviceGroups[]

object (DeviceGroup)

Definition von Gerätegruppen für die App.
deviceTierSet

object (DeviceTierSet)

Definition der Geräteklassen für die App.
userCountrySets[]

object (UserCountrySet)

Definition von Nutzerländersets für die App.

DeviceGroup

Eine Gruppe von Geräten.

Eine Gruppe wird durch eine Reihe von Geräteauswahlen definiert. Ein Gerät gehört zur Gruppe, wenn es mit einem beliebigen Selektor übereinstimmt (logisches OR).

JSON-Darstellung 
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
Felder
name

string

Der Name der Gruppe.
deviceSelectors[]

object (DeviceSelector)

Geräteauswahl für diese Gruppe. Ein Gerät, das mit einem der Selektoren übereinstimmt, wird in diese Gruppe aufgenommen.

DeviceSelector

Auswahl für eine Gerätegruppe. Ein Selektor besteht aus einer Reihe von Bedingungen für das Gerät, die alle erfüllt sein müssen (logisches UND), um die Berechtigung für eine Gerätegruppe zu bestimmen.

Wenn in einem Selektor beispielsweise RAM-Bedingungen, die Einbeziehung von Gerätemodellen und der Ausschluss von Gerätemodellen angegeben sind, gilt ein Gerät als passend, wenn: das Gerät den RAM-Bedingungen entspricht UND das Gerät einem der eingeschlossenen Gerätemodelle entspricht UND das Gerät nicht den ausgeschlossenen Gerätemodellen entspricht.

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

object (DeviceRam)

Bedingungen für den RAM des Geräts.
includedDeviceIds[]

object (DeviceId)

Gerätemodelle, die von dieser Auswahl einbezogen werden.
excludedDeviceIds[]

object (DeviceId)

Gerätemodelle, die durch diesen Selektor ausgeschlossen werden, auch wenn sie alle anderen Bedingungen erfüllen.
requiredSystemFeatures[]

object (SystemFeature)

Ein Gerät muss alle diese Systemfunktionen haben, damit es vom Selektor berücksichtigt wird.
forbiddenSystemFeatures[]

object (SystemFeature)

Ein Gerät, das eine dieser Systemfunktionen hat, wird durch diesen Selektor ausgeschlossen, auch wenn es allen anderen Bedingungen entspricht.
systemOnChips[]

object (SystemOnChip)

Optional. Die von diesem Selektor eingeschlossenen SoCs. Funktioniert nur auf Geräten mit Android S und höher.

DeviceRam

Bedingungen für die RAM-Funktionen eines Geräts.

JSON-Darstellung 
{
  "minBytes": string,
  "maxBytes": string
}
Felder
minBytes

string (int64 format)

Mindest-RAM in Byte (Grenze eingeschlossen).
maxBytes

string (int64 format)

Maximaler RAM in Byte (Grenze ausgeschlossen).

DeviceId

Kennung eines Geräts.

JSON-Darstellung 
{
  "buildBrand": string,
  "buildDevice": string
}
Felder
buildBrand

string

Wert von Build.BRAND.
buildDevice

string

Wert von Build.DEVICE.

SystemFeature

Darstellung einer Systemfunktion

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

Der Name des Features.

SystemOnChip

Darstellung eines System-on-Chip (SoC) eines Android-Geräts. Kann verwendet werden, um Geräte mit Android S+ anzusprechen.

JSON-Darstellung 
{
  "manufacturer": string,
  "model": string
}
Felder
manufacturer

string

Erforderlich. Der Designer des SoC, z. B. „Google“ Wert der Build-Eigenschaft „ro.soc.manufacturer“ https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER Erforderlich.
model

string

Erforderlich. Das Modell des SoC, z. B. „Tensor“-Wert der Build-Property „ro.soc.model“ https://developer.android.com/reference/android/os/Build#SOC_MODEL. Erforderlich.

DeviceTierSet

Eine Reihe von Geräteklassen.

Ein Stufensatz bestimmt, welche Variante von App-Inhalten auf einem bestimmten Gerät bereitgestellt wird, wenn Inhalte auf Geräte ausgerichtet sind.

Sie sollten jeder Stufe eine Prioritätsstufe zuweisen, die die Reihenfolge bestimmt, in der sie von Google Play ausgewertet werden. Weitere Informationen finden Sie in der Dokumentation zu DeviceTier.level.

JSON-Darstellung 
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
Felder
deviceTiers[]

object (DeviceTier)

Geräteklassen, die zum Set gehören.

DeviceTier

Eine einzelne Geräteklasse.

Geräte, die einer der Gerätegruppen in „deviceGroupNames“ entsprechen, werden als Geräte der Geräteklasse betrachtet.

JSON-Darstellung 
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
Felder
deviceGroupNames[]

string

Gerätegruppen, die in dieser Stufe enthalten sind. Diese Gruppen müssen in dieser Konfiguration explizit unter „deviceGroups“ definiert werden.
level

integer

Die Prioritätsstufe der Stufe.

Die Stufen werden in absteigender Reihenfolge ausgewertet: Die Stufe mit dem höchsten Niveau hat die höchste Priorität. Für ein bestimmtes Gerät wird die höchste Stufe ausgewählt, die mit dem Gerät übereinstimmt.

Sie sollten für Ihre Stufen in einem Stufensatz einen zusammenhängenden Bereich von Stufen verwenden. Stufenebenen in einem Stufensatz müssen eindeutig sein. Wenn Ihr Stufensatz beispielsweise vier Stufen (einschließlich des globalen Fallbacks) hat, sollten Sie die Stufen 1, 2 und 3 in dieser Konfiguration definieren.

Hinweis: Tier 0 ist implizit als globaler Fallback definiert und wird für Geräte ausgewählt, die keinem der hier explizit definierten Tiers entsprechen. Sie dürfen Ebene 0 in dieser Konfiguration nicht explizit definieren.

UserCountrySet

Eine Gruppe von Nutzerländern.

Mit einem Länderset wird festgelegt, welche Variante von App-Inhalten an einem bestimmten Ort ausgeliefert wird.

JSON-Darstellung 
{
  "name": string,
  "countryCodes": [
    string
  ]
}
Felder
name

string

Name des Ländersets.
countryCodes[]

string

Liste der Ländercodes, die Länder repräsentieren. Ein Ländercode wird im ISO 3166-Alpha-2-Format dargestellt. Beispiel: „IT“ für Italien, „GE“ für Georgien.

Methoden

create

 Erstellt eine neue Geräteklassenkonfiguration für eine App.

get

 Gibt eine bestimmte Gerätekonfiguration zurück.

list

 Gibt erstellte Gerätekonfigurationen zurück, sortiert nach absteigender Erstellungszeit.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dieser Fehler wird häufig zurückgegeben, wenn das Kauf-Token fehlerhaft oder ungültig ist. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern anhand der API-Referenz.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, ob alle Pflichtfelder und ‑parameter enthalten sind.
403 userInsufficientPermission Der Nutzer hat nicht die erforderlichen Berechtigungen, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kauf-Token, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
5xx Generic error Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.