Method: customers.userLists.addEventMatchers

Fügt Event-Matcher einer häufigkeitsbasierten Nutzerliste hinzu. Bei diesem Aufruf können keine vorhandenen Ereignis-Matcher gelöscht und keine häufigkeitsbasierten Einschränkungsmetadaten geändert werden, z. B. das Zeitfenster oder wenn ein Nutzer hinzugefügt wird. Die Nutzerliste enthält möglicherweise bereits einige Event-Matcher. Dieser Aufruf kann beispielsweise hinzugefügt werden: AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { matchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } }Damit dieser Aufruf erfolgreich ist, darf die Nutzerliste „12345“ noch keine Kampagneneinschränkung „ID_quot“ mit _„4“ haben.

HTTP-Anfrage

POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userList

string

Erforderlich. Der vollständige Ressourcenname hat das Format „customers/[customerId]/userLists/[userlist_id]“. UID muss den UID-Typ „FREQUENCY_BASED“ haben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "eventMatchers": [
    {
      object (EventMatcher)
    }
  ]
}
Felder
eventMatchers[]

object (EventMatcher)

Enthält nur die Einschränkungen, die in die Nutzerliste aufgenommen werden sollen. Für die von „userList“ angegebene Nutzerliste sollte keine der hier zum Zeitpunkt des Anrufs festgelegten Einschränkungen gelten, es können aber auch noch andere Einschränkungen gelten.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von UserList.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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