Merchant 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 및 리소스
이름이 포함된
계정
리소스가 반환됩니다.
{
"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을 사용하여 각 테스트 계정의 목적을 나타냅니다(예: '마이그레이션 테스트' 또는 '통합 테스트 계정').