# 导入目录

> 将现有目录导入 Unity Dashboard（Unity 后台）以创建或替换目录。

使用目录导入可将现有列表从 App Store Connect 或 Google Play 直接拉入 Unity Dashboard（Unity 后台）。导入时，Unity 会使用您提供的凭据检索您的列表，并将新列表添加到您的目录中。对于已存在的列表，可以选择跳过或覆盖它们。

## 从 App Store Connect 或 Google Play 导入##import-from-app-store-connect-or-google-play

要从 Unity Dashboard（Unity 后台）导入目录，请执行以下步骤：

1. 打开 **In-App Purchases** > **Catalog**。
2. 选择 **Import catalog**（导入目录）。
3. 选择要导入目录的平台（**iOS** 或 **Android**）。
4. 选择平台的凭据。有关所需的凭据内容和权限，请参阅[凭据要求](#credential-requirements)。
5. 查看导入摘要。文件中的每个列表都分配了一个状态。对于具有 **Conflict** 状态的列表，请选择如何处理它们：
   * **跳过重复项**：保留现有列表并忽略导入的版本。
   * **覆盖现有**：将现有列表替换为导入的版本。
6. 选择 **Import SKUs**（导入 SKU）。

### 凭据要求##credential-requirements

凭据是您存储在 [Secret Manager](/services/secret-manager.md) 中的秘密。Unity 使用它来从商店中读取您的列表。对于每个平台，请将完整的 JSON 条目复制到单个密钥中。所需的内容和权限取决于您的平台。

对于 iOS，请将 App Store Connect API 密钥存储为以下 JSON 条目：

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

仅包含团队关键点的`issuerId`，而忽略单个关键点。API 密钥必须具有 **App Manager** 角色或更高版本，例如 **Admin** 或 **Account Holder**。

对于 Android，请将 Google Play 服务帐户密钥存储为以下 JSON 条目：

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

服务帐户必须具有 **View app information（只读）** 和 **Manage Store presence** 权限。

## 导入状态##import-statuses

每个 SKU 都有一个状态标签：

| 状态           | 描述                                       |
| ------------ | ---------------------------------------- |
| **新建**       | SKU 在您的目录中不存在，可以导入。                      |
| **错误**       | SKU 的必填字段缺失或无效。更正错误并尝试再次导入。              |
| **Conflict** | SKU 已存在于您的目录中。比较导入窗口中的现有值和传入值，然后选择跳过或覆盖。 |

## 从 Editor 或 CLI 部署 Remote Catalog##deploy-a-remote-catalog-from-the-editor-or-cli

不必导入目录即可在 Dashboard（后台）上进行管理。从 Unity Editor 或 CLI 部署[远程目录](../payment-providers/configure-remote-catalog)时，Unity 会自动将这些列表添加到 Unity Dashboard（Unity 后台）。然后，可以从 Dashboard（后台）以及导入的任何目录管理、编辑和部署它们。