REST Resource: customers.userListQueries

منبع: UserListQuery

یک پرس و جو لیست کاربر را تعریف می کند که می تواند در Ads Data Hub اجرا شود.

نمایندگی 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
  ]
}
زمینه های
name

string

نامی که به طور منحصربه‌فرد یک پرس و جو را شناسایی می‌کند. این فرم مشتریان/[customerId]/userListQueries/[resource_id] است، به عنوان مثال 'customers/123/userListQueries/abcd1234'. شناسه منبع توسط سرور تولید می شود.

title

string

عنوان پرس و جو، که در یک مشتری Ads Data Hub و نوع درخواست منحصر به فرد است.

queryText

string

متن استعلام

parameterTypes

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

هر پارامتر اضافی مورد انتظار پرس و جو. نام هر آرگومان را به نوع آرگومان آن نگاشت می کند.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

queryState

enum ( QueryState )

وضعیت پرس و جو

updateTime

string ( Timestamp format)

زمان آخرین به روز رسانی پرس و جو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

updateEmail

string

آدرس ایمیل کاربری که آخرین بار درخواست را به روز کرده است.

createTime

string ( Timestamp format)

زمان ایجاد پرس و جو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

createEmail

string

آدرس ایمیل کاربری که پرس و جو را ایجاد کرده است.

queryShare[]

object ( QueryShare )

راه‌هایی را نشان می‌دهد که ممکن است درخواستی فراتر از مالک Ads Data Hub به اشتراک گذاشته شود.

userList[]

string

فقط خروجی منبع لیست کاربر Ads Data Hub که می تواند با این عبارت جستجوی لیست کاربر پر شود.

مواد و روش ها

create

 یک پرس و جو لیست کاربر را برای اجرای بعدی ایجاد می کند.

delete

 یک پرس و جو لیست کاربر را حذف می کند.

get

 پرس و جو لیست کاربر درخواستی را بازیابی می کند.

list

 جستارهای فهرست کاربران متعلق به مشتری مشخص را فهرست می کند.

patch

 یک جستجوی لیست کاربر موجود را به روز می کند.

start

 اجرا را در یک پرس و جو لیست کاربر ذخیره شده شروع می کند.

startTransient
(deprecated)

 اجرا را در یک پرس و جو لیست کاربر گذرا شروع می کند.

validate

 بررسی های اعتبارسنجی ایستا را در پرس و جو لیست کاربر ارائه شده انجام می دهد.