2026 年 11 月 4 日（水曜日）
今年、Google Ads API では、API を使用して機密情報に関する操作を行う際に複数の関係者による承認（MPA）が必要になりました。2026 年 12 月 7 日の週より、マルチパーティ承認のデベロッパー エクスペリエンスを向上させるための追加の変更を導入します。
変更内容
アクセス招待の作成の延期: 複数の関係者による承認が必要な場合、CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation メソッドは、複数の関係者による承認リクエストが承認されるまで、アクセス招待リソースの作成を延期します。このような場合、resource_name フィールドは入力されません。保留中の MPA リクエストが承認されると、審査結果からアクセス招待リソースを利用できるようになります。現在、このメソッドは招待状を作成して招待状の resource_name を返しますが、関連付けられた MPA リクエストが承認されるまで、招待メールの送信などの追加のアクションは実行しません。
古いリクエストに関する新しいエラーコード: 審査の作成後にターゲット リソースが変更または削除されたために、保留中の MPA リクエストが無効になった場合、partial failure フィールドに新しい MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST エラーコードが返されるようになります。このエラーコードは、今後の v26.2 リリースで導入される予定です。古い API バージョン（v23 ～ v25）では MultiPartyAuthReviewError.UNKNOWN エラーが返され、GoogleAdsError.details の unpublished_error_code フィールドが MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST に設定されます。
MPA レビューの上限の引き上げ: MultiPartyAuthReviewService.ResolveMultiPartyAuthReview メソッドの 1 回の呼び出しで、最大 100 件の保留中の MPA レビューを解決できるようになりました。現在、このメソッドは API 呼び出しごとに 1 つのレビューに制限されています。
必要な対応
複数の関係者による承認を使用している場合は、2026 年 12 月 7 日までに、新しい API の動作を反映するようにコードを確認して更新してください。Google Ads API の v26 を使用している場合は、v26.2 のリリース後に最新のクライアント ライブラリをダウンロードして、新しい STALE_MULTI_PARTY_AUTH_REQUEST エラーコードのサポートを入手してください。複数の関係者による承認について詳しくは、技術ガイドをご覧ください。技術的なサポートが必要な場合は、Google Ads API サポートにお問い合わせください。ご不明な点がある場合や、この投稿についてディスカッションをご希望の場合は、Google 広告および測定のコミュニティ Discord サーバーまでお問い合わせください。
- Anash P. Google Ads API チーム、Oommen
ラベル: authorization、 google-ads-api、 release