다음을 통해 공유

패키지 플라이트 가져오기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱을 위한 패키지 플라이트의 데이터를 가져옵니다.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

  • 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

Request

이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 본문에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.

메서드 요청 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

요청 헤더

헤더 형식 설명
권한 부여 string 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰.

요청 매개 변수

속성 형식 설명
applicationId 문자열 필수. 가져오려는 패키지 플라이트가 포함된 앱의 Store ID. 앱의 Store ID는 파트너 센터에서 사용할 수 있습니다.
flightId 문자열 필수. 가져올 패키지 플라이트 ID. 이 ID는 패키지 플라이트 만들기 및 앱의 패키지 플라이트 가져오기 요청에 대한 응답 데이터에서 사용할 수 있습니다. 파트너 센터에서 만든 플라이트의 경우, 파트너 센터의 플라이트 페이지 URL에서도 이 ID를 사용할 수 있습니다.

요청 본문

이 메서드에 대한 요청 본문을 제공하지 마세요.

요청 예시

다음 예제는 Store ID 값이 9WZDNCRD91MD인 앱의 ID가 43e448df-97c9-4a43-a0bc-2a445e736bcd인 패키지 플라이트 정보를 검색하는 방법을 보여 줍니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

Response

다음 예제는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문의 값에 대한 자세한 내용은 다음 섹션을 참조하세요.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

응답 본문

값 형식 설명
flightId 문자열 패키지에 대한 ID. 이 값은 파트너 센터에서 제공합니다.
friendlyName 문자열 개발자가 지정한 패키지 플라이트의 이름입니다.
lastPublishedFlightSubmission 개체 패키지 플라이트에서 마지막으로 게시된 제출에 대한 정보를 제공하는 개체입니다. 자세한 정보는 아래의 제출 개체 섹션을 참조하세요.
pendingFlightSubmission 개체 패키지 플라이트에 대한 현재 보류 중인 제출 정보를 제공하는 개체. 자세한 정보는 아래의 제출 개체 섹션을 참조하세요.
groupIds 배열 패키지 플라이트와 연결된 플라이트 그룹의 ID를 포함하는 문자열 배열입니다. 플라이트 그룹에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.
rankHigherThan 문자열 현재 패키지 플라이트보다 바로 낮은 순위가 지정된 패키지 플라이트의 식별 이름입니다. 플라이트 그룹 순위에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.

제출 개체

응답 본문의 lastPublishedFlightSubmission 및 pendingFlightSubmission 값에는 패키지 플라이트 제출에 대한 리소스 정보를 제공하는 개체가 포함되어 있습니다. 이러한 개체에는 다음과 같은 값이 있습니다.

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

오류 코드

요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.

오류 코드 설명
400 요청이 잘못되었습니다.
404 지정된 패키지 플라이트를 찾을 수 없습니다.
409 앱이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다.