패키지 플라이트 제출 가져오기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 기존 패키지 플라이트 제출에 대한 데이터를 가져옵니다. Microsoft Store 제출 API를 사용하여 패키지 플라이트 제출을 만드는 프로세스의 절차에 대한 자세한 정보는 패키지 플라이트 제출 관리하기를 참조하세요.

필수 조건

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

  • 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
  • 파트너 센터의 앱에 대한 패키지 플라이트 제출을 만듭니다. 파트너 센터에서 이 작업을 수행하거나 패키지 플라이트 제출 만들기 메서드를 사용하여 이 작업을 수행할 수 있습니다.

요청

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

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

요청 헤더

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

요청 매개 변수

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

요청 본문

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

요청 예제

다음 예제는 스토어 ID가 9WZDNCRD91MD인 앱의 패키지 플라이트 제출을 가져오는 방법을 보여 줍니다.

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

응답

다음 예제는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문에는 지정된 제출에 대한 정보가 포함됩니다. 응답 본문의 값에 대한 자세한 내용은 패키지 플라이트 제출 리소스를 참조하세요.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

오류 코드

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

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