Method: availableProjects.list

يسرد كل Google Cloud Platform (GCP) Project الذي يمكن إضافة موارد Firebase إليها.

لن يتم إدراج المشروع إلا في الحالات التالية:

طلب HTTP

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

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

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

المَعلمات
pageToken

string

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

integer

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

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

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

نص الطلب

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

نص الاستجابة

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

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

object (ProjectInfo)

قائمة Projects في Google Cloud Platform والتي يمكن إضافة موارد Firebase إليها.
nextPageToken

string

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

يمكن استخدام هذا الرمز المميّز في استدعاءات لاحقة إلى availableProjects.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

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

معلومات المشروع

مرجع إلى Project في Google Cloud Platform (GCP).

تمثيل JSON 
{
  "project": string,
  "displayName": string,
  "locationId": string
}
الحقول
project

string

اسم مورد Project على Google Cloud Platform الذي يمكن إضافة موارد Firebase إليه، بالتنسيق:

projects/PROJECT_IDENTIFIER

راجِع الحقل FirebaseProject name للحصول على تفاصيل حول قيم PROJECT_IDENTIFIER.
displayName

string

الاسم المعروض الذي خصّصه المستخدم لـ Project في Google Cloud Platform، مثل: My App
locationId

string

رقم تعريف الموقع الجغرافي التلقائي لموارد Google Cloud Platform للمشروع. يكون الموقع الجغرافي أحد مواقع موارد GCP المتاحة.

لن تتم تعبئة هذا الحقل في بعض المشاريع. إذا لم تتم تعبئة هذا الحقل، يعني هذا أنّ المشروع لا يتضمّن حتى الآن الموقع الجغرافي التلقائي لموارد GCP. لضبط الموقع الجغرافي التلقائي لمورد Google Cloud Platform لمشروع ما، يمكنك طلب defaultLocation.finalize بعد إضافة موارد Firebase إلى المشروع.