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}

يتطلّب التفويض إذن إدارة الهوية وإمكانية الوصول التالي في مشروع 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.