패키지 플라이트 만들기

  • 아티클

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

참고 항목

이 메서드는 제출 없이 패키지 플라이트를 만듭니다. 패키지 플라이트 제출을 만들려면 패키지 플라이트 제출 관리의 메서드를 참조하세요.

필수 조건

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

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

요청

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

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

요청 헤더

헤더 유형 설명
Authorization 문자열 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰입니다.

요청 매개 변수

이름 형식 설명
applicationId string 필수입니다. 패키지 플라이트를 만들려는 앱의 스토어 ID. Store ID에 대한 자세한 정보는 앱 ID 세부 정보 보기를 참조하세요.

요청 본문

다음 매개 변수가 요청 본문에 있습니다.

매개 변수 형식 설명 필수
friendlyName string 개발자가 지정한 패키지 플라이트의 이름입니다. 아니요
groupIds 배열 패키지 플라이트와 연결된 플라이트 그룹의 ID를 포함하는 문자열 배열입니다. 플라이트 그룹에 대한 자세한 정보는 패키지 플라이트를 참조하십시오. 아니요
rankHigherThan string 현재 패키지 플라이트보다 바로 낮은 순위가 지정된 패키지 플라이트의 식별 이름입니다. 이 매개 변수를 설정하지 않으면 새 패키지 플라이트가 모든 패키지 플라이트 중 가장 높은 순위를 갖게 됩니다. 플라이트 그룹 순위에 대한 자세한 정보는 패키지 플라이트를 참조하십시오. 아니요

요청 예제

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

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

응답

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

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

응답 본문

값 Type 설명
flightId string 패키지에 대한 ID. 이 값은 파트너 센터에서 제공합니다.
friendlyName string 요청에 지정된 패키지 플라이트의 이름입니다.
groupIds 배열 요청에 지정된 대로 패키지 플라이트와 연결된 플라이트 그룹의 ID를 포함하는 문자열 배열입니다. 플라이트 그룹에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.
rankHigherThan string 요청에 지정된 대로 현재 패키지 플라이트보다 바로 낮은 순위가 지정된 패키지 플라이트 이름입니다. 플라이트 그룹 순위에 대한 자세한 정보는 패키지 플라이트를 참조하십시오.

오류 코드

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

오류 코드 Description
400 요청이 잘못되었습니다.
409 현재 상태로 인해 패키지 플라이트를 만들 수 없거나 앱이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다.