개발자 토큰은 앱을 Google Ads API에 연결할 수 있는 22자리 영숫자 문자열입니다. 토큰이 Google에서 할당되면 Google Ads 관리자 계정의 API 센터 페이지에서 토큰을 보거나 새 토큰을 만들 수 있습니다.
각 개발자 토큰에는 토큰으로 일일 API 호출 수와 호출할 수 있는 환경을 제어하는 액세스 수준이 할당됩니다.
프로덕션 계정에 대해 API 호출을 하려면 토큰 신청 절차 중에 개발자 토큰에 대해 기본 액세스 수준 또는 표준 액세스 수준을 요청해야 합니다. 테스트 계정에 대해 호출하는 데 이러한 액세스 수준이 필요하지 않으므로 연습을 진행할 수 있지만 이 가이드를 완료한 후 기본 액세스 수준을 신청하는 방법을 확인하는 것이 좋습니다.
새 개발자 토큰이 필요한가요?
새 개발자 토큰을 등록해야 하는지 여부는 몇 가지 요인에 따라 달라집니다. 일반적인 이유는 다음과 같습니다.
시나리오 |
다음 단계 |
| 회사에서 Google Ads API를 사용한 적이 없으며 자체 앱을 개발하려고 합니다. | 새 개발자 토큰에 가입합니다. 자세히 알아보기 |
| 귀사에서 Google Ads API를 활발하게 사용하고 있거나 과거에 사용한 적이 있습니다. | Google에서는 일반적으로 회사당 하나의 개발자 토큰을 부여하므로 회사가 이미 Google Ads API를 사용하고 있다면 기존 개발자 토큰을 재사용해야 합니다. 자세히 알아보기 |
| 회사가 이미 Google Ads API를 사용하고 있지만 새로운 제품이나 도구를 개발하고 있습니다. | 기존 개발자 토큰을 사용할 수 없다고 확신하는 경우, 신청서에 사용 사례를 설명하여 새 토큰을 신청할 수 있습니다. 이 가이드의 나머지 부분에서는 기존 개발자 토큰을 사용할 수 있습니다. 자세히 알아보기 |
| 회사에서 서드 파티 앱을 사용하는 경우 | 자체 앱을 개발하는 경우에만 개발자 토큰이 필요합니다. 서드 파티 앱 또는 서비스를 사용하는 경우 해당 앱의 개발자가 앱의 개발자 토큰을 받아야 합니다. 이 경우에 해당하지 않는 경우 API 규정 준수팀에 문의하세요. |
개발자 토큰을 신청하는 방법
개발자 토큰을 신청할 때는 두 단계를 거칩니다.
1단계: Google Ads 관리자 계정 선택 또는 만들기
이미 Google Ads 관리자 계정이 있는 경우 토큰을 신청할 때 해당 계정을 선택하세요. 이 관리자 계정이 아직 다른 계정에 연결되지 않은 경우, 토큰 검토 절차를 간소화하고 나중에 계정 관리를 단순화하기 위해 계정 계층 구조의 루트에 배치하는 것이 좋습니다.
관리자 계정이 없는 경우 고객센터 안내에 따라 계정을 만드세요.
2단계: Google Ads API 액세스 권한 신청
개발자 토큰 검토 프로세스를 완료하는 데 다소 시간이 걸릴 수 있습니다. 자세히 알아보기
웹브라우저에서 https://ads.google.com/aw/apicenter로 이동합니다. 메시지가 표시되면 Google Ads 관리자 계정에 로그인합니다.
API 액세스 양식을 작성하고 이용약관에 동의합니다.
정보가 정확하고 회사 웹사이트 URL이 작동하는지 확인합니다. 웹사이트가 운영되지 않는 경우 Google에서 신청을 처리하지 못해 거부할 수 있습니다.
제공하는 API 연락처 이메일이 정기적으로 모니터링되는 받은편지함으로 연결되는지 확인합니다. Google의 API 규정 준수팀에서 검토 과정에서 설명을 요청하기 위해 이 이메일 주소로 연락할 수 있습니다. 연락이 닿지 않으면 Google에서 신청을 계속 진행하지 않을 수 있습니다.
API 센터에서 API 연락처 이메일을 수정할 수 있습니다. Google에서 중요한 서비스 공지를 보낼 수 있도록 신청 절차가 끝난 후에도 이 정보를 최신 상태로 유지하세요.
신청 절차를 완료하면 API 센터에 개발자 토큰이 승인 대기 중 상태로 표시됩니다. 이제 개발자 토큰의 액세스 수준이 테스트 계정 액세스로 설정되었으며 테스트 계정에 대해 API 호출을 시작할 수 있습니다.
개발자 토큰을 획득한 후에는 첫 번째 API 호출 시 필요하므로 값을 적어둡니다.
관리자 계정에 로그인되어 있는지 확인
개발자 토큰에 액세스하려면 관리자 계정에 로그인해야 하며 테스트 관리자 계정은 사용할 수 없습니다.
관리자 계정에 로그인되어 있는지 확인하려면 다음 단계를 따르세요.
웹브라우저에서 https://ads.google.com/aw/apicenter로 이동합니다.
고객 계정에 로그인한 경우 페이지에 API 센터는 관리자 계정에서만 사용할 수 있습니다.라는 메시지가 표시됩니다.
오른쪽 상단에 테스트 계정이 빨간색으로 표시되면 계정이 테스트 관리자 또는 테스트 광고주입니다.
개발자 토큰을 찾을 수 있는 위치
개발자 토큰이 있는 경우 Google Ads 관리자 계정의 API 센터 페이지에서 확인할 수 있습니다.