匯入和匯出 PWA 的市集清單

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

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

提示

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

匯出清單

在應用程式的應用程式概觀頁面上，按兩下 [匯出清單] （在市集清單區段中）， 以產生以 UTF-8 編碼的.csv檔案。 將此檔案儲存到電腦上的某個位置。

您可以使用 Microsoft Excel 或其他編輯器來編輯此檔案。 請注意，Microsoft 365 版本的 Excel 可讓您將 .csv 檔案儲存為 CSV UTF-8 (逗號分隔) (*.csv)，但其他版本可能不支援此專案。

如果您尚未為產品建立任何清單，您匯出的 .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 檔案的資料夾。 然後，在根資料夾或子資料夾中新增相同資料夾的影像。 您必須在欄位中輸入完整路徑，包括根資料夾名稱。

例如，如果您的根資料夾名為 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 清單頁面上稱為圖示)。 標題欄位是必要的，而其他兩個欄位則為選擇性欄位。

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