Google Ads API での複数の関係者による承認

2026 年 6 月 25 日（木曜日）

Google 広告アカウントのセキュリティ強化の一環として、Google Ads API では、API を使用して機密情報に関する操作を行う際に複数の関係者による承認が必要になります。これは、Google 広告アカウントで機密情報に関する操作を行う際に複数の関係者による承認を必要とする、Google 広告のより広範な変更の一環として行われます。これらの重要なセキュリティ アップデートは、2026 年 7 月 27 日からリリースされ、今後数週間以内にすべてのユーザーに適用されます。

変更内容

この変更が有効になると、次の API 呼び出しの動作が変更されます。

ユーザーを招待する

CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation メソッドを使用して Google 広告アカウントを管理する新規ユーザーを招待する場合、Google Ads API は複数の関係者による承認が必要かどうかを評価するようになりました。サーバーが審査が必要と判断した場合、システムは標準のワークフローを一時停止し、CustomerUserAccessInvitation の生成や招待メールの送信をすぐには行いません。代わりに MultiPartyAuthReview リソースが開始され、そのリソース名がレスポンスで返されます。保留中の審査が 2 人目のアカウント管理者から承認されると、CustomerUserAccessInvitation が作成され、招待されたユーザーにメールが届きます。保留中の審査が解決されるまで、ユーザーに新しい招待を作成することはできません。

ユーザーのアクセス権の更新または終了

CustomerUserAccessService.MutateCustomerUserAccess メソッドを使用して、更新オペレーションでユーザーの権限を調整したり、削除オペレーションでアクセス権を取り消したりすると、Google Ads API はマルチパーティ承認が必要かどうかを評価するようになりました。サーバーが審査が必要であると判断した場合、API は保留状態の MultiPartyAuthReview リソースを生成し、そのリソース名を返します。リクエストされた変更は、保留状態となり、別のアカウント管理者が複数の関係者による確認を承認した時点で反映されます。審査中の CustomerUserAccess は、審査が完了するまで変更できません。

複数の関係者による承認リクエストを承認するにはどうすればよいですか？

保留中の MultiPartyAuthReview を取得するには、GoogleAdsService.Search メソッドまたは GoogleAdsService.SearchStream メソッドを使用し、次の GAQL クエリを使用します。

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

保留中の MultiPartyAuthReview リクエストは、MultiPartyAuthReviewService.ResolveMultiPartyAuthReview API リクエストを使用して承認または拒否できます。この確認は、元のリクエストを作成した管理者とは別の管理者が行う必要があります。これは、管理者権限を持つユーザーまたはサービス アカウントです。保留中のレビューは、元のリクエスト元が取り消すことができます。

必要なご対応

アプリケーションでこれらのメソッドを使用されている場合は、2026 年 7 月 27 日までに複数の関係者による承認のワークフローに対応できるよう必ず更新してください。API のすべてのメジャー バージョン（v24.2、v23.3、v22.2、v21.2）で、複数の関係者による承認に対応しました。公式のクライアント ライブラリを使用されている場合は、最新バージョンをダウンロードしてください。これらの変更について詳しくは、次のガイドをご覧ください。

この更新についてご不明な点やご質問がございましたら、「広告と測定に関する Google コミュニティ」Discord サーバーまでお問い合わせください。技術的なサポートが必要な場合は、https://support.google.com/google-ads/contact/google_ads_api にお問い合わせください。

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

ラベル: authorization、 google-ads-api