RemoteConfig

Um RemoteConfig representa um modelo do Configuração remota.

O modelo do Configuração remota de um projeto é avaliado durante a busca de cada instância do aplicativo.

O valor resolvido de um parâmetro é determinado da seguinte forma:

Dados os conditional values que se referem a conditions true para a instância do aplicativo, o valor resolvido do parâmetro é o valor condicional cujo name é o mais antigo na conditions list .

Caso contrário, se o parâmetro tiver um default value , o valor resolvido será definido como o valor padrão.

Caso contrário, o parâmetro não terá valor e será omitido do resultado que a instância do aplicativo busca.

Por exemplo, suponha que temos o parâmetro fruit , com valor padrão pear e submapa de valor condicional {"is_ios": "apple", "is_in_20_percent": "banana"} onde "is_ios" e "is_20_percent" são nomes de condições no pedido lista de condições. O valor de fruit seria avaliado como apple se is_ios fosse verdadeiro. Caso contrário, se is_in_20_percent for true , fruit seria avaliada como banana , e se is_ios e is_in_20_percent forem ambos falsos, fruit seria avaliada como pear . Se nenhum valor padrão fosse especificado e is_ios e is_in_20_percent fossem falsos, nenhum valor para fruit seria retornado do servidor do Configuração remota para o cliente.

Depois que o modelo do Configuração remota de um projeto tiver sido publicado por meio de uma chamada projects.updateRemoteConfig bem-sucedida, os clientes poderão buscar esses valores de parâmetros e exibi-los aos usuários.

Representação JSON
{
  "conditions": [
    {
      object (RemoteConfigCondition)
    }
  ],
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  },
  "version": {
    object (Version)
  },
  "parameterGroups": {
    string: {
      object (RemoteConfigParameterGroup)
    },
    ...
  }
}
Campos
conditions[]

object ( RemoteConfigCondition )

Uma lista de condições em ordem decrescente de prioridade.

Os valores das entradas google.firebase.remoteconfig.v1.RemoteConfigCondition.name devem ser exclusivos.

parameters

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

Mapa de chaves de parâmetro para seus valores padrão opcionais e valores condicionais opcionais.

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

version

object ( Version )

Somente saída, exceto a description da versão. Metadados associados a uma versão específica de um modelo. O campo de descrição de uma versão pode ser especificado em chamadas projects.updateRemoteConfig .

parameterGroups

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

Mapa de nomes de grupos de parâmetros para suas descrições e parâmetros agrupados. O nome de um grupo é mutável, mas deve ser exclusivo entre os grupos na configuração. O nome é limitado a 256 caracteres e deve ser legível por humanos. Quaisquer caracteres Unicode são permitidos.

Os grupos têm uma lista de parâmetros que permite aos usuários da API agrupar parâmetros associados ao mesmo recurso ou tema para facilitar o acesso organizacional.

Por exemplo, um grupo de parâmetros com o nome "Pesquisa V2" pode ter a description "Nova visualização de pesquisa móvel" e conter parâmetros para o layout e a fonte da nova pesquisa.

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Condição deConfiguraçãoRemota

Uma condição direcionada a um grupo específico de usuários. Uma lista dessas condições faz parte de um objeto RemoteConfig.

Representação JSON
{
  "name": string,
  "expression": string,
  "tagColor": enum (ConditionDisplayColor)
}
Campos
name

string

Obrigatório. Um nome não vazio e exclusivo desta condição.

expression

string

Obrigatório. A lógica desta condição.

Consulte a documentação sobre Expressões de Condição para a sintaxe esperada deste campo.

tagColor

enum ( ConditionDisplayColor )

Opcional. A cor associada a esta condição para fins de exibição no Firebase Console. Não especificar esse valor ou ter "CONDITION_DISPLAY_COLOR_UNSPECIFIED" faz com que o Console escolha uma cor arbitrária para associar à condição.

CondiçãoDisplayColor

Lista de cores associadas às Condições para fins de exibição.

Enums
CONDITION_DISPLAY_COLOR_UNSPECIFIED
BLUE Azul
BROWN Marrom
CYAN Ciano
DEEP_ORANGE também conhecido como "Laranja Vermelha"
GREEN Verde
INDIGO Índigo
LIME Lima
ORANGE Laranja
PINK Rosa
PURPLE Roxo
TEAL Cerceta

Parâmetro RemoteConfig

Um valor de parâmetro associado a uma chave de parâmetro em google.firebase.remoteconfig.v1.RemoteConfig.parameters .

No mínimo, uma entrada defaultValue ou conditionalValues ​​deve estar presente para que o parâmetro tenha algum efeito.

Representação JSON
{
  "defaultValue": {
    object (RemoteConfigParameterValue)
  },
  "conditionalValues": {
    string: {
      object (RemoteConfigParameterValue)
    },
    ...
  },
  "description": string,
  "valueType": enum (ParameterValueType)
}
Campos
defaultValue

object ( RemoteConfigParameterValue )

Opcional - valor para definir o parâmetro, quando nenhuma das condições nomeadas for avaliada como true .

conditionalValues

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

Opcional - um mapa ( condition name , valor). O Condition_name de prioridade mais alta (aquele listado primeiro na lista de condições do RemoteConfig) determina o valor deste parâmetro.

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

description

string

Opcional. Uma descrição para este parâmetro. Seu comprimento deve ser menor ou igual a 256 caracteres. Uma descrição pode conter quaisquer caracteres Unicode.

valueType

enum ( ParameterValueType )

O tipo de dados para todos os valores deste parâmetro na versão atual do modelo. O padrão é ParameterValueType.STRING se não for especificado.

RemoteConfigParameterValue

Um recurso RemoteConfigParameterValue contém o valor que um parâmetro pode ter.

Representação 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.
}
Campos
Campo de união value_option . Um RemoteConfigParameterValue consiste em uma string (valor) ou um booleano (use_in_app_default, definido como true, se aplicável). value_option pode ser apenas um dos seguintes:
value

string

O valor da string para o qual o parâmetro está definido.

useInAppDefault

boolean

Se verdadeiro, o parâmetro será omitido dos valores de parâmetro retornados a um cliente.

personalizationValue

object ( PersonalizationValue )

Um valor dinâmico e específico do usuário calculado quando a configuração é buscada.

PersonalizaçãoValor

Contém as informações necessárias para buscar um valor personalizado.

Representação JSON
{
  "personalizationId": string
}
Campos
personalizationId

string

Identificador que representa uma definição de personalização. Esta definição é usada para resolver o valor no momento da busca de configuração. Este valor gerado pelo sistema não deve ser modificado.

ParâmetroValueType

Tipos de dados aceitos para valores de parâmetros.

Enums
PARAMETER_VALUE_TYPE_UNSPECIFIED Pega-tudo para valores enum não reconhecidos.
STRING Representa valores de String.
BOOLEAN Representa valores booleanos ("true" ou "false").
NUMBER Representa valores inteiros e flutuantes positivos e negativos.
JSON Representa valores JSON.

RemoteConfigParameterGroup

Um grupo nomeado de parâmetros. O agrupamento de parâmetros é apenas para fins de gerenciamento e não afeta a busca de valores de parâmetros no lado do cliente.

Representação JSON
{
  "description": string,
  "parameters": {
    string: {
      object (RemoteConfigParameter)
    },
    ...
  }
}
Campos
description

string

Opcional. Uma descrição para o grupo. Seu comprimento deve ser menor ou igual a 256 caracteres. Uma descrição pode conter quaisquer caracteres Unicode.

parameters

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

Mapa de chaves de parâmetro para seus valores padrão opcionais e valores condicionais opcionais para parâmetros que pertencem a este grupo. Um parâmetro aparece apenas uma vez por RemoteConfig: um parâmetro desagrupado aparece no nível superior; um parâmetro organizado dentro de um grupo aparece no mapa de parâmetros do seu grupo.

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .