개발자 토큰은 앱이 Google Ads API에 연결할 수 있는 22자 길이의 영숫자 문자열입니다. Google에서 토큰을 할당하면 Google Ads 관리자 계정의 API Center 페이지에서 토큰을 확인하거나 새 토큰을 만들 수 있습니다.
각 개발자 토큰에는 토큰으로 하루에 실행할 수 있는 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 액세스 권한 신청
개발자 토큰 검토 프로세스를 완료하는 데 다소 시간이 걸릴 수 있습니다. 자세히 알아보기
관리자 계정에 로그인합니다. 관리자 계정인지 확인할 수 있습니다.
페이지 상단의 검색창에 'api center'를 입력하고 검색 자동 완성에서 선택합니다. API Center 옵션은 Google Ads 관리자 계정에만 표시되며 고객 계정 또는 테스트 관리자 계정에는 표시되지 않습니다.
API 액세스 양식을 작성하고 이용약관에 동의합니다.
정보가 정확하고 회사의 웹사이트 URL이 작동하는지 확인합니다. 웹사이트가 게시되지 않은 경우 Google에서 신청을 처리하지 못하고 거부할 수 있습니다.
제공한 API 연락처 이메일이 정기적으로 모니터링되는 받은편지함으로 연결되는지 확인합니다. Google의 API 규정 준수팀에서 검토 과정에서 이 이메일 주소로 문의하여 설명을 요청할 수 있습니다. 연락할 수 없는 경우 Google에서 신청을 계속 처리하지 않을 수 있습니다.
API Center에서 API 문의 이메일을 수정할 수 있습니다. Google에서 중요한 서비스 공지사항을 보내드릴 수 있도록 신청 절차 후에도 이 정보를 최신 상태로 유지하세요.
신청 절차가 완료되면 개발자 토큰이 API Center에 승인 대기 중 상태로 표시됩니다. 이제 개발자 토큰에 테스트 액세스 수준이 설정되어 테스트 계정에 대해 API를 호출할 수 있습니다.
개발자 토큰을 가져온 후에는 첫 번째 API 호출 시 필요하므로 값을 기록해 둡니다.
관리자 계정에 로그인했는지 확인
개발자 토큰에 액세스하려면 관리자 계정에 로그인해야 하며 테스트 관리자 계정은 사용할 수 없습니다.
관리자 계정에 로그인되어 있는지 확인하려면 다음 단계를 따르세요.
계정에 로그인합니다.
왼쪽에서 관리를 선택합니다. 왼쪽 상단에 관리자 계정 설정이 표시되면 관리자 계정에 로그인한 것입니다. 계정 설정이 표시되면 고객 계정에 로그인한 것입니다.
오른쪽 상단에 테스트 계정이 빨간색으로 표시되면 계정이 테스트 관리자 또는 테스트 광고주입니다.
개발자 토큰을 찾을 수 있는 위치
개발자 토큰이 있는 경우 Google Ads 관리자 계정의 API 센터 페이지에서 확인할 수 있습니다.
관리자 계정에 로그인합니다. 관리자 계정인지 확인할 수 있습니다.
페이지 상단의 검색창에 'api center'를 입력하고 검색 자동 완성에서 선택합니다. API 센터 옵션은 Google Ads 관리자 계정에만 표시되며 테스트 관리자 계정에는 표시되지 않습니다.
개발자 토큰 및 액세스 수준은 API 액세스에 나열된 첫 번째 값입니다.