2026년 9월 10일 목요일
개발자 온보딩 및 사용 환경을 개선하기 위해 Google Cloud 콘솔에 Google Ads API의 새 홈페이지를 구축했습니다. 이제 브랜드 인증을 완료한 개발자는 기본 액세스 신청이 자동화됩니다. 이 블로그 게시물에서는 오늘부터 적용되는 몇 가지 관련 변경사항을 다룹니다. 개발자는 원활한 전환을 위해 이 게시물의 필요한 조치 섹션을 검토해야 합니다.
API 액세스 관리 변경사항
Google Ads API 액세스를 신청하고 관리하는 방식이 업데이트됩니다.
Google Ads API의 새로운 온보딩 환경: 이제 Google Ads 관리자 계정 없이도 Google Cloud 콘솔에서 직접 Google Ads API 액세스를 신청할 수 있습니다. 관리자 계정의 API 센터 페이지에서 모든 신규 가입 및 API 액세스 관리 기능이 지원 중단되고 Google Cloud 콘솔의 Google Ads API 개요 페이지로 전환됩니다. API 센터 페이지에 액세스하여 이전 개발자 세부정보를 계속 참조할 수 있습니다. 이 페이지는 향후 완전히 지원 중단될 예정입니다.
API 액세스 수준이 Google Cloud 프로젝트와 연결됨: 개발자 토큰이 지원 중단됩니다. 현재 활성 상태인 개발자 토큰 액세스 수준은 최근 API 활동을 기반으로 Google Cloud 프로젝트로 자동 이전됩니다. API 호출 헤더에 개발자 토큰을 계속 전송할 수 있지만, 이는 선택사항이며 API 서버에서 무시됩니다. 기존 코드는 변경 없이 계속 작동합니다. 이제 API 액세스 수준은 OAuth 사용자 인증 정보를 생성하는 데 사용한 Google Cloud 프로젝트에 따라 결정됩니다. FAQ 페이지를 참고하여 이번 변경사항에 대해 자세히 알아보고 발생할 수 있는 문제를 해결하세요.
새 오류 코드: Google Ads API 버전 v25에서는 테스트 계정 액세스 수준이 있는 Google Cloud 프로젝트를 사용하여 프로덕션 계정을 호출하려고 하면 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 오류가 발생합니다. 이전 API 버전에서는 대신 ACTION_NOT_PERMITTED 오류가 발생합니다. 이 오류가 발생하면 Google Cloud 프로젝트의 Google Ads API 개요 페이지로 이동하여 탐색기 액세스 권한을 신청하세요.
API 검토 절차 변경사항
Basic 및 일반 액세스에 브랜드 인증 필요: 새로운 Basic 및 일반 액세스 신청의 경우 Google Cloud 프로젝트에 대한 브랜드 인증을 완료해야 합니다 . 기존 액세스 권한 보유자는 브랜드 인증을 완료하지 않아도 되지만 완료하는 것이 좋습니다.
자동화된 Basic 액세스 승인: Basic 액세스 신청이 자동화되어 브랜드 인증 및 제출 후 몇 분 이내에 검토됩니다.
대기 중인 기본 액세스 신청의 일회성 거부: 이러한 절차 업데이트로 인해 대기 중인 모든 기본 API 액세스 신청은 이번 전환의 일환으로 종료됩니다. 영향을 받는 신청자에게는 세부정보가 포함된 이메일이 전송되며, Google Ads API 개요 페이지에서 API 액세스를 다시 신청해야 합니다.
조치 필요
API 액세스 확인: 프로젝트의 API 액세스 수준이 기존 개발자 토큰과 정확히 일치하는지 확인합니다.
- Google Ads 관리자 계정의 API 센터에서 개발자 토큰의 액세스 수준을 확인합니다.
- Google Ads API 개요 페이지에서 Google Cloud 프로젝트의 액세스 수준이 동일한지 확인합니다.
- 액세스 수준이 일치하지 않는 경우 Google Ads API 개요 페이지에서 API 액세스를 다시 신청하거나 도움이 필요한 경우 Google Ads API 지원팀에 문의하세요.
API 연락처 이메일 주소 업데이트: Cloud 프로젝트의 IAM(Identity and Access Management) 페이지로 이동합니다. 소유자 및 편집자 역할의 사용자 목록이 최신 상태인지 확인합니다. 향후 Google Ads API의 변경사항을 알려드리기 위해 이 이메일 주소로 필수 서비스 공지(MSA)를 보내드릴 예정입니다.
코드 변경: API 호출의 일부로 개발자 토큰을 전송하지 않도록 애플리케이션 코드를 업데이트하시기 바랍니다. 개발자 토큰을 설정하지 않고도 API를 호출할 수 있는 새로운 버전의 클라이언트 라이브러리를 게시했습니다. Google Ads API의 향후 메이저 버전에서는 API 호출 시 개발자 토큰이 거부됩니다.
해당하는 경우 API 액세스 권한 재신청: 대기 중인 기본 API 액세스 신청이 이번 전환의 일환으로 종료된 경우 Google Cloud 콘솔의 Google Ads API 개요 페이지에서 API 액세스 권한을 다시 신청하세요.
이러한 변경사항을 파악하는 데 도움이 되도록 업데이트된 문서를 게시했습니다. 기술 지원 문제는 FAQ 페이지를 참고하거나 Google Ads API 지원팀에 문의하세요. 궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 Google 광고 및 측정 커뮤니티 Discord 서버를 통해 문의해 주세요.
- 아나시 P. , Google Ads API팀
라벨: google-ads-api, release