导入和导出应用商店一览

  • 项目

无需在合作伙伴中心中直接输入 Store 一览的信息，你可以选择通过这种方式添加或更新信息：以 .csv 文件格式导出一览，输入信息和资产，然后导入更新后文件。 可以通过这种方法从头开始创建一览，或者更新早已创建的一览。

当你想要为产品创建或更新多语言 Store 一览时，此选项非常有用，因为你可以将相同信息复制/粘帖到多个字段，并且可以轻松地对特定语言进行更改。 但是，不能使用此方法为以前发布的支持旧版操作系统版本的应用创建或更新特定于平台的应用商店列表。

提示

还可以通过此功能为加载项导入和导出应用商店一览详细信息。 对于加载项，相应流程相同，不过仅包含与加载项有关的字段。 请记住，你可以始终在合作伙伴中心中直接创建或更新一览（即便你先前已使用导入/导出方法）。 如果只是进行了简单更改，在合作伙伴中心中直接更新可能更方便，不过你可以在任何时候使用任何一种方法。

导出一览

在应用的提交概述页中，单击导出一览（位于应用商店一览部分）以生成采用 UTF-8 编码的 .csv 文件。 将该文件保存到计算机上。

可以使用 Microsoft Excel 或其他编辑器来编辑该文件。 请注意，Microsoft 365 版本的 Excel 可将 .csv 文件另存为 CSV UTF-8（逗号分隔）(*.csv) 文件，但其他版本不支持此功能。 有关支持此功能的 Excel 版本的详细信息，请参阅 Excel 2016 新功能公告，或点此了解关于在多种编辑器中采用 UTF-8 编码的详细信息。

如果尚未为产品创建任何一览，则导出的 .csv 文件将不包含任何自定义数据。 将看到字段、ID、类型和默认列，以及与应用商店一览中出现的各项相对应的各行。

如果已创建一览（或已上载程序包），则还会看到各列标有与已创建一览的语言相对应的（或者在程序包中检测到的）语言区域设置代码，以及之前提供的任何一览信息。

以下概述了导出的 .csv 文件中各列包含的内容：

  • 字段列包含与应用商店一览每一部分相关联的名称。 这些名称对应于在合作伙伴中心中创建应用商店一览时可提供的相同各项，不过有些名称可能稍有不同。 对于可以输入多个相同类型项目的各项，在文件中可以看到多行，可达到所提供的最大数量。 例如，在应用功能中可以看到功能 1、功能 2 等，一直到功能 20（因为可提供至多 20 个应用功能）。
  • ID 列包含合作伙伴中心与每个字段相关联的数字。
  • 类型列提供关于可为该字段提供何种信息类型的通用指南，例如文本或相对路径（或指向合作伙伴中心中文件的 URL）。
  • 默认列（以及标有语言区域设置代码的任何列）表示与应用商店一览每一部分相关联的文本或资产。 可以编辑这些列中的字段以更新应用商店一览。

重要

请勿更改字段、ID 或类型列的任何信息。 这些列中的信息必须保持不变，才能处理导入的文件。

更新一览信息

导出一览并保存 .csv 文件之后，可以直接在 .csv 文件中编辑一览信息。

除了默认列，为其创建一览的每种语言也具有相应列。 在各列中所做的更改将应用于使用该语言的描述。 可以为新语言创建一览，添加语言区域设置代码至首行的下一个空列即可。 有关有效的语言区域设置代码列表，请参阅支持的语言。

可以使用默认列输入希望在应用的所有描述中共享的信息。 如果给定语言的字段留空，则默认列中的信息将用于该语言。 可以输入特定语言的不同信息，从而覆盖该语言的字段。

大部分应用商店一览字段都为可选字段。 每个一览均需要描述字段和一个屏幕截图；对于没有关联程序包的语言，则还需要提供标题字段以表明该一览应使用哪一个保留的应用名称。 对于所有其他字段，如果不希望将其包括在一览中，则可以留空。 请记住，如果给定语言的字段留空，我们将查看默认列中该字段中是否有信息。 如有信息，则将使用该信息。

例如，考虑以下示例：

已导出的一览示例

  • “默认描述”文本将被用于 en-us 和 fr-fr 一览中的描述字段。 但是，es-es 一览中的描述将使用“西班牙语描述”文本。
  • 对于发行说明字段，en-us 一览将使用“英语发行说明”文本，fr-fr 一览则使用“法语发行说明”文本。 但是，es-es 一览中将无任何发行说明字段。

如果不希望对特定字段进行任何编辑，可以从电子表格中删除该字段的整行，仅保留预告片行以及相关联的缩略图行和标题行。 除了这些项之外，删除行不会影响与一览中该字段相关联的数据。 这样可以删除不希望进行编辑的任何行，从而集中于需要进行更改的字段。

删除一种语言中某个字段中的信息但不删除整行，操作方式则有所不同，具体取决于字段。 对于类型为文本的字段，删除该字段中的信息将会从该语言的一览中删除该条目。 但是，删除图像（例如屏幕截图或徽标）字段中的信息，则不会有任何影响；之前的图像仍可以使用，除非直接在合作伙伴中心中通过编辑将该图像删除。 删除预告片字段中的信息实际上会从合作伙伴中心中删除该预告片，因此在进行此类操作之前，请确保具有任何所需文件的副本。

已导出一览中的许多字段都需要文本条目，例如上述示例中的描述和发行说明。 对于这些类型的字段，只需在每种语言的字段中输入相应文本。 请确保遵守每个字段的长度和其他要求。 有关这些要求的详细信息，请参阅创建应用商店一览。

为与资产（例如图像和预告片）相对应的字段提供信息则更加复杂。 这些资产的类型并非文本，而是相对路径（或指向合作伙伴中心中文件的 URL）。

如果已为应用商店一览上载资产，则这些资产将以 URL 表示。 这些 URL 可重复用于产品的多个描述中，或者同一开发者帐户的不同产品中，所以可以复制这些 URL 以重复用于不同字段中。

提示

若要确认与 URL 对应的资产，可以在浏览器中输入 URL 以查看图像（或下载预告片视频）。 必须登录合作伙伴中心帐户，URL 才有效。 如果希望使用之前未添加到合作伙伴中心的新资产，可以文件夹形式而非单个 .csv 文件导入一览。 需要创建一个包含 .csv 文件的文件夹。 之后将图像添加到同一文件夹，根文件夹或子文件夹中均可。 需要在字段中输入完整路径，包括根文件夹名称。

提示

以文件夹形式导入一览时，如要获得最佳效果，请确保使用最新版本的 Microsoft Edge、Chrome 或 Firefox。 例如，如果根文件夹名称为 my_folder，并且希望为桌面屏幕截图 1 使用名为 screenshot1.png 的图像，则可以将 screenshot1.png 添加至该文件夹的根目录，然后在桌面屏幕截图 1 字段中输入 my_folder/screenshot1.png。 如果在根文件夹中创建了一个图像文件夹，并将 screenshot1.jpg 放入该文件夹，则应输入 my_folder/images/screenshot1.png。 请注意，使用文件夹导入一览之后，下一次导出一览的时候，指向图像的路径将转换为指向合作伙伴中心中文件的 URL。 可以复制粘贴这些 URL 以便重复使用（例如，在多种一览语言中使用相同的资产）。

重要

如果导出的一览包括预告片，请注意，如果从 .csv 文件中删除指向该预告片或其缩略图图像的 URL，则将从合作伙伴中心中彻底删除已被删除的文件，并且将无法再访问这些文件（除非该文件还被用于其他一览并且在其中并未被删除）。

导入一览

在 .csv 文件中输入所有更改（并包括希望上载的任何资产）之后，需要先保存文件才能进行上载。 如果使用支持 UTF-8 编码的 Microsoft Excel 版本，请确保选择“另存为”并采用 CSV UTF-8（逗号分隔）(*.csv) 格式。 如果使用其他编辑器来查看和编辑 .csv 文件，在上载之前请确保 .csv 文件采用 UTF-8 编码。

准备好上载更新后的 .csv 文件并导入一览数据时，请在提交概述页上选择导入一览。 如果仅导入 .csv 文件，请选择导入 .csv、浏览至文件，然后单击打开。 如果导入含图像文件的文件夹，请选择“导入文件夹”、浏览至文件夹，然后单击选择文件夹。 请确保除需要上载的资产之外，文件夹中只有一个 .csv 文件。

在处理导入的 .csv 文件时，可以看到一个反映导入和验证状态的进度条。 处理可能需要一些时间，如果有大量一览和/或图像文件时尤其如此。

如果检测到任何问题，则将看到一个说明，表明需要进行任何所需更新，然后重试。 选择查看错误链接以查看无效的字段以及原因。 需要在 .csv 文件中更正这些问题（或替换任何无效资产），然后再次导入一览。

提示

之后可以通过查看上次导入的错误链接再次访问此信息。 在解决文件中的所有错误之前，.csv 文件中的任何信息都将不会保存在合作伙伴中心中，即使没有出现错误的字段也是如此。 导入没有任何错误的 .csv 文件之后，所提供的一览信息将保存在合作伙伴中心中，并将用于该提交。

可以导入其他更新后的 .csv 文件，或者直接在合作伙伴中心中进行更改，从而继续更新一览。

外接程序

对于加载项，导入和导出应用商店一览的流程与上述相同，不过仅有三个与加载项应用商店一览相关的字段：描述、标题和应用商店徽标 300x300（在合作伙伴中心的应用商店一览页面上被称为“图标”）。 标题字段为必填字段，其他两个字段为可选字段。

请注意，必须导航至应用中加载项的提交概述页，从而为每个加载项单独导入和导出应用商店一览。

无需直接在合作伙伴中心输入应用商店一览的信息，你可以选择添加或更新信息，方法是将一览导出到.csv文件中，输入信息和资产，然后导入更新的文件。 可以通过这种方法从头开始创建一览，或者更新早已创建的一览。

当你想要为产品创建或更新多语言 Store 一览时，此选项非常有用，因为你可以将相同信息复制/粘帖到多个字段，并且可以轻松地对特定语言进行更改。

导出列表

在应用的“应用商店一览”页上，可以添加语言，然后单击“导出列表”，以使用所选语言 () 以及列表字段生成.csv文件。 或者，可以先单击“导出列表”，然后选择语言。 成功导出列表后，请下载列表。 在导出的列表中，你将看到字段名称、类型和你为列表选择的语言。

以下概述了导出的 .csv 文件中各列包含的内容：

  • 字段列包含与应用商店一览每一部分相关联的名称。 这些名称对应于在合作伙伴中心中创建应用商店一览时可提供的相同各项，不过有些名称可能稍有不同。 对于可以输入多个相同类型的项目的项目，你将看到多行，最多可以提供的最大数量。 例如，对于产品功能，你将看到 ProductFeatures1、ProductFeatures2 等，并转到 ProductFeatures20 (，因为你可以) 提供最多 20 个应用功能。 请参阅下表，查找 Microsoft Store 一览字段与导出到 .csv 文件中的字段的确切映射。
  • “类型”列提供有关要为该字段提供哪种类型的信息的常规指导，例如“文本”或“相对路径”。
合作伙伴中心应用商店一览中的字段名称 导出.csv文件中的相应字段名称
说明 说明
产品名称 ProductName
此版本中有哪些新增功能？ WhatsNew
产品功能 ProductFeatures1 到 ProductFeatures20
屏幕截图 屏幕截图 1 到屏幕截图 10
商店徽标 (1：1 框艺术) StoreLogos1
商店徽标 (2：3 海报艺术) StoreLogos2
简短说明 ShortDescription
最低硬件 RequirementsMinimum1 到 RequirementsMinimum11
推荐硬件 RequirementsRecommended1 到 RequirementsRecommended11
搜索词 SearchTerms1 到 SearchTerms7
版权和商标信息 版权信息
适用的许可条款 适用的许可条款
开发团队 开发依据

重要

请勿更改导出的.csv文件中的任何字段名称或删除任何字段。 字段下的列和项的名称必须保持不变，才能处理导入的文件。

更新一览信息

导出一览并保存 .csv 文件之后，可以直接在 .csv 文件中编辑一览信息。 对于添加的每种语言，都有一个单独的列，其中语言的名称作为标题。 请勿更改在 .csv 文件中导出的语言的名称。 在列中所做的更改将应用于该语言的列表。

大部分应用商店一览字段都为可选字段。 每个列表都需要说明、一个屏幕截图、应用商店徽标 (1：1 框艺术) 和适用的许可条款。 对于所有其他字段，如果不希望将其包括在一览中，则可以留空。

导出的一览中的许多字段都需要文本输入，例如上述示例中的“说明”和“WhatsNew”。 对于这些类型的字段，只需在每种语言的字段中输入相应文本。 请确保遵守每个字段的长度和其他要求。 有关这些要求的详细信息，请参阅创建应用商店一览。

为与资产（如图像）对应的字段提供信息要复杂一些。 这些资产的类型是相对路径，而不是文本。

提示

如果 (屏幕截图或徽标) 的资产与导出的.csv文件位于同一文件夹中，则相对路径将只是屏幕截图或徽标 (的名称，例如：logo.png) 。 如果已在具有 .csv 文件的 main 文件夹中为图像创建了子文件夹，则相对路径将以子文件夹的名称开头。 (例如，如果子文件夹的名称为“Images”，则相对路径将为 Images/logo.png)

导入列表

将所有更改输入到.csv文件 (并包含要上传) 的任何资产后，需要在上传文件之前保存文件。

准备好上传更新的.csv文件并导入商品数据时，请在应用的应用商店一览页上选择“导入一览”。 首次导入列表时，必须使用一个文件夹上传列表，该文件夹将导出.csv文件和所有资产。 请确保除需要上载的资产之外，文件夹中只有一个 .csv 文件。

重要

首次导入列表时，需要上传文件夹。 此文件夹应包含导出的.csv文件，其中包含在.csv文件中提到的列表信息以及所有资产 (屏幕截图和徽标) 。

如果我们检测到任何问题，你将看到一条说明，指示导入失败。 下载报告以检查错误。 需要在 .csv 文件中更正这些问题（或替换任何无效资产），然后再次导入一览。

请参阅下表，了解错误消息、其含义以及解决这些问题的建议。

错误消息 含义和建议
“.csv文件为空。 请确保该文件包含所需的信息。” 你可能上传了空白.csv文件。 在应用商店一览页中，导出最新的.csv文件。
“字段不存在或无效。 请通过导出列表来使用正确的模板。” 你可能已删除现有字段或在导出的 .csv 文件中添加了一个新字段。 从应用商店一览页导出.csv文件。 请勿更改.csv文件中的任何字段。
“语言代码无效或列表不适用于语言。 请通过导出列表来使用最新的模板。” 你可能在导出的 .csv 文件中编辑了语言代码，或者可能添加了 Microsoft Store 一览页中不存在的新语言代码。 在应用商店一览页中，选择所需的语言，然后导出一览。
“导入的.csv文件中不存在所有选定的语言。 请通过导出列表来使用最新的模板。” 你可能已在 .csv 文件中删除了语言代码。 从应用商店一览页导出.csv文件。 请勿更改 .csv 文件中的任何语言代码。

可以导入其他更新后的 .csv 文件，或者直接在合作伙伴中心中进行更改，从而继续更新一览。