Method: sites.versions.list

يسرد الإصدارات التي تم إنشاؤها للموقع الإلكتروني المحدّد.

تتضمن هذه القائمة إصدارات لكل من قناة live التلقائية وأي قنوات معاينة نشطة للموقع الإلكتروني المحدّد.

طلب HTTP

GET https://firebasehosting.googleapis.com/v1beta1/{parent=sites/*}/versions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوب. الموقع الإلكتروني أو القناة التي يتم إدراج نُسخ لها بأي من التنسيقَين التاليَين:

  • sites/SITE_ID

  • sites/SITE_ID/channels/CHANNEL_ID

معامِلات طلب البحث

المَعلمات
pageSize

integer

الحد الأقصى لعدد الإصدارات المطلوب عرضها.

قد تعرض الخدمة رقمًا أقل إذا كانت هناك إصدارات أقل من هذا العدد الأقصى.
وإذا لم يتم تحديده، يتم ضبط القيمة التلقائية على 25. الحد الأقصى للقيمة هو 100؛ سيتم فرض القيم الأكبر من 100 على 100.

pageToken

string

رمز مميّز من مكالمة سابقة إلى versions.list لإعلام الخادم بمكان استئناف بطاقة بيانات المتجر

filter

string

سلسلة فلاتر تُستخدَم لعرض مجموعة فرعية من الإصدارات في الردّ.

الحقول التي يمكن استخدامها حاليًا للفلترة هي: name وstatus وcreateTime. اطّلِع على مزيد من المعلومات حول الفلترة في معيار AIP 160 من Google.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "versions": [
    {
      object (Version)
    }
  ],
  "nextPageToken": string
}
الحقول
versions[]

object (Version)

قائمة الإصدارات، إن وجدت.

nextPageToken

string

الرمز المميّز للتقسيم على صفحات، في حال توفُّر نتائج أخرى غير تلك الواردة في هذه الاستجابة.

يمكنك تضمين هذا الرمز في مكالمتك التالية مع versions.list. تكون الرموز المميّزة للصفحة قصيرة الأجل ويجب عدم تخزينها.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/firebase.hosting.readonly
  • https://www.googleapis.com/auth/firebase.hosting
  • https://www.googleapis.com/auth/firebase.readonly
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.