Data Manager API 更新：RemoveAllAudienceMembers 方法、擷取欄位警告、擴充地址資料

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 (街道地址)
• city
• administrative_area (州或省)

此外，您現在可以使用現有的使用者提供資料 (user_data) 欄位，滿足傳送至網站資料串流的多來源事件 ID 規定。如果多來源事件沒有 ad_identifiers.gclid、user_id 或 client_id，您可以使用這個選項。

開始使用

• 瞭解如何為工作流程實作新的 RemoveAllAudienceMembers 方法：
  • Google Ads 目標顧客比對
  • Display & Video 360 目標顧客比對
• 請參閱「瞭解 API 錯誤」指南的「擷取警告」一節，瞭解如何檢查回應是否有警告。
• 開始使用 Data Manager API 將事件傳送至 Google Analytics：
  • 傳送建議和自訂事件
  • 從 Measurement Protocol 升級
  • 建議事件參考資料

運用 AI 代理技能加快建構速度：我們最近推出新的 Data Manager API 代理技能，可協助您加快整合速度。歡迎前往 Google Skills GitHub 存放區探索新技能，直接在 AI 輔助程式設計環境中，取得更準確、更有效率的指引。

如有任何疑問，或想討論這篇文章，歡迎透過 Google 廣告與評估社群 Discord 伺服器與我們聯絡。如果您有任何問題或需要 API 相關協助，也可以透過支援頁面與我們聯絡。

如果您有意成為資料合作夥伴，請填寫合作夥伴意願調查表。

- Data Manager API 團隊代表 Lindsey Volta

標籤： analytics、 data-manager-api