Method: customers.generateInsightsFinderReport

创建可在 Insights Finder 工具中查看的已保存报告。

抛出的错误列表：AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 请求

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateInsightsFinderReport

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
字段
baselineAudience

object (BasicInsightsAudience)

必需。此报告的基准受众群体，通常是一个区域内的所有用户。
specificAudience

object (BasicInsightsAudience)

必需。此报告中感兴趣的特定受众群体。报告中的数据分析依据的是此受众群体中更为常见的属性，而非报告的基准受众群体中的属性。
customerInsightsGroup

string

为其规划的客户的名称。这是用户定义的值。

响应正文

AudienceInsightsService.GenerateInsightsFinderReport 的响应消息，包含报告的可分享网址。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "savedReportUrl": string
}
字段
savedReportUrl

string

一个 HTTPS 网址，用于提供指向 Insights Finder 界面的深层链接，并且报告输入会根据请求进行填充。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。

BasicInsightsAudience

用于请求数据分析的受众群体的说明。

JSON 表示法 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
字段
countryLocation[]

object (LocationInfo)

必需。此受众群体的国家/地区。
subCountryLocations[]

object (LocationInfo)

国家/地区下级地理位置属性。如果存在，则每个元素必须包含在此受众群体的某个国家/地区中。
gender

object (GenderInfo)

观众的性别。如果不包含，则受众群体不会按性别进行限制。
ageRanges[]

object (AgeRangeInfo)

受众群体的年龄段。如果不包含，该受众群体表示所有年满 18 周岁且符合其他特征的用户。
userInterests[]

object (UserInterestInfo)

定义此受众群体的用户兴趣。支持兴趣相似的受众群体和有购买意向的受众群体。
topics[]

object (AudienceInsightsTopic)

此受众群体感兴趣的主题，以知识图谱实体和/或产品和服务类别表示。

AudienceInsightsTopic

表示定义受众群体的主题的实体或类别。

JSON 表示法 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
字段
联合字段 topic。实体或类别属性。topic 只能是下列其中一项：
entity

object (AudienceInsightsEntity)

知识图谱实体
category

object (AudienceInsightsCategory)

“产品和服务”类别