RemoteConfig は Remote Config テンプレートを表します。
プロジェクトの Remote Config テンプレートは、各アプリケーション インスタンスのフェッチ中に評価されます。
パラメータの解決された値は次のように決定されます。
アプリケーション インスタンスのtrue
conditions
参照するconditional values
指定すると、パラメーターの解決された値は、 conditions list
でname
が最も古い条件値になります。
それ以外の場合、パラメータにdefault value
ある場合、解決された値はデフォルト値に設定されます。
それ以外の場合、パラメーターには値がなく、アプリケーション インスタンスがフェッチする結果から省略されます。
たとえば、デフォルト値pear
と条件値サブマップ{"is_ios": "apple", "is_in_20_percent": "banana"}
持つパラメーター キーfruit
があるとします。ここで、 "is_ios"
と"is_20_percent"
は順序付けされた条件の名前です。状態リスト。 is_ios
true の場合、 fruit
の値はapple
と評価されます。それ以外の場合、 is_in_20_percent
がtrue
の場合、 fruit
はbanana
と評価され、 is_ios
とis_in_20_percent
が両方とも false の場合、 fruit
はpear
と評価されます。デフォルト値が指定されておらず、 is_ios
とis_in_20_percent
が両方とも false の場合、 fruit
の値は Remote Config サーバーからクライアントに返されません。
プロジェクトの Remote Config テンプレートが、 projects.updateRemoteConfig
呼び出しの成功によって公開されると、クライアントはこれらのパラメーター値を取得してユーザーに表示できます。
JSON表現 |
---|
{ "conditions": [ { object ( |
田畑 | |
---|---|
conditions[] | 優先度の降順に並べられた条件のリスト。 |
parameters | パラメータ キーとそのオプションのデフォルト値およびオプションの条件値へのマップ。 |
version | バージョンの |
parameterGroups | パラメータ グループ名の説明とグループ化されたパラメータへのマップ。グループの名前は変更可能ですが、構成内のグループ間で一意である必要があります。名前は 256 文字に制限されており、人間が判読できるように設計されています。あらゆる Unicode 文字が許可されます。 グループにはパラメータのリストがあり、API のユーザーは、同じ機能またはテーマに関連付けられたパラメータをグループ化して、組織的に簡単にアクセスできるようになります。 たとえば、「Search V2」という名前のパラメータ グループには「新しいモバイル検索ビュー」 |
RemoteConfigCondition
特定のユーザー グループを対象とした条件。これらの条件のリストは、RemoteConfig オブジェクトの一部を構成します。
JSON表現 |
---|
{
"name": string,
"expression": string,
"tagColor": enum ( |
田畑 | |
---|---|
name | 必須。この条件の空ではない一意の名前。 |
expression | 必須。この条件のロジック。 このフィールドの予想される構文については、条件式に関するドキュメントを参照してください。 |
tagColor | オプション。 Firebase コンソールでの表示を目的として、この条件に関連付けられた色。この値を指定しない場合、または「CONDITION_DISPLAY_COLOR_UNSPECIFIED」を指定すると、コンソールは条件に関連付ける任意の色を選択します。 |
状態表示色
表示目的で条件に関連付けられている色のリスト。
列挙型 | |
---|---|
CONDITION_DISPLAY_COLOR_UNSPECIFIED | |
BLUE | 青 |
BROWN | 茶色 |
CYAN | シアン |
DEEP_ORANGE | 別名「レッドオレンジ」 |
GREEN | 緑 |
INDIGO | インジゴ |
LIME | ライム |
ORANGE | オレンジ |
PINK | ピンク |
PURPLE | 紫 |
TEAL | ティール |
RemoteConfigパラメータ
google.firebase.remoteconfig.v1.RemoteConfig.parameters
のパラメータ キーに関連付けられたパラメータ値。
パラメータが何らかの効果を発揮するには、少なくとも、 defaultValue
またはconditionalValues
エントリが存在する必要があります。
JSON表現 |
---|
{ "defaultValue": { object ( |
田畑 | |
---|---|
defaultValue | オプション - 指定された条件がいずれも |
conditionalValues | オプション - ( |
description | オプション。このパラメータの説明。その長さは 256 文字以下である必要があります。説明には Unicode 文字を含めることができます。 |
valueType | 現在のバージョンのテンプレートにおけるこのパラメータのすべての値のデータ型。指定しない場合、デフォルトは |
RemoteConfigParameterValue
RemoteConfigParameterValue リソースには、パラメーターが持つことができる値が含まれています。
JSON表現 |
---|
{ // Union field |
田畑 | |
---|---|
ユニオンフィールドvalue_option 。 RemoteConfigParameterValue は、文字列 (値) またはブール値 (use_in_app_default、該当する場合は true に設定) で構成されます。 value_option は、次のいずれか 1 つだけを指定できます。 | |
value | パラメータに設定される文字列値。 |
useInAppDefault | true の場合、クライアントに返されるパラメータ値からパラメータが省略されます。 |
personalizationValue | 構成がフェッチされるときに計算される動的なユーザー固有の値。 |
パーソナライゼーション価値
パーソナライズされた値を取得するために必要な情報が含まれています。
JSON表現 |
---|
{ "personalizationId": string } |
田畑 | |
---|---|
personalizationId | パーソナライゼーション定義を表す識別子。この定義は、構成の取得時に値を解決するために使用されます。このシステム生成値は変更しないでください。 |
パラメータ値の種類
パラメーター値として受け入れられるデータ型。
列挙型 | |
---|---|
PARAMETER_VALUE_TYPE_UNSPECIFIED | 認識できない列挙値をキャッチオールします。 |
STRING | 文字列値を表します。 |
BOOLEAN | ブール値 (「true」または「false」) を表します。 |
NUMBER | 正と負の両方の整数値と浮動小数点数を表します。 |
JSON | JSON値を表します。 |
RemoteConfigParameterGroup
パラメータの名前付きグループ。パラメータのグループ化は管理のみを目的としており、クライアント側でのパラメータ値の取得には影響しません。
JSON表現 |
---|
{
"description": string,
"parameters": {
string: {
object ( |
田畑 | |
---|---|
description | オプション。グループの説明。その長さは 256 文字以下である必要があります。説明には Unicode 文字を含めることができます。 |
parameters | このグループに属するパラメータのオプションのデフォルト値およびオプションの条件値へのパラメータ キーのマップ。パラメータは RemoteConfig ごとに 1 回だけ表示されます。グループ化されていないパラメータは最上位に表示されます。グループ内で編成されたパラメータは、そのグループのパラメータ マップ内に表示されます。 |