개발자 토큰 은 앱을 Google Ads API에 연결하는 데 사용되는 22자 길이의 영숫자 문자열입니다. 개발자 토큰은 2026년 9월 9일 에 지원 중단되었습니다. 이 가이드에서는 기존 개발자를 지원하기 위해 이 이전과 관련된 변경사항을 요약하고 자주 묻는 질문을 나열합니다.
변경되는 사항
개발자 토큰 지원 중단의 일환으로 Google Ads API 온보딩 환경과 API 액세스 관리에 몇 가지 변경사항이 도입되었습니다. 이 섹션에서는 주요 변경사항을 중점적으로 설명합니다.
API 액세스 수준은 Google Cloud 프로젝트와 연결됨
2026년 9월 9일에 개발자 토큰이 지원 중단되었습니다. 최근 API 활동에 따라 현재 활성 개발자 토큰 액세스 수준이 Google Cloud 프로젝트로 자동 이전되었습니다. API 호출 헤더에서 개발자 토큰을 계속 보낼 수 있지만 이는 선택사항이며 API 서버에서 무시됩니다. 기존 코드는 변경 없이 계속 작동합니다. 이제 API 액세스 수준은 OAuth 사용자 인증 정보를 생성하는 데 사용한 Google Cloud 프로젝트에 따라 결정됩니다.
- 앱에서 사용자 인증 워크플로를 사용하는 경우 OAuth 클라이언트 ID와 보안 비밀을 소유하는 프로젝트입니다.
- 서비스 계정 워크플로를 사용하는 경우 서비스 계정을 소유하는 프로젝트입니다.
Google Ads API의 새로운 가입 환경
이제 Google Ads 관리자 계정 없이 Google Cloud 콘솔에서 직접 Google Ads API에 대한 액세스 권한을 신청할 수 있습니다. API 센터 페이지에서 개발자 토큰을 신청하거나 Google Ads 관리자 계정의 API 센터 페이지에서 API 액세스 권한을 신청하지 마세요. 이러한 프로세스는 Google Cloud 콘솔로 이전되었으며 API 센터 페이지에서 시작하면 처리되지 않습니다.
새로운 API 액세스 관리 환경
Google Ads 관리자 계정의 API Center 페이지에서 API 액세스 신청 및 API 액세스 수준 관리와 같은 모든 새로운 가입 및 API 액세스 관리 기능이 지원 중단되었습니다. 이제 이러한 기능은 Google Cloud 콘솔의 Google Ads API 개요 페이지에서 사용할 수 있습니다.
API 센터 페이지에 계속 액세스하여 이전 개발자 세부정보를 참조할 수 있습니다. 이 페이지는 향후 완전히 지원 중단될 예정입니다.
새로운 오류 코드
Google Ads API 버전 v25에서는 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 오류가 발생합니다. 테스트 계정 액세스 수준의 Google Cloud 프로젝트를 사용하여 프로덕션 계정을 호출하려고 하면 테스트 계정 액세스 수준 오류가 발생합니다. 이전 API 버전에서는 대신 ACTION_NOT_PERMITTED 오류가 발생합니다. 이 오류가 발생하면 Google Ads API 개요 페이지로 이동하여 Google Cloud 프로젝트의 탐색기 액세스 권한을 신청하세요.
기본 및 일반 액세스에 브랜드 인증이 필요함
새로운 기본 및 일반 액세스 애플리케이션의 경우 Google Cloud 프로젝트에 대한 브랜드 인증을 완료해야 합니다. 기존 액세스 권한 보유자는 브랜드 인증을 완료할 필요는 없지만 완료하는 것이 좋습니다.
이제 기본 액세스 애플리케이션이 자동화되었으며 브랜드 인증 및 제출 후 몇 분 이내에 검토됩니다.
이러한 프로세스 업데이트로 인해 이 전환의 일환으로 보류 중인 모든 기본 API 액세스 애플리케이션이 종료됩니다. 영향을 받는 신청자에게 세부정보가 포함된 이메일이 전송되며 Google Ads API 개요 페이지에서 API 액세스 권한을 다시 신청해야 합니다.
새로운 API 연락처 이메일
API 센터 페이지 지원 중단을 준비하면서 Google Cloud 프로젝트의 소유자 및 편집자 사용자 목록을 관리 및 필수 규정 준수 커뮤니케이션의 유일한 채널로 전환할 예정입니다. 원활한 전환을 위해 필수 서비스 공지 (MSA)는 API 센터에 등록된 이메일 주소로 계속 전송됩니다. 커뮤니케이션 채널 전환이 완료되면 업데이트를 제공해 드리겠습니다.
기존 개발자인 경우 대처 방법
Google Cloud 프로젝트의 API 액세스 수준 검토: 기존 개발자인 경우 Google Cloud 프로젝트의 Google Ads API 개요 페이지 를 검토하여 기존 개발자 토큰과 동일한 API 액세스 수준을 보유하고 있는지 확인하는 것이 좋습니다. 이 가이드의 안내에 따라 발견한 불일치를 해결하세요.
API 연락처 이메일 주소 검토: Google Cloud 프로젝트의 IAM (Identity and Access Management) 페이지를 방문하세요. 활성 Google Ads 개발자 및 계정 관리자에게 Google Cloud 프로젝트에서 적절한 소유자 또는 편집자 역할 이 할당되어 있는지 확인합니다. 향후 Google Ads API 변경사항을 알려 드리기 위해 이러한 이메일 주소로 필수 서비스 공지 (MSA)를 전송할 예정입니다. MSA는 API 센터에 등록된 연락처 이메일 주소로 일시적으로 계속 전송되며 이 프로세스가 업데이트될 때마다 알려 드리겠습니다.
앱 코드 수정: API 호출의 일부로 개발자 토큰을 보내지 않도록 앱을 업데이트하는 것이 좋습니다. 개발자 토큰을 설정하지 않고 API 호출을 할 수 있는 업데이트된 버전의 클라이언트 라이브러리, Google Ads MCP 서버, 그리고 Google Ads API 개발자 어시스턴트가 게시되었습니다. 향후 Google Ads API의 메이저 버전에서는 API 호출에서 개발자 토큰이 거부됩니다. 앱에서 이러한 라이브러리를 사용하는 경우 최신 버전을 사용하도록 앱 종속 항목을 업데이트하세요.
추가 지원이 필요하거나 궁금한 점이 있으면 Google Ads API 지원팀에 문의하세요.
자주 묻는 질문(FAQ)
API 액세스 수준은 어떻게 되나요?
API 액세스 수준은 Google Ads API에서 계속 적용됩니다. 하지만 이제 개발자 토큰 대신 Google Cloud 콘솔 프로젝트에 부여됩니다. API 호출을 할 때 이제 API 액세스 수준은 OAuth 사용자 인증 정보를 생성하는 데 사용한 Google Cloud 프로젝트에 따라 결정됩니다.
- 앱에서 사용자 인증 워크플로를 사용하는 경우 OAuth 클라이언트 ID와 보안 비밀을 소유하는 프로젝트입니다.
- 서비스 계정 워크플로를 사용하는 경우 서비스 계정을 소유하는 프로젝트입니다.
API 액세스 수준을 이전할 프로젝트는 어떻게 식별되었나요?
2026년 9월 9일 이전에 승인된 개발자 토큰이 있는 경우 액세스 수준이 다음과 같이 Google Cloud 프로젝트로 이전되었습니다.
- 지난 90일간의 API 호출 로그를 검토하여 승인된 개발자 토큰으로 API 호출을 하는 데 사용된 Cloud 프로젝트를 식별했습니다.
- 식별된 모든 Cloud 프로젝트에 개발자 토큰의 API 액세스 수준을 할당했습니다.
이 변경사항 이후에 다양한 액세스 수준의 Cloud 프로젝트를 여러 개 보유할 수 있나요?
예, API 액세스 수준이 다른 Google Cloud 프로젝트를 여러 개 보유할 수 있습니다. 예를 들어 기본 액세스 권한이 있는 Google Cloud 프로젝트와 일반 액세스 권한이 있는 Google Cloud 프로젝트를 보유할 수 있습니다.
예
예를 들어 다음과 같은 세부정보가 포함된 개발자 토큰 4개와 Cloud 프로젝트 6개가 있다고 가정해 보겠습니다.
- 개발자 토큰 1:
abcdefghijkl1234567890에 일반 액세스 권한이 있습니다. 프로젝트 ID1234567890,5678912345,45678912345와 함께 사용되었습니다. - 개발자 토큰 2:
xyzabcdefghi6789012345에 기본 액세스 권한이 있습니다. 프로젝트 ID1231235678과 함께 사용되었습니다. - 개발자 토큰 3:
asdfgflkjhjz7654321012에 기본 액세스 권한이 있지만 API 호출을 하는 데 사용된 적이 없습니다. 최근에 승인되었습니다. - 개발자 토큰 4:
qwertypoiuyu6543298790에 일반 액세스 권한이 있었지만 지난 90일 동안 사용되지 않았습니다. 프로젝트 ID9876564900은 과거에 이 개발자 토큰과 함께 사용되었습니다. - Cloud 프로젝트: Cloud 프로젝트 ID:
7171234567은 API 호출을 하는 데 개발자 토큰과 함께 사용된 적이 없습니다.
API 액세스 수준은 다음과 같이 개발자 토큰에서 Google Cloud 프로젝트로 이전됩니다.
| 개발자 토큰 | 프로젝트 ID | 액세스 수준 | 설명 |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
일반 액세스 | 개발자 토큰과 프로젝트 ID가 서로 연결되어 있습니다. |
abcdefghijkl1234567890 |
5678912345 |
일반 액세스 | 개발자 토큰과 프로젝트 ID가 서로 연결되어 있습니다. |
abcdefghijkl1234567890 |
45678912345 |
일반 액세스 | 개발자 토큰과 프로젝트 ID가 서로 연결되어 있습니다. |
xyzabcdefghi6789012345 |
1231235678 |
기본 액세스 | 개발자 토큰과 프로젝트 ID가 서로 연결되어 있습니다. |
asdfgflkjhjz7654321012 |
-- |
-- |
개발자 토큰의 API 액세스 권한은 API 호출을 하는 데 사용된 적이 없으므로 프로젝트로 이전되지 않았습니다. |
qwertypoiuyu6543298790 |
9876564900 |
테스트 계정 액세스 | 개발자 토큰의 API 액세스 권한은 90 일 동안 활동이 없어 취소되었습니다. 프로젝트의 API 액세스 수준은 기본적으로 테스트 계정 액세스입니다. |
-- |
7171234567 |
테스트 계정 액세스 | 개발자 토큰과 함께 사용된 적이 없는 새 프로젝트입니다. 프로젝트의 API 액세스 수준은 기본적으로 테스트 계정 액세스입니다. |
승인된 개발자 토큰이 두 개 이상 있습니다. 어떤 프로젝트로 API 액세스 수준을 이전하나요?
승인된 각 개발자 토큰의 액세스 수준은 해당 개발자 토큰과 연결된 Google Cloud 프로젝트로 이전됩니다. 예를 참고하세요.
Google Cloud 프로젝트를 여러 개 사용합니다. 어떤 프로젝트로 API 액세스 수준을 이전하나요?
지난 90일 동안 승인된 개발자 토큰으로 여러 Google Cloud 프로젝트를 사용한 경우 이러한 모든 프로젝트에 개발자 토큰과 동일한 API 액세스 수준이 부여됩니다. 예를 참고하세요.
더 이상 사용하지 않는 프로젝트에 API 액세스 수준이 할당되었습니다. 이 문제를 해결하려면 어떻게 해야 하나요?
더 이상 사용하지 않는 Google Cloud 프로젝트에 Google Ads API 액세스 권한이 할당된 경우 추가 조치가 필요하지 않습니다. Google은 90일 동안 활동이 없는 사용되지 않는 프로젝트의 API 액세스 권한을 취소합니다.
Google Cloud 프로젝트에 API 액세스 수준이 할당되지 않았습니다. 이 문제를 해결하려면 어떻게 해야 하나요?
개발자 토큰과 Cloud 프로젝트를 사용하여 API 호출을 한 적이 없거나 활동이 없어 개발자 토큰의 API 액세스 권한이 최근에 만료되었기 때문에 Google Cloud 프로젝트가 개발자 토큰의 액세스 수준을 상속하지 않았을 수 있습니다. 이 문제를 해결하려면 Google Ads API 개요 페이지에서 해당 프로젝트에 적절한 API 액세스 수준을 신청하세요. 예를 참고하세요.
프로젝트의 API 액세스 수준은 어디에서 확인할 수 있나요?
Google Ads API 개요 페이지에서 Google Cloud 프로젝트의 API 액세스 수준을 확인할 수 있습니다.
더 높은 API 액세스 수준을 신청하려면 어떻게 해야 하나요?
API 액세스 수준을 Google Cloud 프로젝트에 더 높게 신청할 수 있습니다. 신청은 Google Ads API 개요 페이지에서 할 수 있습니다.
보류 중인 API 액세스 신청은 어떻게 되나요?
2026년 9월 9일 이전에 Google Ads 관리자 계정의 API 센터에서 시작한 보류 중인 기본 액세스 애플리케이션은 종료됩니다. Google Cloud 프로젝트의 Google Ads API 개요 페이지에서 기본 액세스 권한을 다시 신청해야 합니다. 이 변경사항의 영향을 받는 경우 필요한 안내가 포함된 이메일이 전송됩니다.
2026년 9월 9일 현재 Google Ads 관리자 계정의 API 센터에서 시작한 보류 중인 일반 액세스 애플리케이션은 평소와 같이 검토됩니다. 승인되면 개발자 토큰과 연결된 Google Cloud 프로젝트에 일반 액세스 권한이 부여됩니다.
승인된 개발자 토큰을 새 Google Cloud 프로젝트와 다시 연결할 수 있나요?
이전에는 Google Ads API팀에서 개발자 토큰을 새 Google Cloud 프로젝트와 다시 연결하는 것을 사례별로 지원했습니다. 개발자 토큰이 지원 중단되었으므로 2026년 9월 9일부터는 더 이상 지원되지 않습니다. 새 Google Cloud 프로젝트를 사용해야 하는 경우 Google Cloud 프로젝트의 Google Ads API 개요 페이지에서 적절한 API 액세스 권한을 신청해야 합니다.
승인된 개발자 토큰이 있지만 사용한 적이 없습니다. 이 개발자 토큰을 사용할 수 있나요?
아니요, 이 개발자 토큰을 사용할 수 없습니다. 두 가지 가능성이 있습니다.
활동이 없어 개발자 토큰 액세스 권한이 취소될 수 있음: Google 정책에 따라 API 토큰이 90일 연속으로 사용되지 않을 경우 Google에서 API 토큰을 취소할 수 있습니다. 개발자 토큰을 한동안 사용하지 않은 경우 활동이 없어 액세스 수준이 취소되었을 수 있습니다. 이 경우 Google Ads API 개요 페이지에서 Google Cloud 프로젝트의 API 액세스 권한을 다시 신청하세요. 예를 참고하세요.
개발자 토큰이 최근에 승인되었지만 2026년 9월 9일 이전에 사용한 적이 없음: 2026년 9월 9일 이전에 승인된 개발자 토큰을 Google Cloud 프로젝트와 함께 사용한 적이 없으므로 액세스 수준이 Cloud 프로젝트로 이전되지 않았습니다. 따라서 더 이상 개발자 토큰을 사용할 수 없습니다. 이 개발자 토큰으로 프로덕션 계정에 API 호출을 시도하면
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION오류가 발생합니다. 이 오류를 해결하려면 Google Cloud 프로젝트의 Google Ads API 개요 페이지에서 적절한 API 액세스 권한을 신청하세요. 예를 참고하세요.
두 경우 모두 탐색기 액세스 및 기본 액세스 수준 애플리케이션을 신청하고 자동으로 검토받을 수 있습니다. 검토 프로세스를 완료하기 위해 더 이상 Google의 규정 준수팀과 협력할 필요가 없습니다. 일반 액세스 권한이 필요한 경우 직접 검토가 필요합니다. 하지만 일반 액세스 권한을 신청할 때 승인된 개발자 토큰 세부정보를 공유하여 규정 준수팀에서 새 일반 액세스 애플리케이션을 검토할 수 있도록 할 수 있습니다.
API 요청의 일부로 개발자 토큰을 보내지 않아도 되나요?
예, API 요청의 일부로 개발자 토큰을 보내지 않아도 됩니다. 클라이언트 라이브러리를 사용하는 경우 최신 버전으로 업그레이드해야 할 수 있습니다. 라이브러리의 변경 로그를 확인하여 개발자 토큰을 지정하지 않고 API 호출을 할 수 있는지 확인하세요.
Cloud 관리 액세스 수준 파일럿 프로그램에 참여했습니다. 어떤 영향을 받나요?
Cloud 관리 액세스 수준 파일럿 프로그램은 Google Cloud 개발자가 API 요청의 일부로 개발자 토큰을 보내지 않고 API 호출을 할 수 있도록 도입되었습니다. 개발자 토큰이 지원 중단되었으므로 이 프로그램은 중단됩니다.
활성 개발자 토큰의 액세스 수준이 Google Cloud 프로젝트로 이전되었으므로 기존 코드는 변경 없이 계속 작동합니다. 새 Google Cloud 프로젝트를 사용해야 하는 경우 Google Cloud 프로젝트의 Google Ads API 개요 페이지에서 API 액세스 권한을 신청해야 합니다.
개발자 토큰이 허용 목록에 포함되어 있었습니다. 어떤 영향을 받나요?
Google은 일부 개발자에게 실험용 기능에 대한 액세스 권한을 부여하는 파일럿 프로그램을 실행할 수 있습니다. 이러한 기능에 대한 액세스 권한은 개발자 토큰을 허용 목록에 추가하여 제공되기도 합니다. 이러한 파일럿 프로그램에 참여한 경우 별도의 조치가 필요하지 않습니다.
허용 목록 메커니즘으로 개발자 토큰 대신 Google Cloud 프로젝트를 사용하도록 모든 파일럿 프로그램을 업데이트하고 개발자 토큰의 허용 목록 상태를 연결된 Google Cloud 프로젝트로 이전했습니다. 기존 코드는 변경 없이 계속 작동합니다. 문제가 계속 발생하면 파일럿 프로그램에 등록한 Google 계정 관리자에게 문의하세요.
승인된 개발자 토큰이 있으며 새 Google Cloud 프로젝트와 함께 사용하고 싶습니다. 허용되나요?
아니요, 승인된 개발자 토큰으로 새 Google Cloud 프로젝트를 사용할 수 없습니다. 2026년 9월 9일 이전에 승인된 개발자 토큰을 새 Google Cloud 프로젝트와 함께 사용한 적이 없으므로 액세스 수준이 Cloud 프로젝트로 이전되지 않았습니다. 개발자 토큰은 더 이상 API 액세스 수준을 결정하는 데 사용되지 않으므로 이 개발자 토큰으로 API 호출을 시도하면
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 오류가 발생합니다. 이 오류를 해결하려면 Google Cloud 프로젝트의 Google Ads API 개요
페이지에서 적절한 API 액세스 권한을 신청하세요. 예를 참고하세요.
개발자 토큰이 외부로 유출되었습니다. 개발자 토큰을 재설정해야 하나요?
아니요, 이 경우 개발자 토큰을 재설정할 필요가 없습니다. 개발자 토큰의 API 액세스 수준이 Google Cloud 프로젝트로 이전되었으므로 승인되지 않은 사용자는 더 이상 자신의 Google Cloud 프로젝트에서 개발자 토큰을 사용할 수 없습니다. 하지만 원하는 경우 API 센터에서 개발자 토큰을 재설정할 수 있습니다.
API 센터는 어떻게 되나요?
Google Ads 관리자 계정 내의 기존 API 센터 페이지는 지원 중단되었으며 조만간 삭제될 예정입니다. 이미 개발자 토큰이 있는 경우 Google Ads 관리자 계정에 계속 로그인하여 세부정보를 확인할 수 있습니다. 하지만 이는 참조용으로만 제공됩니다. 이 페이지에서 더 높은 API 액세스 수준을 신청하는 것과 같은 개발자 토큰 액세스 수준과 관련된 작업을 실행하지 마세요.
더 높은 API 액세스 수준을 신청해야 하는 경우 Google Cloud 프로젝트의 Google Ads API 개요 페이지에서 신청해야 합니다.
Google Ads API를 사용하려면 Google Ads 관리자 계정이 계속 필요한가요?
더 이상 Google Ads API를 사용하는 데 Google Ads 관리자 계정이 필요하지 않습니다. API를 사용하여 여러 계정을 연결하고 관리해야 하는 경우에만 관리자 계정이 필요합니다.
새로운 개발자입니다. Google Ads API에 가입하려면 어떻게 해야 하나요?
시작하기 가이드의 안내에 따라 Google Ads API에 가입하세요. Google Ads 관리자 계정의 API 센터에서 개발자 토큰을 신청하지 마세요. 이러한 애플리케이션은 처리되지 않습니다. API 센터는 조만간 지원 중단될 예정입니다.