创建可在 Insights Finder 工具中查看的已保存报告。
抛出的错误列表:AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateInsightsFinderReport
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "baselineAudience": { object ( |
字段 | |
---|---|
baselineAudience |
必需。此报告的基准受众群体,通常是一个区域内的所有用户。 |
specificAudience |
必需。此报告中感兴趣的特定受众群体。报告中的数据分析依据的是此受众群体中更为常见的属性,而非报告的基准受众群体中的属性。 |
customerInsightsGroup |
为其规划的客户的名称。这是用户定义的值。 |
响应正文
AudienceInsightsService.GenerateInsightsFinderReport
的响应消息,包含报告的可分享网址。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "savedReportUrl": string } |
字段 | |
---|---|
savedReportUrl |
一个 HTTPS 网址,用于提供指向 Insights Finder 界面的深层链接,并且报告输入会根据请求进行填充。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
BasicInsightsAudience
用于请求数据分析的受众群体的说明。
JSON 表示法 |
---|
{ "countryLocation": [ { object ( |
字段 | |
---|---|
countryLocation[] |
必需。此受众群体的国家/地区。 |
subCountryLocations[] |
国家/地区下级地理位置属性。如果存在,则每个元素必须包含在此受众群体的某个国家/地区中。 |
gender |
观众的性别。如果不包含,则受众群体不会按性别进行限制。 |
ageRanges[] |
受众群体的年龄段。如果不包含,该受众群体表示所有年满 18 周岁且符合其他特征的用户。 |
userInterests[] |
定义此受众群体的用户兴趣。支持兴趣相似的受众群体和有购买意向的受众群体。 |
topics[] |
此受众群体感兴趣的主题,以知识图谱实体和/或产品和服务类别表示。 |
AudienceInsightsTopic
表示定义受众群体的主题的实体或类别。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 topic 。实体或类别属性。topic 只能是下列其中一项: |
|
entity |
知识图谱实体 |
category |
“产品和服务”类别 |