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

لتحديد ترتيب تنازلي للحقل، قم بإلحاق لاحقة "تنازلي"، على سبيل المثال، createTime desc .

إذا لم يتم تعيين هذه المعلمة، فسيتم ترتيب الإصدارات حسب createTime بترتيب تنازلي.

filter

string

التعبير لتصفية الإصدارات المدرجة في الاستجابة. لمعرفة المزيد حول التصفية، راجع معيار Google AIP-160 .

الحقول المدعومة:

  • يدعم 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 .

تمثيل جيسون
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
مجالات
releases[]

object ( Release )

الإصدارات

nextPageToken

string

رمز مميز قصير العمر، يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. إذا تم حذف هذا الحقل، فلن تكون هناك صفحات لاحقة.

نطاقات التفويض

يتطلب نطاق OAuth التالي:

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

لمزيد من المعلومات، راجع نظرة عامة على OAuth 2.0 .