将受众群体名单导出至 Google 表格。创建受众群体后,用户无法立即用于商品详情。首先,您需要向 audienceLists.create
发出请求,以创建用户受众群体名单;其次,此方法用于将受众群体名单中的这些用户导出到 Google 表格。
请参阅创建受众群体名单,通过示例简单了解受众群体名单。
借助 Google Analytics 4 中的受众群体,您可以根据自身业务需求对用户进行细分。如需了解详情,请参阅 https://support.google.com/analytics/answer/9267572。
此方法是在 Alpha 版稳定性阶段推出的,目的是在进入 Beta 版之前收集有关语法和功能的反馈。要针对此 API 提供反馈,请填写 Google Analytics Audience Export API 反馈表单。
HTTP 请求
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。要从中检索用户的受众群体名单的名称。格式: |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "offset": string, "limit": string } |
字段 | |
---|---|
offset |
可选。起始行的行数。第一行计为第 0 行。 分页时,第一个请求不指定偏移量;将偏移量设置为 0;第一个请求返回前 如需详细了解此分页参数,请参阅分页。 |
limit |
可选。要返回的行数。如果未指定,则返回 10,000 行。无论您要求返回多少行,对于每个请求,API 最多只能返回 25 万行。 如果维度值没有 如需详细了解此分页参数,请参阅分页。 |
响应正文
已创建的 Google 表格,其中包含受众群体名单中的用户。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
字段 | |
---|---|
spreadsheetUri |
供您在浏览器中访问以查看 Google 表格的 URI。 |
spreadsheetId |
用于标识所创建的 Google 表格资源的 ID。 |
rowCount |
AudienceList 结果中的总行数。 如需详细了解此分页参数,请参阅分页。 |
audienceList |
要导出的受众群体名单的相关配置数据。返回以帮助解读此回答的 Google 表格中的 AudienceList。 例如,AudienceList 的行数可能多于 Google 表格中的行数,在这种情况下,您可能需要另外发送一个工作表导出请求,并使用其他 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets