REST Resource: properties.dataStreams.eventCreateRules

Recurso: EventCreateRule

Uma regra de criação de evento define condições que acionarão a criação de um evento totalmente novo com base nos critérios correspondentes de um evento de origem. Mutações adicionais dos parâmetros do evento de origem podem ser definidas.

Ao contrário das regras de edição de eventos, as regras de criação de eventos não têm uma ordem definida. Elas serão executadas de forma independente.

As regras de Edição de evento e Criação de evento não podem ser usadas para modificar um evento criado com base em uma regra de Criação de evento.

Representação JSON
{
  "name": string,
  "destinationEvent": string,
  "eventConditions": [
    {
      object (MatchingCondition)
    }
  ],
  "sourceCopyParameters": boolean,
  "parameterMutations": [
    {
      object (ParameterMutation)
    }
  ]
}
Campos
name

string

Apenas saída. Nome do recurso para este recurso EventCreateRule. Formato: Properties/{property}/dataStreams/{dataStream}/eventCreateRules/{eventCreateRule}

destinationEvent

string

Obrigatório. Nome do novo evento a ser criado.

Esse valor precisa: * ter menos de 40 caracteres * conter apenas letras, dígitos ou _ (sublinhados) * começar com uma letra

eventConditions[]

object (MatchingCondition)

Obrigatório. É preciso ter pelo menos uma condição e um máximo de 10. As condições no evento de origem precisam corresponder para que essa regra seja aplicada.

sourceCopyParameters

boolean

Se for verdadeiro, os parâmetros de origem serão copiados para o novo evento. Se for "false" ou não for definido, nenhum parâmetro interno será copiado do evento de origem. As mutações de parâmetro são aplicadas após a cópia dos parâmetros.

parameterMutations[]

object (ParameterMutation)

As mutações de parâmetro definem o comportamento do parâmetro no novo evento e são aplicadas em ordem. É possível aplicar no máximo 20 mutações.

MatchingCondition

Define uma condição para quando uma regra de edição ou criação de evento se aplica a um evento.

Representação JSON
{
  "field": string,
  "comparisonType": enum (ComparisonType),
  "value": string,
  "negated": boolean
}
Campos
field

string

Obrigatório. O nome do campo que é comparado para a condição. Se "eventName" for especificado, essa condição será aplicada ao nome do evento. Caso contrário, a condição será aplicada a um parâmetro com o nome especificado.

Esse valor não pode conter espaços.

comparisonType

enum (ComparisonType)

Obrigatório. O tipo de comparação a ser aplicado ao valor.

value

string

Obrigatório. O valor comparado para esta condição. A implementação do ambiente de execução pode realizar a coerção do tipo desse valor para avaliar essa condição com base no tipo do valor do parâmetro.

negated

boolean

Se o resultado da comparação deve ou não ser negado. Por exemplo, se negated for verdadeira, as comparações de "igual" vão funcionar como "não é igual".

ComparisonType

Tipo de comparação para a condição correspondente

Enums
COMPARISON_TYPE_UNSPECIFIED Desconhecido
EQUALS Igual a, diferencia maiúsculas de minúsculas
EQUALS_CASE_INSENSITIVE Igual a, não diferencia maiúsculas de minúsculas
CONTAINS Contém, diferencia maiúsculas de minúsculas
CONTAINS_CASE_INSENSITIVE Contém, não diferencia maiúsculas de minúsculas
STARTS_WITH Começa com, diferencia maiúsculas de minúsculas
STARTS_WITH_CASE_INSENSITIVE Começa com, não diferencia maiúsculas de minúsculas
ENDS_WITH Termina com, diferencia maiúsculas de minúsculas
ENDS_WITH_CASE_INSENSITIVE Termina com, não diferencia maiúsculas de minúsculas
GREATER_THAN Maior que
GREATER_THAN_OR_EQUAL maior ou igual a
LESS_THAN Menor que
LESS_THAN_OR_EQUAL menor ou igual a
REGULAR_EXPRESSION expressão regular. Compatível apenas com fluxos da Web.
REGULAR_EXPRESSION_CASE_INSENSITIVE expressão regular que não diferencia maiúsculas de minúsculas. Compatível apenas com fluxos da Web.

ParameterMutation

Define um parâmetro de evento a ser modificado.

Representação JSON
{
  "parameter": string,
  "parameterValue": string
}
Campos
parameter

string

Obrigatório. O nome do parâmetro a ser modificado. Esse valor precisa: * ter menos de 40 caracteres. * ser exclusivo em todas as mutações na regra * consistir apenas em letras, dígitos ou _ (sublinhados). Para regras de edição de eventos, o nome também pode ser definido como "eventName" para modificar o eventName definido.

parameterValue

string

Obrigatório. A mutação de valor a ser executada. * Precisa ter menos de 100 caracteres. * Para especificar um valor constante para o parâmetro, use a string do valor. * Para copiar o valor de outro parâmetro, use sintaxe como "[[other_parameter]]". Para mais detalhes, consulte este artigo da Central de Ajuda.

Métodos

create

Cria uma EventCreateRule.

delete

Exclui uma EventCreateRule.

get

Procura uma única EventCreateRule.

list

Lista EventCreateRules em um fluxo de dados da Web.

patch

Atualiza uma EventCreateRule.