Method: projects.apps.releases.list

Lists releases. By default, sorts bycreateTime in descending order.

HTTP request

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

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The name of the app resource, which is the parent of the release resources.

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

Authorization requires the followingIAM permission on the Firebase project that owns the specified resourceparent:

  • firebaseappdistro.releases.list

Query parameters

Parameters
pageSize

integer

The maximum number of releases to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 releases are returned. Values above 100 are coerced to 100.

pageToken

string

A page token, received from a previousreleases.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided toreleases.list must match the call that provided the page token.

orderBy

string

The fields used to order releases.

Supported fields:

  • createTime

To specify descending order for a field, append a "desc" suffix, for example,createTime desc.

If this parameter is not set, releases are ordered bycreateTime in descending order.

filter

string

The expression to filter releases listed in the response. To learn more about filtering, refer toGoogle's AIP-160 standard.

Supported fields:

  • releaseNotes.text supports= (can contain a wildcard character (*) at the beginning or end of the string)
  • createTime supports<,<=,> and>=, and expects an RFC-3339 formatted string

Examples:

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

Request body

The request body must be empty.

Response body

The response message forreleases.list.

If successful, the response body contains data with the following structure:

JSON representation
{"releases":[{object (Release)}],"nextPageToken":string}
Fields
releases[]

object (Release)

The releases

nextPageToken

string

A short-lived token, which can be sent aspageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see theOAuth 2.0 Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-12-30 UTC.