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

Bắt buộc. Tên của tài nguyên ứng dụng, gốc của tài nguyên phát hành.

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

Để uỷ quyền, bạn cần có quyền IAM sau đây đối với dự án Firebase sở hữu tài nguyên được chỉ định parent:

  • firebaseappdistro.releases.list

Tham số truy vấn

Thông số
pageSize

integer

Số lượng bản phát hành tối đa cần trả về. 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 chỉ định (0), hệ thống sẽ trả về tối đa 25 bản phát hành. Những giá trị lớn hơn 100 sẽ bị 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 mã 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 dùng để sắp xếp các bản 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 "sản phẩm mô tả" hậu tố, ví dụ: createTime desc.

Nếu bạn không đặt tham số này, các bản phát hành đượ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ề cách 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à dự kiến sẽ có 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

Nội dung 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:

Tin nhắn phản hồi cho releases.list.

Biểu diễn dưới dạng JSON 
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
Trường
releases[]

object (Release)

Bản phát hành
nextPageToken

string

Mã thông báo ngắn hạ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 thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

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

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

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