Method: customers.describeValidFrequencyLimitingEventMatchers

Elenca gli eventi di abbinamento degli eventi validi insieme ai relativi metadati per gli elenchi dei segmenti di pubblico con quota limite. Ogni matcher evento dispone di metadati che includono, ad esempio, un proprietario dell'elemento AdsDataLink.Entity e un nome per la campagna o l'elemento pubblicitario corrispondenti.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
customer

string

Nome della risorsa del cliente, ad esempio 'customers/123'.

Parametri di ricerca

Parametri
adsDataCustomerId

string (int64 format)

ID proprietario dei dati pubblicitari, ad es. 456.
pageSize

integer

Numero massimo di articoli da restituire. Se il valore è 0, il server determinerà il numero di clienti collegati da restituire.
pageToken

string

Token di pagina, restituito da una chiamata precedente, utilizzato per richiedere l'eventuale pagina successiva dei risultati.
filter

string

Limita gli abbinamenti di eventi che vengono restituiti. Accetta filtri in tutti i sottocampi di eventMatcher, eventMatcherMetadata.entity ed eventMatcherMetadata.parent_event_matcher. Filtri di esempio: 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_id = 5 -Corrispondenza evento

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risposta a una richiesta DescribeValidLimitLimitingEventMatchersRequest.

Rappresentazione JSON 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
Campi
eventMatcherInfos[]

object (EventMatcherInfo)

Elenco delle unità, ciascuna contenente un matcher evento insieme ai relativi metadati
nextPageToken

string

Un token che può essere utilizzato per richiedere la pagina dei risultati successiva. Il campo è vuoto se non vengono restituiti risultati aggiuntivi.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

InformazioniCorrispondenza evento

Corrispondenza di evento e relativi metadati.

Rappresentazione JSON 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
Campi
eventMatcher

object (EventMatcher)

Corrispondenza di evento contenente il tipo di vincolo e l'ID vincolo valido.
eventMatcherMetadata

object (EventMatcherMetadata)

Metadati per la corrispondenza evento.

Metadati eventoMatcher

Metadati per la corrispondenza evento.

Rappresentazione JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
Campi
entity

object (Entity)

Entità collegata da AdsDataLink.
displayName

string

Nome dell'archivio dati sottostante per il vincolo. Potrebbe essere il nome della campagna, il nome dell'elemento pubblicitario e così via.
parentEventMatcher

object (EventMatcher)

EventMatcher padre correlato, se presente. Se eventMatcher è un elemento pubblicitario DV360, questo campo farà riferimento a EventMatcher per l'ordine di inserzione DV360 corrispondente a cui fa parte l'elemento pubblicitario.