MSIX アプリのストア登録情報のインポートとエクスポート

  • [アーティクル]

パートナー センターに Store 登録情報を直接入力する代わりに、登録情報を .csv ファイルにエクスポートして情報と資産を入力し、更新したファイルをインポートして、情報を追加または更新することもできます。 この方法を使用すると、一から一覧を作成したり、既に作成した一覧を更新したりできます。

このオプションは、製品の Store 登録情報を複数の言語で作成または更新する場合に特に便利です。同じ情報を複数のフィールドにコピー/貼り付け、特定の言語に適用する必要がある変更を簡単に行うことができるためです。

ヒント

この機能を使用して、アドオンのストア登録情報の詳細をインポートおよびエクスポートすることもできます。 アドオンの場合、プロセスは同じように機能しますが、 アドオンに関連するフィールド が含まれている点が異なります。 パートナー センターでは、(以前にインポート/エクスポートの方法を使用した場合でも) 登録情報をいつでも直接作成または更新できることに留意してください。 単純な変更を行うだけの場合はパートナー センターで直接更新した方が簡単な場合がありますが、いずれの方法もいつでも使用することができます。

リストのエクスポート

アプリのアプリの概要ページで、 Export listing ( Store listings セクション) をクリックして、UTF-8 でエンコードされた.csv ファイルを生成します。 このファイルをコンピューター上の場所に保存します。

Microsoft Excel または別のエディターを使用して、このファイルを編集できます。 Microsoft 365 バージョンの Excel では .csv ファイルを CSV UTF-8 (カンマ区切り) (*.csv) 形式で保存できますが、その他のバージョンではこれはサポートされていない可能性があります。

製品の一覧をまだ作成していない場合、エクスポートした.csv ファイルにはカスタム データは含まれません。 Field、ID、Type、default、および Store 登録情報に表示できるすべてのアイテムに対応する行が表示されます。

登録情報を既に作成している (またはパッケージをアップロードした) 場合は、作成した (またはパッケージで検出された) 各リストの言語に対応する言語ロケール コードでラベル付けされた列と、以前に指定したリスト情報も表示されます。

エクスポートされた.csv ファイルの各列に含まれる内容の概要を次に示します。

  • Field 列には、Store 登録情報のすべての部分に関連付けられている名前が含まれています。 これらは、パートナー センターで Store 登録情報を作成したときに指定できるものと同じ項目に対応していますが、若干名前が異なっているものもあります。 同じ種類のアイテムを複数入力できるアイテムの場合は、指定できる最大数までの複数の行が表示されます。 たとえば、App 機能の場合Feature1、Feature2 など、Feature20 まで表示されます (最大 20 個のアプリ機能を提供できるため)。
  • [ID] 列には、パートナー センターで各フィールドに関連付けられている番号が含まれます。
  • [種類] 列には、テキストや相対パス (またはパートナー センターのファイルへの URL) など、各フィールドに指定する情報の種類について、全般的なガイドが示されます。
  • default 列 (および言語ロケール コードでラベル付けされた列) は、Store 登録情報の各部分に関連付けられているテキストまたはアセットを表します。 これらの列のフィールドを編集して、ストア登録情報を更新できます。

重要

Field、ID、または Type 列の情報は変更しないでください。 インポートしたファイルを処理するには、これらの列の情報は変更されない必要があります。

リスト情報を更新する

一覧をエクスポートして.csv ファイルを保存したら、.csv ファイルで直接登録情報を編集できます。

default 列と共に、一覧を作成した各言語には独自の列があります。 列で行った変更は、その言語の説明に適用されます。 新しい言語の一覧を作成するには、先頭行の次の空の列に言語ロケール コードを追加します。 有効な言語ロケール コードの一覧については、「 サポートされている言語」を参照してください。

default 列を使用して、アプリのすべての説明で共有する情報を入力できます。 特定の言語のフィールドを空白のままにすると、既定の列の情報がその言語に使用されます。 特定の言語のフィールドをオーバーライドするには、その言語の別の情報を入力します。

ほとんどの Store 登録情報フィールドは省略可能です。 リストごとに Description と 1 つのスクリーンショットが必要です。パッケージが関連付けられていない言語の場合は、 Title を指定して、その一覧に使用する予約済みアプリ名を指定する必要があります。 他のすべてのフィールドについて、リストにフィールドを含めない場合は、フィールドを空のままにすることができます。 特定の言語のフィールドを空白のままにすると、既定の列にそのフィールドに情報があるかどうかを確認します。 その場合は、その情報が使用されます。

たとえば、次の例を考えてみましょう。

エクスポートされたリストの例

  • "既定の説明" というテキストは、en-us および fr-fr リストの Description フィールドに使用されます。 ただし、es-es リストの Description フィールドでは、"スペイン語の説明" というテキストが使用されます。
  • ReleaseNotes フィールドでは、"英語のリリース ノート" というテキストが en-us に使用され、テキスト "French release notes" が fr-fr に使用されます。 ただし、es-es のリリース ノートは表示されません。

特定のフィールドに対して編集を行わない場合は、行全体をスプレッドシートから削除できます 予告編の行とそれに関連付けられているサムネイルとタイトルは除きます。 これらの項目を除き、行を削除すると、リスト内のそのフィールドに関連付けられているデータには影響しません。 これにより、編集する予定のない行を削除できるため、変更するフィールドに集中できます。

1 つの言語のフィールド内の情報を、行全体を削除せずに削除すると、フィールドによって動作が異なります。 Type が Text であるフィールドの場合、フィールド内の情報を削除すると、その言語の一覧からそのエントリが削除されます。 しかし、スクリーンショットやロゴなど、画像のフィールドの情報を削除する場合は、何も変更されません。パートナー センターで直接編集して削除しない限り、以前の画像が引き続き使用されます。 ただし、トレーラーのフィールドについては情報を削除すると、パートナー センターからそのトレーラーが削除されるため、削除する前に必要なファイルのコピーを保存しておいてください。

エクスポートされた一覧の多くのフィールドには、上の例のテキスト入力、 Description ReleaseNotes が必要です。 これらの種類のフィールドでは、各言語のフィールドに適切なテキストを入力するだけです。 各フィールドの長さと他の要件に従ってください。 これらの要件の詳細については、「 アプリ ストア登録情報の作成」を参照してください。

画像やトレーラーなど、資産に対応するフィールドの情報の提供は、もう少し複雑です。 これらの資産の種類は、テキストではなく、相対パス (またはパートナー センターのファイルへの URL) になります。

ストア登録情報のアセットを既にアップロードしている場合、これらの資産は 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 をコピーして貼り付けて、もう一度使用できます (たとえば、複数のリスト言語で同じ資産を使用する場合)。

重要

エクスポートした登録情報にトレーラーが含まれている場合、トレーラーやそのサムネイル画像への URL を .csv ファイルから削除すると、そのファイルはパートナー センターから完全に削除され、そこからはアクセスできなくなります (そのファイルが別の登録情報でも使用されていて、そこで削除されていない場合はアクセスできます)。

リストのインポート

.csv ファイルにすべての変更を入力し (アップロードする資産を含めた)、アップロードする前にファイルを保存する必要があります。 UTF-8 エンコードをサポートするバージョンの Microsoft Excel を使用している場合は、必ず [として保存] を選択しCSV UTF-8 (コンマ区切り) (*.csv)形式を使用してください。 別のエディターを使用して.csv ファイルを表示および編集する場合は、アップロードする前に、.csv ファイルが UTF-8 でエンコードされていることを確認してください。

更新された.csv ファイルをアップロードして登録情報データをインポートする準備ができたら、アプリの概要ページで 登録情報のインポート を選択します。 .csv ファイルのみをインポートする場合は、[ インポート] .csvを選択し、ファイルを参照して 、[開く ] をクリック。 イメージ ファイルを含むフォルダーをインポートする場合は、[フォルダーのインポート] を選択し、フォルダーを参照して、[フォルダーの選択 クリックします。 アップロードするアセットと共に、フォルダー内に.csvファイルが 1 つだけ存在することを確認します。 画像の場合は、ルート フォルダー名を含む完全なパスをフィールドに入力する必要があります。

インポートした.csvファイルを処理すると、インポートと検証の状態を反映した進行状況バーが表示されます。 これは、特にリストや画像ファイルが多数ある場合に、しばらく時間がかかる場合があります。

問題が検出された場合は、必要な更新を行ってやり直す必要があることを示すメモが表示されます。 表示エラーリンクを選択して、無効なフィールドとその理由を確認します。 .csv ファイルでこれらの問題を修正 (または無効な資産を置き換える) してから、一覧をもう一度インポートする必要があります。

ヒント

この情報には、後で最後のインポートリンクの View エラーを使用して再度アクセスできます。 ファイル内のエラーがすべて解決しないと、.csv ファイルの情報は、エラーのないフィールドも含めて、パートナー センターにまったく保存されません。 エラーのない .csv ファイルがインポートされると、用意した登録情報がパートナー センターに保存され、該当する申請に使用されます。

更新した別の .csv ファイルをインポートするか、パートナー センターで直接変更を行うことで、登録情報は引き続き更新できます。

アドオン

アドオンの場合、Store 登録情報のインポートとエクスポートのプロセスは上記と同じですが、対象になるフィールドは アドオンの Store 登録情報に関連する [説明]、[タイトル]、[StoreLogo300x300] (パートナー センターの Store 登録情報ページでは [アイコン]) の 3 フィールドのみです。 Title フィールドは必須で、他の 2 つのフィールドは省略可能です。

アドオンの申請の概要ページに移動して、アプリのアドオンごとにストア登録情報を個別にインポートおよびエクスポートする必要があることに注意してください。