アプリの申請の管理Manage app submissions

Microsoft Store 申請 API には、段階的なパッケージのロールアウトなど、アプリの申請を管理するために使用できるメソッドが用意されています。The Microsoft Store submission API provides methods you can use to manage submissions for your apps, including gradual package rollouts. Microsoft Store 申請 API の概要については、「Microsoft Store サービスを使用した申請の作成と管理」をご覧ください。この API を使用するための前提条件などの情報があります。For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

重要

Microsoft Store 送信 API を使用して、アプリの提出を作成すると、必ずを変更するさらに、送信のみパートナー センターではなく、API を使用してください。If you use the Microsoft Store submission API to create a submission for an app, be sure to make further changes to the submission only by using the API, rather than Partner Center. パートナー センターを使用して API を使用して作成した元の送信を変更する場合は、変更、または API を使用して送信をコミットすることはできなくなります。If you use Partner Center to change a submission that you originally created by using the API, you will no longer be able to change or commit that submission by using the API. 場合によっては、申請がエラー状態のままになり、申請プロセスを進めることができなくなります。In some cases, the submission could be left in an error state where it cannot proceed in the submission process. この場合、申請を削除して新しい申請を作成する必要があります。If this occurs, you must delete the submission and create a new submission.

重要

この API を使って、ビジネス向け Microsoft Store や教育機関向け Microsoft Store でのボリューム購入の申請を公開したり、LOB アプリの申請を直接企業に発行したりすることはできません。You cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education or to publish submissions for LOB apps directly to enterprises. 両方のシナリオには、パートナー センターを使用して、送信を発行する必要があります。For both of these scenarios, you must use Partner Center to publish the submission.

アプリの申請を管理するためのメソッドMethods for managing app submissions

アプリの申請を取得、作成、更新、コミット、または削除するには、次のメソッドを使用します。Use the following methods to get, create, update, commit, or delete an app submission. これらのメソッドを使用する前に、アプリは、パートナー センター アカウントに既に存在する必要があり、パートナー センターでアプリの 1 つのサブミッションを初めて作成する必要があります。Before you can use these methods, the app must already exist in your Partner Center account and you must first create one submission for the app in Partner Center. 詳しくは、「前提条件」をご覧ください。For more information, see the prerequisites.

メソッドMethod URIURI 説明Description
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} 既存のアプリの提出を取得します。Get an existing app submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status 既存のアプリの送信の状態を取得します。Get the status of an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions 新しいアプリの提出を作成します。Create a new app submission
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} 既存のアプリの申請を更新します。Update an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit 新規または更新済みのアプリの提出をコミットします。Commit a new or updated app submission
DelDELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} アプリの提出を削除します。Delete an app submission

アプリの申請の作成Create an app submission

アプリの申請を作成するには、次のプロセスに従います。To create a submission for an app, follow this process.

  1. Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.

    注意

    年齢区分の情報を含む 1 つ以上の申請がアプリで既に完了していることを確認します。Make sure the app already has at least one completed submission with the age ratings information completed.

  2. Azure AD のアクセス トークンを取得しますObtain an Azure AD access token. このアクセス トークンを Microsoft Store 申請 API のメソッドに渡す必要があります。You must pass this access token to the methods in the Microsoft Store submission API. アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。After you obtain an access token, you have 60 minutes to use it before it expires. トークンの有効期限が切れたら新しいトークンを取得できます。After the token expires, you can obtain a new one.

  3. Microsoft Store 申請 API の次のメソッドを実行して、アプリの申請を作成します。Create an app submission by executing the following method in the Microsoft Store submission API. このメソッドによって、新しい申請が作成され、審査中になります。これは、前回発行した申請のコピーです。This method creates a new in-progress submission, which is a copy of your last published submission.

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

    応答本文には、新しい申請の ID、申請用の関連ファイル (アプリ パッケージ、登録情報の画像、トレーラー ファイルなど) を Azure Blob Storage にアップロードするための共有アクセス署名 (SAS) URI、および新しい申請のすべてのデータ (登録情報や価格情報など) が含まれたアプリの申請リソースが含まれています。The response body contains an app submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any related files for the submission to Azure Blob storage (such as app packages, listing images, and trailer files), and all of the data for the new submission (such as the listings and pricing information).

    注意

    SAS URI では、アカウント キーを必要とせずに、Azure Storage 内のセキュリティで保護されたリソースにアクセスできます。A SAS URI provides access to a secure resource in Azure storage without requiring account keys. SAS URI の背景情報と Azure Blob Storage での SAS URI の使用については、Shared Access Signature 第 1 部: SAS モデルについてShared Access Signature、第 2 部。作成し、Blob storage では、SAS を使用してします。For background information about SAS URIs and their use with Azure Blob storage, see Shared Access Signatures, Part 1: Understanding the SAS model and Shared Access Signatures, Part 2: Create and use a SAS with Blob storage.

  4. 申請用に新しいパッケージ、登録情報の画像、またはトレーラー ファイルを追加する場合は、アプリのパッケージを準備し、アプリのスクリーンショット、画像、およびトレーラーを準備します。If you are adding new packages, listing images, or trailer files for the submission, prepare the app packages and prepare the app screenshots, images, and trailers. これらのファイルをすべてまとめて ZIP アーカイブに追加します。Add all of these files to a ZIP archive.

  5. 新しい申請用に必要な変更を行ってアプリの申請データを修正し、次のメソッドを実行してアプリの申請を更新します。Revise the app submission data with any required changes for the new submission, and execute the following method to update the app submission.

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

    注意

    申請用に新しいファイルを追加する場合、ZIP アーカイブ内の新しいファイルの名前と相対パスを参照するように、申請データを更新してください。If you are adding new files for the submission, make sure you update the submission data to refer to the name and relative path of these files in the ZIP archive.

  6. 申請用に新しいパッケージ、登録情報の画像、またはトレーラー ファイルを追加する場合は、上記で呼び出した POST メソッドの応答本文に含まれていた SAS URI を使用して、ZIP アーカイブを Azure Blob Storage にアップロードします。If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive to Azure Blob storage using the SAS URI that was provided in the response body of the POST method you called earlier. さまざまなプラットフォームでこれを行うために使用できる、次のようなさまざまな Azure ライブラリがあります。There are different Azure libraries you can use to do this on a variety of platforms, including:

    次の C# コード例は、.NET 用 Azure Storage クライアント ライブラリの CloudBlockBlob クラスを使用して ZIP アーカイブを Azure Blob Storage にアップロードする方法を示しています。The following C# code example demonstrates how to upload a ZIP archive to Azure Blob storage using the CloudBlockBlob class in the Azure Storage Client Library for .NET. この例では、ZIP アーカイブが既にストリーム オブジェクトに書き込まれていることを前提としています。This example assumes that the ZIP archive has already been written to a stream object.

    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. 次のメソッドを実行して、アプリの申請をコミットします。Commit the app submission by executing the following method. お客様の提出を終了することと、自分のアカウントに、更新プログラムが適用されるようになりましたことは、パートナー センターが警告されます。This will alert Partner Center that you are done with your submission and that your updates should now be applied to your account.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit
    
  8. 次のメソッドを実行してアプリの申請の状態を取得して、コミット状態を確認します。Check on the commit status by executing the following method to get the status of the app submission.

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

    申請の状態を確認するには、応答本文の status の値を確認します。To confirm the submission status, review the status value in the response body. この値が CommitStarted から PreProcessing (要求が成功した場合) または CommitFailed (要求でエラーが発生した場合) に変わっています。This value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. エラーがある場合は、statusDetails フィールドにエラーについての詳細情報が含まれています。If there are errors, the statusDetails field contains further details about the error.

  9. コミットが正常に処理されると、インジェストのために申請がストアに送信されます。After the commit has successfully completed, the submission is sent to the Store for ingestion. 前のメソッドを使用するか、パートナー センターにアクセスして、送信進行状況を監視できます。You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

段階的なパッケージのロールアウトを管理するためのメソッドMethods for managing a gradual package rollout

アプリの申請で更新されたパッケージを、アプリの Windows 10 のユーザーの一部に、段階的にロールアウトできます。You can gradually roll out the updated packages in an app submission to a percentage of your app’s customers on Windows 10. これにより、更新に確信が持てるよう、特定のパッケージのフィードバックと分析データを監視してから、より広くロールアウトできます。This allows you to monitor feedback and analytic data for the specific packages to make sure you’re confident about the update before rolling it out more broadly. 新しい申請を作成することなく、公開された申請のロールアウトの割合を変更する (または更新を停止する) ことができます。You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. 詳細については、有効にして、パートナー センターでのパッケージを段階的なロールアウトを管理する方法の手順などを参照してください今回します。For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

アプリの申請の段階的なパッケージのロールアウトをプログラムによって有効化するには、Microsoft Store 申請 API のメソッドを使用して、次の手順に従います。To programmatically enable a gradual package rollout for an app submission, follow this process using methods in the Microsoft Store submission API:

  1. アプリの申請を作成するか、既存のアプリの申請を取得します。Create an app submission or get an existing app submission.
  2. 応答データで、packageRollout リソースを探し、 [isPackageRollout] フィールドを [true] に設定し、 [packageRolloutPercentage] フィールドに、アプリのユーザーが更新されたパッケージを取得する割合を設定します。In the response data, locate the packageRollout resource, set the isPackageRollout field to true, and set the packageRolloutPercentage field to the percentage of your app's customers who should get the updated packages.
  3. アプリの申請の更新のメソッドに、更新されたアプリの申請データを渡します。Pass the updated app submission data to the update an app submission method.

アプリの申請の段階的なパッケージのロールアウトが有効化された後、段階的なロールアウトをプログラムで取得、更新、停止、または完了するには、次のメソッドを使用できます。After a gradual package rollout is enabled for an app submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

メソッドMethod URIURI 説明Description
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout アプリの提出の段階的なロールアウト情報を取得します。Get the gradual rollout info for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage アプリの提出を段階的なロールアウト率を更新します。Update the gradual rollout percentage for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout アプリの提出を段階的なロールアウトを停止します。Halt the gradual rollout for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout アプリの提出を段階的なロールアウトを最終処理します。Finalize the gradual rollout for an app submission

アプリの申請を管理するためのコード例Code examples for managing app submissions

次の記事では、さまざまなプログラミング言語でアプリの申請を作成する方法を説明する詳しいコード例を紹介します。The following articles provide detailed code examples that demonstrate how to create an app submission in several different programming languages:

StoreBroker PowerShell モジュールStoreBroker PowerShell module

Microsoft Store 申請 API を直接呼び出す代わりに、API の上にコマンド ライン インターフェイスを実装するオープンソースの PowerShell モジュールも用意されています。As an alternative to calling the Microsoft Store submission API directly, we also provide an open-source PowerShell module which implements a command-line interface on top of the API. このモジュールは、StoreBroker と呼ばれています。This module is called StoreBroker. このモジュールを使うと、Microsoft Store 申請 API を直接呼び出さずに、コマンド ラインからアプリ、フライト、アドオンの申請を管理できます。また、ソースを参照して、この API を呼び出す方法の例を確認することもできます。You can use this module to manage your app, flight, and add-on submissions from the command line instead of calling the Microsoft Store submission API directly, or you can simply browse the source to see more examples for how to call this API. StoreBroker モジュールは、多くのファースト パーティ アプリケーションをストアに申請する主要な方法として Microsoft 内で積極的に使っています。The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

詳しくは、GitHub の StoreBroker に関するページをご覧ください。For more information, see our StoreBroker page on GitHub.

データ リソースData resources

アプリの申請を管理するための Microsoft Store 申請 API のメソッドでは、次の JSON データ リソースが使われます。The Microsoft Store submission API methods for managing app submissions use the following JSON data resources.

アプリの申請のリソースApp submission resource

このリソースは、アプリの申請を記述しています。This resource describes an app submission.

{
  "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": []
}

このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
idid stringstring 申請 ID。The ID of the submission. この ID は、アプリの申請の作成要求、すべてのアプリの取得要求、アプリの取得要求に対する応答データで確認できます。This ID is available in the response data for requests to create an app submission, get all apps, and get an app. パートナー センターで作成された送信、この ID はパートナー センターでの送信 ページの URL で使用できるも。For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.
applicationCategoryapplicationCategory stringstring アプリのカテゴリとサブカテゴリを指定する文字列です。A string that specifies the category and/or subcategory for your app. カテゴリとサブカテゴリは、アンダースコア "" で 1 つの文字列に連結します (例: BooksAndReference_EReader)。Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
pricingpricing オブジェクトobject アプリの価格設定情報が保持される価格リソースです。A pricing resource that contains pricing info for the app.
visibilityvisibility stringstring アプリの可視性です。The visibility of the app. 次のいずれかの値を使用できます。This can be one of the following values:
  • HiddenHidden
  • パブリックPublic
  • PrivatePrivate
  • NotSetNotSet
targetPublishModetargetPublishMode stringstring 申請の公開モードです。The publish mode for the submission. 次のいずれかの値を使用できます。This can be one of the following values:
  • 即時Immediate
  • ManualManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring targetPublishMode が SpecificDate に設定されている場合、ISO 8601 形式での申請の公開日です。The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
listingslistings オブジェクトobject キーと値のペアのディクショナリです。各キーは国コード、各値はアプリの登録情報を含む登録情報リソース オブジェクトです。A dictionary of key and value pairs, where each key is a country code and each value is a listing resource that contains listing info for the app.
hardwarePreferenceshardwarePreferences arrayarray アプリのハードウェアの基本設定を定義する文字列の配列です。An array of strings that define the hardware preferences for your app. 次のいずれかの値を使用できます。This can be one of the following values:
  • タッチTouch
  • キーボードKeyboard
  • マウスMouse
  • CameraCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • TelephonyTelephony
automaticBackupEnabledautomaticBackupEnabled booleanboolean OneDrive への自動バックアップにアプリのデータを含めることができるかどうかを示します。Indicates whether Windows can include your app's data in automatic backups to OneDrive. 詳しくは、「アプリの宣言」をご覧ください。For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean ユーザーがアプリをリムーバブル記憶域にインストールできるかどうかを示します。Indicates whether customers can install your app to removable storage. 詳しくは、「アプリの宣言」をご覧ください。For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean アプリのゲーム録画が有効になっているかどうかを示します。Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions arrayarray アプリのゲーム関連の設定を定義する 1 つのゲーム オプション リソースを格納する配列です。An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean ユーザーが Microsoft Store コマース システムを使わないで購入することをアプリが許可するかどうかを示します。Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. 詳しくは、「アプリの宣言」をご覧ください。For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean アプリがアクセシビリティ ガイドラインを満たことをテストされているかどうかを示します。Indicates whether your app has been tested to meet accessibility guidelines. 詳しくは、「アプリの宣言」をご覧ください。For more information, see App declarations.
notesForCertificationnotesForCertification stringstring アプリの認定の注意書きが含まれます。Contains notes for certification for your app.
statusstatus stringstring 申請の状態。The status of the submission. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • 公開Publishing
  • 公開済みPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • 認定Certification
  • CertificationFailedCertificationFailed
  • リリースRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails オブジェクトobject エラーに関する情報など、申請のステータスに関する追加情報が保持されるステータスの詳細に関するリソースです。A status details resource that contains additional details about the status of the submission, including information about any errors.
fileUploadUrlfileUploadUrl stringstring 申請のパッケージのアップロードに使用する共有アクセス署名 (SAS) URI です。The shared access signature (SAS) URI for uploading any packages for the submission. 申請用に新しいパッケージ、登録情報の画像、またはトレーラー ファイルを追加する場合は、パッケージと画像を含む ZIP アーカイブをこの URI にアップロードします。If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive that contains the packages and images to this URI. 詳しくは、「アプリの申請の作成」をご覧ください。For more information, see Create an app submission.
applicationPackagesapplicationPackages arrayarray 申請の各パッケージに関する詳細を提供するアプリケーション パッケージ リソースの配列です。An array of application package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions オブジェクトobject 申請の段階的なパッケージのロールアウトと必須の更新の設定が含まれたパッケージ配布オプション リソースです。A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
enterpriseLicensingenterpriseLicensing stringstring アプリのエンタープライズ ライセンス動作を示すエンタープライズ ライセンス値のいずれかです。One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosoftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean アプリを将来の Windows 10 デバイス ファミリで利用できるようにすることを Microsoft が許可されているかどうかを示すします。Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies オブジェクトobject キーと値のペアのディクショナリです。各キーは Windows 10 デバイス ファミリ を表し、各値は指定されたデバイス ファミリをアプリがターゲットにできるかどうかを示すブール値です。A dictionary of key and value pairs, where each key is a Windows 10 device family and each value is a boolean that indicates whether your app is allowed to target the specified device family.
friendlyNamefriendlyName stringstring パートナー センターで示すように、送信のフレンドリ名。The friendly name of the submission, as shown in Partner Center. この値は、申請を作成するときに生成されます。This value is generated for you when you create the submission.
trailerstrailers arrayarray アプリの登録情報用のビデオ トレーラーを表すトレーラー リソースを 15 個まで格納する配列です。An array that contains up to 15 trailer resources that represent video trailers for the app listing.

価格リソースPricing resource

このリソースにはアプリの価格設定情報が保持されます。This resource contains pricing info for the app. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
trialPeriodtrialPeriod stringstring アプリの試用期間を示す文字列です。A string that specifies the trial period for the app. 次のいずれかの値を使用できます。This can be one of the following values:
  • NoFreeTrialNoFreeTrial
  • OneDayOneDay
  • TrialNeverExpiresTrialNeverExpires
  • SevenDaysSevenDays
  • FifteenDaysFifteenDays
  • ThirtyDaysThirtyDays
marketSpecificPricingsmarketSpecificPricings オブジェクトobject キーと値のペアのディクショナリです。各キーは 2 文字の ISO 3166-1 alpha-2 の国コードで、各値は価格帯です。A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. これらの項目は、特定の市場でのアプリのカスタム価格を表します。These items represent the custom prices for your app in specific markets. このディクショナリに含まれる項目は、指定された市場の priceId の値によって指定されている基本価格を上書きします。Any items in this dictionary override the base price specified by the priceId value for the specified market.
salessales arrayarray 推奨されなくなった値です。Deprecated. アプリの販売情報が保持される販売リソースの配列です。An array of sale resources that contain sales information for the app.
priceIdpriceId stringstring アプリの基本価格を規定する価格帯です。A price tier that specifies the base price for the app.
isAdvancedPricingModelisAdvancedPricingModel booleanboolean true の場合、開発者アカウントは 0.99 USD ~ 1999.99 USD の拡張された価格セットにアクセスできます。If true, your developer account has access to the expanded set of price tiers from .99 USD to 1999.99 USD. false の場合、開発者アカウントは 0.99 USD ~ 999.99 USD の元の価格帯セットにアクセスできます。If false, your developer account has access to the original set of price tiers from .99 USD to 999.99 USD. 各種価格帯について詳しくは、「価格帯」をご覧ください。For more information about the different tiers, see price tiers.

  このフィールドは読み取り専用です。Note  This field is read-only.

セール リソースSale resource

このリソースにはアプリのセール情報が保持されます。This resources contains sale info for an app.

重要

セール リソースはサポートを終了しました。現在、Microsoft Store 申請 API を使ってアプリの申請の販売データを取得または変更することはできません。The Sale resource is no longer supported, and currently you cannot get or modify the sale data for an app submission using the Microsoft Store submission API. 将来的には、Microsoft Store 申請 API を更新して、アプリの申請のセール情報にプログラムでアクセスする新しい方法を導入する予定です。In the future, we will update the Microsoft Store submission API to introduce a new way to programmatically access sales information for app submissions.

  • アプリの申請を取得する GET メソッドを呼び出すと、セール リソースは空になります。After calling the GET method to get an app submission, the sales value will be empty. パートナー センターを使用して、アプリの提出の販売データを取得する続行することができます。You can continue to use Partner Center to get the sale data for your app submission.
  • アプリの申請を更新する PUT メソッドを呼び出すとき、セールの値に含まれた情報は無視されます。When calling the PUT method to update an app submission, the information in the sales value is ignored. パートナー センターを使用して、アプリの提出の販売データを変更する続行することができます。You can continue to use Partner Center to change the sale data for your app submission.

このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
namename stringstring セールの名前です。The name of the sale.
basePriceIdbasePriceId stringstring セールの基本価格として使用する価格帯です。The price tier to use for the base price of the sale.
startDatestartDate stringstring ISO 8601 形式で表したセールの開始日です。The start date for the sale in ISO 8601 format.
endDateendDate stringstring ISO 8601 形式で表したセールの終了日です。The end date for the sale in ISO 8601 format.
marketSpecificPricingsmarketSpecificPricings オブジェクトobject キーと値のペアのディクショナリです。各キーは 2 文字の ISO 3166-1 alpha-2 の国コードで、各値は価格帯です。A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. これらの項目は、特定の市場でのアプリのカスタム価格を表します。These items represent the custom prices for your app in specific markets. このディクショナリに含まれる項目は、指定された市場の basePriceId の値によって指定されている基本価格を上書きします。Any items in this dictionary override the base price specified by the basePriceId value for the specified market.

登録情報リソースListing resource

このリソースにはアプリの登録情報が保持されます。This resource contains listing info for an app. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
baseListingbaseListing オブジェクトobject アプリの基本の登録情報です。これはすべてのプラットフォームで既定の登録情報となります。The base listing info for the app, which defines the default listing info for all platforms.
platformOverridesplatformOverrides オブジェクトobject キーと値のペアのディクショナリです。各キーは、登録情報を上書きするプラットフォームを示す文字列を表し、各値は、指定されたプラットフォームで上書きする登録情報を示す基本の登録情報リソース (description から title までの値のみが保持されています) を表します。A dictionary of key and value pairs, where each key is string that identifies a platform for which to override the listing info, and each value is a base listing resource (containing only the values from description to title) that specifies the listing info to override for the specified platform. キーには次の値を設定できます。The keys can have the following values:
  • UnknownUnknown
  • Windows80Windows80
  • Windows81Windows81
  • WindowsPhone71WindowsPhone71
  • WindowsPhone80WindowsPhone80
  • WindowsPhone81WindowsPhone81

基本の登録情報リソースBase listing resource

このリソースにはアプリの基本の登録情報が保持されます。This resource contains base listing info for an app. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
copyrightAndTrademarkInfocopyrightAndTrademarkInfo stringstring (省略可能) 著作権や商標の情報です。Optional copyright and/or trademark info.
keywordskeywords arrayarray 結果にアプリが表示される確率を高めるキーワードの配列です。An array of keyword to help your app appear in search results.
licenseTermslicenseTerms stringstring アプリのライセンス条項 (省略可能) です。The optional license terms for your app.
privacyPolicyprivacyPolicy stringstring この値は使われなくなりました。This value is obsolete. を設定またはアプリのプライバシー ポリシー URL を変更する必要がありますこれを行う上、プロパティパートナー センターでのページ。To set or change the privacy policy URL for your app, you must do this on the Properties page in Partner Center. この値は、申請 API の呼び出しから省略することができます。You can omit this value from your calls to the submission API. この値を設定しても無視されます。If you set this value, it will be ignored.
supportContactsupportContact stringstring この値は使われなくなりました。This value is obsolete. を設定またはアプリのサポートの連絡先 URL または電子メールのアドレスを変更する必要がありますこれを行う上、プロパティパートナー センターでのページ。To set or change the support contact URL or email address for your app, you must do this on the Properties page in Partner Center. この値は、申請 API の呼び出しから省略することができます。You can omit this value from your calls to the submission API. この値を設定しても無視されます。If you set this value, it will be ignored.
websiteUrlwebsiteUrl stringstring この値は使われなくなりました。This value is obsolete. を設定またはアプリの web ページの URL を変更する必要がありますこれを行う上、プロパティパートナー センターでのページ。To set or change the URL of the web page for your app, you must do this on the Properties page in Partner Center. この値は、申請 API の呼び出しから省略することができます。You can omit this value from your calls to the submission API. この値を設定しても無視されます。If you set this value, it will be ignored.
descriptiondescription stringstring アプリの登録情報の説明です。The description for the app listing.
featuresfeatures arrayarray アプリの機能を示す最大 20 個の文字列の配列です。An array of up to 20 strings that list the features for your app.
releaseNotesreleaseNotes stringstring アプリのリリース ノートです。The release notes for your app.
imagesimages arrayarray アプリの登録情報の画像とアイコンのリソースの配列です。An array of image and icon resources for the app listing.
recommendedHardwarerecommendedHardware arrayarray アプリの推奨されるハードウェア構成を示す最大 11 個の文字列の配列です。An array of up to 11 strings that list the recommended hardware configurations for your app.
minimumHardwareminimumHardware stringstring アプリの最小ハードウェア構成を示す最大 11 個の文字列の配列です。An array of up to 11 strings that list the minimum hardware configurations for your app.
titletitle stringstring アプリの登録情報のタイトルです。The title for the app listing.
shortDescriptionshortDescription stringstring ゲームにのみ使用されます。Only used for games. この説明は、Xbox One のゲーム ハブにある [情報] セクションに表示され、ユーザーがどのようなゲームかを理解するのに役立ちます。This description appears in the Information section of the Game Hub on Xbox One, and helps customers understand more about your game.
shortTitleshortTitle stringstring 製品の名前の短いバージョン。A shorter version of your product’s name. 指定した場合、Xbox One のさまざまな場所 (インストール時や [実績] など) で製品のフル タイトルの代わりにこの短い名前が表示されることがあります。If provided, this shorter name may appear in various places on Xbox One (during installation, in Achievements, etc.) in place of the full title of your product.
sortTitlesortTitle stringstring 製品のアルファベット表記が複数ある場合、ここに別のバージョンを入力できます。If your product could be alphabetized in different ways, you can enter another version here. これにより、ユーザーが検索したときに製品がすばやく見つかるようになる可能性があります。This may help customers find the product more quickly when searching.
voiceTitlevoiceTitle stringstring Kinect やヘッドセットを使うときに Xbox One のオーディオ エクスペリエンスで使われる、製品の代替名 (ある場合)。An alternate name for your product that, if provided, may be used in the audio experience on Xbox One when using Kinect or a headset.
devStudiodevStudio stringstring 登録情報に [Developed by] (開発元) フィールドを含める必要がある場合はこの値を指定しますSpecify this value if you want to include a Developed by field in the listing. (devStudio 値の指定とは関係なく、 [公開元] フィールドにはアカウントに関連付けられた発行者の表示名が示されます)。(The Published by field will list the publisher display name associated with your account, whether or not you provide a devStudio value.)

画像リソースImage resource

このリソースにはアプリの登録情報の画像とアイコンのデータが保持されます。This resource contains image and icon data for an app listing. アプリの登録情報の画像とアイコンについて詳しくは、「アプリのスクリーンショットと画像」をご覧ください。For more information about images and icons for an app listing, see App screenshots and images. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
fileNamefileName stringstring 申請用にアップロードした ZIP アーカイブに含まれている画像ファイルの名前です。The name of the image file in the ZIP archive that you uploaded for the submission.
fileStatusfileStatus stringstring 画像ファイルの状態です。The status of the image file. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • PendingUploadPendingUpload
  • UploadedUploaded
  • PendingDeletePendingDelete
idid stringstring 画像の ID です。The ID for the image. この値は、パートナー センターによって提供されます。This value is supplied by Partner Center.
descriptiondescription stringstring 画像の説明です。The description for the image.
imageTypeimageType stringstring 画像の種類を示します。Indicates the type of the image. 現在サポートされている文字列は次のとおりです。The following strings are currently supported.

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

  • Screenshot (デスクトップのスクリーンショットにはこの値を使用します)Screenshot (use this value for the desktop screenshot)
  • MobileScreenshotMobileScreenshot
  • XboxScreenshotXboxScreenshot
  • SurfaceHubScreenshotSurfaceHubScreenshot
  • HoloLensScreenshotHoloLensScreenshot

ストア ロゴ:Store logos:

  • StoreLogo9x16StoreLogo9x16
  • StoreLogoSquareStoreLogoSquare
  • Icon (1:1 の 300 x 300 ピクセルのロゴにはこの値を使用します)Icon (use this value for the 1:1 300 x 300 pixels logo)

プロモーション画像:Promotional images:

  • PromotionalArt16x9PromotionalArt16x9
  • PromotionalArtwork2400X1200PromotionalArtwork2400X1200

Xbox 画像:Xbox images:

  • XboxBrandedKeyArtXboxBrandedKeyArt
  • XboxTitledHeroArtXboxTitledHeroArt
  • XboxFeaturedPromotionalArtXboxFeaturedPromotionalArt

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

  • SquareIcon358X358SquareIcon358X358
  • BackgroundImage1000X800BackgroundImage1000X800
  • PromotionalArtwork414X180PromotionalArtwork414X180

ゲーム オプション リソースGaming options resource

このリソースにはアプリのゲーム関連の設定が保持されます。This resource contains game-related settings for the app. このリソースの値に対応して、ゲーム設定のパートナー センターで送信します。The values in this resource correspond to the game settings for submissions in Partner Center.

{
  "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"
    }
  ],
}

このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
genresgenres arrayarray ゲームのジャンルを説明する次の 1 つ以上の文字列の配列です。An array of one or more of the following strings that describe the genres of the game:
  • Games_ActionAndAdventureGames_ActionAndAdventure
  • Games_CardAndBoardGames_CardAndBoard
  • Games_CasinoGames_Casino
  • Games_EducationalGames_Educational
  • Games_FamilyAndKidsGames_FamilyAndKids
  • Games_FightingGames_Fighting
  • Games_MusicGames_Music
  • Games_PlatformerGames_Platformer
  • Games_PuzzleAndTriviaGames_PuzzleAndTrivia
  • Games_RacingAndFlyingGames_RacingAndFlying
  • Games_RolePlayingGames_RolePlaying
  • Games_ShooterGames_Shooter
  • Games_SimulationGames_Simulation
  • Games_SportsGames_Sports
  • Games_StrategyGames_Strategy
  • Games_WordGames_Word
isLocalMultiplayerisLocalMultiplayer booleanboolean ゲームでローカル マルチプレイヤーがサポートされているかどうかを示します。Indicates whether the game supports local multiplayer.
isLocalCooperativeisLocalCooperative booleanboolean ゲームでローカル協力プレイがサポートされているかどうかを示します。Indicates whether the game supports local co-op.
isOnlineMultiplayerisOnlineMultiplayer booleanboolean ゲームでオンライン マルチプレイヤーがサポートされているかどうかを示します。Indicates whether the game supports online multiplayer.
isOnlineCooperativeisOnlineCooperative booleanboolean ゲームでオンライン協力プレイがサポートされているかどうかを示します。Indicates whether the game supports online co-op.
localMultiplayerMinPlayerslocalMultiplayerMinPlayers intint ゲームでサポートされるローカル マルチプレイヤーの最小プレイヤー数を指定します。Specifies the minimum number of players the game supports for local multiplayer.
localMultiplayerMaxPlayerslocalMultiplayerMaxPlayers intint ゲームでサポートされるローカル マルチプレイヤーの最大プレイヤー数を指定します。Specifies the maximum number of players the game supports for local multiplayer.
localCooperativeMinPlayerslocalCooperativeMinPlayers intint ゲームでサポートされるローカル協力プレイの最小プレイヤー数を指定します。Specifies the minimum number of players the game supports for local co-op.
localCooperativeMaxPlayerslocalCooperativeMaxPlayers intint ゲームでサポートされるローカル協力プレイの最大プレイヤー数を指定します。Specifies the maximum number of players the game supports for local co-op.
isBroadcastingPrivilegeGrantedisBroadcastingPrivilegeGranted booleanboolean ゲームでブロードキャストがサポートされているかどうかを示します。Indicates whether the game supports broadcasting.
isCrossPlayEnabledisCrossPlayEnabled booleanboolean ゲームで Windows 10 PC と Xbox のプレイヤー間でのマルチプレイヤー セッションがサポートされているかどうかを示します。Indicates whether the game supports multiplayer sessions between players on Windows 10 PCs and Xbox.
kinectDataForExternalkinectDataForExternal stringstring 次の各文字列値は、ゲームで Kinect データを収集し、外部サービスに送信できるかどうかを示します。One of the following string values that indicates whether the game can collect Kinect data and send it to external services:
  • NotSetNotSet
  • UnknownUnknown
  • 有効Enabled
  • DisabledDisabled

注意

gamingOptions リソースは、Microsoft Store 申請 API が開発者向けに最初にリリースされた後、2017 年 5 月に追加されました。The gamingOptions resource was added in May 2017, after the Microsoft Store submission API was first released to developers. このリソースが導入される前に申請 API を通じててアプリの申請を作成し、その申請がまだ審査中の場合、申請を正常にコミットするか削除するまで、アプリの申請に対するこのリソースは null になります。If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. アプリの申請で gamingOptions リソースが利用できない場合、アプリの取得メソッドから返されるアプリケーション リソースhasAdvancedListingPermission フィールドは false になります。If the gamingOptions resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

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

このリソースには、申請の状態についての追加情報が保持されます。This resource contains additional details about the status of a submission. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
errorserrors オブジェクトobject 申請のエラーの詳細が保持されるステータスの詳細リソースの配列です。An array of status detail resources that contain error details for the submission.
warningswarnings オブジェクトobject 申請の警告の詳細が保持されるステータスの詳細リソースの配列です。An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports オブジェクトobject 申請の認定レポート データへのアクセスを提供する認定レポート リソースです。An array of certification report resources that provide access to the certification report data for the submission. 認定されなかった場合に、これらのレポートから詳しい情報を知ることができます。You can examine these reports for more information if the certification fails.

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

このリソースには、申請に関連するエラーや警告についての追加情報が保持されます。This resource contains additional information about any related errors or warnings for a submission. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
codecode stringstring エラーや警告の種類を説明する申請ステータス コードです。A submission status code that describes the type of error or warning.
detailsdetails stringstring 問題についての詳細が含まれるメッセージです。A message with more details about the issue.

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

このリソースには、申請のアプリ パッケージについての情報が保持されます。This resource contains details about an app package for the submission.

{
  "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"
      ]
    }
  ],
}

このリソースには、次の値があります。This resource has the following values.

注意

アプリの申請の更新のメソッドを呼び出す場合、要求本文に必要なのは、このオブジェクトの fileNamefileStatusminimumDirectXVersionminimumSystemRam の値のみです。When calling the update an app submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. パートナー センターでは、その他の値が設定されます。The other values are populated by Partner Center.

ValueValue 種類Type 説明Description
fileNamefileName stringstring パッケージの名前。The name of the package.
fileStatusfileStatus stringstring パッケージの状態です。The status of the package. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • PendingUploadPendingUpload
  • UploadedUploaded
  • PendingDeletePendingDelete
idid stringstring パッケージを一意に識別する ID です。An ID that uniquely identifies the package. この値は、パートナー センターによって提供されます。This value is provided by Partner Center.
versionversion stringstring アプリ パッケージのバージョンです。The version of the app package. 詳しくは、「パッケージ バージョンの番号付け」をご覧ください。For more information, see Package version numbering.
architecturearchitecture stringstring パッケージのアーキテクチャ (ARM など) です。The architecture of the package (for example, ARM).
languageslanguages arrayarray アプリがサポートする言語の言語コードの配列です。An array of language codes for the languages the app supports. 詳しくは、「サポートされている言語」をご覧ください。For more information, see Supported languages.
capabilitiescapabilities arrayarray パッケージに必要な機能の配列です。An array of capabilities required by the package. 機能について詳しくは、「アプリ機能の宣言」をご覧ください。For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion stringstring アプリ パッケージによってサポートされる DirectX の最小バージョンです。The minimum DirectX version that is supported by the app package. Windows 8.x をターゲットとするアプリでのみ設定できます。This can be set only for apps that target Windows 8.x. その他の OS バージョンをターゲットとするアプリの場合、アプリの申請の更新メソッドの呼び出し時にはこの値が存在している必要がありますが、指定した値は無視されます。For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam stringstring アプリ パッケージに必要な RAM の最小サイズです。The minimum RAM that is required by the app package. Windows 8.x をターゲットとするアプリでのみ設定できます。This can be set only for apps that target Windows 8.x. その他の OS バージョンをターゲットとするアプリの場合、アプリの申請の更新メソッドの呼び出し時にはこの値が存在している必要がありますが、指定した値は無視されます。For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • Memory2GBMemory2GB
targetDeviceFamiliestargetDeviceFamilies arrayarray パッケージがターゲットにするデバイス ファミリを表す文字列の配列です。An array of strings that represent the device families that the package targets. この値は Windows 10 をターゲットにするパッケージにしか使用できません。以前のリリースをターゲットにするパッケージでは、この値は None になります。This value is used only for packages that target Windows 10; for packages that target earlier releases, this value has the value None. Windows 10 パッケージでは、現在、次のデバイス ファミリ文字列がサポートされます。 {0} は Windows 10 のバージョン文字列で、10.0.10240.0、10.0.10586.0、10.0.14393.0 などになります。The following device family strings are currently supported for Windows 10 packages, where {0} is a Windows 10 version string such as 10.0.10240.0, 10.0.10586.0 or 10.0.14393.0:
  • Windows.Universal min version {0}Windows.Universal min version {0}
  • Windows.Desktop min version {0}Windows.Desktop min version {0}
  • Windows.Mobile min version {0}Windows.Mobile min version {0}
  • Windows.Xbox min version {0}Windows.Xbox min version {0}
  • Windows.Holographic min version {0}Windows.Holographic min version {0}

認定レポート リソースCertification report resource

このリソースは、申請の認定レポート データへのアクセスを提供します。This resource provides access to the certification report data for a submission. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
datedate stringstring 日付と ISO 8601 形式でレポートが生成された時刻。The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl stringstring レポートにアクセスできる URL です。The URL at which you can access the report.

パッケージの配信オプション リソースPackage delivery options resource

このリソースには、申請の段階的なパッケージのロールアウトと必須の更新の設定が含まれています。This resource contains gradual package rollout and mandatory update settings for the submission.

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

このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
packageRolloutpackageRollout オブジェクトobject 申請の段階的なパッケージのロールアウトの設定が含まれたパッケージのロールアウトのリソースです。A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate booleanboolean この申請のパッケージを自己インストールのアプリの更新のために必須として扱うかどうかを指定します。Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. 自己インストールのアプリの更新のために必須なパッケージについて詳しくは、「アプリのパッケージの更新をダウンロードしてインストールする」をご覧ください。For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate datedate この申請のパッケージが必須となる日時 (ISO 8601 形式、UTC タイムゾーン)。The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

パッケージのロールアウトのリソースPackage rollout resource

このリソースには、申請の段階的なパッケージのロールアウトの設定が含まれています。This resource contains gradual package rollout settings for the submission. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
isPackageRolloutisPackageRollout booleanboolean 申請の段階的なパッケージのロールアウトが有効化されているかどうかを示します。Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage FLOATfloat 段階的なロールアウトでパッケージを受信するユーザーの割合。The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus stringstring 段階的なパッケージのロールアウトの状態を示す、次の文字列のいずれかです。One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId stringstring 段階的なロールアウトのパッケージを入手しないユーザーが受信する申請のID。The ID of the submission that will be received by customers who do not get the gradual rollout packages.

注意

PackageRolloutStatusfallbackSubmissionId値は、パートナー センターで割り当てられているし、開発者によって設定するためのものはありません。The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. これらの値を要求本文に含めると、これらの値は無視されます。If you include these values in a request body, these values will be ignored.

トレーラー リソースTrailers resource

このリソースは、アプリの登録情報のビデオ トレーラーを表します。This resource represents a video trailer for the app listing. このリソースの値に対応して、トレーラーパートナー センターで送信するためのオプション。The values in this resource correspond to the trailers options for submissions in Partner Center.

アプリの申請リソースtrailers 配列には最大 15 個のトレーラー リソースを追加できます。You can add up to 15 trailer resources to the trailers array in an app submission resource. 申請用のトレーラー ビデオ ファイルとサムネイル画像をアップロードするには、申請用のパッケージと登録情報の画像が含まれているものと同一の ZIP アーカイブにこれらのファイルを追加し、この ZIP アーカイブを申請用の共有アクセス署名 (SAS) URI にアップロードします。To upload trailer video files and thumbnail images for a submission, add these files to the same ZIP archive that contains the packages and listing images for the submission, and then upload this ZIP archive to the shared access signature (SAS) URI for the submission. ZIP アーカイブを SAS URI にアップロードする方法について詳しくは、「アプリの申請の作成」をご覧ください。For more information uploading the ZIP archive to the SAS URI, see Create an app submission.

{
  "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."
            }
          ]
        }
      }
    }
  ]
}

このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
idid stringstring トレーラーの ID です。The ID for the trailer. この値は、パートナー センターによって提供されます。This value is provided by Partner Center.
videoFileNamevideoFileName stringstring 申請用のファイルが含まれた ZIP アーカイブ内のトレーラー ビデオ ファイルの名前です。The name of the trailer video file in the ZIP archive that contains files for the submission.
videoFileIdvideoFileId stringstring トレーラー ビデオ ファイルの ID です。The ID for the trailer video file. この値は、パートナー センターによって提供されます。This value is provided by Partner Center.
trailerAssetstrailerAssets オブジェクトobject キーと値のペアのディクショナリです。各キーは言語コードであり、各値はトレーラーの追加のロケール固有アセットを含むトレーラー アセット リソースです。A dictionary of key and value pairs, where each key is a language code and each value is a trailer assets resource that contains additional locale-specific assets for the trailer. サポートされている言語コードについて詳しくは、「サポートされている言語」をご覧ください。For more information about the supported language codes, see Supported languages.

注意

trailers リソースは、Microsoft Store 申請 API が開発者向けに最初にリリースされた後、2017 年 5 月に追加されました。The trailers resource was added in May 2017, after the Microsoft Store submission API was first released to developers. このリソースが導入される前に申請 API を通じててアプリの申請を作成し、その申請がまだ審査中の場合、申請を正常にコミットするか削除するまで、アプリの申請に対するこのリソースは null になります。If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. アプリの申請で trailers リソースが利用できない場合、アプリの取得メソッドから返されるアプリケーション リソースhasAdvancedListingPermission フィールドは false になります。If the trailers resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

トレーラー アセット リソースTrailer assets resource

このリソースには、トレーラー リソースで定義されているトレーラー用の追加のロケール固有アセットが保持されます。This resource contains additional locale-specific assets for a trailer that is defined in a trailer resource. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
titletitle stringstring トレーラーのローカライズされたタイトルです。The localized title of the trailer. タイトルは、ユーザーがトレーラーを全画面表示モードで再生すると表示されます。The title is displayed when the user plays the trailer in full screen mode.
imageListimageList arrayarray 1 つの画像リソースが含まれた配列で、トレーラーのサムネイル画像を提供します。An array that contains one image resource that provides the thumbnail image for the trailer. この配列には 1 つの画像リソースのみを含めることができます。You can only include one image resource in this array.

画像リソース (トレーラー用)Image resource (for a trailer)

このリソースは、トレーラーのサムネイル画像を記述しています。This resource describes the thumbnail image for a trailer. このリソースには、次の値があります。This resource has the following values.

ValueValue 種類Type 説明Description
fileNamefileName stringstring 申請用にアップロードした ZIP アーカイブに含まれているサムネイル画像ファイルの名前です。The name of the thumbnail image file in the ZIP archive that you uploaded for the submission.
idid stringstring サムネイル画像の ID です。The ID for the thumbnail image. この値は、パートナー センターによって提供されます。This value is provided by Partner Center.
descriptiondescription stringstring サムネイル画像の説明です。The description for the thumbnail image. この値はメタデータのみです。ユーザーには表示されません。This value is metadata only, and is not displayed to users.

列挙型Enums

これらのメソッドでは、次の列挙型が使用されます。These methods use the following enums.

価格帯Price tiers

次の値は、価格リソースにおける、アプリの申請に利用できる価格帯を表します。The following values represent available price tiers in the pricing resource resource for an app submission.

ValueValue 説明Description
基本Base 価格帯が設定されていない場合、アプリの基本価格が使用されます。The price tier is not set; use the base price for the app.
NotAvailableNotAvailable アプリは指定された地域で提供されていません。The app is not available in the specified region.
FreeFree アプリは無償です。The app is free.
TierxxxTierxxx アプリの価格帯を指定する文字列 (Tierxxxx の形式)。A string that specifies the price tier for the app, in the format Tierxxxx. 現在のところ、次の範囲の価格帯がサポートされています。Currently, the following ranges of price tiers are supported:

  • 価格リソースisAdvancedPricingModel 値が true の場合、アカウントで利用可能な価格帯値は Tier1012 - Tier1424 です。If the isAdvancedPricingModel value of the pricing resource is true, the available price tier values for your account are Tier1012 - Tier1424.
  • 価格リソースisAdvancedPricingModel 値が false の場合、アカウントで利用可能な価格帯値は Tier2 - Tier96 です。If the isAdvancedPricingModel value of the pricing resource is false, the available price tier values for your account are Tier2 - Tier96.
各レベルに関連付けられている市場固有の価格を含む、開発者アカウントの利用できる価格レベルの完全なテーブルを確認する、価格と可用性でアプリを送信する、いずれかのページパートナー センターと、をクリックして、ビュー テーブルのリンクを市場やカスタムの価格セクション (このリンクは一部の開発者アカウントで、価格セクション)。To see the complete table of price tiers that are available for your developer account, including the market-specific prices that are associated with each tier, go to the Pricing and availability page for any of your app submissions in Partner Center and click the view table link in the Markets and custom prices section (for some developer accounts, this link is in the Pricing section).

エンタープライズ ライセンス値Enterprise licensing values

次の値は、アプリに対する組織のライセンス動作を表します。The following values represent the organizational licensing behavior for the app. これらのオプションについて詳しくは、「組織のライセンス オプション」をご覧ください。For more information about these options, see Organizational licensing options.

注意

アプリに対する組織のライセンス オプションは申請 API を通じて構成できますが、この API を使ってビジネス向け Microsoft Store や教育機関向け Microsoft Store でのボリューム購入の申請を公開することはできません。Although you can configure the organizational licensing options for an app submission via the submission API, you cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education. ビジネス向け Microsoft Store および教育機関向け Microsoft Store への発信を発行するには、パートナー センターを使用する必要があります。To publish submissions to the Microsoft Store for Business and Microsoft Store for Education, you must use Partner Center.

ValueValue 説明Description
なしNone ストアで管理される (オンラインの) ボリューム ライセンスがある企業に、アプリの利用を許可しません。Do not make your app available to enterprises with Store-managed (online) volume licensing.
オンラインOnline ストアで管理される (オンラインの) ボリューム ライセンスがある企業に、アプリの利用を許可します。Make your app available to enterprises with Store-managed (online) volume licensing.
OnlineAndOfflineOnlineAndOffline ストアで管理される (オンラインの) ボリューム ライセンスがある企業にアプリの利用を許可し、未接続状態 (オフライン) のライセンスのある企業にアプリの利用を許可します。Make your app available to enterprises with Store-managed (online) volume licensing, and make your app available to enterprises via disconnected (offline) licensing.

申請の状態コードSubmission status code

次の値は、申請の状態コードを表します。The following values represent the status code of a submission.

ValueValue 説明Description
なしNone コードが指定されていません。No code was specified.
InvalidArchiveInvalidArchive パッケージが含まれる ZIP アーカイブは無効であるか、認識できないアーカイブ形式です。The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles ZIP アーカイブに、申請データで指定されているすべてのファイルが含まれていないか、ファイルのアーカイブ内の場所が正しくありません。The ZIP archive does not have all files which were listed in your submission data, or they are in the wrong location in the archive.
PackageValidationFailedPackageValidationFailed 申請の 1 つ以上のパッケージを検証できませんでした。One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue 要求本文に含まれるパラメーターの 1 つが無効です。One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation 実行された操作は無効です。The operation you attempted is invalid.
InvalidStateInvalidState 実行された操作は、パッケージ フライトの現在の状態では無効です。The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound 指定されたパッケージ フライトは見つかりませんでした。The specified package flight could not be found.
ServiceErrorServiceError 内部サービス エラーのため、要求を処理できませんでした。An internal service error prevented the request from succeeding. もう一度要求を行ってください。Try the request again.
ListingOptOutWarningListingOptOutWarning 開発者が以前の申請の登録情報を削除しているか、パッケージによってサポートされる登録情報を含めていませんでした。The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning 開発者が登録情報を追加しました。The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning 開発者が、更新サポートしかないものを挿入しようとしています。The developer is trying to insert something that only has update support.
その他Other 申請が非認識または未分類の状態です。The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning パッケージ検証プロセスの結果、警告が生成されました。The package validation process resulted in a warning.