ویژگی های مخاطب را جستجو می کند که می تواند برای ایجاد بینش استفاده شود.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:searchAudienceInsightsAttributes
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "dimensions": [ enum ( |
زمینه های | |
---|---|
dimensions[] | ضروری. انواع ویژگی هایی که باید برگردانده شوند. |
queryText | ضروری. یک پرسش متنی رایگان. اگر ابعاد درخواستی شامل ویژگیهای CATEGORY یا KNOWLEDGE_GRAPH باشد، ویژگیهای برگردانده شده برای آن ابعاد مطابقت دارند یا با این رشته مرتبط هستند. برای سایر ابعاد، این فیلد نادیده گرفته می شود و تمام ویژگی های موجود برگردانده می شوند. |
customerInsightsGroup | نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است. |
locationCountryFilters[] | اگر ویژگیهای SUB_COUNTRY_LOCATION یکی از ابعاد درخواستی باشد و این فیلد وجود داشته باشد، ویژگیهای SUB_COUNTRY_LOCATION بازگردانده شده در این کشورها قرار خواهند گرفت. اگر این فیلد وجود نداشته باشد، ویژگی های مکان بر اساس کشور فیلتر نمی شوند. تنظیم این فیلد زمانی که ویژگیهای SUB_COUNTRY_LOCATION درخواست نمیشوند، یک خطا برمیگرداند. |
بدن پاسخگو
پیام پاسخ برای AudienceInsightsService.ListAudienceInsightsAttributes
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"attributes": [
{
object ( |
زمینه های | |
---|---|
attributes[] | ویژگی های مطابق با عبارت جستجو |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.