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

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