Method: projects.list

يسرد كل FirebaseProject يمكن للمتصل الوصول إليه.

يتم إرجاع العناصر بدون ترتيب معين، ولكنها ستكون عرضًا متسقًا للمشاريع عند تقديم طلبات إضافية باستخدام pageToken.

تتوافق هذه الطريقة في النهاية مع التغييرات في المشروع، ما يعني أنّ المشاريع التي تم توفير المتطلبات اللازمة لها حديثًا والتعديلات الأخيرة على المشاريع الحالية قد لا تظهر في مجموعة المشاريع. لن تتضمن القائمة سوى المشاريع النشطة.

يمكنك استخدام projects.get للحصول على قراءات متسقة وكذلك للحصول على تفاصيل إضافية عن المشروع.

طلب HTTP

GET https://firebase.googleapis.com/v1beta1/projects

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

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

المَعلمات
pageToken

string

تم عرض رمز مميّز من استدعاء سابق إلى projects.list يشير إلى مكان استئناف الإدراج في مجموعة المشاريع.
pageSize

integer

الحد الأقصى لعدد المشاريع التي سيتم عرضها في الردّ.

وقد يعرض الخادم عددًا أقل من هذا العرض بناءً على تقديره الخاص. إذا لم يتم تحديد أي قيمة (أو تم تحديد قيمة أكبر مما يجب)، سيفرض الخادم حده الخاص.

لا يمكن أن تكون هذه القيمة سالبة.
showDeleted

boolean

هذه السمة اختيارية. تتحكّم هذه السياسة في ما إذا كان يجب عرض المشاريع في حالة DELETED في الردّ.

وفي حال عدم تحديده، سيتم عرض ACTIVE مشروع فقط.

نص الطلب

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

نص الاستجابة

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

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

object (FirebaseProject)

صفحة واحدة من قائمة المشاريع التي يمكن للمتصل الوصول إليها.
nextPageToken

string

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

يمكن استخدام هذا الرمز المميّز في استدعاءات لاحقة إلى projects.list للعثور على المجموعة التالية من المشاريع.

تكون الرموز المميّزة للصفحة قصيرة الأجل ويجب عدم الاحتفاظ بها.

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

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

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

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