Method: sites.versions.files.list

يسرد الملفات المتبقية التي سيتم تحميلها للإصدار المحدّد.

طلب HTTP

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

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

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

المَعلمات
parent

string

مطلوب. الإصدار الذي يجب إدراج الملفات له بالتنسيق:

sites/SITE_ID/versions/VERSION_ID

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

المَعلمات
status

enum (Status)

نوع الملفات التي يجب إدراجها للإصدار المحدّد.
pageSize

integer

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

قد تعرض الخدمة رقمًا أقل في حال توفُّر ملفات إصدار أقل من هذا العدد الأقصى.
وإذا لم يتم تحديده، يتم استخدام القيمة التلقائية 1000.
pageToken

string

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

نص الطلب

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

نص الاستجابة

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

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

object (VersionFile)

قائمة المسارات إلى تجزئات الملفات في الإصدار المحدّد
nextPageToken

string

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

يمكنك تضمين هذا الرمز في مكالمتك التالية مع files.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

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

الحالة

الحالة الحالية للملفات التي تتم إضافتها إلى أحد الإصدارات

تعدادات
STATUS_UNSPECIFIED الحالة التلقائية لا ينبغي أن يتم استخدامه عمدًا.
EXPECTED تم تضمين الملف في الإصدار ومن المتوقّع أن يتم تحميله في المستقبل القريب.
ACTIVE تم تحميل الملف من قبل إلى "استضافة Firebase".

ملف الإصدار

يشير ذلك المصطلح إلى ملف محتوى ثابت يشكّل جزءًا من إصدار.

تمثيل JSON 
{
  "path": string,
  "hash": string,
  "status": enum (Status)
}
الحقول
path

string

معرّف الموارد المنتظم (URI) الذي يجب أن يظهر عليه محتوى الملف
hash

string

تجزئة محتوى SHA256 للملف
status

enum (Status)

النتائج فقط. الحالة الحالية لملف معيّن في الإصدار المحدّد

ستكون القيمة إما pending upload أو uploaded.