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 ( |
필드 | |
---|---|
conditions[] |
우선순위별 내림차순으로 표시된 조건 목록입니다.
|
parameters |
선택적 기본값 및 선택적 조건부 값에 대한 매개변수 키 매핑입니다.
|
version |
출력 전용(버전 |
parameterGroups |
매개변수 그룹 이름을 설명 및 그룹화된 매개변수에 매핑합니다. 그룹 이름은 변경할 수 있지만 구성의 그룹 간에 고유해야 합니다. 이름은 256자(영문 기준)로 제한되며 사람이 읽을 수 있도록 되어 있습니다. 모든 유니코드 문자가 허용됩니다. 그룹에는 API 사용자가 동일한 기능 또는 테마와 연결된 매개변수를 그룹화하여 쉽게 조직적으로 액세스할 수 있는 매개변수 목록이 있습니다. 예를 들어 이름이 'Search V2'인 매개변수 그룹에는
|
원격 구성 조건
특정 사용자 그룹을 타겟팅하는 조건입니다. 이러한 조건 목록은 RemoteConfig 객체의 일부로 구성됩니다.
JSON 표현 |
---|
{
"name": string,
"expression": string,
"tagColor": enum ( |
필드 | |
---|---|
name |
필수 항목입니다. 이 조건의 비어 있지 않고 고유한 이름입니다. |
expression |
필수 항목입니다. 이 조건의 로직입니다. 이 필드의 예상 구문은 조건 표현식 관련 문서를 참조하세요. |
tagColor |
선택사항입니다. 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 ( |
필드 | |
---|---|
defaultValue |
선택사항 - |
conditionalValues |
선택사항 - (
|
description |
선택사항입니다. 이 매개변수에 대한 설명입니다. 길이는 256자 이하여야 합니다 . 설명에는 모든 유니코드 문자가 포함될 수 있습니다. |
valueType |
템플릿의 현재 버전에서 이 매개변수의 모든 값에 대한 데이터 유형입니다. 지정되지 않은 경우 기본값은 |
원격 구성 매개변수 값
RemoteConfigParameterValue 리소스에는 매개변수에 있을 수 있는 값이 포함됩니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 value_option . RemoteConfigParameterValue는 문자열 (값) 또는 부울 (use_in_app_default, 해당하는 경우 true로 설정)으로 구성됩니다. value_option 는 다음 중 하나여야 합니다. |
|
value |
매개변수가 설정된 문자열 값입니다. |
useInAppDefault |
true인 경우 클라이언트에 반환된 매개변수 값에서 매개변수가 생략됩니다. |
personalizationValue |
구성을 가져올 때 계산된 동적 사용자별 값입니다. |
rolloutValue |
Firebase ABT 실험 서비스에서 관리하는 동적 출시 값입니다. |
맞춤설정 값
맞춤설정된 값을 가져오는 데 필요한 정보가 포함되어 있습니다.
JSON 표현 |
---|
{ "personalizationId": string } |
필드 | |
---|---|
personalizationId |
맞춤설정 정의를 나타내는 식별자입니다. 이 정의는 구성을 가져올 때 값을 확인하는 데 사용됩니다. 이 시스템 생성 값은 수정해서는 안 됩니다. |
출시 값
출시와 관련된 정보입니다.
JSON 표현 |
---|
{ "rolloutId": string, "value": string, "percent": number } |
필드 | |
---|---|
rolloutId |
매개변수 값을 출시 실험에 연결하는 식별자입니다. |
value |
적용될 사용자 지정 값입니다. |
percent |
출시 값을 받게 될 사용자의 비율입니다. |
ParameterValueType
매개변수 값에 허용되는 데이터 유형입니다.
열거형 | |
---|---|
PARAMETER_VALUE_TYPE_UNSPECIFIED |
인식할 수 없는 enum 값을 포함합니다. |
STRING |
문자열 값을 나타냅니다. |
BOOLEAN |
부울 값 ('true' 또는 'false')을 나타냅니다. |
NUMBER |
양의 정수와 음의 정수 및 부동 소수점 값을 모두 나타냅니다. |
JSON |
JSON 값을 나타냅니다. |
원격 구성 매개변수 그룹
이름이 지정된 매개변수 그룹입니다. 매개변수를 그룹화하는 것은 관리 목적으로만 사용되며 클라이언트 측 매개변수 값 가져오기에는 영향을 미치지 않습니다.
JSON 표현 |
---|
{
"description": string,
"parameters": {
string: {
object ( |
필드 | |
---|---|
description |
선택사항입니다. 그룹에 대한 설명입니다. 길이는 256자(영문 기준) 이하여야 합니다. 설명에는 모든 유니코드 문자가 포함될 수 있습니다. |
parameters |
선택적 기본값 및 이 그룹에 속한 매개변수의 선택적 조건부 값에 매개변수 키를 매핑합니다. 매개변수는 RemoteConfig당 한 번만 표시됩니다. 그룹화되지 않은 매개변수는 최상위 수준에 표시되고 그룹 내에 구성된 매개변수는 그룹의 매개변수 맵 내에 표시됩니다.
|