2026년 11월 4일 수요일
올해 초부터 Google Ads API는 민감한 API 작업을 수행할 때 복수 사용자 승인 체계(MPA)를 요구하기 시작했습니다. 2026년 12월 7일 주부터 다자간 승인의 개발자 환경을 개선하기 위한 추가 변경사항이 도입됩니다.
변경되는 사항
액세스 초대 생성 지연: 복수 사용자 승인이 필요한 경우 CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation 메서드는 복수 사용자 승인 요청이 승인될 때까지 액세스 초대 리소스 생성을 지연합니다. 이러한 경우 resource_name 필드가 채워지지 않습니다. 대기 중인 MPA 요청이 승인되면 검토 결과에서 액세스 초대 리소스를 사용할 수 있습니다. 현재 이 메서드는 초대를 만들고 초대의 resource_name를 반환하지만, 연결된 MPA 요청이 승인될 때까지 초대 이메일 전송과 같은 추가 작업을 실행하지 않습니다.
오래된 요청에 대한 새로운 오류 코드: 검토가 생성된 후 대상 리소스가 수정되거나 삭제되어 대기 중인 MPA 요청이 더 이상 유효하지 않은 경우 부분 실패 필드에 새로운 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 메서드를 한 번 호출하여 대기 중인 MPA 리뷰를 최대 100개까지 해결할 수 있습니다. 현재 이 메서드는 API 호출당 하나의 리뷰로 제한됩니다.
조치 필요
복수 사용자 승인을 사용하는 경우 2026년 12월 7일 전에 새 API 동작을 반영하도록 코드를 검토하고 업데이트하세요. Google Ads API v26을 사용하는 경우 v26.2가 출시된 후 최신 클라이언트 라이브러리를 다운로드하여 새로운 STALE_MULTI_PARTY_AUTH_REQUEST 오류 코드를 지원받으세요. 복수 사용자 승인에 대해 자세히 알아보려면 기술 가이드를 참고하세요. 기술 지원 문제는 Google Ads API 지원팀에 문의하세요. 궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 Google 광고 및 측정 커뮤니티 Discord 서버를 통해 문의해 주세요.
- 아나시 P. , Google Ads API팀
라벨: 승인, google-ads-api, 출시