REST Resource: customers.userListQueries

Ressource: UserListQuery

Definiert eine Nutzerliste, die in Ads Data Hub ausgeführt werden kann.

JSON-Darstellung
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],
  "userList": [
    string
  ]
}
Felder
name

string

Name, der eine Abfrage eindeutig identifiziert. Sie hat das Format „customers/[customerId]/userListQuery/[resource_id]“, z.B. 'customers/123/userListQuery/abcd1234'. Die Ressourcen-ID wird vom Server generiert.

title

string

Abfragetitel, der innerhalb eines einzelnen Ads Data Hub-Kunden und eines Abfragetyps eindeutig ist.

queryText

string

Abfragetext.

parameterTypes

map (key: string, value: object (ParameterType))

Alle zusätzlichen Parameter, die von der Abfrage erwartet werden. Ordnet jeden Argumentnamen dem zugehörigen Argumenttyp zu.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

queryState

enum (QueryState)

Abfragestatus.

updateTime

string (Timestamp format)

Zeitpunkt der letzten Aktualisierung der Abfrage.

Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateEmail

string

E-Mail-Adresse des Nutzers, der die Abfrage zuletzt aktualisiert hat.

createTime

string (Timestamp format)

Zeitpunkt der Erstellung der Abfrage.

Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

createEmail

string

E-Mail-Adresse des Nutzers, der die Abfrage erstellt hat.

queryShare[]

object (QueryShare)

Hier sehen Sie, wie eine Abfrage möglicherweise außerhalb des Inhabers von Ads Data Hub freigegeben wird.

userList[]

string

Nur Ausgabe. Die Ads Data Hub-Nutzerlistenressource, die durch diese Nutzerliste gefüllt werden kann.

Methoden

create

Erstellt eine Nutzerliste-Abfrage für die spätere Ausführung.

delete

Löscht eine Nutzerliste-Abfrage.

get

Ruft die angeforderte Abfrage für die Nutzerliste ab.

list

Listet die Nutzerlistenabfragen des angegebenen Kunden auf.

patch

Aktualisiert eine vorhandene Abfrage der Nutzerliste.

start

Startet die Ausführung bei einer gespeicherten Nutzerliste-Abfrage.

startTransient
(deprecated)

Startet die Ausführung bei einer temporären Abfrage der Nutzerliste.

validate

Führt statische Validierungsprüfungen für die angegebene Nutzerliste-Abfrage durch.