アプリの申請の管理

Microsoft Store 申請 API には、段階的なパッケージのロールアウトなど、アプリの申請を管理するために使用できるメソッドが用意されています。 Microsoft Store 申請 API の概要については、「Microsoft Store サービスを使用した申請の作成と管理」をご覧ください。この API を使用するための前提条件などの情報があります。

重要

Microsoft Store 申請 API を使ってアプリの提出を作成する場合、申請にさらに変更を加えるには、必ずパートナー センターではなく API のみを使用してください。 最初に API を使って作成した申請を、パートナー センターを使って変更した場合、API を使ってその申請を変更またはコミットすることができなくなります。 場合によっては、申請がエラー状態のままになり、申請プロセスを進めることができなくなります。 この場合、申請を削除して新しい申請を作成する必要があります。

重要

この API を使用して、ビジネス向け Microsoft Storeと教育機関向け Microsoft Storeを通じてボリューム購入の申請を発行したり、LOB アプリの申請を企業に直接発行したりすることはできません。 このようなシナリオでは、どちらの場合もパートナー センターを使って申請を公開する必要があります。

アプリの申請を管理するためのメソッド

アプリの申請を取得、作成、更新、コミット、または削除するには、次のメソッドを使用します。 これらのメソッドを使用するには、アプリをお客様自身のパートナー センター アカウントに用意し、まずパートナー センターでそのアプリの申請を 1 つ作成しておく必要があります。 詳細については、前提条件を参照してください。

Method URI 説明
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} 既存のアプリ申請を取得する
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status 既存のアプリ申請の状態を取得する
投稿 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions 新しいアプリの申請を作成する
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} 既存のアプリの申請を更新する
投稿 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit 新しいアプリまたは更新されたアプリの申請をコミットする
DELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} アプリの申請の削除

アプリの申請の作成

アプリの申請を作成するには、このプロセスに従います。

  1. Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。

    Note

    評価情報が完了した、少なくとも 1 つの完了した申請がアプリに既に存在することを確認します。

  2. Azure AD のアクセス トークンを取得します。 このアクセス トークンを Microsoft Store 申請 API のメソッドに渡す必要があります。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。

  3. Microsoft Store 申請 API で次のメソッドを実行して アプリの申請を作成します。 このメソッドによって、新しい申請が作成され、審査中になります。これは、前回発行した申請のコピーです。

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions
    

    応答本文には、新しい申請の ID、申請用の関連ファイル (アプリ パッケージ、登録情報の画像、トレーラー ファイルなど) を Azure Blob Storage にアップロードするための共有アクセス署名 (SAS) URI、および新しい申請のすべてのデータ (登録情報や価格情報など) が含まれたアプリの申請リソースが含まれています。

    Note

    SAS URI では、アカウント キーを必要とせずに、Azure Storage 内のセキュリティで保護されたリソースにアクセスできます。 SAS URI の背景情報と Azure Blob Storage での SAS URI の使用については、「Shared Access Signatures、第 1 部: SAS モデルについて」と「Shared Access Signature、第 2 部: BLOB ストレージでの SAS の作成と使用」を参照してください。

  4. 申請用に新しいパッケージ、一覧表示イメージ、またはトレーラー ファイルを追加する場合は、アプリ パッケージ 準備し アプリのスクリーンショット、画像、およびトレーラーを します。 これらのファイルをすべて ZIP アーカイブに追加します。

  5. app 申請新しい申請に必要な変更を含むデータを修正し、次のメソッドを実行してアプリの申請を更新します

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}
    

    Note

    申請用に新しいファイルを追加する場合は、ZIP アーカイブ内のこれらのファイルの名前と相対パスを参照するように申請データを更新してください。

  6. 申請用に新しいパッケージ、登録情報の画像、またはトレーラー ファイルを追加する場合は、上記で呼び出した POST メソッドの応答本文に含まれていた SAS URI を使用して、ZIP アーカイブを Azure Blob Storage にアップロードします。 さまざまなプラットフォームでこれを行うために使用できる、次のようなさまざまな Azure ライブラリがあります。

    次の C# コード例は、.NET 用 Azure Storage クライアント ライブラリの CloudBlockBlob クラスを使って ZIP アーカイブを Azure Blob Storage にアップロードする方法を示しています。 この例では、ZIP アーカイブが既にストリーム オブジェクトに書き込まれていることを前提としています。

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
    Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
        new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
    await blockBob.UploadFromStreamAsync(stream);
    
  7. 次のメソッドを実行して アプリの申請をコミットします。 これで、申請が完了し、更新がアカウントに適用されていることがパートナー センターに通知されます。

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit
    
  8. 次のメソッドを実行してコミットの状態を確認し、アプリの申請の状態を 取得します

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status
    

    申請の状態を確認するには、応答本文の status の値を確認します。 この値が CommitStarted から PreProcessing (要求が成功した場合) または CommitFailed (要求でエラーが発生した場合) に変わっています。 エラーがある場合は、statusDetails フィールドにエラーについての詳細情報が含まれています。

  9. コミットが正常に処理されると、インジェストのために申請がストアに送信されます。 上記のメソッドを使うか、パートナー センターのダッシュボードから、申請の進行状況を引き続き監視できます。

段階的なパッケージのロールアウトを管理するための方法

Windows 10 および Windows 11 では、アプリの申請で更新されたパッケージをアプリの顧客の割合に徐々にロールアウトできます。 これにより、特定のパッケージのフィードバックと分析データを監視して、更新プログラムをより広範にロールアウトする前に確実に更新プログラムを確認できます。 公開された申請のロールアウト率を変更 (または更新を停止) できます。新しい申請を作成する必要はありません。 パートナー センターで段階的なパッケージのロールアウトの有効化と管理を行う方法などについて詳しくは、この記事をご覧ください。

アプリの申請に対して段階的なパッケージのロールアウトをプログラムで有効にするには、Microsoft Store 申請 API のメソッドを使用して、次のプロセスに従います。

  1. アプリの申請を作成するか既存のアプリ申請を取得
  2. 応答データで、 packageRollout リソースを見つけ、 isPackageRollout フィールドを true に設定し、 packageRolloutPercentage フィールドを、更新されたパッケージを取得するアプリの顧客の割合に設定します。
  3. 更新されたアプリ申請データを update a app submission メソッドに渡します。

アプリの申請に対して段階的なパッケージのロールアウトが有効になった後は、次の方法を使用して、段階的なロールアウトをプログラムで取得、更新、停止、または最終処理できます。

Method URI 説明
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout アプリの申請に関する段階的なロールアウト情報を取得する
投稿 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage アプリの申請の段階的なロールアウト率を更新する
投稿 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout アプリの申請の段階的なロールアウトを停止する
投稿 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout アプリの申請の段階的なロールアウトを完了する

アプリの申請を管理するためのコード例

次の記事では、いくつかの異なるプログラミング言語でアプリの申請を作成する方法を示す詳細なコード例を示します。

StoreBroker PowerShell モジュール

Microsoft Store 申請 API を直接呼び出す代わりに、API の上にコマンド ライン インターフェイスを実装するオープンソースの PowerShell モジュールも用意されています。 このモジュールは、StoreBroker と呼ばれています。 このモジュールを使うと、Microsoft Store 申請 API を直接呼び出さずに、コマンド ラインからアプリ、フライト、アドオンの申請を管理できます。また、ソースを参照して、この API を呼び出す方法の例を確認することもできます。 StoreBroker モジュールは、多くのファースト パーティ アプリケーションをストアに申請する主要な方法として Microsoft 内で積極的に使っています。

詳しくは、GitHub の StoreBroker に関するページをご覧ください。

データ リソース

アプリの申請を管理するための Microsoft Store 申請 API メソッドでは、次の JSON データ リソースが使用されます。

アプリの申請リソース

このリソースでは、アプリの申請について説明します。

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
          "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "description": "Main page",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

このリソースには、次の値があります。

種類 説明
id string 申請 ID。 この ID は、アプリの申請の作成、すべてのアプリのの取得、アプリのの取得をする要求の応答データで使用できます。 アプリの申請をパートナー センターで作成した場合、この ID は、パートナー センターの申請ページの URL でも確認できます。
applicationCategory string アプリの カテゴリまたはサブカテゴリ を指定する文字列。 カテゴリとサブカテゴリは、 BooksAndReference_EReaderなど、アンダースコア '_' 文字を持つ 1 つの文字列に結合されます。
価格 オブジェクト アプリの価格情報を含む 価格の高いリソース
visibility string アプリの可視性。 次のいずれかの値を指定できます。
  • 非表示
  • パブリック
  • プライベート
  • NotSet
targetPublishMode string 申請の公開モードです。 次のいずれかの値を指定できます。
  • 即時
  • 手動
  • SpecificDate
targetPublishDate string targetPublishMode が SpecificDate に設定されている場合、ISO 8601 形式での申請の公開日です。
listings オブジェクト キーと値のペアのディクショナリ。各キーは国コードで、各値はアプリの一覧情報を含む リストリソース です。
hardwarePreferences 配列 アプリの ハードウェアの基本設定 を定義する文字列の配列。 次のいずれかの値を指定できます。
  • タッチ
  • キーボード
  • マウス
  • Camera
  • NfcHce
  • Nfc
  • BluetoothLE
  • テレフォニー
automaticBackupEnabled boolean Windows が OneDrive への自動バックアップにアプリのデータを含めることができるかどうかを示します。 詳細については、「 App 宣言」を参照してください。
canInstallOnRemovableMedia boolean ユーザーがアプリをリムーバブル 記憶域にインストールできるかどうかを示します。 詳細については、「 App 宣言」を参照してください。
isGameDvrEnabled boolean アプリに対してゲーム録画が有効になっているかどうかを示します。
gamingOptions 配列 アプリのゲーム関連の設定を定義する 1 つの ギャミング オプション リソース を含む配列。
hasExternalInAppProducts boolean アプリでユーザーが Microsoft Store コマース システムの外部で購入できるかどうかを示します。 詳細については、「 App 宣言」を参照してください。
meetAccessibilityGuidelines boolean アプリがアクセシビリティ ガイドラインを満たすようにテストされているかどうかを示します。 詳細については、「 App 宣言」を参照してください。
notesForCertification string アプリの認定脚注が含まれています。
status string 申請の状態。 次のいずれかの値を指定できます。
  • なし
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • 発行
  • 公開済み
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • 認定資格
  • CertificationFailed
  • リリース
  • ReleaseFailed
statusDetails object エラーに関する情報など、申請のステータスに関する追加情報が保持されるステータスの詳細に関するリソースです。
fileUploadUrl string 申請のパッケージのアップロードに使用する共有アクセス署名 (SAS) URI です。 新しいパッケージの追加、画像の一覧表示、または提出用のトレーラー ファイルを行う場合は、パッケージと画像を含む ZIP アーカイブをこの URI にアップロードします。 詳細については、「 アプリの申請を作成する」を参照してください。
applicationPackages 配列 申請内の各パッケージの詳細を提供する アプリケーション パッケージ リソース の配列。
packageDeliveryOptions オブジェクト パッケージ配信オプション リソース申請の段階的なパッケージのロールアウトと必須の更新設定が含まれています。
enterpriseLicensing string ライセンス値の 1 つアプリのエンタープライズ ライセンス動作を示す値です。
allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies boolean Microsoft が将来の Windows 10 および Windows 11 デバイス ファミリで使用できるアプリを できるかどうかを示します
allowTargetFutureDeviceFamilies オブジェクト キーと値のペアのディクショナリ。各キーは Windows 10 および Windows 11 デバイス ファミリであり 各値は、アプリが指定したデバイス ファミリをターゲットにできるかどうかを示すブール値です。
friendlyName string パートナー センターに表示される申請のフレンドリ名です。 この値は、申請を作成するときに生成されます。
トレーラー 配列 アプリ一覧のビデオ トレーラーを表す最大 15 trailer リソース を含む配列。

価格リソース

このリソースには、アプリの価格情報が含まれています。 このリソースには、次の値があります。

種類 説明
trialPeriod string アプリの試用期間を指定する文字列。 次のいずれかの値を指定できます。
  • NoFreeTrial
  • OneDay
  • TrialNeverExpires
  • SevenDays
  • 15Days
  • 30Days
marketSpecificPricings object キーと値のペアのディクショナリです。各キーは 2 文字の ISO 3166-1 alpha-2 の国コードで、各値は価格帯です。 これらの項目は、特定の市場でのアプリの カスタム価格を表します。 このディクショナリに含まれる項目は、指定された市場の priceId の値によって指定されている基本価格を上書きします。
営業 array 削除されました。 アプリの販売情報を含む セール リソース の配列。
priceId string アプリのベース価格を指定する価格レベル
isAdvancedPricingModel boolean true の場合、開発者アカウントは 0.99 USD ~ 1999.99 USD の拡張された価格セットにアクセスできます。 false の場合、開発者アカウントは 0.99 USD ~ 999.99 USD の元の価格帯セットにアクセスできます。 各種価格帯について詳しくは、「価格帯」をご覧ください。

このフィールドは読み取り専用です。

セール リソース

このリソースには、アプリの販売情報が含まれています。

重要

Sale リソースはサポートされなくなりました。現在、Microsoft Store 申請 API を使用してアプリ申請の販売データを取得または変更することはできません。 今後、Microsoft Store 申請 API を更新して、アプリ申請の販売情報にプログラムでアクセスする新しい方法を導入する予定です。

このリソースには、次の値があります。

種類 説明
name string セールの名前です。
basePriceId string セールの基本価格として使用する価格帯です。
startDate string ISO 8601 形式で表したセールの開始日です。
endDate string ISO 8601 形式で表したセールの終了日です。
marketSpecificPricings object キーと値のペアのディクショナリです。各キーは 2 文字の ISO 3166-1 alpha-2 の国コードで、各値は価格帯です。 これらの項目は、特定の市場でのアプリの カスタム価格を表します。 このディクショナリに含まれる項目は、指定された市場の basePriceId の値によって指定されている基本価格を上書きします。

登録情報リソース

このリソースには、アプリの一覧情報が含まれています。 このリソースには、次の値があります。

種類 説明
baseListing オブジェクト ベースの一覧アプリの情報。すべてのプラットフォームの既定の登録情報を定義します。
platformOverrides オブジェクト キーと値のペアのディクショナリ。各キーはリスト情報をオーバーライドするプラットフォームを識別する文字列であり、各値は ベースの一覧 リソース (説明からタイトルまでの値のみを含む) であり、指定されたプラットフォームでオーバーライドするリスト情報を指定します。 キーには、次の値を指定できます。
  • Unknown
  • Windows80
  • Windows81
  • WindowsPhone71
  • WindowsPhone80
  • WindowsPhone81

ベース リスト リソース

このリソースには、アプリのベース リスト情報が含まれています。 このリソースには、次の値があります。

種類 説明
copyrightAndTrademarkInfo string 省略可能な copyright または商標情報
keywords 配列 アプリを検索結果に表示するのに役立つ keyword の配列。
licenseTerms string アプリの省略可能な ライセンス条項
privacyPolicy string この値は廃止されています。 アプリのプライバシー ポリシーの URL を設定または変更するには、パートナー センターのプロパティ ページを使用する必要があります。 この値は、申請 API の呼び出しから省略できます。 この値を設定すると、無視されます。
supportContact string この値は廃止されています。 アプリのサポート連絡先の URL やメール アドレスを設定または変更するには、パートナー センターのプロパティ ページを使用する必要があります。 この値は、申請 API の呼び出しから省略できます。 この値を設定すると、無視されます。
websiteUrl string この値は廃止されています。 アプリの Web ページの URL を設定または変更するには、パートナー センターのプロパティ ページを使用する必要があります。 この値は、申請 API の呼び出しから省略できます。 この値を設定すると、無視されます。
description string アプリ一覧の 説明
features 配列 アプリの features を一覧表示する最大 20 個の文字列の配列。
releaseNotes string アプリの リリースノート
images 配列 アプリ一覧の イメージとアイコン リソースの配列。
recommendedHardware 配列 アプリの で推奨されるハードウェア構成 を一覧表示する最大 11 個の文字列の配列。
minimumHardware string アプリの minimum ハードウェア構成 を一覧表示する最大 11 個の文字列の配列。
タイトル string アプリの一覧のタイトル。
shortDescription string ゲームにのみ使用されます。 この説明は、Xbox One のゲーム ハブの Information セクションに表示され、お客様がゲームの詳細を理解するのに役立ちます。
shortTitle string あなたの製品名の短いバージョン。 提供された場合、この短い名前は、製品のフルタイトルの代わりに、Xbox Oneの様々な場所(インストール中、成果など)に現れる可能性がある。
sortTitle string 製品が異なる方法でアルファベット順に表示される場合は、ここで別のバージョンを入力できます。 これにより、顧客は検索時に製品をより迅速に見つけることができます。
voiceTitle string 提供された場合、キネクトまたはヘッドセットを使用する場合、Xbox Oneのオーディオエクスペリエンスで使用できる製品の別称。
devStudio string リストに Developed by フィールドを含める場合は、この値を指定します。 ( 発行者 フィールドには、 devStudio 値を指定したかどうかにかかわらず、アカウントに関連付けられている発行元の表示名が一覧表示されます。

イメージ リソース

このリソースには、アプリの一覧の画像とアイコンのデータが含まれています。 アプリの一覧の画像とアイコンの詳細については、「 App のスクリーンショットと画像を参照してください。 このリソースには、次の値があります。

種類 説明
fileName string 申請用にアップロードした ZIP アーカイブ内のイメージ ファイルの名前。
fileStatus string イメージ ファイルの状態。 次のいずれかの値を指定できます。
  • なし
  • PendingUpload
  • アップロード完了
  • PendingDelete
ID string イメージの ID。 この値はパートナー センターによって提供されます。
description string イメージの説明。
imageType string イメージの種類を示します。 現在、次の文字列がサポートされています。

スクリーンショットの画像:

  • スクリーンショット (デスクトップのスクリーンショットにこの値を使用)
  • MobileScreenshot
  • XboxScreenshot
  • SurfaceHubScreenshot
  • HoloLensScreenshot

ストア ロゴ:

  • StoreLogo9x16
  • StoreLogoSquare
  • アイコン (1:1 300 x 300 ピクセルのロゴにこの値を使用)

プロモーション画像:

  • PromotionalArt16x9
  • PromotionalArtwork2400X1200

Xbox イメージ:

  • XboxBrandedKeyArt
  • XboxTitledHeroArt
  • XboxFeaturedPromotionalArt

オプションのプロモーション 画像:

  • SquareIcon358X358
  • BackgroundImage1000X800
  • PromotionalArtwork414X180

ゲーム オプション リソース

このリソースには、アプリのゲーム関連の設定が含まれています。 このリソースの値は、パートナー センターの申請のゲーム設定に対応します。

{
  "gamingOptions": [
    {
      "genres": [
        "Games_ActionAndAdventure",
        "Games_Casino"
      ],
      "isLocalMultiplayer": true,
      "isLocalCooperative": true,
      "isOnlineMultiplayer": false,
      "isOnlineCooperative": false,
      "localMultiplayerMinPlayers": 2,
      "localMultiplayerMaxPlayers": 12,
      "localCooperativeMinPlayers": 2,
      "localCooperativeMaxPlayers": 12,
      "isBroadcastingPrivilegeGranted": true,
      "isCrossPlayEnabled": false,
      "kinectDataForExternal": "Enabled"
    }
  ],
}

このリソースには、次の値があります。

種類 説明
ジャンル 配列 ゲームのジャンルを記述する次の文字列の 1 つ以上の配列。
  • Games_ActionAndAdventure
  • Games_CardAndBoard
  • Games_Casino
  • Games_Educational
  • Games_FamilyAndKids
  • Games_Fighting
  • Games_Music
  • Games_Platformer
  • Games_PuzzleAndTrivia
  • Games_RacingAndFlying
  • Games_RolePlaying
  • Games_Shooter
  • Games_Simulation
  • Games_Sports
  • Games_Strategy
  • Games_Word
isLocalMultiplayer boolean ゲームがローカル マルチプレイヤーをサポートしているかどうかを示します。
isLocalCooperative boolean ゲームがローカル協力をサポートしているかどうかを示します。
isOnlineMultiplayer boolean ゲームがオンライン マルチプレイヤーをサポートしているかどうかを示します。
isOnlineCooperative boolean ゲームがオンライン協力をサポートしているかどうかを示します。
localMultiplayerMinPlayers int ローカル マルチプレイヤーでゲームがサポートするプレイヤーの最小数を指定します。
localMultiplayerMaxPlayers int ローカル マルチプレイヤーでゲームがサポートするプレイヤーの最大数を指定します。
localCooperativeMinPlayers int ゲームがローカル協力に対してサポートするプレイヤーの最小数を指定します。
localCooperativeMaxPlayers int ゲームがローカル協力に対してサポートするプレイヤーの最大数を指定します。
isBroadcastingPrivilegeGranted boolean ゲームがブロードキャストをサポートしているかどうかを示します。
isCrossPlayEnabled boolean ゲームが Windows 10 と Windows 11 PC と Xbox のプレイヤー間のマルチプレイヤー セッションをサポートしているかどうかを示します。
kinectDataForExternal string ゲームが Kinect データを収集して外部サービスに送信できるかどうかを示す次のいずれかの文字列値。
  • NotSet
  • Unknown
  • Enabled
  • 無効

Note

gamingOptions リソースは、Microsoft Store 申請 API が開発者に最初にリリースされた後、2017 年 5 月に追加されました。 このリソースが導入される前に申請 API を使用してアプリの申請を作成し、この申請がまだ進行中の場合、申請が正常にコミットされるか削除されるまで、このリソースはアプリの申請に対して null になります。 gamingOptionsリソースがアプリの申請に使用できない場合、Application リソースのhasAdvancedListingPermissionフィールドget an app メソッドによって返されます。

ステータスの詳細に関するリソース

このリソースには、申請の状態についての追加情報が保持されます。 このリソースには、次の値があります。

種類 説明
エラー object 申請のエラーの詳細が保持されるステータスの詳細リソースの配列です。
warnings object 申請の警告の詳細が保持されるステータスの詳細リソースの配列です。
certificationReports object 申請の認定レポート データへのアクセスを提供する認定レポート リソースです。 認定されなかった場合に、これらのレポートから詳しい情報を知ることができます。

ステータスの詳細に関するリソース

このリソースには、申請に関連するエラーや警告についての追加情報が保持されます。 このリソースには、次の値があります。

種類 説明
code string エラーや警告の種類を説明する申請ステータス コードです。
details string 問題についての詳細が含まれるメッセージです。

アプリケーション パッケージ リソース

このリソースには、申請のアプリ パッケージに関する詳細が含まれています。

{
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
}

このリソースには、次の値があります。

Note

update アプリの申請メソッドを呼び出す場合、要求本文には、fileNamefileStatusminimumDirectXVersion、および minimumSystemRam 値のみが必要です。 他の値はパートナー センターによって設定されます。

種類 説明
fileName string パッケージの名前です。
fileStatus string パッケージの状態。 次のいずれかの値を指定できます。
  • なし
  • PendingUpload
  • アップロード完了
  • PendingDelete
ID string パッケージを一意に識別する ID。 この値はパートナー センターによって提供されます。
version string アプリ パッケージのバージョン。 詳細については、「 Package のバージョン番号付けを参照してください。
アーキテクチャ string パッケージのアーキテクチャ (ARM など)。
言語 配列 アプリがサポートする言語の言語コードの配列。 詳細については、サポートされる言語 を参照してください。
capabilities 配列 パッケージに必要な機能の配列。 機能の詳細については、「 App capability 宣言」を参照してください。
minimumDirectXVersion string アプリ パッケージでサポートされている DirectX の最小バージョン。 これは、Windows 8.x を対象とするアプリに対してのみ設定できます。 他の OS バージョンを対象とするアプリの場合、 update a app submission メソッドを呼び出すときにこの値が存在する必要がありますが、指定した値は無視されます。 次のいずれかの値を指定できます。
  • なし
  • DirectX93
  • DirectX100
minimumSystemRam string アプリ パッケージに必要な最小 RAM。 これは、Windows 8.x を対象とするアプリに対してのみ設定できます。 他の OS バージョンを対象とするアプリの場合、 update a app submission メソッドを呼び出すときにこの値が存在する必要がありますが、指定した値は無視されます。 次のいずれかの値を指定できます。
  • なし
  • Memory2GB
targetDeviceFamilies 配列 パッケージが対象とするデバイス ファミリを表す文字列の配列。 この値は、Windows 10 を対象とするパッケージにのみ使用されます。以前のリリースを対象とするパッケージの場合、この値の値は None です。 現在、次のデバイス ファミリ文字列は Windows 10 および Windows 11 パッケージでサポートされています。 {0} は Windows 10 または Windows 11 のバージョン文字列 (10.0.10240.0、10.0.10586.0、10.0.14393.0 など) です。
  • Windows.Universal min バージョン {0}
  • Windows.Desktop の最小バージョン {0}
  • Windows.Mobile の最小バージョン {0}
  • Windows.Xbox の最小バージョン {0}
  • Windows.Holographic の最小バージョン {0}

id="certification-report-resource"

認定レポート リソース

このリソースは、申請の認定レポート データへのアクセスを提供します。 このリソースには、次の値があります。

種類 説明
date string ISO 8601 形式で表された、レポートが生成された日付と時刻です。
reportUrl string レポートにアクセスできる URL です。

パッケージ配信オプション リソース

このリソースには、申請の段階的なパッケージのロールアウトと必須の更新設定が含まれています。

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

このリソースには、次の値があります。

種類 説明
packageRollout オブジェクト 申請の段階的なパッケージ ロールアウト設定を含む パッケージ ロールアウト リソース
isMandatoryUpdate boolean この申請のパッケージを、アプリの更新プログラムの自己インストールに必須として扱うかどうかを示します。 アプリの更新プログラムを自己インストールするための必須パッケージの詳細については、「 アプリのパッケージ更新プログラムをダウンロードしてインストールするを参照してください。
mandatoryUpdateEffectiveDate 日付 この申請のパッケージが必須になる日時 (ISO 8601 形式と UTC タイム ゾーン)。

パッケージ ロールアウト リソース

このリソースには、申請の段階的な パッケージロールアウト設定 が含まれています。 このリソースには、次の値があります。

種類 説明
isPackageRollout boolean 申請に対して段階的なパッケージ ロールアウトが有効になっているかどうかを示します。
packageRolloutPercentage float 段階的なロールアウトでパッケージを受け取るユーザーの割合。
packageRolloutStatus string 段階的なパッケージロールアウトの状態を示す次のいずれかの文字列。
  • PackageRolloutNotStarted
  • PackageRolloutInProgress
  • PackageRolloutComplete
  • PackageRolloutStopped
fallbackSubmissionId string 段階的なロールアウト パッケージを取得しないお客様が受け取る申請の ID。

Note

packageRolloutStatusfallbackSubmissionId の値はパートナー センターで割り当てられます。これらの値は、開発者が設定する値ではありません。 これらの値を要求本文に含める場合、これらの値は無視されます。

Trailers リソース

このリソースは、アプリの一覧のビデオ トレーラーを表します。 このリソースの値は、パートナー センターの申請のトレーラー オプションに対応します。

app 申請リソース内の trailers 配列に最大 15 個のトレーラー リソースを追加できます。 提出用のトレーラー ビデオ ファイルとサムネイル 画像をアップロードするには、これらのファイルをパッケージを含む同じ ZIP アーカイブに追加し、申請の画像を一覧表示してから、この ZIP アーカイブを申請の Shared Access Signature (SAS) URI にアップロードします。 ZIP アーカイブを SAS URI にアップロードする方法の詳細については、「 アプリの申請を作成する」を参照してください。

{
  "trailers": [
    {
      "id": "1158943556954955699",
      "videoFileName": "Trailers\\ContosoGameTrailer.mp4",
      "videoFileId": "1159761554639123258",
      "trailerAssets": {
        "en-us": {
          "title": "Contoso Game",
          "imageList": [
            {
              "fileName": "Images\\ContosoGame-Thumbnail.png",
              "id": "1155546904097346923",
              "description": "This is a still image from the video."
            }
          ]
        }
      }
    }
  ]
}

このリソースには、次の値があります。

種類 説明
id string トレーラーの ID。 この値はパートナー センターによって提供されます。
videoFileName string 申請のファイルを含む ZIP アーカイブ内の予告編ビデオ ファイルの名前。
videoFileId string 予告編ビデオ ファイルの ID。 この値はパートナー センターによって提供されます。
trailerAssets オブジェクト キーと値のペアのディクショナリ。各キーは言語コードであり、各値はトレーラー用の追加のロケール固有の資産を含む の資産リソース です。 サポートされている言語コードの詳細については、「 サポートされている言語」を参照してください。

Note

trailers リソースは、Microsoft Store 申請 API が開発者に最初にリリースされた後、2017 年 5 月に追加されました。 このリソースが導入される前に申請 API を使用してアプリの申請を作成し、この申請がまだ進行中の場合、申請が正常にコミットされるか削除されるまで、このリソースはアプリの申請に対して null になります。 trailersリソースがアプリの申請に使用できない場合、get an app メソッドによって返される Application リソースの hasAdvancedListingPermission フィールドは false です。

トレーラー資産リソース

このリソースには、 trailer リソースで定義されているトレーラー用の追加のロケール固有の資産が含まれています。 このリソースには、次の値があります。

種類 説明
肩書き string トレーラーのローカライズされたタイトル。 ユーザーがトレーラーを全画面表示モードで再生すると、タイトルが表示されます。
imageList 配列 トレーラーのサムネイル画像を提供する 1 つの image リソースを含む配列。 この配列には、 image リソースを 1 つだけ含めることができます。

イメージ リソース (トレーラー用)

このリソースでは、トレーラーのサムネイル画像について説明します。 このリソースには、次の値があります。

種類 説明
fileName string 申請用にアップロードした ZIP アーカイブ内のサムネイル画像ファイルの名前。
ID string サムネイル画像の ID。 この値はパートナー センターによって提供されます。
description string サムネイル画像の説明。 この値はメタデータのみであり、ユーザーには表示されません。

列挙型

これらのメソッドでは、次の列挙型が使用されます。

価格レベル

次の値は、アプリ申請の pricing リソース リソースで使用可能な価格レベルを表します。

Value 説明
ベース 価格レベルは設定されていません。アプリの基本価格を使用します。
NotAvailable アプリは、指定されたリージョンでは使用できません。
Free このアプリは無料です。
Tierxxx Tierxxxx の形式で、アプリの価格レベルを指定する文字列。 現在のところ、次の範囲の価格帯がサポートされています。

  • 価格リソースisAdvancedPricingModel 値が true の場合、アカウントで利用可能な価格帯値は Tier1012 - Tier1424 です。
  • 価格リソースisAdvancedPricingModel 値が false の場合、アカウントで利用可能な価格帯値は Tier2 - Tier96 です。
各価格帯に関連付けられた市場固有の価格を含む、開発者アカウントで利用可能な価格帯の詳しい表を参照するには、パートナー センターでいずれかのアプリ申請の[価格と使用可能状況] ページにアクセスし、[市場と特別価格] セクションで [view table] (表を表示) リンクをクリックします (一部の開発者アカウントでは、このリンクは [Pricing] (価格) セクションにあります)。

エンタープライズ ライセンスの値

次の値は、アプリの組織のライセンス動作を表します。 これらのオプションの詳細については、「 Organizational ライセンス オプションを参照してください。

Note

申請 API を使用してアプリの申請の組織のライセンス オプションを構成することはできますが、この API を使用して、ビジネス向け Microsoft Storeと教育機関向け Microsoft Storeを通じてボリューム購入の申請を発行することはできません。 ビジネス向け Microsoft Store for Business や教育機関向け Microsoft Store に申請を公開するには、パートナー センターを使う必要があります。

Value 説明
なし ストアマネージド (オンライン) ボリューム ライセンスを使用する企業では、アプリを使用できるようにしないでください。
オンライン ストアマネージド (オンライン) ボリューム ライセンスを使用する企業がアプリを利用できるようにします。
OnlineAndOffline ストア管理 (オンライン) ボリューム ライセンスを持つ企業がアプリを利用できるようにすると共に、切断された (オフラインの) ライセンスを使用してアプリを企業が利用できるようにします。

申請の状態コード

次の値は、申請の状態コードを表します。

説明
なし コードが指定されていません。
InvalidArchive パッケージが含まれる ZIP アーカイブは無効であるか、認識できないアーカイブ形式です。
MissingFiles ZIP アーカイブに、申請データで指定されているすべてのファイルが含まれていないか、ファイルのアーカイブ内の場所が正しくありません。
PackageValidationFailed 申請の 1 つ以上のパッケージを検証できませんでした。
InvalidParameterValue 要求本文に含まれるパラメーターの 1 つが無効です。
InvalidOperation 実行された操作は無効です。
InvalidState 実行された操作は、パッケージ フライトの現在の状態では無効です。
ResourceNotFound 指定されたパッケージ フライトは見つかりませんでした。
ServiceError 内部サービス エラーのため、要求を処理できませんでした。 もう一度要求を行ってください。
ListingOptOutWarning 開発者が以前の申請の登録情報を削除しているか、パッケージによってサポートされる登録情報を含めていませんでした。
ListingOptInWarning 開発者が登録情報を追加しました。
UpdateOnlyWarning 開発者が、更新サポートしかないものを挿入しようとしています。
その他 申請が非認識または未分類の状態です。
PackageValidationWarning パッケージ検証プロセスの結果、警告が生成されました。