Ressource: Track
Eine Track-Konfiguration. Die Ressource für TracksService.
| JSON-Darstellung |
|---|
{
"track": string,
"releases": [
{
object ( |
| Felder | |
|---|---|
track |
Kennung des Tracks. Formfaktor-Tracks haben ein spezielles Präfix als Kennzeichnung, z. B. |
releases[] |
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 ( |
| Felder | |
|---|---|
name |
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[] |
Versionscodes aller APKs im Release. Muss Versionscodes enthalten, die aus vorherigen Releases beibehalten werden sollen. |
releaseNotes[] |
Eine Beschreibung der Neuerungen in diesem Release. |
status |
Der Status der Veröffentlichung. |
userFraction |
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 |
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 |
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 |
Sprachlokalisierungscode (ein BCP-47-Sprachcode, z. B. „de-AT“ für Österreichisches Deutsch). |
text |
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[] |
Länder, auf die die Ausrichtung erfolgen soll, angegeben als zweistellige CLDR-Codes. |
includeRestOfWorld |
Schließen Sie sowohl „Rest der Welt“ als auch explizit ausgerichtete Länder ein. |
Methoden |
|
|---|---|
|
Erstellt einen neuen Track. |
|
Ruft einen Track ab. |
|
Listet alle Tracks auf. |
|
Patcht einen Track. |
|
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. |