Method: customers.describeValidFrequencyLimitingEventMatchers

Listet gültige Ereignis-Matcher sowie ihre Metadaten für Zielgruppenlisten mit Frequency Capping auf Jeder Ereignis-Matcher hat Metadaten, z. B. eine eigene AdsDataLink.Entity und einen Namen für die entsprechende Kampagne oder Werbebuchung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Ressourcenname des Kunden, z.B. 'customers/123'.

Abfrageparameter

Parameter
adsDataCustomerId

string (int64 format)

Anzeigendaten, die der Kundennummer des Kunden gehören, z.B. 456.
pageSize

integer

Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Bei 0 ermittelt der Server die Anzahl verknüpfter Kunden, die zurückgegeben werden sollen.
pageToken

string

Seitentoken, das von einem vorherigen Aufruf zurückgegeben wurde und zum Anfordern der nächsten Ergebnisseite verwendet wird, falls vorhanden.
filter

string

Einschränken, welche Ereignis-Matcher zurückgegeben werden Akzeptiert Filter für alle untergeordneten Felder von „eventMatcher“, „eventMatcherMetadata.entity“ und „eventMatcherMetadata.parent_event_matcher“. Beispielfilter: 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.id_6.Match_6_match_6.match_6.quotial

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort auf eine describeValidFrequencyLimitingEventMatchersRequest-Anfrage.

JSON-Darstellung 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
Felder
eventMatcherInfos[]

object (EventMatcherInfo)

Liste der Einheiten, die jeweils einen Ereignis-Matcher und seine Metadaten enthalten
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite angefordert werden kann. Dieses Feld ist leer, wenn keine weiteren Ergebnisse vorhanden sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

EventMatcherInfo

Ereignis-Matcher mit seinen Metadaten.

JSON-Darstellung 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
Felder
eventMatcher

object (EventMatcher)

Ereignis-Matcher mit Einschränkungstyp und gültiger Einschränkungs-ID
eventMatcherMetadata

object (EventMatcherMetadata)

Metadaten für den Event-Matcher.

EventMatcher-Metadaten

Metadaten für den Event-Matcher.

JSON-Darstellung 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
Felder
entity

object (Entity)

Verknüpftes Element aus AdsDataLink.
displayName

string

Name im zugrunde liegenden Datenspeicher für die Einschränkung. Das kann ein Kampagnenname oder ein Werbebuchungsname sein.
parentEventMatcher

object (EventMatcher)

Zugehöriger übergeordneter EventMatcher, falls vorhanden. Wenn eventMatcher eine DV360-Werbebuchung ist, bezieht sich dieses Feld auf den EventMatcher für den entsprechenden DV360-Anzeigenauftrag, zu dem die Werbebuchung gehört.