판매자 API 테스트 계정 기능을 사용하면 라이브 환경에 배포하기 전에 통합을 철저히 테스트할 수 있는 안전하고 격리된 공간이 제공됩니다. 샌드박스 테스트 계정을 사용하면 프로덕션 데이터에 영향을 주거나, 실시간 작업을 중단하거나, 실수로 판매자 센터 정책을 위반하지 않고도 개발 주기 초기에 API 호출을 실험하고, 코드를 검증하고, 잠재적인 문제를 식별할 수 있습니다.
기본 요건
테스트 계정을 만들고 사용하려면 다음 요구사항을 충족해야 합니다.
- 판매자 센터 계정: 판매자 센터 계정이 있어야 합니다.
- Merchant API 액세스: Merchant API의 등록된 사용자여야 합니다.
테스트 계정의 이점
테스트 계정을 사용하면 다음과 같은 주요 이점이 있습니다.
- 간단한 설정: 테스트 계정 설정은 복잡하지 않은 프로세스로, 기능을 빠르게 테스트하고 통합할 수 있습니다.
- 데이터 무결성 및 안전: 프로덕션 데이터가 보호되고 프로덕션 계정에서 정책 위반이 발생할 위험이 사라집니다.
- 테스트 효율성: 테스트 목적으로 병렬 프로덕션 계정을 유지하지 않고도 다양한 시나리오와 특이 사례를 테스트할 수 있습니다.
- 즉각적인 혜택 검증: 테스트 계정의 홈페이지 소유권 주장 및 인증 자동 면제를 활용하여 혜택 삽입을 빠르게 테스트합니다. 테스트 계정의 경우 혜택이 기본적으로 승인됩니다.
- 실제와 유사한 시뮬레이션: 환경은 제품 업로드 및 인벤토리 관리와 같은 중요한 기능의 프로덕션 동작을 미러링하여 테스트 결과의 신뢰성을 보장합니다.
- 원활한 API 이전: 테스트 계정을 사용하면 나란히 유효성 검사를 실행하여 Content API에서 Merchant API로 또는 한 API 버전에서 다른 API 버전으로 이동하는 사용자가 자신감 있고 원활하게 전환할 수 있습니다.
테스트 계정을 만드는 방법
테스트 계정은 Merchant API의 특정 맞춤 메서드를 사용하여 생성됩니다.
accounts.createTestAccount 메서드를 사용합니다.
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}"
{
"account_name": "{TEST_ACCOUNT_NAME}",
"time_zone": {
"id": "America/Los_Angeles"
},
"language_code": "en-US"
}
다음을 바꿉니다.
ACCOUNT_ID: 판매자 센터 ID입니다.ACCESS_TOKEN: API 호출을 수행하는 데 사용되는 승인 토큰TEST_ACCOUNT_NAME: 테스트 계정의 이름입니다. 테스트에 사용됨을 나타내는 의미 있는 이름을 사용하는 것이 좋습니다. 예를 들어 테스트 계정 이름에test라는 단어가 포함되도록 합니다.
테스트 계정을 만들 때는 다음 필드가 필요합니다.
time_zone: 계정의 보고 및 표시 시간대입니다.language_code: 계정의 BCP-47 언어 코드입니다(예:en-US).
호출이 성공하면 새 테스트 계정의 고유한 accountId 및 리소스 이름이 포함된 Account 리소스가 반환됩니다.
{
"name": "accounts/{TEST_ACCOUNT_ID}",
"accountId": "{TEST_ACCOUNT_ID}",
"accountName": "{TEST_ACCOUNT_NAME}",
"adultContent": false,
"testAccount": true,
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
제한사항
테스트 계정은 기능 검증을 위해 설계되었으며 다음과 같은 특정 제한사항이 있습니다.
- 테스트 계정 수: Google 계정당 최대 5개의 테스트 계정을 만들 수 있습니다. 테스트 계정은 Google 계정당 판매자 센터 계정의 기본 한도에 포함됩니다.
- Merchant API 할당량과의 통합: API 할당량 관점에서 Merchant API는 테스트 계정을 프로덕션 계정으로 취급합니다. 테스트 계정에는 프로덕션 계정과 동일한 할당량이 적용됩니다. 테스트 계정의 할당량은 늘릴 수 없습니다.
- 고급 계정: 고급 테스트 계정을 만들거나 고급 계정을 테스트 계정으로 전환할 수 없습니다.
- 공개 게재 없음: 테스트 계정에 제출된 데이터는 검색 또는 쇼핑 광고와 같은 Google 플랫폼에 게시되지 않습니다.
- 제한된 엔드포인트: 다음과 같은 특정 기능을 사용할 때는 테스트 계정을 사용할 수 없습니다.
- 연결 제한: 테스트 계정을 다른 Google Ads 또는 Google 비즈니스 프로필 계정에 연결할 수 없습니다.
- 테스트 계정 등록 불가: 테스트 계정은 등록할 수 없습니다.
권장사항
테스트 계정을 사용할 때는 다음 권장사항을 따르는 것이 좋습니다.
- 샌드박스 우선 개발: 프로덕션 환경에 적용하기 전에 항상 테스트 계정에서 새 통합 기능을 검증하세요.
- 자동 통합 테스트: 테스트 계정을 자동 회귀 테스트를 실행하기 위한 안정적인 환경으로 사용합니다.
- 테스트 계정 이름 지정:
account_name를 사용하여 각 테스트 계정의 목적을 힌트로 제공합니다(예: '이전 테스트' 또는 '통합 테스트 계정').