Method: customers.generateInsightsFinderReport

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

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

HTTP 请求

POST https://googleads.googleapis.com/v17/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)

产品与服务类别