アプリ データの入手
パートナー センター アカウント内の既存のアプリのデータを取得するには、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 に付加できる相対パス。 |