Google Ads API의 동의 번들 해제

2025년 2월 20일 목요일

변경되는 사항
2025년 5월 1일부터 2019년 이전에 생성된 모든 Google Cloud 프로젝트에 OAuth 사용자 인증을 위한 동의 분리가 적용됩니다. 2019년 이전에 생성된 Google Cloud 프로젝트를 통해 광고 관련 API를 사용하는 애플리케이션을 소유하고 있다면 2025년 5월 1일 전에 분리된 사용자 동의를 처리하도록 애플리케이션을 업데이트해야 할 수 있습니다.

배경
OAuth 사용자 인증 흐름의 동의 분리를 통해 사용자는 전부 아니면 전무 방식이 아닌, 애플리케이션에 승인할 특정 OAuth 범위를 맞춤설정할 수 있습니다. 2019년 이후에 생성된 모든 Google Cloud 콘솔 프로젝트에는 이 기능이 사용 설정되어 있지만 2019년 이전에 생성된 모든 프로젝트에는 이 기능이 사용 중지되어 있습니다.

이번 변경사항의 영향을 받는 대상은 누구인가요?
다음 조건이 모두 충족되는 경우 이 변경사항의 영향을 받게 됩니다.

  1. API 애플리케이션에서 2019년 이전에 생성된 Google Cloud 콘솔 프로젝트를 사용합니다.
  2. 애플리케이션은 OAuth 2.0 사용자 동의 흐름을 구현합니다. 이는 사용자가 Google 계정으로 로그인하고 애플리케이션에서 요청하는 하나 이상의 권한을 부여하는 인증 워크플로입니다.
  3. 애플리케이션에서 두 개 이상의 Google API를 사용하며, API 중 하나가 아래에 나열된 Google Ads 관련 API입니다.

이번 변경사항의 영향을 받지 않는 대상은 누구인가요?

  • 기존 갱신 토큰: 이 변경사항은 이미 설정된 사용자 인증에는 영향을 미치지 않습니다. 기존 갱신 토큰은 변경이나 재인증 없이 계속 작동합니다.
  • 단일 범위 애플리케이션: 애플리케이션에서 Google API 범위를 하나만 사용하는 경우 번들 해제할 OAuth 범위가 여러 개 없으므로 이 변경사항의 영향을 받지 않습니다.
  • 단일 사용자 애플리케이션/수동 인증 애플리케이션: 애플리케이션에 명시적인 OAuth 사용자 인증 흐름이 구현되어 있지 않습니다. 대신 GenerateUserCredentials, gcloud CLI 또는 OAuth Playground와 같은 수동 인증 스크립트를 사용하여 사용자를 인증한 다음 해당 사용자 인증 정보를 장기간 사용합니다. 인증하는 동안 애플리케이션에 필요한 모든 범위를 선택하므로 이 변경사항은 애플리케이션에 영향을 미치지 않습니다.
  • 서비스 계정: 애플리케이션에서 서비스 계정을 사용하여 API 호출을 인증하는 경우 이 변경사항의 영향을 받지 않습니다.

어떤 조치를 취해야 하나요?
애플리케이션이 부분적인 사용자 동의를 처리할 수 있어야 합니다. 방법은 다음과 같습니다.

  1. OAuth 흐름에 include_granted_scopes 매개변수를 포함하여 사용자가 동의한 OAuth 범위 목록을 요청합니다.
  2. OAuth 응답에서 사용자가 동의한 OAuth 범위의 실제 목록을 검사합니다.
  3. 애플리케이션에 점진적 승인을 구현합니다.

OAuth 상세 동의 가이드를 검토하여 상세 동의를 처리하기 위한 요구사항과 권장사항을 알아보세요.

이 기능을 테스트하려면 어떻게 해야 하나요?
이 기능을 테스트하는 방법에는 두 가지가 있습니다.

  1. 새 Google Cloud 프로젝트 만들기: 새 Google Cloud 프로젝트에서는 OAuth 동의 번들 해제가 사용 설정되어 있습니다. 따라서 새 Google Cloud 프로젝트를 만들어 애플리케이션을 테스트하는 데 사용할 수 있습니다.
  2. 기존 프로젝트에서 동의 번들 해제 사용 설정: OAuth 승인 요청에서 enable_granular_consent 매개변수를 true로 설정할 수 있습니다.

어떤 API 범위가 영향을 받나요?
Google Ads와 관련된 다음 API가 이번 변경사항의 영향을 받습니다.

API OAuth 범위
Google Ads API https://adwords.google.com/api/adwords
Google Ad Manager API(SOAP API, 베타) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
Bid Manager API https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
Display & Video 360 API https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
AdMob API https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
플랫폼용 애드센스 API https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
Google Analytics API https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.manage.users
https://www.googleapis.com/auth/analytics.manage.users.readonly
https://www.googleapis.com/auth/analytics.provision
https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API https://www.googleapis.com/auth/tagmanager.delete.containers
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.manage.accounts
https://www.googleapis.com/auth/tagmanager.manage.users
https://www.googleapis.com/auth/tagmanager.publish
https://www.googleapis.com/auth/tagmanager.readonly
실시간 입찰 API https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

도움받기
궁금한 점이 있거나 도움이 필요한 경우 각 API의 지원팀에 문의하세요.

저자 초상화 - , Google Ads API팀

라벨: 인증, oauth