Google Ads API の Search と SearchStream のレスポンスに関する今後の変更

2025 年 7 月 1 日（火曜日）

変更内容

昨年、Google 広告 API クエリのコストを測定する方法として query_resource_consumption 指標を導入しました。ただし、クエリ結果が空の場合、このコストは返されませんでした。

2025 年 8 月 4 日の週より、すべての API バージョンで GoogleAdsService の Search メソッドと SearchStream メソッドの動作が変更され、クエリ結果が空の場合でも query_resource_consumption 指標と field_mask フィールドが返されるようになります。空のクエリ結果に対するレスポンスは、次のように変更されます。

メソッド 古い回答 新しい回答
検索 
{
    "fieldMask": "..."
}
 
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream 
[]
 
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

必要なご対応

Search メソッドと SearchStream メソッドを使用して Google Ads API レポートをダウンロードしている場合は、変更されたレスポンスをアプリケーションで処理できることを確認してください。

ご不明な点がある場合やサポートが必要な場合は、Google Ads API のサポートページをご覧ください。

アカウント ポリシーに関するご不明な点については、Google 広告プロダクト サポートチームにお問い合わせください。

著者のポートレート - Google Ads API チーム、Oommen

ラベル: google-ads-api、 reporting