Method: customers.searchAudienceInsightsAttributes

ویژگی های مخاطب را جستجو می کند که می تواند برای ایجاد بینش استفاده شود.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:searchAudienceInsightsAttributes

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
زمینه های
dimensions[]

enum ( AudienceInsightsDimension )

ضروری. انواع ویژگی هایی که باید برگردانده شوند.

queryText

string

ضروری. یک پرسش متنی رایگان. اگر ابعاد درخواستی شامل ویژگی‌های CATEGORY یا KNOWLEDGE_GRAPH باشد، ویژگی‌های برگردانده شده برای آن ابعاد مطابقت دارند یا با این رشته مرتبط هستند. برای سایر ابعاد، این فیلد نادیده گرفته می شود و تمام ویژگی های موجود برگردانده می شوند.

customerInsightsGroup

string

نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است.

locationCountryFilters[]

object ( LocationInfo )

اگر ویژگی‌های SUB_COUNTRY_LOCATION یکی از ابعاد درخواستی باشد و این فیلد وجود داشته باشد، ویژگی‌های SUB_COUNTRY_LOCATION بازگردانده شده در این کشورها قرار خواهند گرفت. اگر این فیلد وجود نداشته باشد، ویژگی های مکان بر اساس کشور فیلتر نمی شوند. تنظیم این فیلد زمانی که ویژگی‌های SUB_COUNTRY_LOCATION درخواست نمی‌شوند، یک خطا برمی‌گرداند.

بدن پاسخگو

پیام پاسخ برای AudienceInsightsService.ListAudienceInsightsAttributes .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
زمینه های
attributes[]

object ( AudienceInsightsAttributeMetadata )

ویژگی های مطابق با عبارت جستجو

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.