Method: projects.apps.releases.list

แสดงรายการรุ่น โดยค่าเริ่มต้น จะจัดเรียงตาม createTime ในลำดับจากมากไปน้อย

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ชื่อของทรัพยากรแอป ซึ่งเป็นระดับบนสุดของทรัพยากรรุ่น

รูปแบบ: projects/{projectNumber}/apps/{appId}

การให้สิทธิ์ต้องมีสิทธิ์ IAM ต่อไปนี้ในโปรเจ็กต์ Firebase ที่เป็นเจ้าของทรัพยากรที่ระบุ parent

  • firebaseappdistro.releases.list

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

จำนวนสูงสุดของรุ่นที่จะส่งคืน บริการอาจแสดงผลน้อยกว่าค่านี้ ช่วงที่ถูกต้องคือ [1-100] หากไม่ระบุ (0) ระบบจะแสดงผลรุ่นสูงสุด 25 รายการ ค่าที่มากกว่า 100 จะถูกเปลี่ยนเป็น 100
pageToken

string

โทเค็นของหน้าเว็บที่ได้รับจากการโทร releases.list ก่อนหน้า ระบุพารามิเตอร์นี้เพื่อเรียกข้อมูลหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ releases.list ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ
orderBy

string

ช่องที่ใช้สั่งซื้อรุ่น

ฟิลด์ที่รองรับ:

  • createTime

หากต้องการระบุลำดับช่องจากมากไปน้อย ให้ใส่ "มากไปน้อย" ต่อท้าย เช่น createTime desc

หากไม่ได้ตั้งค่าพารามิเตอร์นี้ รุ่นจะเรียงลำดับตาม createTime ในลำดับจากมากไปน้อย
filter

string

นิพจน์สำหรับกรองรุ่นต่างๆ ที่แสดงอยู่ในคำตอบ ดูข้อมูลเพิ่มเติมเกี่ยวกับการกรองได้ที่มาตรฐาน AIP-160 ของ Google

ฟิลด์ที่รองรับ:

  • releaseNotes.text รองรับ = (มีอักขระไวลด์การ์ด (*) ที่ตอนต้นหรือตอนท้ายของสตริงได้)
  • createTime รองรับ <, <=, > และ >= และต้องใช้สตริงในรูปแบบ RFC-3339

ตัวอย่าง

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

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลที่มีโครงสร้างต่อไปนี้

ข้อความตอบกลับสำหรับ releases.list

การแสดง JSON 
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
ช่อง
releases[]

object (Release)

ผลงาน
nextPageToken

string

โทเค็นที่มีอายุสั้น ซึ่งสามารถส่งเป็น pageToken เพื่อเรียกดูหน้าถัดไปได้ หากเว้นช่องนี้ไว้ จะไม่มีหน้าลำดับต่อมา

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0