다음을 통해 공유

앱 데이터 가져오기

  • 아티클

Microsoft Store 제출 API에서 다음 메서드를 사용하여 파트너 센터 계정의 기존 앱에 대한 데이터를 가져옵니다. API 사용을 위한 필수 조건을 비롯한 Microsoft Store 제출 API에 대한 자세한 정보는 Microsoft Store 서비스를 사용하여 제출 만들기 및 관리하기를 참조하세요.

이러한 방법을 사용하려면 앱이 파트너 센터 계정에 이미 있어야 합니다. 앱에 대한 제출을 만들거나 관리하려면 앱 제출 관리하기의 메서드를 참조하세요.

메서드 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 문자열 앱의 Store ID. Store ID에 대한 자세한 정보는 앱 ID 세부 정보 보기를 참조하세요.
primaryName 문자열 앱의 기본 이름.
packageFamilyName 문자열 앱의 패키지 패밀리 이름.
packageIdentityName 문자열 앱의 패키지 ID 이름.
publisherName 문자열 앱에 연결되는 Windows 게시자 ID. 이 ID는 Windows 파트너 센터에서 앱의 앱 ID 페이지에 나타나는 패키지/ID/게시자 값에 해당합니다.
firstPublishedDate 문자열 ISO 8601 형식의 앱이 처음 게시된 날짜.
lastPublishedApplicationSubmission 개체 앱에 대해 마지막으로 게시된 제출에 대한 정보를 제공하는 제출 리소스.
pendingApplicationSubmission 개체 앱에 대해 현재 보류 중인 제출에 대한 정보를 제공하는 제출 리소스.
hasAdvancedListingPermission boolean 앱 제출에서 gamingOptions이나 trailers를 구성할 수 있는지 알려줍니다 2017년 5월 이후에 만든 제출의 경우 이 값은 true입니다.

추가 기능 리소스

이 리소스는 추가 기능에 대한 정보를 제공합니다.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

해당 리소스 값은 다음과 같습니다.

값 형식 설명
inAppProductId 문자열 추가 기능의 Store ID. 이 값은 Store에서 제공됩니다. 예를 들어 Store 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 문자열 패키지에 대한 ID. 이 값은 파트너 센터에서 제공합니다.
friendlyName 문자열 개발자가 지정한 패키지 플라이트의 이름입니다.
lastPublishedFlightSubmission 개체 패키지 플라이트에 대해 마지막으로 게시된 제출에 대한 정보를 제공하는 제출 리소스.
pendingFlightSubmission 개체 패키지 플라이트에 대해 현재 보류 중인 제출에 대한 정보를 제공하는 제출 리소스.
groupIds 배열 패키지 플라이트와 연결된 플라이트 그룹의 ID를 포함하는 문자열 배열입니다. 플라이트 그룹에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.
rankHigherThan 문자열 현재 패키지 플라이트보다 바로 낮은 순위가 지정된 패키지 플라이트의 식별 이름입니다. 플라이트 그룹 순위에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.

제출 리소스

이 리소스는 제출에 대한 정보를 제공합니다. 다음 예제는 이 리소스의 형식을 보여 줍니다.

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

이 리소스의 값은 다음과 같습니다.

값 형식 설명
id 문자열 제출 ID.
resourceLocation 문자열 기본 https://manage.devcenter.microsoft.com/v1.0/my/ 요청 URI에 추가하여 제출에 대한 전체 데이터를 검색할 수 있는 상대 경로.