Method: projects.apps.releases.list

Wyświetla listę wersji. Domyślnie sortowanie według kolumny createTime w kolejności malejącej.

Żądanie HTTP

GET https://firebaseappdistribution.googleapis.com/v1/{parent=projects/*/apps/*}/releases

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Nazwa zasobu aplikacji, który jest elementem nadrzędnym dla zasobów wersji.

Format: projects/{projectNumber}/apps/{appId}

Autoryzacja wymaga następujących uprawnień uprawnień w projekcie Firebase, do którego należy określony zasób parent:

  • firebaseappdistro.releases.list

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wersji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Prawidłowy zakres to [1-100]; Jeśli wartość nie jest określona (0), zwracanych jest maksymalnie 25 wersji. Wartości powyżej 100 są zmieniane na 100.

pageToken

string

Token strony otrzymany z poprzedniego wywołania funkcji releases.list. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu releases.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

orderBy

string

Pola używane do sortowania wersji.

Obsługiwane pola:

  • createTime

Aby określić kolejność malejącą dla pola, dołącz element „desc” (malejąco). sufiks, np. createTime desc.

Jeśli ten parametr nie jest skonfigurowany, wersje są porządkowane według parametru createTime w kolejności malejącej.

filter

string

Wyrażenie do filtrowania wersji wymienionych w odpowiedzi. Więcej informacji o filtrowaniu znajdziesz w standardzie Google AIP-160.

Obsługiwane pola:

  • Funkcja releaseNotes.text obsługuje ciągi = (może zawierać symbol wieloznaczny (*) na początku lub na końcu ciągu)
  • createTime obsługuje <, <=, > i >= oraz oczekuje ciągu w formacie RFC-3339

Przykłady:

  • createTime <= "2021-09-08T00:00:00+04:00"
  • releaseNotes.text="fixes" AND createTime >= "2021-09-08T00:00:00.0Z"
  • releaseNotes.text="*v1.0.0-rc*"

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Wiadomość z odpowiedzią dla: releases.list.

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

object (Release)

Wersje

nextPageToken

string

Token o ograniczonym czasie ważności, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu protokołu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.