API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفتها و نسخههای آینده بهروز باشید.
لیست کاربران
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک لیست کاربر. این لیستی از کاربرانی است که یک مشتری ممکن است آنها را هدف قرار دهد. کلید منحصر به فرد یک لیست کاربر شامل فیلدهای زیر است: id . توجه داشته باشید که name نیز باید برای لیستهای کاربری متعلق به یک مشتری خاص منحصر به فرد باشد، مگر در مواردی که access_reason روی SHARED تنظیم شده باشد. نقض محدودیت نام منحصر به فرد خطایی ایجاد میکند: UserListError.INVALID_NAME .
فیلدهای منابع فوق میتوانند به همراه این منبع در عبارات SELECT و WHERE شما انتخاب شوند. این فیلدها معیارها را در عبارت SELECT شما تقسیمبندی نمیکنند .
شناسه_کاربر
توضیحات فیلد
شناسهی لیست کاربران.
دسته بندی
ATTRIBUTE
نوع داده
INT64
نوع آدرس اینترنتی
N/A
قابل فیلتر کردن
درست
قابل انتخاب
درست
قابل مرتب سازی
درست
تکرار شده
نادرست
نام_لیست_کاربر
توضیحات فیلد
نام این فهرست کاربران. برای هر فهرست کاربر منحصر به فرد است، مگر در مواردی که برای فهرست کاربرانی با نام مشابه، access_reason روی SHARED تنظیم شده باشد.
دسته بندی
ATTRIBUTE
نوع داده
STRING
نوع آدرس اینترنتی
N/A
قابل فیلتر کردن
درست
قابل انتخاب
درست
قابل مرتب سازی
درست
تکرار شده
نادرست
نام_منبع_کاربر
توضیحات فیلد
نام منبع لیست کاربران. نامهای منابع لیست کاربران به شکل زیر است: customers/{customer_id}/userLists/{user_list_id}
تاریخ آخرین بهروزرسانی 2026-03-10 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-03-10 بهوقت ساعت هماهنگ جهانی."],[],["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"]]
