Questions about Apple Books Delivery

作者和小型出版商可以将自己在 Junifye 中拥有的图书分发到自己的 Apple Books 提供商账户。您仍然是出版商，Apple 会直接向您的账户付款；Publifye 提供分发工作流。您需要拥有符合资格的 Apple 账户和凭据，且最终是否收录该图书仍由 Apple 决定。

Ask your AI

帮我将我的 Junifye 图书分发到我自己的 Apple Books 账户。

What it does

operator_guide → apple_ready → apple_allowance → apple_credential_set → apple_delivery_begin → (安全 HTTPS 上传) → review → apple_deliver

What you get

在您自己账户上创建的分发任务，附带进度和凭证记录。

试运行（dry run）能让谨慎的初次作者在不上传到 Apple 的情况下验证文件包。通过 request_type=verify 创建分发，安全提供所需文件并提交验证。试运行不会消耗分发配额；Apple 是否最终收录仍是独立的决定。

Ask your AI

在不正式发布的情况下，检查这本书是否存在分发问题。

What it does

apple_ready → apple_delivery_begin (request_type=verify) → 安全上传 → apple_deliver → apple_delivery_status

What you get

一份说明任何可能阻碍图书通过问题的验证结果，且无需上传到 Apple。

出版社可以为其图书准备并提交独立的所属绑定任务，然后跟踪每个任务的最终结果。全服务的 Apple Transporter 任务一次运行一个，因此现有书目会按队列推进，而不是一次性全部上传。请先查看您的配额，如需更大量分发，可通过商店或联系页面进行安排。

Ask your AI

协助我们的出版社分发这些图书并跟踪每本书的处理结果。

What it does

apple_allowance → 针对每本书：apple_delivery_begin → review → apple_deliver → apple_delivery_status

What you get

每本书都有一个可审计的独立任务：排队、已上传以及 Apple 端可见的状态均清晰区分开来。

在提交上传之前，您可以预览所选基准价格如何换算为 Apple 各个国家/地区的价格档位。预览结果包含各区域明细行，并标出不适用项或缺失的价格输入。预览操作不会上传图书，也不会更改其 Apple 上的在售信息。

Ask your AI

在我确认分发前，先预览这本书在 Apple 各个国家/地区的价格。

What it does

apple_price_preview (book_id, base_price_usd)

What you get

一份区域价格表，明确列出缺失和不适用的项目，无需凭空猜测。

您的 AI 可以检查任务状态和安全分发进度，而无需猜测图书为何停滞。系统将上传结果与后续的 Apple 查询状态区分开来，因此确认延迟并不意味着需要重复上传。私密凭据内容和原始 Transporter 诊断信息不属于普通客户可见的常规进度。

Ask your AI

查明导致本次分发停滞的原因，以及我下一步可以安全执行的操作。

What it does

apple_delivery_status → apple_delivery_log → 按照指明的拒绝原因或审查项操作

What you get

已保存的状态以及明确的下一步操作。

获得授权的内部出版操作人员可将提供的 ISBN 列表与 Apple 进行对账并读取保存的结果。这并非无限制的 Apple 目录列表：结果仅限于所提供的标识符。目录扫描属于管理员操作，因此客户 OAuth 用户应联系其出版操作人员来执行此工作流。

对您的 AI 说：“帮我将 Publifye 账户连接到 Apple Books Delivery。”从“连接”页面添加 MCP 终端节点并登录，然后让 AI 阅读 operator_guide 并调用 apple_connection_setup。您将获得已配置的 HTTPS 提交路由和身份验证指导；Apple 用户名、密码和私钥字节绝不能出现在聊天内容或 MCP 参数中。

对 AI 说：“将这本 Junifye 图书分发到我的 Apple Books 账户。”您的 AI 会阅读 operator_guide，检查 apple_ready 和 apple_allowance，使用 apple_credential_set 注册您的 App Store Connect 凭据标识符，并开启 apple_delivery_begin。安全客户端通过经过身份验证的 HTTPS 上传所需文件和单次任务密钥；在完成必要审查后，apple_deliver 提交任务，并通过 apple_delivery_status 跟踪进度。您需要拥有自己的 Apple 账户、正确的团队或个人密钥类型，以及工作流所要求的提供商确认。

对 AI 说：“在发布前对这本书运行一次试运行检查。”您的 AI 会检查 apple_ready，使用 request_type=verify 开启 apple_delivery_begin，并让安全客户端上传所需文件和密钥；apple_deliver 启动验证，并通过 apple_delivery_status 返回结果。该流程会检查 EPUB 及其与图书元数据的一致性，构建分发包并在上传前进行验证。检查无误是有利的参考凭据，但不代表 Apple 必定收录。

对 AI 说：“跟踪这次分发并告诉我实际进展。”您的 AI 会轮询 apple_delivery_status 并读取 apple_delivery_log 获取安全进度；由于上传操作共用一个 Transporter 槽位，任务排队属于正常现象。返回结果将上传凭据与后续查询凭据区分开来，而且查询到记录并不证明已通过 Apple 审核或已在店面上架。您将获得真实可靠的状态以供决策，而不是猜测的完成时间或自动重复上传。

对 AI 说：“显示此图书待处理的 Apple 工单。”您的 AI 会调用 apple_connection_setup 和 apple_connection_status；此操作必须有明确保存的 Books 连接可用。在您通过经过身份验证的 HTTPS 提交经过证明的 App 专用密码后，apple_tickets_enqueue 启动归属人绑定查询，apple_ticket_job 跟踪该查询，并通过 apple_ticket_page 读取保存的工单结果。您将获得保存的未结工单及备注；凭据不可用或 Apple 查询失败均属于错误，并不能证明不存在工单。

您的 App Store Connect 密钥 (.p8) 会通过 HTTPS 发送并仅用于单次分发任务，且仅保留在该任务的临时工作空间中，任务结束后便会立即销毁。Books 连接则有所不同：在其有效期内（默认为 12 小时，最长 72 小时），系统会对您的 Apple 用户名和 App 专用密码进行加密保存，随后将其删除。您可以随时提前断开连接，也可以随时在 Apple 账户设置中撤销该 App 专用密码。

分发路由是根据图书的权威所有者及已存储的提供商绑定关系自动推导出的，而非由调用者随意指定目标。工作流会核实提供商确认信息和凭据绑定，若身份缺失或存在冲突则会直接拒绝。审核流程会绑定目标软件包，而 Apple 后续的反馈结果也会与上传结果分开独立记录。

本服务会保留凭据标识符、密钥指纹和永久分发凭证，以便每次上传尝试都能追溯到其所有者、图书和软件包。SHA-256 指纹用于识别密钥，但无法用于还原密钥本身；它不能替代已保存的活动 Books 连接的加密凭据。任务记录、安全进度、已保存的工单以及可重复使用的 Books 凭据各自拥有独立的生命周期，删除凭据并不会清除分发凭证。

请查看商店了解当前的方案，如需更高用量可通过联系页面进行安排。在提交任务前，您可以使用您拥有的图书调用 apple_allowance 来检查剩余配额。分发记账明确区分成功上传与被拒绝或失败的任务；验证、状态读取和价格预览不会消耗分发次数。状态不确定的上传必须进行核查，绝不能自动重试，也不能直接视作未发送。

图书是直接分发至您的 Apple 提供商账户的，因此停止使用本分发服务并不会将它们转移给 Publifye。Apple 仍全权负责其审核与店面决策，您也将继续管理自己的账户。有关当前的购买、取消和退款条件，请参阅商店及链接的服务条款；本服务不承诺不间断的可用性或分发截止时限。