Method: projects.searchApps

Wyświetla listę wszystkich dostępnych aplikacji dla określonego FirebaseProject .

Jest to wygodna metoda. Zazwyczaj interakcja z aplikacją powinna odbywać się za pomocą usługi specyficznej dla platformy, ale niektóre przypadki użycia narzędzi wymagają podsumowania wszystkich znanych aplikacji (np. w przypadku interfejsów selektora aplikacji).

Żądanie HTTP

GET https://firebase.googleapis.com/v1beta1/{parent=projects/*}:searchApps

Adres URL używa składni transkodowania gRPC .

Parametry ścieżki

Parametry
parent

string

Nadrzędny FirebaseProject , dla którego chcesz wyświetlić listę aplikacji, w formacie:

projects/ PROJECT_IDENTIFIER

Szczegółowe informacje na temat wartości PROJECT_IDENTIFIER można znaleźć w polu name FirebaseProject .

Parametry zapytania

Parametry
pageToken

string

Token zwrócony z poprzedniego wywołania projects.searchApps wskazujący, gdzie w zestawie aplikacji należy wznowić wyświetlanie.

pageSize

integer

Maksymalna liczba aplikacji zwracanych w odpowiedzi.

Serwer może według własnego uznania zwrócić mniej niż ta wartość. Jeśli nie zostanie określona żadna wartość (lub zostanie określona wartość zbyt duża), serwer narzuci własny limit.

Wartość ta nie może być ujemna.

filter

string

Ciąg zapytania zgodny ze standardem Google AIP-160 .

Użyj dowolnego z poniższych pól w zapytaniu:

To zapytanie obsługuje również następujące pola „wirtualne”. Są to pola, które w rzeczywistości nie są częścią zwróconego obiektu zasobu, ale można je odpytywać tak, jakby były wstępnie wypełnione określonymi wartościami.

  • sha1_hash lub sha1Hashes : To pole jest uważane za powtarzające się pole string , wypełnione listą wszystkich odcisków palców certyfikatów SHA-1 zarejestrowanych w AndroidApp . Ta lista jest pusta, jeśli aplikacja nie jest AndroidApp .
  • sha256_hash lub sha256Hashes : To pole jest uznawane za powtarzające się pole string , w którym znajduje się lista wszystkich odcisków palców certyfikatów SHA-256 zarejestrowanych w AndroidApp . Ta lista jest pusta, jeśli aplikacja nie jest AndroidApp .
  • appStoreId : To pole jest uważane za pojedyncze pole string wypełnione identyfikatorem Apple App Store zarejestrowanym w aplikacji IosApp . To pole jest puste, jeśli aplikacja nie jest aplikacją IosApp .
  • teamId : To pole jest uważane za pojedyncze pole string , wypełnione identyfikatorem zespołu Apple zarejestrowanym w IosApp . To pole jest puste, jeśli aplikacja nie jest aplikacją IosApp .
showDeleted

boolean

Określa, czy aplikacje w stanie DELETED powinny być zwracane.

Jeśli nie określono, zwrócone zostaną tylko ACTIVE aplikacje.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Jeśli się powiedzie, treść odpowiedzi zawiera dane o następującej strukturze:

Reprezentacja JSON
{
  "apps": [
    {
      object (FirebaseAppInfo)
    }
  ],
  "nextPageToken": string
}
Pola
apps[]

object ( FirebaseAppInfo )

Jedna strona wyników wywołania projects.searchApps .

nextPageToken

string

Jeśli lista wyników jest zbyt duża, aby zmieścić się w jednej odpowiedzi, zwracany jest token.

Token ten można wykorzystać w kolejnych wywołaniach projects.searchApps w celu znalezienia kolejnej grupy aplikacji.

Tokeny strony są krótkotrwałe i nie należy ich utrwalać.

Zakresy autoryzacji

Wymaga jednego z następujących zakresów 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

Aby uzyskać więcej informacji, zobacz Omówienie uwierzytelniania .

Informacje o aplikacji Firebase

Ogólne podsumowanie aplikacji.

Reprezentacja JSON
{
  "name": string,
  "displayName": string,
  "platform": enum (AppPlatform),
  "appId": string,
  "namespace": string,
  "apiKeyId": string,
  "state": enum (State)
}
Pola
name

string

Nazwa zasobu aplikacji Firebase w formacie:

projects/ PROJECT_ID /iosApps/ APP_ID

Lub

projects/ PROJECT_ID /androidApps/ APP_ID

Lub

projects/ PROJECT_ID /webApps/ APP_ID

displayName

string

Przypisana przez użytkownika nazwa wyświetlana aplikacji Firebase.

platform

enum ( AppPlatform )

Platforma aplikacji Firebase.

appId

string

Tylko wyjście. Niezmienny. Unikalny globalnie identyfikator przypisany przez Firebase dla WebApp .

Identyfikator ten należy traktować jako token nieprzezroczysty, gdyż nie jest określony format danych.

namespace

string

Tylko wyjście. Niezmienny. Identyfikator aplikacji specyficzny dla platformy.

Uwaga: w większości przypadków użyj appId , który jest kanonicznym, globalnie unikalnym identyfikatorem odwołującym się do aplikacji.

Ten ciąg pochodzi z natywnego identyfikatora każdej platformy: packageName dla AndroidApp , bundleId dla IosApp i webId dla WebApp . Jego zawartość należy traktować jako nieprzejrzystą, ponieważ natywny format identyfikatora może zmieniać się w miarę ewolucji platform. Ten ciąg jest unikalny tylko w ramach FirebaseProject i powiązanych z nim aplikacji.

apiKeyId

string

Globalnie unikalny identyfikator przypisany przez Google (UID) klucza API Firebase powiązanego z Aplikacją.

Należy pamiętać, że ta wartość jest identyfikatorem UID klucza API, a nie keyString klucza API. keyString to wartość, którą można znaleźć w artefakcie konfiguracji aplikacji ( AndroidApp | IosApp | WebApp ).

Jeśli apiKeyId nie jest ustawiony w żądaniach utworzenia aplikacji ( AndroidApp | IosApp | WebApp ), Firebase automatycznie kojarzy apiKeyId z aplikacją. Ten automatycznie powiązany klucz może być istniejącym prawidłowym kluczem lub, jeśli nie istnieje żaden ważny klucz, zostanie udostępniony nowy.

state

enum ( State )

Tylko wyjście. Stan cyklu życia aplikacji.

Platforma aplikacji

Platformy, z którymi można powiązać aplikację Firebase.

Wyliczenia
PLATFORM_UNSPECIFIED Nieznany stan. Służy tylko do rozróżniania nieustawionych wartości.
IOS Aplikacja Firebase jest powiązana z systemem iOS.
ANDROID Aplikacja Firebase jest powiązana z systemem Android.
WEB Aplikacja Firebase jest powiązana z web.