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/userListQuries/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

يجري عمليات تحقّق ثابتة للتحقّق من صحة طلب قائمة المستخدمين المقدَّم.