ویژگی های مخاطب را جستجو می کند که می تواند برای ایجاد بینش استفاده شود.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v15/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 مراجعه کنید.