REST Resource: edits.tracks

Zasób: Track

konfigurację ścieżki, Zasób dla usługi TracksService.

Zapis JSON
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
Pola
track

string

Identyfikator ścieżki.

Ścieżki w formie mają specjalny prefiks jako identyfikator, np. wear:production, automotive:production.

Więcej informacji o nazwie utworu

releases[]

object (Release)

W przypadku żądania odczytu reprezentuje wszystkie aktywne wersje na ścieżce. W prośbie o aktualizację reprezentuje żądane zmiany.

Wersja

Wersja na ścieżce.

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

string

Nazwa wersji. Nie musi być unikalny. Jeśli nie jest ustawiona, nazwa jest generowana na podstawie versionName pakietu APK. Jeśli wersja zawiera wiele plików APK, nazwa jest generowana na podstawie daty.

versionCodes[]

string (int64 format)

Kody wersji wszystkich plików APK w wersji. Musi zawierać kody wersji, które mają zostać zachowane z poprzednich wersji.

releaseNotes[]

object (LocalizedText)

Opis nowości w tej wersji.

status

enum (Status)

Stan wersji.

userFraction

number

Ułamek użytkowników, którzy kwalifikują się do stopniowego wdrażania. 0 < ułamek < 1. Można ustawić tylko wtedy, gdy stan to „w trakcie” lub „wstrzymany”.

countryTargeting

object (CountryTargeting)

Ogranicza wersję do określonego zestawu krajów. Pamiętaj, że można to ustawić tylko w przypadku wersji w trakcie wdrażania w ścieżce produkcyjnej.

inAppUpdatePriority

integer

Priorytet aktualizacji w aplikacji. Wszystkie nowo dodane pliki APK w wersji będą traktowane z tym priorytetem. Może przyjmować wartości z zakresu [0, 5], przy czym 5 oznacza najwyższy priorytet. Domyślna wartość to 0. Po wdrożeniu wersji nie można zaktualizować parametru inAppUpdatePriority. Więcej informacji znajdziesz na stronie https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Przetłumaczony tekst w danym języku.

Zapis JSON
{
  "language": string,
  "text": string
}
Pola
language

string

Kod lokalizacji języka (tag języka BCP-47, np. „de-AT” dla języka niemieckiego w Austrii).

text

string

Tekst w danym języku.

Stan

Stan wersji.

Wartości w polu enum
statusUnspecified Stan nieokreślony.
draft Pliki APK wersji nie są udostępniane użytkownikom.
inProgress Pakiety APK z wersji są udostępniane części użytkowników określonej przez parametr „userFraction”.
halted Pliki APK wersji nie będą już udostępniane użytkownikom. Nie ma to wpływu na użytkowników, którzy mają już te pliki APK.
completed Wersja nie będzie już podlegać dalszym zmianom. Jego pliki APK są udostępniane wszystkim użytkownikom, chyba że kwalifikują się oni do korzystania z plików APK z nowszej wersji.

CountryTargeting

Specyfikacja kierowania na kraj.

Zapis JSON
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
Pola
countries[]

string

Kraje, na które chcesz kierować reklamy, podane jako dwuliterowe kody CLDR.

includeRestOfWorld

boolean

Uwzględnij „reszta świata” oraz kraje, na które kierujesz reklamy.

Metody

create

Tworzy nową ścieżkę.

get

Pobiera ścieżkę.

list

Wyświetla listę wszystkich ścieżek.

patch

Poprawia ścieżkę.

update

Aktualizuje ścieżkę.

Kody błędów

Operacje na tym zasobie zwracają te kody błędów HTTP:

Kod błędu Przyczyna Opis Rozdzielczość
400 invalidValue W żądaniu podano nieprawidłową wartość. Często jest zwracany w przypadku nieprawidłowego lub nieprawidłowo sformatowanego tokena zakupu. Popraw nieprawidłową wartość pola w treści żądania lub parametrach na podstawie dokumentacji API.
400 required W żądaniu brakuje wymaganego pola lub parametru. Zapoznaj się z dokumentacją interfejsu API, aby upewnić się, że uwzględniono wszystkie obowiązkowe pola i parametry.
403 userInsufficientPermission Użytkownik nie ma wystarczających uprawnień do wykonania żądanej operacji. Sprawdź, czy uwierzytelniony użytkownik ma niezbędne uprawnienia w Konsoli Google Play. Więcej informacji znajdziesz w artykule Korzystanie z konta usługi.
404 notFound Nie znaleziono żądanego zasobu. Sprawdź, czy identyfikatory (np. token zakupu, nazwa pakietu, identyfikator produktu, identyfikator subskrypcji) są prawidłowe.
409 concurrentUpdate Podjęto próbę zaktualizowania obiektu, który jest aktualizowany równolegle. Ponów próbę wysłania żądania ze wzrastającym czasem do ponowienia. Unikaj jednoczesnego modyfikowania tego samego zasobu.
5xx Generic error Ogólny błąd serwera Google Play. Ponów żądanie.

Jeśli problem nie ustąpi, skontaktuj się z menedżerem konta Google Play lub prześlij prośbę o pomoc. Sprawdź Panel stanu Google Play, aby dowiedzieć się, czy występują znane awarie.