Method: projects.apps.releases.list

انتشارات را فهرست می کند. به طور پیش فرض، بر اساس createTime به ترتیب نزولی مرتب می شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

برای تعیین ترتیب نزولی برای یک فیلد، یک پسوند "desc" اضافه کنید، به عنوان مثال، createTime desc .

اگر این پارامتر تنظیم نشده باشد، انتشارها توسط createTime به ترتیب نزولی مرتب می شوند.

filter

string

عبارت فیلتر کردن انتشارهای فهرست شده در پاسخ. برای کسب اطلاعات بیشتر در مورد فیلتر کردن، به استاندارد AIP-160 گوگل مراجعه کنید.

زمینه های پشتیبانی شده:

  • releaseNotes.text supports = (می تواند شامل یک کاراکتر عام ( * ) در ابتدا یا انتهای رشته باشد)
  • 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 مراجعه کنید.