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가 true인 경우 fruit 값은 apple로 평가됩니다. 그렇지 않은 경우 is_in_20_percent이 true이면 fruit은 banana로, is_ios와 is_in_20_percent가 모두 거짓인 경우 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 '새 모바일 검색 보기'가 있을 수 있음 에는 새 검색의 레이아웃과 글꼴을 위한 매개변수가 포함됩니다.

"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 '빨간색 주황색'이라고도 함
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 값을 나타냅니다.

RemoteConfigParameterGroup

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

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" }