RemoteConfig

RemoteConfig, Remote Config şablonunu temsil eder.

Bir projenin Remote Config şablonu, her uygulama örneğinin getirilmesi sırasında değerlendirilir.

Bir parametrenin çözümlenen değeri şu şekilde belirlenir:

Uygulama örneğinin true conditions atıfta bulunan conditional values göz önüne alındığında, parametrenin çözümlenen değeri, name conditions list en eski olan koşullu değerdir.

Aksi takdirde, parametrenin default value varsa, çözümlenen değer varsayılan değere ayarlanır.

Aksi takdirde parametrenin hiçbir değeri yoktur ve uygulama örneğinin getirdiği sonuçtan çıkarılır.

Örneğin, varsayılan değeri fruit olan ve koşullu değer alt haritası olan {" pear {"is_ios": "apple", "is_in_20_percent": "banana"} sahip olduğumuzu varsayalım; burada "is_ios" ve "is_20_percent" sıralanan koşulların adlarıdır. durum listesi. is_ios doğruysa fruit değeri apple olarak değerlendirilir. Aksi takdirde, is_in_20_percent true , fruit banana olarak değerlendirilir ve is_ios ve is_in_20_percent her ikisi de yanlışsa, fruit pear olarak değerlendirilir. Varsayılan değer belirtilmemişse ve is_ios ve is_in_20_percent her ikisi de yanlışsa, Remote Config sunucusundan istemciye fruit için hiçbir değer döndürülmez.

Bir projenin Remote Config şablonu başarılı bir projects.updateRemoteConfig çağrısı aracılığıyla yayınlandıktan sonra, istemciler bu parametre değerlerini alıp bunları kullanıcılara görüntüleyebilir.

JSON gösterimi
{
  "conditions": [
    {
      object (RemoteConfigCondition)
    }
  ],
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  },
  "version": {
    object (Version)
  },
  "parameterGroups": {
    string: {
      object (RemoteConfigParameterGroup)
    },
    ...
  }
}
Alanlar
conditions[]

object ( RemoteConfigCondition )

Önceliğe göre azalan sırada koşulların listesi.

google.firebase.remoteconfig.v1.RemoteConfigCondition.name girişlerinin değerleri benzersiz olmalıdır.

parameters

map (key: string, value: object ( RemoteConfigParameter ))

Parametre anahtarlarının isteğe bağlı varsayılan değerlerine ve isteğe bağlı koşullu değerlerine eşlenmesi.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

version

object ( Version )

Sürüm description dışında yalnızca çıktı. Bir şablonun belirli bir sürümüyle ilişkili meta veriler. Bir sürümün açıklama alanı, projects.updateRemoteConfig çağrılarında belirtilebilir.

parameterGroups

map (key: string, value: object ( RemoteConfigParameterGroup ))

Parametre grubu adlarının açıklamalarına ve gruplandırılmış parametrelere eşlenmesi. Bir grubun adı değiştirilebilir ancak yapılandırmadaki gruplar arasında benzersiz olmalıdır. Ad 256 karakterle sınırlıdır ve insanların okuyabileceği şekilde tasarlanmıştır. Herhangi bir Unicode karaktere izin verilir.

Gruplarda, API kullanıcılarının, kolay kurumsal erişim için aynı özellik veya temayla ilişkili parametreleri bir arada gruplandırmasına olanak tanıyan bir parametreler listesi bulunur.

Örneğin, "Arama V2" adındaki bir parametre grubu, "Yeni mobil arama görünümü" description sahip olabilir ve yeni aramanın düzeni ve yazı tipine ilişkin parametreler içerebilir.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

RemoteConfigCondition

Belirli bir kullanıcı grubunu hedefleyen bir koşul. Bu koşulların listesi RemoteConfig nesnesinin bir parçasını oluşturur.

JSON gösterimi
{
  "name": string,
  "expression": string,
  "tagColor": enum (ConditionDisplayColor)
}
Alanlar
name

string

Gerekli. Bu durumun boş olmayan ve benzersiz adı.

expression

string

Gerekli. Bu durumun mantığı.

Bu alanın beklenen sözdizimi için Koşul İfadeleri ile ilgili belgelere bakın.

tagColor

enum ( ConditionDisplayColor )

İsteğe bağlı. Firebase Konsolunda görüntüleme amacıyla bu durumla ilişkilendirilen renk. Bu değerin belirtilmemesi veya "CONDITION_DISPLAY_COLOR_UNSPECIFIED" değerine sahip olunması, Konsolun durumla ilişkilendirilmek üzere rastgele bir renk seçmesine neden olur.

DurumGörüntüRenk

Görüntüleme amacıyla Koşullarla ilişkili renklerin listesi.

Numaralandırmalar
CONDITION_DISPLAY_COLOR_UNSPECIFIED
BLUE Mavi
BROWN Kahverengi
CYAN Camgöbeği
DEEP_ORANGE diğer adıyla "Kırmızı Turuncu"
GREEN Yeşil
INDIGO Çivit mavisi
LIME Kireç
ORANGE Turuncu
PINK Pembe
PURPLE Mor
TEAL turkuaz

RemoteConfigParametresi

google.firebase.remoteconfig.v1.RemoteConfig.parameters içindeki bir parametre anahtarıyla ilişkili parametre değeri.

Parametrenin herhangi bir etkiye sahip olması için en azından bir defaultValue veya conditionalValues ​​girişi mevcut olmalıdır.

JSON gösterimi
{
  "defaultValue": {
    object (RemoteConfigParameterValue)
  },
  "conditionalValues": {
    string: {
      object (RemoteConfigParameterValue)
    },
    ...
  },
  "description": string,
  "valueType": enum (ParameterValueType)
}
Alanlar
defaultValue

object ( RemoteConfigParameterValue )

İsteğe bağlı - adlandırılmış koşullardan hiçbiri true olarak değerlendirilmediğinde parametrenin ayarlanacağı değer.

conditionalValues

map (key: string, value: object ( RemoteConfigParameterValue ))

İsteğe bağlı - bir ( condition name , değer) haritası. En yüksek önceliğin koşul_adı (RemoteConfig'in koşullar listesinde ilk sırada listelenen) bu parametrenin değerini belirler.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

description

string

İsteğe bağlı. Bu Parametrenin açıklaması. Uzunluğu 256 karakterden az veya ona eşit olmalıdır. Bir açıklama herhangi bir Unicode karakter içerebilir.

valueType

enum ( ParameterValueType )

Şablonun geçerli sürümündeki bu parametrenin tüm değerlerine ilişkin veri türü. Belirtilmemişse varsayılan olarak ParameterValueType.STRING olur.

RemoteConfigParameterValue

RemoteConfigParameterValue kaynağı, bir parametrenin sahip olabileceği değeri içerir.

JSON gösterimi
{

  // Union field value_option can be only one of the following:
  "value": string,
  "useInAppDefault": boolean,
  "personalizationValue": {
    object (PersonalizationValue)
  }
  // End of list of possible types for union field value_option.
}
Alanlar
Birleşim alanı value_option . RemoteConfigParameterValue, bir dizeden (değer) veya bir booleden (use_in_app_default, uygunsa true olarak ayarlanmıştır) oluşur. value_option aşağıdakilerden yalnızca biri olabilir:
value

string

Parametrenin ayarlandığı dize değeri.

useInAppDefault

boolean

Doğruysa, istemciye döndürülen parametre değerlerinden parametre çıkarılır.

personalizationValue

object ( PersonalizationValue )

Yapılandırma getirildiğinde hesaplanan dinamik, kullanıcıya özel bir değer.

KişiselleştirmeDeğeri

Kişiselleştirilmiş bir değer elde etmek için gerekli bilgileri içerir.

JSON gösterimi
{
  "personalizationId": string
}
Alanlar
personalizationId

string

Kişiselleştirme tanımını temsil eden tanımlayıcı. Bu tanım, yapılandırma getirme sırasındaki değeri çözümlemek için kullanılır. Sistem tarafından oluşturulan bu değer değiştirilmemelidir.

ParametreDeğerTürü

Parametre değerleri için kabul edilen veri türleri.

Numaralandırmalar
PARAMETER_VALUE_TYPE_UNSPECIFIED Tanınmayan numaralandırma değerleri için tümünü yakala.
STRING Dize değerlerini temsil eder.
BOOLEAN Boole değerlerini ("doğru" veya "yanlış") temsil eder.
NUMBER Hem pozitif hem de negatif tamsayı ve kayan değer değerlerini temsil eder.
JSON JSON değerlerini temsil eder.

RemoteConfigParameterGroup

Adlandırılmış bir parametre grubu. Parametrelerin gruplandırılması yalnızca yönetim amaçlıdır ve parametre değerlerinin istemci tarafından getirilmesini etkilemez.

JSON gösterimi
{
  "description": string,
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  }
}
Alanlar
description

string

İsteğe bağlı. Grup için bir açıklama. Uzunluğu 256 karakterden az veya ona eşit olmalıdır. Bir açıklama herhangi bir Unicode karakter içerebilir.

parameters

map (key: string, value: object ( RemoteConfigParameter ))

Parametre anahtarlarının isteğe bağlı varsayılan değerlerine ve bu gruba ait parametreler için isteğe bağlı koşullu değerlere eşlenmesi. Bir parametre RemoteConfig başına yalnızca bir kez görünür: gruplanmamış bir parametre en üst düzeyde görünür; bir grup içinde düzenlenen bir parametre, kendi grubunun parametre haritasında görünür.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .