匯入及匯出 Store 清單

除了直接在合作夥伴中心輸入 Store 清單的資訊，您也可以選擇在 .csv 檔案中匯出清單、輸入資訊和資產，然後匯入更新的檔案，來新增或更新資訊。 您可以使用此方法從頭開始建立清單，或更新您已建立的清單。

如果您想要以多種語言建立或更新產品的 Store 清單，這個選項特別有用，因為您可以將相同的資訊複製/貼到多個欄位中，並輕鬆地進行任何應套用至特定語言的變更。 不過，您無法使用這個方法來建立或更新支援舊版作業系統之先前發行應用程式的平台特定 Store 清單。

提示

您也可以使用此功能來匯入和匯出附加元件之 Store 清單詳細資料。 針對附加元件，此程序的運作方式相同，不同之處在於只包含與附加元件相關的欄位。 請記住，您一律可以直接在合作夥伴中心建立或更新清單 (即使您先前已使用匯入/匯出方法也一樣)。 當您只是進行簡單的變更時，直接在合作夥伴中心更新可能會比較容易，但您可以隨時使用任一方法。

匯出清單

在應用程式的提交概觀頁面上，按一下 [匯出清單] (在 [Store 清單] 區段) 中的 [匯出清單] 來產生以 UTF-8 編碼的 .csv 檔案。 將此檔案儲存到電腦上的某個位置。

您可以使用 Microsoft Excel 或其他編輯器來編輯此檔案。 請注意，Microsoft 365 版本的 Excel 可讓您將 .csv 檔案儲存為 CSV UTF-8 (逗號分隔) (*.csv)，但其他版本可能不支援此專案。 您可以在 Excel 2016 新功能公告中找到有關哪些 Excel 版本支援此功能的詳細資訊，以及有關在此處各種編輯器中編碼為 UTF-8 的更多資訊。

如果您尚未為產品建立任何清單，您匯出的 .csv 檔案將不會包含任何自訂資料。 您會看到 [欄位]、[識別碼]、[類型] 和 [預設值] 的資料行，以及對應到可以出現在 Store 清單中之每個專案的資料列。

如果您已經建立清單 (或已上傳套件)，您也會看到標示為語言地區設定代碼的資料行，這些資料行會對應至您所建立的每個清單的語言 (或我們在套件中偵測到)，以及您先前提供的任何清單資訊。

以下是匯出 .csv 檔案中每個資料行所包含的概觀：

• [欄位] 資料列行含與 Store 清單的每個部分相關聯的名稱。 這些項目會對應至您在合作夥伴中心建立 Store 清單時所能提供的相同專案，但有些名稱稍有不同。 對於您可以輸入多個相同類型項目的項目，您會看到多個資料列，最多可以提供的數目上限。 例如，針對 應用程式功能，您會看到 Feature1、 Feature2等，最多可達 Feature20 (因為您最多可以提供20個應用程式功能)。
• 識別碼資料行包含合作夥伴中心與每個欄位相關聯的數字。
• [類型] 資料行提供該欄位所提供之資訊類型的一般指引，例如文字 或相對路徑 (或合作夥伴中心檔案的 URL)。
• 預設資料列 (以及標示為語言地區設定代碼的任何資料行) 代表與 Store 清單每個部分相關聯的文字或資產。 您可以編輯這些資料列中的欄位，以更新您的 Store 清單。

重要

請勿變更 [欄位]、[識別碼] 或 [類型] 資料行中的任何資訊。 這些資料行中的資訊必須保持不變，才能處理匯入的檔案。

更新清單資訊

匯出清單並儲存 .csv 檔案之後，即可直接在 .csv 檔案中編輯清單資訊。

除了預設資料行，您建立清單的每個語言都有自己的資料行。 您在資料行中所做的變更將會套用至該語言的描述。 您可以將語言地區設定程式碼新增至頂端資料列中的下一個空白資料行，以建立新語言的清單。 如需有效的語言地區設定代碼清單，請參閱支援的語言。

您可以使用預設資料列來輸入您想要在所有應用程式描述中共用的資訊。 如果指定語言的欄位保留空白，則預設資料行中的資訊將會用於該語言。 您可以輸入該語言的不同資訊來覆寫特定語言的欄位。

大部分的 Store 清單欄位都是選擇性的。 每個清單都需要 [描述] 和一個螢幕擷取畫面；對於沒有相關聯套件的語言，您也必須提供標題，以指出該清單應該使用哪一個保留的應用程式名稱。 針對所有其他欄位，如果您不想將欄位包含在清單中，則可以將欄位保留空白。 請記住，如果您將指定語言的欄位保留空白，我們會檢查預設資料行中是否有該欄位中的資訊。 如果是，則會使用該資訊。

例如，請設想下列範例：

• 「預設描述」文字將用於 en-us 和 fr-fr 清單中的 [描述] 欄位。 不過，es-es 清單中的 [描述] 欄位會使用文字「西班牙文描述」。
• 針對 [ReleaseNotes] 欄位，文字「英文版本資訊」將用於 en-us，而文字「法文版本資訊」則用於 fr-fr。 不過，es-es 不會顯示任何版本資訊。

如果您不想對特定欄位進行任何編輯，您可以從電子錶格中刪除整個資料列，但預告片的資料列及其相關聯的縮圖和標題針對 除外。 除了這些專案以外，刪除資料列不會影響與清單中該欄位相關聯的資料。 這可讓您移除任何不想要編輯的資料列，因此您可以將焦點放在您要進行變更的欄位上。

刪除某個語言欄位中的資訊，而不移除整個資料列，會根據欄位而有所不同。 對於類型為文字的欄位，刪除欄位中的資訊只會從該語言的清單中移除該項目。 不過，刪除影像欄位中的資訊，例如螢幕擷取畫面或標誌，將不會有任何作用；除非您直接在合作夥伴中心編輯，否則仍會使用上一個影像。 刪除預告片欄位的資訊實際上會從合作夥伴中心移除該預告片，因此，請先確定您有一份所需的檔案複本，再執行此動作。

匯出清單中的許多欄位都需要文字輸入，例如上述範例中的欄位、描述和 ReleaseNotes。 針對這些類型的欄位，只要在每個語言的欄位中輸入適當的文字即可。 請務必遵循每個欄位的長度和其他需求。 如需這些需求的詳細資訊，請參閱建立應用程式 Store 清單。

提供對應至影像和預告片等資產之欄位的資訊會稍微複雜一點。 這些資產的類型不是文字，而是相對路徑 (或合作夥伴中心檔案的 URL)。

如果您已經上傳 Store 清單的資產，這些資產就會以 URL 表示。 這些 URL 可以在產品的多個描述中重複使用，甚至是在同一個開發人員帳戶內跨不同產品重複使用，因此，如果您想要的話，可以複製這些 URL 以在不同的欄位中重複使用。

提示

若要確認哪個資產對應至 URL，您可以在瀏覽器中輸入 URL 來檢視影像 (或下載預告片影片)。 您必須登入合作夥伴中心帳戶，才能讓此 URL 能夠運作。 如果您想要使用您先前尚未新增至合作夥伴中心的新資產，您可以將清單匯入為資料夾，而不是單一 .csv 檔案來執行此動作。 您必須建立包含 .csv 檔案的資料夾。 然後，在根資料夾或子資料夾中新增相同資料夾的影像。 您必須在欄位中輸入完整路徑，包括根資料夾名稱。

提示

若要在將清單匯入為資料夾時獲得最佳結果，請確定您使用的是最新版的 Microsoft Edge、Chrome 或 Firefox。 例如，如果您的根資料夾名為 my_folder，並且您想要為 DesktopScreenshot1 使用名為 screenshot1.png 的影像，則可以將Screenshot1.png 新增至該資料夾的根目錄，然後在 DesktopScreenshot1 欄位中輸入 my_folder/screenshot1.png。 如果您在根資料夾內建立了影像資料夾，然後在該處放置 screenshot1.jpg，您會輸入 my_folder/images/screenshot1.png。 請注意，當您使用資料夾匯入清單之後，下次匯出清單時，影像的路徑將會轉換成 URL 到合作夥伴中心的檔案。 您可以複製並貼上這些 URL 以再次使用它們 (例如，以數種清單語言使用相同的資產)。

重要

如果您的匯出清單包含預告片，請注意，從您的 .csv 檔案中刪除預告片的 URL 或其縮圖影像將會從合作夥伴中心完全移除已刪除的檔案，而且您將無法再存取該檔案 (除非該檔案也用於尚未刪除的另一個清單中)。

匯入清單

一旦您在 .csv 檔案中輸入所有變更 (並包含您想要上傳的任何資產)，您必須先儲存檔案，再上傳檔案。 如果您使用支援 UTF-8 編碼的 Microsoft Excel 版本，請務必選取 [另存新檔]，並使用 CSV UTF-8 (Comma-delimited) (*.csv) 格式。 如果您使用不同的編輯器來檢視和編輯 .csv 檔案，請在上傳之前，確定 .csv 檔案是以 UTF-8 編碼。

當您準備好上傳更新的 .csv 檔案並匯入清單資料時，請選取提交概觀頁面上的匯入清單。 如果您只匯入 .csv 檔案，請選擇 [匯入 .csv]，瀏覽至您的檔案，然後按一下 [開啟]。 如果您要匯入含有影像檔的資料夾，請選擇 [匯入資料夾]，瀏覽至您的資料夾，然後按一下 [選取資料夾]。 請確定資料夾中只有一個 .csv 檔案，以及您要上傳的任何資產。

當我們處理匯入 .csv 檔案時，您會看到一個進度列，反映匯入和驗證狀態。 這可能需要一些時間，特別是如果您有大量的清單和/或影像檔。

如果我們偵測到任何問題，您會看到指出您需要進行任何所需更新的附註，然後再試一次。 選取 [檢視錯誤] 連結，以查看哪些欄位無效，以及原因。 您必須在 .csv 檔案中更正這些問題 (或取代任何無效的資產)，然後再次匯入您的清單。

提示

您稍後可透過 上次匯入連結的檢視錯誤再次存取這項資訊。 您 .csv 檔案中沒有任何資訊會儲存在合作夥伴中心，直到檔案中的所有錯誤都已解決，即使是沒有錯誤的欄位也一般。 匯入沒有錯誤的 .csv 檔案之後，您所提供的清單資訊將會儲存在合作夥伴中心，並用於該提交。

您可以匯入另一個更新的 .csv 檔案，或直接在合作夥伴中心進行變更，繼續更新清單。

附加元件

若為附加元件，匯入和匯出 Store 清單會使用上述相同程式，不同之處在於您只會看到與附加元件 Store 清單相關的三個欄位：描述、標題和 StoreLogo300x300 (在合作夥伴中心的 Store 清單頁面上稱為圖示)。 標題欄位是必要的，而其他兩個欄位則為選擇性欄位。

請注意，您必須瀏覽至附加元件提交概觀頁面，以個別匯入和匯出應用程式中每個附加元件的清單。

除了直接在合作夥伴中心輸入 Store 清單的資訊，您也可以選擇在 .csv 檔案中匯出清單、輸入資訊和資產，然後匯入更新的檔案，來新增或更新資訊。 您可以使用此方法從頭開始建立清單，或更新您已建立的清單。

如果您想要以多種語言建立或更新產品的 Store 清單，這個選項特別有用，因為您可以將相同的資訊複製/貼到多個欄位中，並輕鬆地進行任何應套用至特定語言的變更。

匯出清單

在應用程式的 [Store 清單] 頁面上，您可以新增語言，然後按一下 [匯出清單] 來產生具有您所選取語言和清單欄位的 .csv 檔案。 或者，您可以先按一下 [匯出] 清單，然後選取語言。 成功匯出清單之後，請下載清單。 在匯出清單中，您會看到 [功能變數名稱]、[類型] 和您針對清單選取的語言。

以下是匯出 .csv 檔案中每個資料行所包含的概觀：

• [欄位] 資料列行含與 Store 清單的每個部分相關聯的名稱。 這些項目會對應至您在合作夥伴中心建立 Store 清單時所能提供的相同專案，但有些名稱稍有不同。 對於您可以輸入多個相同類型項目的項目，您會看到多個資料列，最多可以提供的數目上限。 例如，針對產品功能，您會看到 ProductFeatures1、ProductFeatures2 等，並前往 ProductFeatures20 (因為您可以提供最多 20 個應用程式功能)。 請參閱下表，以尋找 Store 清單欄位與 .csv 檔案中所匯出欄位的確切對應。
• [類型] 資料行提供該欄位所提供之資訊類型的一般指引，例如文字或相對路徑。

合作夥伴中心內 Store 清單中的欄位名稱	匯出 .csv 檔案中的對應功能變數名稱
描述	描述
產品名稱	ProductName
本版新功能？	WhatsNew
產品功能	ProductFeatures1 至 ProductFeatures20
螢幕擷取畫面	Screenshots1 至 Screenshots10
Store 標誌 (1：1 方塊藝術)	StoreLogos1
Store 標誌 (2：3 海報藝術)	StoreLogos2
簡短描述	ShortDescription
最低硬體	RequirementsMinimum1 至 RequirementsMinimum11
建議的硬體	RequirementsRecommended1 至 RequirementsRecommended11
搜尋字詞	SearchTerms1 至 SearchTerms7
著作權和商標資訊	著作權
適用的授權條款	適用的授權條款
開發人員	DevelopedBy

重要

請勿變更任何功能變數名稱，或刪除匯出 .csv 檔案中的任何欄位。 欄位下的資料行和專案名稱必須保持不變，才能處理匯入的檔案。

更新清單資訊

匯出清單並儲存 .csv 檔案之後，即可直接在 .csv 檔案中編輯清單資訊。 針對每個新增的語言，有一個個別的資料行，其名稱為語言做為標題。 請勿變更 .csv 檔案中匯出的語言名稱。 您在資料列中所做的變更將會套用至該語言的清單。

大部分的 Store 清單欄位都是選擇性的。 每個清單都需要描述、一個螢幕擷取畫面、Store 標誌 (1：1 方塊藝術版) 和適用的授權條款。 針對所有其他欄位，如果您不想將欄位包含在清單中，則可以將欄位保留空白。

匯出清單中的許多欄位都需要文字輸入，例如上述範例中的欄位、描述和 WhatsNew。 針對這些類型的欄位，只要在每個語言的欄位中輸入適當的文字即可。 請務必遵循每個欄位的長度和其他需求。 如需這些需求的詳細資訊，請參閱建立應用程式 Store 清單。

為與資產 (例如影像) 對應的欄位提供資訊有點複雜。 這些資產的類型不是文字，而是相對路徑。

提示

如果您的資產 (螢幕擷取畫面或標誌) 位於與匯出 .csv 檔案相同的資料夾中，相對路徑會只是螢幕擷取畫面或標誌的名稱 (例如：logo.png)。 如果您已在主資料夾中建立具有 .csv 檔案之影像的子資料夾，相對路徑會以子資料夾的名稱開頭。 (例如，如果子資料夾的名稱是「Images」，相對路徑會是 Images/logo.png)

匯入清單

一旦您在 .csv 檔案中輸入所有變更 (並包含您想要上傳的任何資產)，您必須先儲存檔案，再上傳檔案。

當您準備好上傳更新的 .csv 檔案並匯入清單資料時，請選取應用程式 Store 清單頁面上的 [匯入清單]。 當您第一次匯入清單時，您必須使用將匯出 .csv 檔案和所有資產的資料夾上傳清單。 請確定資料夾中只有一個 .csv 檔案，以及您要上傳的任何資產。

重要

第一次匯入清單時，您需要上傳資料夾。 此資料夾應包含匯出 .csv 檔案，其中包含清單資訊和您在 .csv 檔案中提及的所有資產 (螢幕擷取畫面和標誌)。

如果我們偵測到任何問題，您會看到指出匯入失敗的注意事項。 下載報告以檢查錯誤。 您必須在 .csv 檔案中更正這些問題 (或取代任何無效的資產)，然後再次匯入您的清單。

請參閱下表，以取得錯誤訊息、其意義，以及解決錯誤訊息的建議。

錯誤訊息	意義和建議
「.csv 檔案為空白。 請確定檔案具有所需的資訊。」	您可能已上傳空白 .csv 檔案。 從 [Store 清單] 頁面，匯出最新的 .csv 檔案。
「欄位不存在或無效。 請匯出清單來使用正確的範本。」	您可能已刪除現有的欄位，或在匯出的 .csv 檔案中新增欄位。 從應用程式 Store 清單頁面匯出 .csv 檔案。 請勿變更 .csv 檔案中的任何欄位。
「語言代碼無效或清單不適用於語言。 請匯出清單來使用最新的範本。」	您可能已在匯出 .csv 檔案中編輯語言代碼，或者您可能已新增不在 Store 清單頁面中的新語言代碼。 從 [Store 清單] 頁面中，選取必要的語言，然後匯出清單。
「所有選取的語言都不存在於匯入 .csv 檔案中。 請匯出清單來使用最新的範本。」	您可能已移除 .csv 檔案中的語言代碼。 從應用程式 Store 清單頁面匯出 .csv 檔案。 請勿變更 .csv 檔案中的任何語言代碼。

您可以匯入另一個更新的 .csv 檔案，或直接在合作夥伴中心進行變更，繼續更新清單。