Method: customers.describeValidFrequencyLimitingEventMatchers

Lista matchers de evento válidos com metadados para listas de público-alvo com limite de frequência. Cada correspondência de evento tem metadados que incluem, por exemplo, o AdsDataLink.Entity de propriedade e um nome para a campanha ou o item de linha correspondente.

Solicitação HTTP

GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customer

string

Nome do recurso do cliente, por exemplo, 'customers/123'.

Parâmetros de consulta

Parâmetros
adsDataCustomerId

string (int64 format)

ID de proprietário dos dados do Google Ads, por exemplo, 456.
pageSize

integer

Número máximo de itens a serem retornados. Se for 0, o servidor determinará o número de clientes vinculados que serão retornados.
pageToken

string

Token da página, retornado por uma chamada anterior, usado para solicitar a próxima página de resultados, se houver.
filter

string

Restringir os matchers de eventos retornados Aceita filtros em todos os subcampos de eventMatcher, eventMatcherMetadata.entity e eventMatcherMetadata.parent_event_matcher. Filtros de exemplo: eventMatcher.value = 1234 eventMatcher.match_type = DV360_LINE_ITEM_ID OR eventMatcher.match_type = DV360_INSERTION_ORDER_ID eventMatcherMetadata.display_name = "Campaign 456" eventMatcherMetadata.entity.entity_type_event_Matchereventquot()

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Resposta a uma solicitação DescreverFrequênciaLimitingEventMatchersRequest.

Representação JSON 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
Campos
eventMatcherInfos[]

object (EventMatcherInfo)

Lista de unidades, cada uma contendo um matcher de eventos com os metadados
nextPageToken

string

Um token que pode ser usado para solicitar a próxima página de resultados. Este campo ficará vazio se não houver resultados adicionais.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adsdatahub

EventMatcherInfo

Correspondência de eventos com seus metadados.

Representação JSON 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
Campos
eventMatcher

object (EventMatcher)

O evento de correspondência contém o tipo de restrição e o ID de restrição válido.
eventMatcherMetadata

object (EventMatcherMetadata)

Metadados para a correspondência de evento.

Correspondência de eventos

Metadados para a correspondência de evento.

Representação JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
Campos
entity

object (Entity)

Entidade vinculada do AdsDataLink.
displayName

string

Nome no armazenamento de dados subjacente para a restrição. Pode ser um nome de campanha, um nome de item de linha etc.
parentEventMatcher

object (EventMatcher)

EventMatcher pai relacionado, se houver. Se eventMatcher for um item de linha do DV360, esse campo fará referência ao EventMatcher para o pedido de inserção do DV360 correspondente do qual o item de linha faz parte.