قائمة_المستخدمين

قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن للعميل استهدافهم. يتألّف المفتاح الفريد لقائمة المستخدمين من الحقل التالي: id. يُرجى العِلم أنّ name يجب أن يكون فريدًا أيضًا لقوائم المستخدمين التي يملكها عميل معيّن، باستثناء بعض الحالات التي يتم فيها ضبط access_reason على SHARED. تؤدّي مخالفة شرط الاسم الفريد إلى ظهور الخطأ: UserListError.INVALID_NAME.

الموارد المنسوبة
العميل

يمكن اختيار الحقول من الموارد أعلاه إلى جانب هذا المورِد في عبارتَي SELECT وWHERE. **لن تقسم** هذه الحقول المقاييس في عبارة SELECT.

الحقول/الشرائح/المقاييس

تعرض هذه الصفحة جميع المقاييس والشرائح التي يمكن وضعها في عبارة SELECT نفسها كحقول user_list. ومع ذلك، عند تحديد user_list في عبارة FROM، لا يمكن استخدام بعض المقاييس والشرائح لا يمكن استخدامها. استخدِم الفلتر التالي لعرض الحقول التي يمكن استخدامها فقط عند تحديد user_list في عبارة FROM.

هل تم تحديد user_list في عبارة FROM الخاصة باستعلامك؟

حقول المورِد
المعرِّف
name
resource_name
type
الشرائح
date
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text

user_list.id

وصف الحقلرقم تعريف قائمة المستخدمين
الفئةATTRIBUTE
نوع البياناتINT64
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ

user_list.name

وصف الحقلاسم قائمة المستخدمين هذه فريد لكل قائمة مستخدمين، باستثناء بعض الحالات التي يتم فيها ضبط access_reason على SHARED لقائمة مستخدمين بالاسم نفسه
الفئةATTRIBUTE
نوع البياناتSTRING
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ

user_list.resource_name

وصف الحقلاسم المورِد الخاص بقائمة المستخدمين تتّخذ أسماء موارد قوائم المستخدمين الشكل التالي: customers/{customer_id}/userLists/{user_list_id}
الفئةATTRIBUTE
نوع البياناتRESOURCE_NAME
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
Sortableخطأ
حقلخطأ

user_list.type

وصف الحقلنوع هذه القائمة هذا الحقل للقراءة فقط.
الفئةATTRIBUTE
نوع البيانات
يُرجى كتابة عنوان URLgoogle.ads.searchads360.v0.enums.UserListTypeEnum.UserListType
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ

segments.date

وصف الحقلالتاريخ الذي تنطبق عليه المقاييس، بتنسيق yyyy-MM-dd، مثلاً ‎2018-04-17
الفئةSEGMENT
نوع البياناتDATE
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ

segments.keyword.ad_group_criterion

وصف الحقلاسم مورِد AdGroupCriterion
الفئةSEGMENT
نوع البياناتRESOURCE_NAME
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
Sortableخطأ
حقلخطأ

segments.keyword.info.match_type

وصف الحقلنوع مطابقة الكلمة الرئيسية
الفئةSEGMENT
نوع البيانات
يُرجى كتابة عنوان URLgoogle.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ

segments.keyword.info.text

وصف الحقلنص الكلمة الرئيسية (80 حرفًا و10 كلمات كحدّ أقصى)
الفئةSEGMENT
نوع البياناتSTRING
يُرجى كتابة عنوان URLN/A
قابل للفلترةTrue
قابل للاختيارTrue
SortableTrue
حقلخطأ