Method: sites.versions.files.list

فایل های باقیمانده برای آپلود برای نسخه مشخص شده را فهرست می کند.

درخواست HTTP

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

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

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

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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.

وضعیت

وضعیت فعلی فایل هایی که به یک نسخه اضافه می شوند.

Enums
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 خواهد بود.