Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

版本说明

您可以在此处了解每个 Data Manager API 版本中的更改。

2026-07-30 v1.8

向 IngestionService 添加了 RemoveAllAudienceMembers 方法，以移除或替换指定用户名单的所有受众群体成员。
- 如需开始使用，请查看有关从受众群体中移除所有成员的指南，了解具体集成。例如，请参阅 Google Ads 或 Display & Video 360 的目标客户匹配指南。
添加了对在事件和受众群体提取期间返回详细警告的支持。
- 向 IngestEventsResponse 和 IngestAudienceMembersResponse 添加了 field_warnings 字段，其中包含 FieldWarning 对象列表。
- 添加了 FieldWarning 资源，其中包含 reason (WarningReason )、description 和 field 路径。
- 添加了 WarningReason 枚举，用于定义警告原因，例如未启用自定义变量或购物车数据中缺少商家 ID。
添加了对发送其他地址字段以进行 Google Analytics 事件提取的支持。
- 向 AddressInfo（在 UserData 中使用）添加了 address_line、city 和 administrative_area 字段。
向 ErrorReason枚举添加了INVALID_REMOVE_AS_OF_TIME和 REQUIRED_PREREQUISITE_LINK_MISSING错误原因。

2026-05-28 v1.7

添加了对使用 `IngestEventsRequestIngestEventsRequest` 将线下转化事件发送到 Google Marketing Platform 产品（包括 Campaign Manager 360、 Search Ads 360 和 Display & Video 360）的支持。
- 向 AccountType 枚举添加了 FLOODLIGHT_CONFIG，以支持 Floodlight 目标位置。
- 向 AdIdentifiers 添加了 dclid、impression_id、match_id 和 encrypted_user_ids 字段。
- 向 Event资源添加了conversion_count字段，以支持跟踪转化数量。
如需开始使用，请查看发送事件指南，或了解如何从 Campaign Manager 360 API 升级。
向 AudienceMember资源添加了composite_data字段，该字段接受 CompositeData对象，并允许您组合多种类型的标识符，例如 UserData和 IpData。如需了解详情，请参阅复合数据。
- 添加了新状态 IngestCompositeDataStatus和 RemoveCompositeDataStatus ，其中包括使用CompositeData的受众群体成员请求的诊断信息（record_count和data_type_counts）。
添加了对通过在复合数据中发送 IpData 来提取 Google Ads 目标客户匹配的 IP 地址的支持。
向 ErrorReason 枚举添加了新的错误原因 FIELD_VALUE_TOO_SHORT、TOO_FEW_ELEMENTS、 BASELINE_LOCATION_AUTO_DETECTION_FAILED 和 INSIGHTS_MISSING_FOR_DIMENSION。
向 ProcessingErrorReason添加了新的诊断值，以便为事件提取期间的失败提供更精细的反馈。

2026-05-07 v1.6

添加了对使用 IngestEventsRequest 发送 Google Ads 实体店销售转化的支持。如需使用此功能，您的 Google Ads 账号必须满足某些资格要求。
- 向 Event添加了event_location字段，该字段支持提供实体store_id.
- 向 Event 添加了 third_party_user_data 字段，允许将提取的数据明确标记为归第三方所有。
  - 只有数据合作伙伴才能填充此字段。
- 向 Item 资源添加了以下字段：
  - merchant_id
  - merchant_feed_label
  - merchant_feed_language_code
  - conversion_value
  - custom_variables（接受 ItemCustomVariable 对象列表）
- 如需开始使用，请查看以下指南：
  - 从 Google Ads 升级
  - 发送事件
添加了对将任何非预留事件的网站或应用事件发送到 Google Analytics 的支持。
- 向 Event 资源添加了 app_instance_id 字段。
- 向 DeviceInfo 添加了字段，以提供有关用户设备的元数据。
- 向 AdIdentifiers 添加了 mobile_device_id 字段。
- 向 Event 添加了 event_location 字段，以捕获 city、subdivision_code、region_code、 subcontinent_code 和 continent_code 等字段。
- 如需开始使用，请查看以下指南：
添加了对将 任何包含交易 ID 的事件作为额外的网站和应用数据流数据源发送到您的代码或 Google Analytics for Firebase (GA4F) SDK 实现的支持。
- 此功能仅限于已列入许可名单的 Google Analytics 媒体资源；如果您有意将您的媒体资源添加到许可名单，请填写此表单。
向 CartData 添加了 coupon_codes 字段，以跟踪发送到 Google Ads 和 Google Analytics 的事件的所有应用于购物车的优惠券代码。
- 对于 Google Ads 中的优惠券兑换用例，请使用 OFFLINE_PROMOTION_REDEMPTION 转化类型。
为与创建、搜索和删除合作伙伴关联的方法添加了新的 OAuth 范围 https://www.googleapis.com/auth/datamanager.partnerlink。
向 ErrorReason 枚举添加了新值，以支持对实体店销售和 Google Analytics 事件提取进行详细验证。
向 SizeInfo资源添加了youtube_members_count和gmail_members_count字段。

2026-03-26

向 ErrorReason枚举添加了EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED。

为了遵守欧盟政治广告法规 (EU PAR)，Google 要求所有客户自行声明其广告是否属于 EU PAR 规定的政治广告。了解欧盟政治广告的定义以及 Google 针对欧盟政治广告的欧盟限制。

自 2026 年 4 月 1 日 起，对于缺少此声明的账号，以下操作可能会受到限制或失败，并显示错误 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED。
- UserListService （create、 update 和 delete）
- IngestionService （ingestAudienceMembers）
如需解决此错误，广告客户必须在 Google Ads 界面中提供强制要求的声明。详细了解如何为您的账号确认。
向 ErrorReason枚举添加了INVALID_MERCHANT_ID。

2026-02-17 v1.5

Data Manager API 现在支持管理受众群体的整个端到端工作流，包括受众群体创建、提取和检索。

添加了 UserList 资源和 UserListService，以允许创建、检索、更新和删除用户名单。
- 查看 Google Ads 或 Display & Video 360 指南，了解如何使用 Data Manager API 创建、填充和验证目标客户匹配受众群体的端到端演练。
- 如需了解迁移步骤，请参阅 Google Ads 或 Display & Video 360 升级指南。
添加了对通过受众群体成员提取发送用户 ID的支持，以便在 Google Ads 中与目标客户匹配搭配使用。
- 向 AudienceMember 添加了 UserIdData。
- 向 statuses returned by the RetrieveRequestStatus method. 添加了 IngestUserIdDataStatus 和 RemoveUserIdDataStatus。使用这些字段检索有关用户 ID 提取和移除的诊断信息。
添加了 PartnerLink 资源和 PartnerLinkService，以创建和管理广告客户账号与数据合作伙伴账号之间的关联。
- 查看合作伙伴关联指南，开始使用。

2026-02-10

现在，所有 Google Ads 账号都可以使用基于多个数据源发送转化数据以提升效果和数据强度的功能。

此功能仍仅适用于已列入许可名单的 Google Analytics 媒体资源。如果您有意将您的 Google Analytics 媒体资源添加到许可名单，请填写此表单。

2025-11-05 v1.4

添加了对将 Google Analytics purchase 事件作为代码转化数据的额外数据源发送的支持，以最大限度地提高广告互动信号，并增强您的数据和整体效果。
- 向 AccountType 枚举添加了 GOOGLE_ANALYTICS_PROPERTY。
- 向 Event 添加了多个字段：
  - event_name
  - client_id
  - user_id
  - additional_event_parameters
- 向 UserProperties 添加了 additional_user_properties。
如需详细了解如何发送 Google Analytics purchase 事件以及如何将 Google Analytics 事件参数和用户属性映射到其 Data Manager API 等效项，请参阅事件指南。
添加了 AwsWrappedKeyInfo ，以支持使用 AWS 密钥管理服务中的加密密钥。
向 ErrorReason 添加了以下枚举值：
- EVENT_TIME_INVALID
- FIELD_VALUE_TOO_LONG
- INVALID_EVENT_NAME
- INVALID_PROPERTY_TYPE
- INVALID_REQUEST_ID
- INVALID_STREAM_TYPE
- LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
- MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
- NOT_ALLOWLISTED
- OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
- RESERVED_NAME_USED
- TOO_MANY_ELEMENTS
- UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
- UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

Data Manager API 现已正式面向所有用户发布。

基于多个数据源发送转化数据以提升效果和数据强度的功能仍仅适用于已列入许可名单的账号。如果您有意添加您的账号，请填写此表单。

填写合作伙伴意向表单，表明您有意成为数据合作伙伴。
添加了 RetrieveRequestStatus 方法，用于检索诊断信息，用于事件和受众群体提取请求。
已弃用 ProductAccount 的 product 字段和 Product 枚举。请改用 account_type 字段和新的 AccountType 枚举。
添加了对在 IngestAudienceMembersRequest中为每个 AudienceMember指定destination的支持。使用此功能可在单个请求中将受众群体数据发送到多个不同的目标位置。
使用 API 提取的受众群体现在只要至少有 100 名成员，就有资格用于定位。以前，成员人数阈值为 1000 名成员。
现在，在发送线下转化或增强型潜在客户转化时，transaction_id的 Event 是可选的。在将线下转化作为额外的数据源发送以提升效果和数据强度时，仍需要 transaction_id。

2025-08-06 v1.2

添加了对使用 IngestEvents 方法将线下转化和增强型潜在客户转化发送到 Google Ads 目标位置的支持。如需了解如何为这些转化配置加密，请参阅更新后的加密指南。
向 EventSource枚举添加了APP、IN_STORE、PHONE和OTHER值。线下转化和增强型潜在客户转化需要 event_source。
向 Event 添加了 user_properties 字段。将此字段设置为 UserProperties 对象，以便在事件发生时添加广告客户评估的用户信息。
添加了 destination_references 重复字段到 CustomVariable。使用此字段可仅将自定义变量值应用于 Event 的一部分目标位置。
为线下转化和增强型潜在客户转化添加了以下错误：
- DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
- DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
- DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

向 IngestionService添加了IngestEvents方法。将 IngestEvents作为代码转化数据的额外数据源使用，以最大限度地提高广告互动信号，并增强您的数据和整体效果。

2025-04-02 v1.0

Data Manager API 的首个版本，支持将受众群体数据发送到 Google Ads 和 Display & Video 360。
添加了对 gRPC 和 REST 的支持。
添加了 IngestionService，其中包含 IngestAudienceMembers 和 RemoveAudienceMembers 方法，用于使用以下数据类型管理受众群体成员：
使用 Data Manager API 管理的受众群体只有在至少有 1000 名成员时才有资格用于定位。

版本说明 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。