アプリ データの入手

  • [アーティクル]

パートナー センター アカウント内の既存のアプリのデータを取得するには、Microsoft Store 申請 API の以下のメソッドを使います。 Microsoft Store 申請 API の概要については、「Microsoft Store サービスを使用した申請の作成と管理」をご覧ください。この API を使用するための前提条件などの情報があります。

これらのメソッドを使用するには、アプリをお客様自身のパートナー センター アカウントに用意しておく必要があります。 アプリの提出を作成または管理する方法については、「アプリ提出の管理」のメソッドを参照してください。

認証方法 URI 説明
GET https://manage.devcenter.microsoft.com/v1.0/my/applications 全アプリのデータの取得
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} 特定アプリのデータの取得
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts アプリのアドオンの取得
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights アプリのパッケージ フライトの取得

前提条件

Microsoft Store 申請 API に関するすべての前提条件がまだ満たされていない場合は、ここに記載されているメソッドを使用する前に前提条件を整えてください。

データ リソース

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

アプリケーション リソース

このリソースは、アカウントに登録されているアプリを表します。

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

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

値 種類 説明
id string アプリケーションのストア ID です。 ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。
primaryName string アプリのプライマリ名です。
packageFamilyName string アプリのパッケージ ファミリ名です。
packageIdentityName string アプリのパッケージ ID 名です。
publisherName string アプリに関連付けられている Windows 発行元 ID です。 これは、パートナー センターのアプリの「アプリ ID」ページに表示される「パッケージ/ID/発行者」値と同じです。
firstPublishedDate string アプリが最初に発行された日付 (ISO 8601 形式)。
lastPublishedApplicationSubmission object アプリの最後に公開された申請に関する情報を提供する申請のリソース。
pendingApplicationSubmission object アプリの現在保留中の申請に関する情報を提供する申請のリソース。
hasAdvancedListingPermission boolean アプリの申請用に gamingOptions またはトレーラーを構成できるかどうかを示します。 2017 年 5 月以降に作成された申請では、この値は true になります。

アドオン リソース

このリソースは、アドオンに関する情報を提供します。

{
    "inAppProductId": "9WZDNCRD7DLK"
}

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

値 種類 説明
inAppProductId string アドオンのストア ID です。 この値は、ストアによって提供されます。 ストア ID の例は 9NBLGGH4TNMP です。

フライト リソース

このリソースは、アプリのパッケージ フライトに関する情報を提供します。

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

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

値 種類 説明
flightId string パッケージ フライトの ID。 この値はパートナー センターによって提供されます。
friendlyName string 開発者によって指定されているパッケージ フライトの名前。
lastPublishedFlightSubmission object パッケージ フライトの最後に公開された申請に関する情報を提供する申請のリソース。
pendingFlightSubmission object パッケージ フライトの現在保留中の申請に関する情報を提供する申請のリソース。
groupIds array パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。 フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。
rankHigherThan string 現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。 フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。

申請のリソース

このリソースは、申請に関する情報を提供します。 次の例は、このリソースの書式設定を示しています。

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

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

値 種類 説明
id string 申請 ID。
resourceLocation string 申請の完全なデータを取得するために基本 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI に付加できる相対パス。