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
모두 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 콘솔에서 표시 목적으로 이 조건과 연결된 색상입니다. 이 값을 지정하지 않거나 "CONDITION_DISPLAY_COLOR_UNSPECIFIED"를 사용하면 콘솔이 조건과 연결할 임의의 색상을 선택하게 됩니다. |
상태표시색상
표시 목적으로 조건과 연관된 색상 목록입니다.
열거형 | |
---|---|
CONDITION_DISPLAY_COLOR_UNSPECIFIED | |
BLUE | 파란색 |
BROWN | 갈색 |
CYAN | 청록색 |
DEEP_ORANGE | 일명 '레드 오렌지' |
GREEN | 녹색 |
INDIGO | 남빛 |
LIME | 라임 |
ORANGE | 주황색 |
PINK | 분홍색 |
PURPLE | 보라 |
TEAL | 물오리 |
원격 구성 매개변수
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 | 구성을 가져올 때 계산되는 동적 사용자별 값입니다. |
개인화가치
개인화된 가치를 가져오는 데 필요한 정보가 포함되어 있습니다.
JSON 표현 |
---|
{ "personalizationId": string } |
필드 | |
---|---|
personalizationId | 개인화 정의를 나타내는 식별자입니다. 이 정의는 구성 가져오기 시 값을 확인하는 데 사용됩니다. 이 시스템 생성 값은 수정하면 안 됩니다. |
매개변수값 유형
매개변수 값에 허용되는 데이터 유형입니다.
열거형 | |
---|---|
PARAMETER_VALUE_TYPE_UNSPECIFIED | 인식할 수 없는 열거형 값에 대한 포괄적인 기능입니다. |
STRING | 문자열 값을 나타냅니다. |
BOOLEAN | 부울 값("true" 또는 "false")을 나타냅니다. |
NUMBER | 양수와 음수 정수 및 부동 소수점 값을 모두 나타냅니다. |
JSON | JSON 값을 나타냅니다. |
원격구성매개변수그룹
명명된 매개변수 그룹입니다. 매개변수 그룹화는 관리 목적으로만 사용되며 클라이언트측 매개변수 값 가져오기에는 영향을 주지 않습니다.
JSON 표현 |
---|
{
"description": string,
"parameters": {
string: {
object ( |
필드 | |
---|---|
description | 선택 과목. 그룹에 대한 설명입니다. 길이는 256자 이하여야 합니다. 설명에는 유니코드 문자가 포함될 수 있습니다. |
parameters | 이 그룹에 속하는 매개변수에 대한 선택적 기본값 및 선택적 조건부 값에 매개변수 키를 매핑합니다. 매개변수는 RemoteConfig당 한 번만 표시됩니다. 그룹 해제된 매개변수는 최상위 수준에 표시됩니다. 그룹 내에 구성된 매개변수는 해당 그룹의 매개변수 맵 내에 나타납니다. |