Method: projects.apps.releases.list

Liệt kê các bản phát hành. Theo mặc định, sắp xếp theo createTime theo thứ tự giảm dần.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC .

Tham số đường dẫn

Thông số
parent

string

Yêu cầu. Tên của tài nguyên ứng dụng, là nguồn gốc của tài nguyên phát hành.

Định dạng: projects/{projectNumber}/apps/{appId}

Việc ủy ​​quyền yêu cầu quyền IAM sau đối với dự án Firebase sở hữu parent tài nguyên được chỉ định:

  • firebaseappdistro.releases.list

Tham số truy vấn

Thông số
pageSize

integer

Số lượng phát hành tối đa để trả lại. Dịch vụ có thể trả về ít hơn giá trị này. Phạm vi hợp lệ là [1-100]; Nếu không được chỉ định (0), tối đa 25 bản phát hành sẽ được trả về. Các giá trị trên 100 bị ép buộc thành 100.

pageToken

string

Mã thông báo trang, nhận được từ lệnh gọi releases.list trước đó. Cung cấp điều này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho releases.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

orderBy

string

Các trường được sử dụng để đặt hàng phát hành.

Các trường được hỗ trợ:

  • createTime

Để chỉ định thứ tự giảm dần cho một trường, hãy thêm hậu tố "desc", ví dụ: createTime desc .

Nếu tham số này không được đặt, các bản phát hành sẽ được sắp xếp theo createTime theo thứ tự giảm dần.

filter

string

Biểu thức để lọc các bản phát hành được liệt kê trong phản hồi. Để tìm hiểu thêm về lọc, hãy tham khảo tiêu chuẩn AIP-160 của Google .

Các trường được hỗ trợ:

  • releaseNotes.text hỗ trợ = (có thể chứa ký tự đại diện ( * ) ở đầu hoặc cuối chuỗi)
  • createTime hỗ trợ < , <= , > và >= và mong đợi một chuỗi được định dạng RFC-3339

Ví dụ:

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

Nội dung yêu cầu

Phần thân yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho releases.list .

Biểu diễn JSON
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
Lĩnh vực
releases[]

object ( Release )

Các bản phát hành

nextPageToken

string

Mã thông báo tồn tại trong thời gian ngắn, có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, sẽ không có trang tiếp theo.

Phạm vi ủy quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0 .