REST Resource: customers.userListQueries

Zasób: UserListQuery

Określa zapytanie o listę użytkowników, które można wykonać w Centrum danych reklam.

Zapis JSON
{
  "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
  ]
}
Pola
name

string

Nazwa, która jednoznacznie identyfikuje zapytanie. Ma ona format customer/[customerId]/userListQuery/[resource_id], np. 'customers/123/userListQuery/abcd1234'. Identyfikator zasobu jest generowany przez serwer.

title

string

Tytuł zapytania, który jest unikalny w obrębie jednego klienta i typu zapytania w Centrum danych reklam.

queryText

string

Tekst zapytania.

parameterTypes

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

Dodatkowe parametry oczekiwane przez zapytanie. Mapuje każdą nazwę argumentu na jej typ.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

queryState

enum (QueryState)

Stan zapytania.

updateTime

string (Timestamp format)

Czas ostatniej aktualizacji zapytania.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

updateEmail

string

Adres e-mail użytkownika, który jako ostatni zaktualizował zapytanie.

createTime

string (Timestamp format)

Czas utworzenia zapytania.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

createEmail

string

Adres e-mail użytkownika, który utworzył zapytanie.

queryShare[]

object (QueryShare)

Wskazuje, jak można udostępnić zapytanie poza właścicielem klienta Ads Data Hub.

userList[]

string

Tylko dane wyjściowe. Zasób listy użytkowników Centrum danych reklam, który może zostać uzupełniony przez to zapytanie dotyczące listy użytkowników.

Metody

create

Tworzy zapytanie dotyczące listy użytkowników na potrzeby późniejszego wykonania.

delete

Usuwa zapytanie dotyczące listy użytkowników.

get

Pobiera zapytanie listy użytkowników.

list

Zawiera listę zapytań użytkowników na liście należących do określonego klienta.

patch

Aktualizuje dotychczasowe zapytanie o listę użytkowników.

start

Rozpoczyna wykonywanie zapytania na zapisanej liście użytkowników.

startTransient
(deprecated)

Rozpoczyna wykonywanie zapytania między tymczasowymi listami użytkowników.

validate

Przeprowadza testy walidacji na podstawie podanego zapytania o listę użytkowników.