RemoteConfig

RemoteConfig는 원격 구성 템플릿을 나타냅니다.

프로젝트의 원격 구성 템플릿은 각 애플리케이션 인스턴스를 가져오는 동안 평가됩니다.

참고: 서버 템플릿은 현재 비율 조건을 지원합니다. 지원되지 않는 조건부 값을 사용하여 서버 템플릿을 게시하면 유효성 검사 오류가 반환됩니다. 자세한 내용은 서버 환경의 원격 구성을 참조하세요.

매개변수의 결정된 값은 다음과 같이 결정됩니다.

애플리케이션 인스턴스의 true conditions를 참조하는 conditional values가 주어지면 매개변수의 결정된 값은 name가 conditions list에서 가장 이른 값을 갖는 조건부 값입니다.

그렇지 않으면 매개변수에 default value이 있으면 확인된 값이 기본값으로 설정됩니다.

그렇지 않으면 매개변수에 값이 없으며 애플리케이션 인스턴스가 가져오는 결과에서 생략됩니다.

예를 들어 기본값이 pear이고 조건부 값 서브맵이 {"is_ios": "apple", "is_in_20_percent": "banana"}인 매개변수 키 fruit이 있다고 가정해 보겠습니다. 여기서 "is_ios" 및 "is_20_percent"은 순서가 지정된 조건 목록에 있는 조건의 이름입니다. is_ios가 참이면 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 값이 반환되지 않습니다.

projects.updateRemoteConfig 호출을 통해 프로젝트의 원격 구성 템플릿이 게시되면 클라이언트는 이러한 매개변수 값을 가져와 사용자에게 표시할 수 있습니다.

JSON 표현 
{
  "conditions": [
    {
      object (RemoteConfigCondition)
    }
  ],
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  },
  "version": {
    object (Version)
  },
  "parameterGroups": {
    string: {
      object (RemoteConfigParameterGroup)
    },
    ...
  }
}
필드
conditions[]

object (RemoteConfigCondition)

우선순위별 내림차순으로 표시된 조건 목록입니다.

google.firebase.remoteconfig.v1.RemoteConfigCondition.name 항목의 값은 고유해야 합니다.
parameters

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

선택적 기본값 및 선택적 조건부 값에 대한 매개변수 키 매핑입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
version

object (Version)

출력 전용(버전 description 제외) 템플릿의 특정 버전과 연결된 메타데이터입니다. 버전의 설명 필드를 projects.updateRemoteConfig 호출에서 지정할 수 있습니다.
parameterGroups

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

매개변수 그룹 이름을 설명 및 그룹화된 매개변수에 매핑합니다. 그룹 이름은 변경할 수 있지만 구성의 그룹 간에 고유해야 합니다. 이름은 256자(영문 기준)로 제한되며 사람이 읽을 수 있도록 되어 있습니다. 모든 유니코드 문자가 허용됩니다.

그룹에는 API 사용자가 동일한 기능 또는 테마와 연결된 매개변수를 그룹화하여 쉽게 조직적으로 액세스할 수 있는 매개변수 목록이 있습니다.

예를 들어 이름이 'Search V2'인 매개변수 그룹에는 description 'New mobile search view'가 있을 수 있으며 새 검색의 레이아웃 및 글꼴에 관한 매개변수가 포함될 수 있습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

원격 구성 조건

특정 사용자 그룹을 타겟팅하는 조건입니다. 이러한 조건 목록은 RemoteConfig 객체의 일부로 구성됩니다.

JSON 표현 
{
  "name": string,
  "expression": string,
  "tagColor": enum (ConditionDisplayColor)
}
필드
name

string

필수 항목입니다. 이 조건의 비어 있지 않고 고유한 이름입니다.
expression

string

필수 항목입니다. 이 조건의 로직입니다.

이 필드의 예상 구문은 조건 표현식 관련 문서를 참조하세요.
tagColor

enum (ConditionDisplayColor)

선택사항입니다. Firebase Console에 표시하기 위해 이 조건과 연결된 색상입니다. 이 값을 지정하지 않거나 'CONDITION_DISPLAY_COLOR_UNSPECIFIED'를 지정하면 콘솔에서 조건과 연결할 임의의 색상을 선택합니다.

조건 표시색상

표시 목적으로 조건과 연결된 색상 목록입니다.

열거형
CONDITION_DISPLAY_COLOR_UNSPECIFIED
BLUE 파란색
BROWN Brown
CYAN 녹청색
DEEP_ORANGE 다른 명칭: "Red Orange"
GREEN 녹색
INDIGO 남색
LIME 석회
ORANGE 주황색
PINK 분홍색\\
PURPLE 보라색
TEAL 청록색

RemoteConfigParameter

google.firebase.remoteconfig.v1.RemoteConfig.parameters의 매개변수 키와 연결된 매개변수 값입니다.

매개변수가 적용되려면 최소한 defaultValue 또는 conditionalValues 항목이 있어야 합니다.

JSON 표현 
{
  "defaultValue": {
    object (RemoteConfigParameterValue)
  },
  "conditionalValues": {
    string: {
      object (RemoteConfigParameterValue)
    },
    ...
  },
  "description": string,
  "valueType": enum (ParameterValueType)
}
필드
defaultValue

object (RemoteConfigParameterValue)

선택사항 - true으로 평가되는 이름이 지정된 조건이 없는 경우 매개변수를 설정할 값입니다.
conditionalValues

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

선택사항 - (condition name, 값) 맵. 가장 높은 우선순위의 조건_이름 (RemoteConfig의 조건 목록에서 첫 번째로 나열된 상태)에 따라 이 매개변수의 값이 결정됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
description

string

선택사항입니다. 이 매개변수에 대한 설명입니다. 길이는 256자 이하여야 합니다 . 설명에는 모든 유니코드 문자가 포함될 수 있습니다.
valueType

enum (ParameterValueType)

템플릿의 현재 버전에서 이 매개변수의 모든 값에 대한 데이터 유형입니다. 지정되지 않은 경우 기본값은 ParameterValueType.STRING입니다.

원격 구성 매개변수 값

RemoteConfigParameterValue 리소스에는 매개변수에 있을 수 있는 값이 포함됩니다.

JSON 표현 
{

  // Union field value_option can be only one of the following:
  "value": string,
  "useInAppDefault": boolean,
  "personalizationValue": {
    object (PersonalizationValue)
  },
  "rolloutValue": {
    object (RolloutValue)
  }
  // End of list of possible types for union field value_option.
}
필드
통합 필드 value_option. RemoteConfigParameterValue는 문자열 (값) 또는 부울 (use_in_app_default, 해당하는 경우 true로 설정)으로 구성됩니다. value_option는 다음 중 하나여야 합니다.
value

string

매개변수가 설정된 문자열 값입니다.
useInAppDefault

boolean

true인 경우 클라이언트에 반환된 매개변수 값에서 매개변수가 생략됩니다.
personalizationValue

object (PersonalizationValue)

구성을 가져올 때 계산된 동적 사용자별 값입니다.
rolloutValue

object (RolloutValue)

Firebase ABT 실험 서비스에서 관리하는 동적 출시 값입니다.

맞춤설정 값

맞춤설정된 값을 가져오는 데 필요한 정보가 포함되어 있습니다.

JSON 표현 
{
  "personalizationId": string
}
필드
personalizationId

string

맞춤설정 정의를 나타내는 식별자입니다. 이 정의는 구성을 가져올 때 값을 확인하는 데 사용됩니다. 이 시스템 생성 값은 수정해서는 안 됩니다.

출시 값

출시와 관련된 정보입니다.

JSON 표현 
{
  "rolloutId": string,
  "value": string,
  "percent": number
}
필드
rolloutId

string

매개변수 값을 출시 실험에 연결하는 식별자입니다.
value

string

적용될 사용자 지정 값입니다.
percent

number

출시 값을 받게 될 사용자의 비율입니다.

ParameterValueType

매개변수 값에 허용되는 데이터 유형입니다.

열거형
PARAMETER_VALUE_TYPE_UNSPECIFIED 인식할 수 없는 enum 값을 포함합니다.
STRING 문자열 값을 나타냅니다.
BOOLEAN 부울 값 ('true' 또는 'false')을 나타냅니다.
NUMBER 양의 정수와 음의 정수 및 부동 소수점 값을 모두 나타냅니다.
JSON JSON 값을 나타냅니다.

원격 구성 매개변수 그룹

이름이 지정된 매개변수 그룹입니다. 매개변수를 그룹화하는 것은 관리 목적으로만 사용되며 클라이언트 측 매개변수 값 가져오기에는 영향을 미치지 않습니다.

JSON 표현 
{
  "description": string,
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  }
}
필드
description

string

선택사항입니다. 그룹에 대한 설명입니다. 길이는 256자(영문 기준) 이하여야 합니다. 설명에는 모든 유니코드 문자가 포함될 수 있습니다.
parameters

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

선택적 기본값 및 이 그룹에 속한 매개변수의 선택적 조건부 값에 매개변수 키를 매핑합니다. 매개변수는 RemoteConfig당 한 번만 표시됩니다. 그룹화되지 않은 매개변수는 최상위 수준에 표시되고 그룹 내에 구성된 매개변수는 그룹의 매개변수 맵 내에 표시됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }