2026년 6월 25일 목요일
Google Ads 계정의 보안을 강화하기 위해 민감한 API 작업을 수행할 때 Google Ads API에서 복수 사용자 승인 체계를 요구합니다. 이는 Google Ads 계정에서 민감한 작업을 수행하려면 복수 사용자 승인 체계를 요구하는 Google Ads의 광범위한 변경사항의 일부입니다. 이 중요한 보안 업데이트는 2026년 7월 27일부터 출시되며, 앞으로 몇 주에 걸쳐 모든 사용자에게 적용됩니다.
어떤 점이 달라지나요?
이 변경사항이 적용되면 다음 API 호출의 동작이 변경됩니다.
사용자 초대하기
CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation 메서드를 사용하여 신규 사용자를 초대하여 Google Ads 계정을 관리하는 경우 이제 Google Ads API에서 복수 사용자 승인 체계가 필요한지 평가합니다. 서버에서 검토가 필요하다고 판단하는 경우 시스템은 표준 워크플로를 일시중지하고 CustomerUserAccessInvitation를 즉시 생성하거나 초대 이메일을 발송하지 않습니다. 대신 MultiPartyAuthReview 리소스가 시작되고 응답에 리소스 이름이 제공됩니다. 대기 중인 검토가 두 번째 계정 관리자의 승인을 받으면 CustomerUserAccessInvitation가 생성되고 초대된 사용자에게 이메일이 전송됩니다. 대기 중인 검토가 해결될 때까지 해당 사용자에 대한 새 초대를 만들 수 없습니다.
사용자 액세스 업데이트 또는 종료
CustomerUserAccessService.MutateCustomerUserAccess 메서드를 사용하여 업데이트 작업으로 사용자의 권한을 조정하거나 삭제 작업으로 액세스 권한을 취소하는 경우 이제 Google Ads API에서 다자간 승인이 필요한지 평가합니다. Google 서버에서 검토가 필요하다고 판단하는 경우 API는 대기 중 상태의 MultiPartyAuthReview 리소스를 생성하고 리소스 이름을 반환합니다. 요청된 수정사항은 대기 상태로 유지되며, 다른 계정 관리자가 복수 사용자 검토를 성공적으로 승인한 후에만 적용됩니다. 검토 중인 CustomerUserAccess은 대기 중인 검토가 해결될 때까지 변경할 수 없습니다.
복수 사용자 승인 요청을 승인하려면 어떻게 해야 하나요?
다음 GAQL 쿼리를 사용하여 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 메서드를 사용해 대기 중인 MultiPartyAuthReview를 가져올 수 있습니다.
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에 문의하세요.
- 아나시 P. , Google Ads API팀