REST Resource: edits.tracks

Ressource: Track

Eine Track-Konfiguration. Die Ressource für TracksService.

JSON-Darstellung
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
Felder
track

string

Kennung des Tracks.

Formfaktor-Tracks haben ein spezielles Präfix als Kennzeichnung, z. B. wear:production oder automotive:production.

Weitere Informationen zum Tracknamen

releases[]

object (Release)

Stellt in einer Leseanfrage alle aktiven Releases im Track dar. Stellt in einer Aktualisierungsanfrage die gewünschten Änderungen dar.

Release

Ein Release in einem Track.

JSON-Darstellung
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
Felder
name

string

Der Releasename. Muss nicht eindeutig sein. Wenn der Name nicht festgelegt ist, wird er aus der versionName des APKs generiert. Wenn der Release mehrere APKs enthält, wird der Name aus dem Datum generiert.

versionCodes[]

string (int64 format)

Versionscodes aller APKs im Release. Muss Versionscodes enthalten, die aus vorherigen Releases beibehalten werden sollen.

releaseNotes[]

object (LocalizedText)

Eine Beschreibung der Neuerungen in diesem Release.

status

enum (Status)

Der Status der Veröffentlichung.

userFraction

number

Anteil der Nutzer, die für eine stufenweise Einführung infrage kommen. 0 < fraction < 1. Kann nur festgelegt werden, wenn der Status „inProgress“ oder „halted“ lautet.

countryTargeting

object (CountryTargeting)

Beschränkt einen Release auf eine bestimmte Gruppe von Ländern. Diese Einstellung darf nur für Releases im Produktions-Track festgelegt werden, die sich im Status „Wird ausgeführt“ befinden.

inAppUpdatePriority

integer

Priorität des In-App-Updates für die Version. Alle neu hinzugefügten APKs im Release werden mit dieser Priorität berücksichtigt. Kann Werte im Bereich [0, 5] annehmen, wobei 5 die höchste Priorität ist. Der Standardwert ist 0. inAppUpdatePriority kann nicht aktualisiert werden, nachdem die Version eingeführt wurde. Weitere Informationen finden Sie unter https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Lokalisierter Text in der angegebenen Sprache.

JSON-Darstellung
{
  "language": string,
  "text": string
}
Felder
language

string

Sprachlokalisierungscode (ein BCP-47-Sprachcode, z. B. „de-AT“ für Österreichisches Deutsch).

text

string

Der Text in der angegebenen Sprache.

Status

Der Status eines Releases.

Enums
statusUnspecified Nicht angegebener Status
draft Die APKs des Releases werden Nutzern nicht zur Verfügung gestellt.
inProgress Die APKs des Releases werden an einen Teil der Nutzer ausgeliefert, der durch „userFraction“ bestimmt wird.
halted Die APKs des Releases werden nicht mehr an Nutzer ausgeliefert. Nutzer, die diese APKs bereits haben, sind davon nicht betroffen.
completed Es wird keine weiteren Änderungen geben. Die APKs werden für alle Nutzer bereitgestellt, sofern sie nicht für APKs eines neueren Releases infrage kommen.

CountryTargeting

Spezifikation für die Länderausrichtung.

JSON-Darstellung
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
Felder
countries[]

string

Länder, auf die die Ausrichtung erfolgen soll, angegeben als zweistellige CLDR-Codes.

includeRestOfWorld

boolean

Schließen Sie sowohl „Rest der Welt“ als auch explizit ausgerichtete Länder ein.

Methoden

create

Erstellt einen neuen Track.

get

Ruft einen Track ab.

list

Listet alle Tracks auf.

patch

Patcht einen Track.

update

Aktualisiert einen Track.

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.