Method: projects.apps.releases.list

Lista as versões. Por padrão, classifica por createTime em ordem decrescente.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do app, que é o pai dos recursos de lançamento.

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

A autorização exige a seguinte permissão do IAM no projeto do Firebase que tem o recurso parent especificado:

  • firebaseappdistro.releases.list

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de versões a serem retornadas. O serviço pode retornar menos que esse valor. O intervalo válido é [1-100]; Se não for especificado (0), no máximo 25 versões serão retornadas. Valores acima de 100 são forçados para 100.
pageToken

string

Um token de página recebido de uma chamada releases.list anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para releases.list precisam corresponder à chamada que forneceu o token da página.
orderBy

string

Os campos usados para ordenar lançamentos.

Campos compatíveis:

  • createTime

Para especificar a ordem decrescente de um campo, adicione um "desc" sufixo, por exemplo, createTime desc.

Se esse parâmetro não for definido, as versões serão ordenadas por createTime em ordem decrescente.
filter

string

A expressão para filtrar as versões listadas na resposta. Para saber mais sobre filtros, consulte o padrão AIP-160 do Google.

Campos compatíveis:

  • releaseNotes.text aceita = (pode conter um caractere curinga (*) no início ou no final da string)
  • createTime oferece suporte a <, <=, > e >= e espera uma string no formato RFC-3339

Exemplos:

  • 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*"

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

A mensagem de resposta para releases.list.

Representação JSON 
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
Campos
releases[]

object (Release)

Os lançamentos
nextPageToken

string

Um token de curta duração, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.