Data Manager API の更新: RemoveAllAudienceMembers メソッド、取り込みフィールドの警告、拡張された住所データ

2026 年 7 月 30 日（木曜日）

Data Manager API の最新リリースでは、オーディエンス管理を簡素化し、フィールド レベルの警告で取り込みワークフローを強化し、Google アナリティクスでより詳細なユーザー提供データを有効にする機能が導入されています。

すべてのオーディエンス メンバーを削除する

新しい RemoveAllAudienceMembers メソッドを使用すると、指定したユーザーリストからすべてのメンバーを 1 回のオペレーションで削除できます。オプションの removeAsOfTime パラメータを使用すると、特定のタイムスタンプの前に追加されたメンバーのみをターゲットにできます。

これは、オーディエンス データの完全な更新（「すべて置換」）を実行する必要がある場合に特に便利です。既存のリストを消去して、新しいユーザーセットを入力できます。

取り込みフィールドの警告

Data Manager API の取り込みレスポンスに、オプション フィールドの検証に関する問題について、フィールド レベルの詳細な警告が含まれるようになりました。API がオプション フィールドの検証に関する問題を検出した場合、取り込みリクエストは成功し、残りの取り込みデータは引き続き処理されます。必須フィールドの検証に失敗すると、ファストフェイル モデルに従ってリクエスト全体が失敗します。

指定したオプション フィールドが無効な場合、IngestEventsRequest または IngestAudienceMembersRequest からのレスポンスには、FieldWarning オブジェクトのリストを含む field_warnings フィールドが含まれます。各警告には、具体的な理由（WarningReason）、説明メッセージ、問題が発生したリクエスト内のフィールドの場所が記載されています。

Google アナリティクス イベントの追加の住所データ

Google アナリティクスのリンク先にイベントを取り込む際に、ユーザーの住所情報を追加できるようになりました。given_name、family_name、region_code、postal_code フィールドに加えて、AddressInfo リソースで以下がサポートされるようになりました。

  • address_line（番地）
  • city
  • administrative_area（都道府県）

また、既存のユーザー提供データ（user_data）フィールドを使用して、ウェブデータ ストリームに送信されるマルチソース イベントの識別子の要件を満たすことができるようになりました。これにより、マルチソース イベントの ad_identifiers.gclid、user_id、client_id がない場合に別のオプションを使用できます。

使ってみる

AI エージェント スキルで構築を迅速化: 最近、統合を迅速化するための新しい Data Manager API エージェント スキルが導入されました。Google Skills GitHub リポジトリで新しいスキルを探索して、AI 支援コーディング環境内でより正確で効率的なガイダンスを直接取得してください。

ご不明な点がある場合や、この投稿についてディスカッションしたい場合は、「広告と測定に関する Google コミュニティ」Discord サーバーまでお問い合わせください。API に関する問題やサポートが必要な場合は、サポートページからお問い合わせいただくこともできます。

データ パートナーになることに関心をお持ちの場合は、パートナーお問い合わせフォームにご記入ください。

著者のポートレート - Data Manager API チーム、Lindsey Volta

ラベル: analytics、 data-manager-api