2026 年 7 月 30 日，星期四
最新版 Data Manager API 引入了多项新功能，可简化受众群体管理、通过字段级警告增强数据注入工作流，并为 Google Analytics 提供更精细的用户提供的数据。
移除所有受众群体成员
使用新的 RemoveAllAudienceMembers 方法，只需执行一次操作即可从指定的用户名单中清除所有成员。
通过可选的 removeAsOfTime 参数，您可以仅定位在特定时间戳之前添加的成员。
当您需要对受众群体数据执行完全刷新（或“全部替换”）时，此功能尤其有用，可让您清除现有列表并用一组新用户填充该列表。
提取字段警告
Data Manager API 提取响应现在包含详细的字段级警告，用于提示可选字段的验证问题。如果 API 检测到可选字段存在验证问题，您的提取请求仍会成功，并且系统仍会处理其余提取数据。必填字段的验证失败将继续导致整个请求失败，遵循快速失败模型。
如果您提供的任何可选字段无效，则 IngestEventsRequest 或 IngestAudienceMembersRequest 的响应会包含一个 field_warnings 字段，其中包含 FieldWarning 对象列表。每个警告都会提供具体原因 (WarningReason)、描述性消息以及请求中发生问题的字段的位置。
Google Analytics 事件的其他地址数据
现在，在将事件注入 Google Analytics 目标位置时，您可以提供更多用户地址信息。除了 given_name、family_name、region_code 和 postal_code 字段之外，AddressInfo 资源现在还支持：
address_line（街道地址）cityadministrative_area（州或省/直辖市/自治区）
此外，您现在可以使用现有的用户提供的数据 (user_data) 字段来满足针对发送到网站数据流的多来源事件的标识符要求。这样，当您没有多来源事件的 ad_identifiers.gclid、user_id 或 client_id 时，便有了另一种选择。
开始
-
了解如何为工作流实现新的
RemoveAllAudienceMembers方法： - 请参阅了解 API 错误指南的提取警告部分，了解如何检查响应中是否存在警告。
- 开始使用 Data Manager API 向 Google Analytics 发送事件：
利用 AI 智能体技能加快构建速度：我们最近推出了新的 Data Manager API 智能体技能，可帮助您加快集成速度。探索 Google Skills GitHub 代码库中的新技能，直接在 AI 辅助编码环境中获得更准确、更高效的指导。
如果您有任何疑问或想讨论此帖子，请通过我们的“Google 广告和效果衡量社区”Discord 服务器与我们联系。如果您遇到问题或需要有关 API 的帮助，也可以通过支持页面与我们联系。
如果您有兴趣成为数据合作伙伴，请填写合作伙伴意向调查表。
- Lindsey Volta，代表 Data Manager API 团队