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