Google Analytics数据保留政策变更：如何批量应用至所有子账户？

嗨，我完全懂你管理多个GA账户一个个改设置的痛苦！针对Google Analytics的数据保留政策变更，官方并没有提供直接在UI里批量应用的功能，但我们可以通过Google Analytics Admin API来实现批量操作，这是最靠谱的官方方案。

核心实现思路 #

GA的数据保留设置是基于「属性（Property）」层级的，所以我们需要遍历主登录名下所有关联的属性，逐一更新它们的数据保留配置。下面是具体步骤：

1. 准备工作

   • 确保你拥有主账户的编辑权限（或更高权限，比如管理员）
   • 登录Google Cloud控制台，启用「Google Analytics Admin API」，并创建服务账号密钥（JSON格式），用于脚本调用API

2. 编写批量更新脚本
   你可以用Python、JavaScript等语言编写脚本，这里给个Python的简化示例（依赖google-api-python-client库）：

   from google.oauth2 import service_account
   from googleapiclient.discovery import build
   
   # 加载服务账号密钥
   SCOPES = ["https://www.googleapis.com/auth/analytics.edit"]
   SERVICE_ACCOUNT_FILE = "your-service-account-key.json"
   
   credentials = service_account.Credentials.from_service_account_file(
       SERVICE_ACCOUNT_FILE, scopes=SCOPES
   )
   
   # 初始化Admin API客户端
   service = build("analyticsadmin", "v1alpha", credentials=credentials)
   
   # 获取主账户下的所有属性（替换成你的主账户ID）
   account_id = "123456789"
   properties = service.accounts().properties().list(parent=f"accounts/{account_id}").execute()
   
   # 定义要设置的数据保留规则（比如事件数据保留26个月，用户数据保留14个月）
   data_retention_settings = {
       "eventDataRetention": "EVENT_DATA_RETENTION_26_MONTHS",
       "userDataRetention": "USER_DATA_RETENTION_14_MONTHS",
       "resetUserDataOnNewActivity": True
   }
   
   # 批量更新每个属性
   for prop in properties.get("properties", []):
       prop_id = prop["name"].split("/")[-1]
       try:
           service.properties().dataRetentionSettings().patch(
               name=f"properties/{prop_id}/dataRetentionSettings",
               updateMask="eventDataRetention,userDataRetention,resetUserDataOnNewActivity",
               body=data_retention_settings
           ).execute()
           print(f"成功更新属性 {prop_id} 的数据保留设置")
       except Exception as e:
           print(f"更新属性 {prop_id} 失败: {str(e)}")
   

3. 注意事项

   • 先在测试属性上跑一遍脚本，确认配置正确后再批量更新所有属性
   • 如果有部分属性不需要应用统一政策，可以在脚本里添加过滤条件（比如根据属性名称或ID排除）
   • 确保服务账号已经被添加到每个GA属性的权限列表中，否则会出现权限不足的错误

补充说明：根据Google官方文档，数据保留政策是属性级别的配置，无法通过UI直接批量应用，API是目前唯一支持批量操作的官方途径。

内容的提问来源于stack exchange，提问作者user9816655