API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفتها و نسخههای آینده بهروز باشید.
لیست کاربران
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک لیست کاربر. این لیستی از کاربرانی است که یک مشتری ممکن است آنها را هدف قرار دهد. کلید منحصر به فرد یک لیست کاربر شامل فیلدهای زیر است: id . توجه داشته باشید که name نیز باید برای لیستهای کاربری متعلق به یک مشتری خاص منحصر به فرد باشد، مگر در مواردی که access_reason روی SHARED تنظیم شده باشد. نقض محدودیت نام منحصر به فرد خطایی ایجاد میکند: UserListError.INVALID_NAME .
فیلدهای منابع فوق میتوانند به همراه این منبع در عبارات SELECT و WHERE شما انتخاب شوند. این فیلدها معیارها را در عبارت SELECT شما تقسیمبندی نمیکنند .
فیلدها/بخشها/معیارها
این صفحه تمام معیارها و بخشهایی را که میتوانند در همان عبارت SELECT به عنوان فیلدهای user_list قرار گیرند، نشان میدهد. با این حال، وقتی user_list در عبارت FROM مشخص میکنید، برخی از معیارها و بخشها قابل استفاده نیستند. از فیلتر زیر برای نمایش فقط فیلدهایی که میتوانند هنگام مشخص شدن user_list در عبارت FROM استفاده شوند، استفاده کنید.
آیا user_list در عبارت FROM کوئری شما مشخص شده است؟
نام این فهرست کاربران. برای هر فهرست کاربر منحصر به فرد است، مگر در مواردی که برای فهرست کاربرانی با نام مشابه، access_reason روی SHARED تنظیم شده باشد.
دسته بندی
ATTRIBUTE
نوع داده
STRING
نوع آدرس اینترنتی
N/A
قابل فیلتر کردن
درست
قابل انتخاب
درست
قابل مرتب سازی
درست
تکرار شده
نادرست
نام_منبع_کاربر
توضیحات فیلد
نام منبع لیست کاربران. نامهای منابع لیست کاربران به شکل زیر است: customers/{customer_id}/userLists/{user_list_id}
تاریخ آخرین بهروزرسانی 2026-05-11 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-05-11 بهوقت ساعت هماهنگ جهانی."],[],["This document describes user lists, which are targetable by customers, and associated data. Key fields include `user_list.id` (unique ID), `user_list.name` (potentially non-unique name), `user_list.resource_name` (resource identifier), and `user_list.type` (list classification, e.g., CRM_BASED). These fields, categorized as attributes, can be used in SELECT and WHERE clauses for filtering and retrieval, but will not segment metrics. The related resource is `customer`, which can also be included.\n"]]
