Method: projects.list

Wyświetla listę wszystkich elementów FirebaseProject dostępnych dla wywołującego.

Elementy są zwracane w niezłej kolejności, ale gdy dodatkowe żądania są wysyłane za pomocą elementu pageToken, pozostają one spójnym widokiem projektów.

Ta metoda jest ostatecznie zgodna z mutacjami w projekcie, co oznacza, że nowo udostępnione projekty i ostatnie zmiany w istniejących projektach mogą nie być uwzględnione w zbiorze projektów. Lista będzie zawierać tylko AKTYWNE projekty.

projects.get umożliwia spójne odczyty oraz dodatkowe szczegóły projektu.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageToken

string

Token zwrócony z poprzedniego wywołania funkcji projects.list wskazujący miejsce w zbiorze projektów do wznowienia wyświetlania.

pageSize

integer

Maksymalna liczba projektów do zwrócenia w odpowiedzi.

Serwer może zwrócić ich mniej według własnego uznania. Jeśli nie podasz żadnej wartości (lub podasz za dużą wartość), serwer nałoży własny limit.

Ta wartość nie może być ujemna.

showDeleted

boolean

Opcjonalnie. Określa, czy w odpowiedzi mają być zwracane projekty w stanie DELETED.

Jeśli nie podasz żadnej wartości, zwrócony zostanie tylko ACTIVE projekt.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "results": [
    {
      object (FirebaseProject)
    }
  ],
  "nextPageToken": string
}
Pola
results[]

object (FirebaseProject)

Jedna strona z listą projektów, które są dostępne dla elementu wywołującego.

nextPageToken

string

Jeśli lista wyników jest zbyt duża, aby zmieścić się w pojedynczej odpowiedzi, zwracany jest token. Jeśli ciąg jest pusty, ta odpowiedź jest ostatnią stroną wyników.

Tego tokena można użyć w kolejnych wywołaniach funkcji projects.list, aby znaleźć następną grupę projektów.

Tokeny stron mają krótki czas życia i nie powinny być zachowywane.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).