يسرد كل FirebaseProject
الذي يمكن للمتصل الوصول إليه.
لا يتم إرجاع العناصر بدون ترتيب معين، ولكنها ستكون عرضًا متسقًا للمشاريع عند تقديم طلبات إضافية باستخدام pageToken
.
تتوافق هذه الطريقة في النهاية مع تغييرات المشروع، مما يعني أن المشروعات المتوفرة حديثًا والتعديلات الأخيرة على المشروعات الحالية قد لا تنعكس في مجموعة المشروعات. ستتضمن القائمة المشاريع النشطة فقط.
استخدم projects.get
للحصول على قراءات متسقة وكذلك للحصول على تفاصيل إضافية عن المشروع.
طلب HTTP
GET https://firebase.googleapis.com/v1beta1/projects
يستخدم عنوان URL بناء جملة gRPC Transcoding .
معلمات الاستعلام
حدود | |
---|---|
pageToken | تم إرجاع الرمز المميز من استدعاء سابق لقائمة |
pageSize | الحد الأقصى لعدد المشاريع المراد إرجاعها في الاستجابة. قد يقوم الخادم بإرجاع أقل من هذا وفقًا لتقديره. إذا لم يتم تحديد أي قيمة (أو تم تحديد قيمة كبيرة جدًا)، فسيفرض الخادم حدًا خاصًا به. لا يمكن أن تكون هذه القيمة سالبة. |
showDeleted | خياري. التحكم في ما إذا كان يجب إرجاع المشاريع الموجودة في الحالة إذا لم يتم تحديدها، سيتم إرجاع المشاريع |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{
"results": [
{
object ( |
مجالات | |
---|---|
results[] | صفحة واحدة من قائمة المشاريع التي يمكن للمتصل الوصول إليها. |
nextPageToken | إذا كانت قائمة النتائج كبيرة جدًا بحيث لا يمكن احتواؤها في استجابة واحدة، فسيتم إرجاع الرمز المميز. إذا كانت السلسلة فارغة، فإن هذه الاستجابة هي الصفحة الأخيرة من النتائج. يمكن استخدام هذا الرمز المميز في الاستدعاءات اللاحقة لقائمة الرموز المميزة للصفحة قصيرة العمر ويجب عدم استمرارها. |
نطاقات التفويض
يتطلب أحد نطاقات 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
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .