MatchingFunction

Função correspondente associada a um CustomerFeed, CampaignFeed ou NomeDo anúncio. A função de correspondência é usada para filtrar o conjunto de itens de feed selecionados.

Representação JSON 
{
  "operator": enum (MatchingFunctionOperator),
  "leftOperands": [
    {
      object (Operand)
    }
  ],
  "rightOperands": [
    {
      object (Operand)
    }
  ],
  "functionString": string
}
Campos
operator

enum (MatchingFunctionOperator)

Operador de uma função.
leftOperands[]

object (Operand)

Os operandos no lado esquerdo da equação. Esse também é o operando a ser usado para expressões de operando único, como NOT.
rightOperands[]

object (Operand)

Os operandos no lado direito da equação.
functionString

string

Representação de string da função.

Exemplos:

  1. IDENTITY(verdadeiro) ou IDENTITY(falso). Todos ou nenhum item do feed foi veiculado.
  2. EQUALS(CONTEXT.DEVICE,"Mobile")
  3. IN(FEED_ITEM_ID,{1000001.1000002,1000003})
  4. CONTAINS_ANY(FeedAttribute[12345678,0],{"Cruzeiro Marte","Cruzeiro Vênus"})
  5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile"))

Para mais detalhes, acesse https://developers.google.com/google-ads/api/docs/extensions/feeds/matching-functions.

Observe que, como várias strings podem representar a mesma função subjacente (espaço em branco e aspas simples versus aspas duplas, por exemplo), o valor retornado pode não ser idêntico à string enviada em uma solicitação mutate.

MatchingFunctionOperator

Operadores possíveis em uma função correspondente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
IN O operador IN.
IDENTITY O operador IDENTITY.
EQUALS O operador EQUALS
AND Operador que usa dois ou mais operandos que são do tipo FunctionOperand e verifica se todos os operandos são avaliados como verdadeiros. Para funções relacionadas a formatos de anúncio, todos os operandos precisam estar em "leftOperands".
CONTAINS_ANY Operador que retorna "true" se os elementos em "leftOperands" contiverem qualquer um dos elementos em "rightOperands". Caso contrário, retorna "false". Os rightOperands precisam conter no mínimo um e no máximo três ConstantOperands.

Operand

Um operando em uma função correspondente.

Representação JSON 
{

  // Union field function_argument_operand can be only one of the following:
  "constantOperand": {
    object (ConstantOperand)
  },
  "feedAttributeOperand": {
    object (FeedAttributeOperand)
  },
  "functionOperand": {
    object (FunctionOperand)
  },
  "requestContextOperand": {
    object (RequestContextOperand)
  }
  // End of list of possible types for union field function_argument_operand.
}
Campos
Campo de união function_argument_operand. Operandos diferentes que podem ser usados em uma função correspondente. Obrigatório. function_argument_operand pode ser apenas de um dos tipos a seguir:
constantOperand

object (ConstantOperand)

Um operando constante em uma função correspondente.
feedAttributeOperand

object (FeedAttributeOperand)

Esse operando especifica um atributo de feed no feed.
functionOperand

object (FunctionOperand)

Um operando em uma função correspondente. Usado para representar funções aninhadas.
requestContextOperand

object (RequestContextOperand)

Um operando em uma função que se refere a um valor no contexto da solicitação.

ConstantOperand

Um operando constante em uma função correspondente.

Representação JSON 
{

  // Union field constant_operand_value can be only one of the following:
  "stringValue": string,
  "longValue": string,
  "booleanValue": boolean,
  "doubleValue": number
  // End of list of possible types for union field constant_operand_value.
}
Campos
Campo de união constant_operand_value. Valores de operando constantes. Obrigatório. constant_operand_value pode ser apenas de um dos tipos a seguir:
stringValue

string

Valor de string do operando, se for um tipo de string.
longValue

string (int64 format)

Valor int64 do operando, se for do tipo int64.
booleanValue

boolean

Valor booleano do operando, se for do tipo booleano.
doubleValue

number

Valor duplo do operando, se for do tipo duplo.

FeedAttributeOperand

Um operando de atributo de feed em uma função correspondente. Usado para representar um atributo de feed no feed.

Representação JSON 
{
  "feedId": string,
  "feedAttributeId": string
}
Campos
feedId

string (int64 format)

O feed associado. Obrigatório.
feedAttributeId

string (int64 format)

ID do atributo de feed referenciado. Obrigatório.

FunctionOperand

Um operando em uma função correspondente. Usado para representar funções aninhadas.

Representação JSON 
{
  "matchingFunction": {
    object (MatchingFunction)
  }
}
Campos
matchingFunction

object (MatchingFunction)

A função correspondente mantida nesse operando.

RequestContextOperand

Um operando em uma função que se refere a um valor no contexto da solicitação.

Representação JSON 
{
  "contextType": enum (MatchingFunctionContextType)
}
Campos
contextType

enum (MatchingFunctionContextType)

Tipo de valor a ser referenciado no contexto da solicitação.

MatchingFunctionContextType

Tipos de contexto possíveis para um operando em uma função correspondente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
FEED_ITEM_ID ID do item do feed no contexto da solicitação.
DEVICE_NAME O dispositivo em uso (possíveis valores são "Computador" ou "Dispositivo móvel").
FEED_ITEM_SET_ID ID do conjunto de itens do feed no contexto da solicitação.