Method: projects.searchApps

Belirtilen FirebaseProject için mevcut tüm Uygulamaları listeler.

Bu kolaylık sağlayan bir yöntemdir. Genellikle bir Uygulamayla etkileşim, platforma özel hizmet kullanılarak yapılmalıdır, ancak bazı araç kullanım durumları, bilinen tüm Uygulamaların bir özetini gerektirir (Uygulama seçici arayüzleri gibi).

HTTP isteği

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

URL, gRPC Kod Dönüştürme sözdizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Uygulamaların listeleneceği ana FirebaseProject şu formattadır:

projects/ PROJECT_IDENTIFIER

PROJECT_IDENTIFIER değerleriyle ilgili ayrıntılar için FirebaseProject name alanına bakın.

Sorgu parametreleri

Parametreler
pageToken

string

Belirteç, önceki bir çağrıdan projects.searchApps geri döndü ve Uygulama kümesinin neresinde listelemeye devam edileceğini belirtti.

pageSize

integer

Yanıtta döndürülecek maksimum Uygulama sayısı.

Sunucu kendi takdirine bağlı olarak bu değerden daha azını döndürebilir. Hiçbir değer belirtilmezse (veya çok büyük bir değer belirtilirse), sunucu kendi sınırını uygulayacaktır.

Bu değer negatif olamaz.

filter

string

Google'ın AIP-160 standardıyla uyumlu bir sorgu dizesi.

Bir sorguda aşağıdaki alanlardan herhangi birini kullanın:

Bu sorgu aynı zamanda aşağıdaki "sanal" alanları da destekler. Bunlar aslında döndürülen kaynak nesnesinin parçası olmayan alanlardır ancak belirli değerlerle önceden doldurulmuş gibi sorgulanabilirler.

  • sha1_hash veya sha1Hashes : Bu alan, AndroidApp kayıtlı tüm SHA-1 sertifikası parmak izlerinin listesiyle doldurulan, tekrarlanan bir string alanı olarak kabul edilir. Uygulama bir AndroidApp değilse bu liste boştur.
  • sha256_hash veya sha256Hashes : Bu alan, AndroidApp kayıtlı tüm SHA-256 sertifikası parmak izlerinin listesiyle doldurulan, tekrarlanan bir string alanı olarak kabul edilir. Uygulama bir AndroidApp değilse bu liste boştur.
  • appStoreId : Bu alan, IosApp kayıtlı Apple App Store Kimliği ile doldurulmuş tekil bir string alanı olarak kabul edilir. Uygulama bir IosApp değilse bu alan boştur.
  • teamId : Bu alan, IosApp kayıtlı Apple ekip kimliğiyle doldurulmuş tekil bir string alanı olarak kabul edilir. Uygulama bir IosApp değilse bu alan boştur.
showDeleted

boolean

DELETED durumundaki Uygulamaların döndürülüp döndürülmeyeceğini kontrol eder.

Belirtilmediği takdirde yalnızca ACTIVE Uygulamalar döndürülecektir.

Talep gövdesi

İstek gövdesi boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "apps": [
    {
      object (FirebaseAppInfo)
    }
  ],
  "nextPageToken": string
}
Alanlar
apps[]

object ( FirebaseAppInfo )

projects.searchApps çağrısından elde edilen sonuçların bir sayfası.

nextPageToken

string

Sonuç listesi tek bir yanıta sığmayacak kadar büyükse bir belirteç döndürülür.

Bu belirteç, sonraki Uygulama grubunu bulmak için projects.searchApps yapılan sonraki çağrılarda kullanılabilir.

Sayfa belirteçleri kısa ömürlüdür ve kalıcı olmamalıdır.

Yetki Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış bölümüne bakın.

FirebaseUygulama Bilgisi

Bir Uygulamanın üst düzey özeti.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "platform": enum (AppPlatform),
  "appId": string,
  "namespace": string,
  "apiKeyId": string,
  "state": enum (State)
}
Alanlar
name

string

Firebase Uygulamasının kaynak adı şu biçimdedir:

projects/ PROJECT_ID /iosApps/ APP_ID

veya

projects/ PROJECT_ID /androidApps/ APP_ID

veya

projects/ PROJECT_ID /webApps/ APP_ID

displayName

string

Firebase Uygulamasının kullanıcı tarafından atanan görünen adı.

platform

enum ( AppPlatform )

Firebase Uygulamasının platformu.

appId

string

Yalnızca çıktı. Değişmez. WebApp için Firebase tarafından atanan küresel benzersiz tanımlayıcı.

Veri formatı belirtilmediğinden bu tanımlayıcının opak bir belirteç olarak ele alınması gerekir.

namespace

string

Yalnızca çıktı. Değişmez. Uygulamanın platforma özel tanımlayıcısı.

Not: Çoğu kullanım durumunda, bir Uygulamaya referans vermek için standart, genel olarak benzersiz tanımlayıcı olan appId kullanın.

Bu dize, her platform için yerel bir tanımlayıcıdan türetilir: AndroidApp için packageName , IosApp için bundleId ve WebApp için webId . Platformlar geliştikçe yerel tanımlayıcı formatı değişebileceğinden içeriğinin opak olarak ele alınması gerekir. Bu dize yalnızca bir FirebaseProject ve onunla ilişkili Uygulamalar içinde benzersizdir.

apiKeyId

string

Uygulamayla ilişkili Firebase API anahtarı için Google tarafından atanan küresel benzersiz tanımlayıcı (UID).

Bu değerin, API anahtarının keyString değil , API anahtarının UID'si olduğunu unutmayın. keyString Uygulamanın yapılandırma yapısında ( AndroidApp | IosApp | WebApp ) bulunabilen değerdir.

Uygulamayı oluşturma isteklerinde apiKeyId ayarlanmamışsa ( AndroidApp | IosApp | WebApp ), Firebase otomatik olarak bir apiKeyId Uygulamayla ilişkilendirir. Otomatik olarak ilişkilendirilen bu anahtar mevcut bir geçerli anahtar olabilir veya geçerli bir anahtar yoksa yeni bir anahtar sağlanacaktır.

state

enum ( State )

Yalnızca çıktı. Uygulamanın yaşam döngüsü durumu.

Uygulama Platformu

Firebase Uygulamasının ilişkilendirilebileceği platformlar.

Numaralandırmalar
PLATFORM_UNSPECIFIED Bilinmeyen durum. Bu yalnızca ayarlanmamış değerleri ayırt etmek için kullanılır.
IOS Firebase Uygulaması iOS ile ilişkilidir.
ANDROID Firebase Uygulaması Android ile ilişkilidir.
WEB Firebase Uygulaması web ile ilişkilidir.