---
title: "应用内SKU联动"
site: "Game8 Store – Developer Center"
lang: "zh"
category: "功能"
canonical: "https://developers.store.game8.jp/zh/store-linkage/"
---

# 应用内SKU联动

📝 本页为参考译文（简体中文）。如与日文原版有出入，以日文版为准。

应用内SKU联动可将在 Apple App Store Connect / Google Play Console 中注册的应用内购买（IAP）信息通过官方API导入 Game8 Store，并作为 Game8 Store 的销售商品进行上架与管理。

无需逐个手动输入商品，导入的商品数据可在仪表盘上单独编辑，可针对 Game8 Store 调整价格、加赠数量等后进行销售。

> 本功能通过管理界面的 **「应用内 SKU 获取（In-app SKU Import）」** 和 **「应用内 SKU 一览（In-app SKU Catalog）」** 这两个界面进行操作。

## 本功能可以实现的内容

- **简便的商品登记**: 只需设置一次认证信息，即可批量导入 Apple / Google 的 IAP 信息。
- **灵活的商品运营**: 导入的商品可在仪表盘上单独编辑。可按每个商品调整运营方式，如调整价格、选择是否上架等。
- **支持的平台**: Apple App Store Connect / Google Play Console

### 关于提供范围

本功能将分阶段提供。

| 提供时期 | 内容 |
| --- | --- |
| 发布初期 | 可将 Apple / Google 中已登记的 IAP 信息（商品 ID、价格、名称等）导入仪表盘。导入的商品可在仪表盘上单独编辑，也可切换上架状态（公开中·非公开）。 |
| 未来实现计划 | 计划实现当在 Apple / Google 一侧新增或更新道具时，自动同步到 Game8 Store 的机制。最终目标是以 Apple / Google 为准，Game8 Store 一侧免维护地跟随更新。 |

## 使用流程

1. **事前准备**: 在 Apple / Google 的各控制台中获取用于关联的认证信息（参见下一章）。
2. **登记连接**: 在「应用内 SKU 获取（In-app SKU Import）」界面创建新连接并登记认证信息。
3. **执行同步**: 使用已登记的连接执行「执行同步」，从 Apple / Google 导入 IAP 信息。
4. **商品上架**: 在「应用内 SKU 一览（In-app SKU Catalog）」界面编辑导入的道具，并作为 Game8 Store 的商品上架。也可从「应用内 SKU 获取（In-app SKU Import）」界面右上方的【查看目录（View Catalog）】进入。

## 需事前准备的内容

关联设置需要在各平台发行的认证信息。

> 本功能**仅以浏览专用（只读）权限**运行。由于无需写入权限，请准备最小权限的认证信息。登记的认证信息将加密保管，原始值不会在仪表盘上再次显示。

### Apple App Store Connect 的情况

| 项目 | 内容 | 获取·确认位置 |
| --- | --- | --- |
| API 密钥（.p8 文件） | 在 Apple App Store Connect 中发行的 API 密钥。权限请选择最小权限的「Read Only」。 | Users and Access → Integrations → App Store Connect API → 通过「＋」按钮发行 |
| Key ID | 与 .p8 文件一同显示的 10 位英数字符。 | API 密钥发行界面（同上） |
| Issuer ID | 团队通用的 UUID。 | API 密钥发行界面上部 |
| Bundle ID | 目标应用的 Bundle ID（无需新发行）。 | 对应应用 → App Information |

> .p8 文件的下载，**仅在发行时的 1 次**可进行。请妥善保管下载的文件。

### Google Play Developer 的情况

| 项目 | 内容 | 获取·确认位置 |
| --- | --- | --- |
| Service Account JSON 密钥 | 在 Google Cloud 中创建的服务账号的 JSON 密钥。 | Google Cloud Console → IAM 与管理 → 服务账号 → 从密钥标签页下载 JSON |
| Package Name | 目标应用的 Package Name（无需新发行）。 | Google Play Console → 对应应用 → 仪表盘 |

同时，请完成以下设置。

- **启用 Google Play Developer API**: 请确认在对应的 GCP 项目中「Google Play Android Developer API」处于 enabled 状态。
- **在 Play Console 中授予权限**: 从 Google Play Console 的「用户和权限」中邀请上述服务账号的邮箱地址，并**仅授予「查看应用信息」**（无需写入权限）。

## 应用内 SKU 获取（In-app SKU Import）：关联连接的管理

用于登记与 Apple / Google 的关联连接并获取（同步）IAP 信息的界面。

### 主要功能与可实现的内容

- **关联连接的管理** ◦ 可新建、编辑、删除与 Apple / Google 的连接。
- **执行同步** ◦ 从已登记的连接导入最新的 IAP 信息。
- **确认同步状态** ◦ 可在一览中确认各连接的同步状态。

### 界面项目说明（一览）

| 项目 | 说明 |
| --- | --- |
| 名称（Name） | 用于识别连接的名称。显示登记时设置的名称。 |
| PF 类别（Platform） | 显示连接目标平台（Apple / Google）。 |
| 应用 ID（App ID） | Apple 显示 Bundle ID，Google 显示 Package Name。 |
| 认证信息（Credentials） | 以「已设置」「未设置」显示认证信息的登记状态。 |
| 同步状态（Sync Status） | 显示同步的状态。为「待机中」「同步中」「成功」「错误」之一。 |
| 操作（Actions） | 可进行「执行同步」「编辑」「删除」。 |

### 新连接的登记

通过一览右上角的「＋ 新建连接」登记关联连接。输入项目如下。

| 项目 | 说明 |
| --- | --- |
| 连接名称（Connection Name） | 输入用于识别连接的任意名称（例：iOS 正式环境）。 |
| PF 类别（Platform） | 选择关联目标平台（Apple App Store Connect / Google Play Developer）。 |
| Bundle ID / Package Name | 根据所选平台，Apple 输入 Bundle ID，Google 输入 Package Name。 |
| 认证信息（Credentials） | Apple 输入 Key ID / Issuer ID / Private Key（.p8），Google 输入 Service Account JSON。 |

> 连接名称（Connection Name）、Bundle ID / Package Name、认证信息（Credentials）均为必填项。需要轮换（更新）认证信息时，请从连接的「编辑（Edit）」重新输入。

### 执行同步

按下一览中的「执行同步」，将从 Apple / Google 获取最新的 IAP 信息。获取的道具将同步到「应用内 SKU 一览（In-app SKU Catalog）」界面。

> 同步可能会根据道具件数花费数十秒至数分钟。处理过程中同步状态显示为「同步中」，按钮会暂时无法点击。完成后请重新加载一览以确认结果。

## 应用内 SKU 一览（In-app SKU Catalog）：导入商品的管理

用于确认从 Apple / Google 导入的道具一览，并作为 Game8 Store 商品进行上架与管理的界面。

### 主要功能与可实现的内容

- **浏览导入的道具** ◦ 可在一览中确认通过同步获取的道具。
- **筛选功能** ◦ 可按「全部」「已上架」「未上架」进行筛选。
- **上架到 Game8 Store** ◦ 可编辑未上架的道具，将其登记为 Game8 Store 的商品。
- **上架状态的管理** ◦ 可进行停止上架、重新公开、以最新值重新获取。

### 界面项目说明（一览）

| 项目 | 说明 |
| --- | --- |
| PF 类别（Platform） | 以徽章显示道具的获取来源平台（Apple / Google）。 |
| 商品名称（Name） | 从 Apple / Google 获取的道具名称。已上架时会成为指向 Game8 Store 商品编辑界面的链接。 |
| PF 商品 ID（Platform Item ID） | 在 Apple / Google 一侧管理的商品 ID（产品 ID）。 |
| 价格（Price） | 从 Apple / Google 获取的价格。 |
| 上架状态（Status） | 显示在 Game8 Store 的上架状态。为「未上架」「公开中」「非公开」之一。 |
| 最后获取（Last Fetched） | 最后一次获取该道具的日期时间。 |
| 操作（Actions） | 可根据上架状态执行「编辑（Edit）」「掲載をやめる（Unpublish）」「公開する（Publish）」「最新で更新（Reimport）」。 |

### 关于上架状态

| 状态 | 说明 |
| --- | --- |
| 未上架（Not Published） | 已导入，但尚未登记为 Game8 Store 商品的状态。 |
| 公开中（Live） | 已登记为 Game8 Store 商品并正在销售（可显示·可购买）的状态。 |
| 不公开（Hidden） | 已登记为 Game8 Store 商品，但已停止销售的状态。 |

### 关于各项操作

| 操作（Actions） | 说明 |
| --- | --- |
| 编辑（Edit） | 编辑未上架的道具，将其登记（上架）为 Game8 Store 的商品。将打开「Game8 Store に掲載（Publish to Game8 Store）」界面。 |
| 停止上架（Unpublish） | 停止公开中商品的销售，将其设为「非公开」。商品数据不会被删除。 |
| 公开（Publish） | 将非公开的商品重新设为「公开中」。 |
| 更新至最新（Reimport） | 导入 Apple / Google 的最新商品名称·销售价格，并同步到上架中的商品。缩略图等已编辑的项目将被保留。 |

> 通过「更新至最新（Reimport）」自动反映价格**仅支持日元（JPY）**。USD 等 JPY 以外币种的道具仅更新商品名称，价格不会同步。换算成日元的价格请手动确认并输入。

### 上架到 Game8 Store（Publish to Game8 Store・上架编辑界面）

按下「编辑（Edit）」后，将打开「Publish to Game8 Store」界面。界面上部的「Apple / Google から取得した情報（Source info from Apple / Google）」中会显示 `PF 商品 ID（Platform Item ID）` / `PF 商品名称（PF Name）` / `PF 价格（PF Price）` ，请参考其内容输入 Game8 Store 的商品信息。
输入项目与道具管理的新建（New Item）相同（基本信息 / 价格设置 / 购买上限・库存 / 购买限制间隔 / 公开・排期 / 分类 / 标签 / 赠品道具 / 捆绑道具）。其中显示名称、商品ID、销售价格会以获取到的值作为初始值。
输入完成后，按下界面下方的「Publish to Game8 Store」即可上架。

| 项目 | 说明 |
| --- | --- |
| 显示名称（Display Name） | 在 Game8 Store 上显示的商品名称（必填）。初始值为获取的商品名称。 |
| 商品ID（Item ID） | 用于 API 联动的 ID。初始值为 PF 商品 ID。 |
| 缩略图（Thumbnail） | 商品的缩略图图片（必填）。 |
| 销售价格（Sales Price） | 在 Game8 Store 上的销售价格（日元）（必填）。JPY 的道具会将获取价格作为初始值填入。 |
| 分类（Category） | 选择用于分类商品的分类。带有「共通（Global）」徽章的分类为全部游戏通用。也可以新建分类。 |

> 当 PF 币种为 JPY 以外时，销售价格的初始值为 0 日元。请务必手动输入换算成日元的价格。

## 注意事项

- **支持的币种**: 价格的自动导入·自动更新仅支持日元（JPY）。其他币种仅同步商品名称。
- **同步所需时间**: 同步可能会根据道具件数花费数十秒至数分钟。即使处理过程中连接中断，后端也可能仍在继续处理。请稍等片刻后重新加载一览进行确认。
- **关于权限**: 仅具有浏览权限的账号无法进行连接的登记·编辑·删除、执行同步、上架等操作（可浏览一览）。
- **关于认证信息**: 关联所需的权限仅为浏览专用（只读）。请勿授予写入权限。

> 如有疑问，请[合作伙伴咨询表单（Partner Inquiry）](https://developers.store.game8.jp/zh/inquiry/)与我们联系。