Google Ads API 통합을 처음 시작하거나, 앱을 유지보수하거나, 기존 통합에 새로운 기능을 추가하는 경우 테스트는 성공적인 Google Ads API 통합을 구축하는 데 중요한 단계입니다. 이 가이드에서는 Google Ads API 통합을 테스트하기 위한 몇 가지 권장사항을 소개합니다.
테스트 계정 및 프로덕션 계정
테스트 계정은 개발 목적으로 사용할 수 있습니다. 테스트 계정을 사용하면 애플리케이션 코드와 구성이 의도대로 작동하는지 확인할 수 있습니다.
하지만 모든 기능을 테스트 계정 에서 테스트할 수 있는 것은 아닙니다.
테스트 계정 한도로 인해 통합에서 일부 기능을 테스트할 수 없는 경우 대신 개발에 프로덕션 계정을 사용할 수 있습니다. 프로덕션 계정을 호출하려면
Google Cloud 프로젝트에
Explorer 액세스 수준 (Explorer, Basic 또는 Standard) 이상이 있어야 합니다. Explorer 액세스는 Basic 또는 Standard 액세스가 필요한 결제 (BillingSetupService
및 AccountBudgetProposalService),
계획, 계정 생성, 사용자 초대 등 특정
서비스를 여전히 제한합니다 (Explorer 기능
제한 참고). 테스트 액세스 수준의 프로젝트에서 프로덕션 계정을 호출하려고 하면
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
v25부터 반환되고
AuthorizationError.ACTION_NOT_PERMITTED은
v24 이하에서 반환됩니다.
개발용 프로덕션 계정은 다음과 같은 점에서 테스트 계정과 다릅니다.
- 사용자가 볼 수 있는 광고를 게재합니다.
- 유효한 URL이 필요합니다.
- 광고 정책을 준수해야 합니다.
프로덕션 계정은 광고를 게재하므로 실적 보고서를 테스트할 수 있는 측정항목을 생성하고 Google Ads API의 다른 모든 기능을 잠금 해제합니다. 하지만 개발에 프로덕션 계정을 사용하려면 추가적인 주의가 필요합니다. 다음 조치를 취하는 것이 좋습니다.
- 개발 목적으로 필요한 사용자에게만 액세스 권한을 부여합니다.
- 고정된 낮은 일일 계정 예산을 설정합니다.
- 테스트 계정을 사용할 수 없는 경우에만 개발에 프로덕션 계정을 사용합니다.
따라서 통합을 완전히 테스트하려면 테스트 사용자 인증 정보와 프로덕션 사용자 인증 정보가 모두 필요할 수 있습니다.
테스트 사용자 인증 정보
개발 계정을 수정하려고 할 때 프로덕션 계정을 실수로 수정할 위험을 최소화하려면 프로덕션 애플리케이션 사용자 인증 정보와 별도의 테스트 사용자 인증 정보 세트를 유지하는 것이 좋습니다.
테스트 사용자 인증 정보 세트를 만들려면 다음 단계를 따르세요.
- 테스트 목적으로만 사용할 이메일 계정 (예:
api.test@example.com) 또는 서비스 계정을 만듭니다. - 이 사용자 또는 서비스 계정을 테스트를 실행하는 Google Ads 계정의 유효한 사용자로 추가합니다. 이 사용자 또는 서비스 계정에 적절한 액세스 수준을 부여해야 합니다. 이 사용자 또는 서비스 계정에 프로덕션 계정 에 대한 액세스 권한을 부여하지 마세요.
- 서비스 계정 흐름이 아닌 OAuth 2.0 사용자 인증 흐름을 사용하는 경우 테스트 사용자 계정의 갱신 토큰을 생성합니다.
- 애플리케이션을 테스트할 때 이 새 사용자 인증 정보를 사용합니다. 클라이언트 ID와 클라이언트 비밀번호는 액세스할 수 있는 Google Ads 계정을 결정하는 데 영향을 미치지 않으므로 테스트 목적으로 재사용할 수 있습니다. 모든 사용자 인증 정보와 갱신 토큰을 안전하게 저장하고 소스 제어에 커밋하지 마세요.
유효성 검사 요청
요청이 유효한지 테스트하기만 하면 되는 경우(예: 요청이 올바르게 구성되어 있고 정책을 위반하지 않는지 확인) validate_only 필드를 사용하면 됩니다. 이 필드는 GoogleAdsService.Search 요청에 사용할 수 있습니다(GoogleAdsService.SearchStream은(는) validate_only을(를) 지원하지 않음). 대부분의 mutate 요청에도 사용할 수 있습니다.
참조 문서를 확인하여 특정 메서드에 이 필드를
사용할 수 있는지 확인하세요.
REST API
요청이 예상 출력을 생성하는지 확인하는 등 임시 테스트의 경우 REST API를 사용하는 것이 가장 쉬운 옵션인 경우가 많습니다. REST 예제를 참고하여 REST API에 요청을 할 때 curl을 사용하는 방법을 알아보세요. 또한 REST 탐색기에서 테스트해 보세요.