# 카탈로그 임포트

> 기존 카탈로그를 Unity Dashboard로 임포트하여 카탈로그를 생성하거나 교체합니다.

카탈로그 가져오기를 사용하여 앱 스토어 연결 또는 Google Play에서 기존 목록을 Unity Dashboard로 바로 가져옵니다. 임포트하면 Unity는 제공한 자격 증명을 사용하여 리스트를 가져와 카탈로그에 새 리스트를 추가합니다. 이미 존재하는 리스트의 경우, 건너뛰거나 덮어쓸 수 있습니다.

## 앱 스토어 Connect 또는 Google Play에서 가져오기##import-from-app-store-connect-or-google-play

Unity Dashboard에서 카탈로그를 임포트하려면 다음 단계를 따르십시오.

1. **인앱 구매** > **카탈로그** 를 엽니다.
2. **Import catalog**를 선택합니다.
3. 카탈로그를 가져올 플랫폼을 선택합니다(**iOS** 또는 **Android**).
4. 플랫폼의 자격 증명을 선택합니다. 필요한 자격 증명 내용 및 권한은 [인증 증명 요구 사항](#credential-requirements)을 참조하십시오.
5. 임포트 요약을 검토합니다. 파일의 각 리스트에는 상태가 할당됩니다. **Conflict** 상태의 리스트의 경우 처리 방법을 선택합니다.
   * **복제 건너뛰기**: 기존 목록을 유지하고 임포트된 버전을 무시합니다.
   * **기존** 목록 덮어쓰기: 기존 목록을 임포트된 버전으로 대체합니다.
6. **Import SKUs**를 선택합니다.

### 자격 증명 요구 사항##credential-requirements

자격 증명은 [비밀 관리자](/services/secret-manager.md)에 저장되는 비밀입니다. Unity는 이를 사용하여 스토어의 리스트를 읽습니다. 각 플랫폼에 대해 전체 JSON 엔트리를 단일 비밀로 복사합니다. 필요한 콘텐츠와 권한은 플랫폼에 따라 다릅니다.

iOS의 경우 앱 스토어 연결 API 키를 다음 JSON 엔트리로 저장합니다.

```json
{
  "p8": "<.p8 App Store Connect API key>",
  "keyId": "<App Store Connect Key ID>",
  "issuerId": "<Issuer ID>"
}
```

팀 키에 대해서만 `issuerId`를 포함하고 개별 키에 대해서는 생략합니다. API 키에는 **관리자** 또는 **계정 보유자**와 같은 더 높은 **앱 관리자** 역할이 있어야 합니다.

Android의 경우 Google Play 서비스 계정 키를 다음 JSON 엔트리로 저장합니다.

```json
{
  "serviceAccountJSON": "<Google service account JSON key>"
}
```

서비스 계정에는 **앱 정보 보기(읽기 전용)** 및 **스토어 상태 관리** 권한이 있어야 합니다.

## 임포트 상태##import-statuses

각 SKU에는 상태 태그가 있습니다.

| 상태           | 설명                                                                  |
| ------------ | ------------------------------------------------------------------- |
| **신규**       | SKU가 카탈로그에 없으며 임포트할 준비가 되었습니다.                                      |
| **오류**       | SKU에 누락되었거나 잘못된 필드가 있습니다. 오류를 수정하고 다시 임포트합니다.                       |
| **Conflict** | SKU가 카탈로그에 이미 있습니다. 임포트 창에서 기존 값과 수신되는 값을 비교한 다음 건너뛰거나 덮어쓰기를 선택합니다. |

## 에디터 또는 CLI에서 원격 카탈로그 배포##deploy-a-remote-catalog-from-the-editor-or-cli

대시보드에서 카탈로그를 관리하려면 카탈로그를 임포트할 필요가 없습니다. Unity 에디터 또는 CLI에서 [원격 카탈로그를](../payment-providers/configure-remote-catalog) 배포하면 Unity가 해당 목록을 Unity Dashboard에 자동으로 추가합니다. 그런 다음 대시보드에서 임포트하는 모든 카탈로그와 함께 관리, 편집, 배포할 수 있습니다.
