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 모두 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 있을 수 있으며 새 검색의 레이아웃 및 글꼴에 대한 매개변수가 포함될 수 있습니다.

"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 콘솔에서 표시 목적으로 이 조건과 연결된 색상입니다. 이 값을 지정하지 않거나 "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 (RemoteConfigParameterValue)
  },
  "conditionalValues": {
    string: {
      object (RemoteConfigParameterValue)
    },
    ...
  },
  "description": string,
  "valueType": enum (ParameterValueType)
}
필드
defaultValue

object ( RemoteConfigParameterValue )

선택 사항 - 명명된 조건 중 true 로 평가되는 조건이 없을 때 매개변수를 설정할 값입니다.

conditionalValues

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

선택사항 - ( condition name , 값) 맵. 가장 높은 우선순위의 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)
  }
  // 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 )

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

개인화가치

개인화된 가치를 가져오는 데 필요한 정보가 포함되어 있습니다.

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

string

개인화 정의를 나타내는 식별자입니다. 이 정의는 구성 가져오기 시 값을 확인하는 데 사용됩니다. 이 시스템 생성 값은 수정하면 안 됩니다.

매개변수값 유형

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

열거형
PARAMETER_VALUE_TYPE_UNSPECIFIED 인식할 수 없는 열거형 값에 대한 포괄적인 기능입니다.
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" } .