추가 기능 제출의 상태 가져오기
Microsoft Store 제출 API에서 이 메서드를 사용하여 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 상태를 가져옵니다. Microsoft Store 제출 API를 사용하여 추가 기능 제출을 만드는 프로세스의 절차에 대한 자세한 정보는 추가 기능 제출 관리하기를 참조하세요.
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
- 여러 앱 중 하나에 대한 추가 기능 제출을 만듭니다. 이 작업은 파트너 센터에서 수행하거나 추가 기능 제출 만들기 메서드를 사용하여 수행할 수 있습니다.
요청
이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 본문에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.
| 메서드 | 요청 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/status |
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | string | 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰. |
요청 매개 변수
| 속성 | 형식 | 설명 |
|---|---|---|
| inAppProductId | 문자열 | 필수입니다. 상태를 가져올 제출이 포함된 추가 기능의 Store ID입니다. Store ID는 파트너 센터에서 사용할 수 있습니다. |
| SubmissionId | 문자열 | 필수입니다. 상태를 가져오려는 제출의 ID입니다. 이 ID는 추가 기능 제출 만들기 요청에 대한 응답 데이터에서 사용할 수 있습니다. 파트너 센터에서 만든 제출의 경우, 파트너 센터의 제출 페이지 URL에서도 이 ID를 사용할 수 있습니다. |
요청 본문
이 메서드에 대한 요청 본문을 제공하지 마세요.
요청 예시
다음 예시는 추가 기능 제출의 상태를 가져오는 방법을 보여 줍니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status HTTP/1.1
Authorization: Bearer <your access token>
Response
다음 예제는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문에는 지정된 제출에 대한 정보가 포함됩니다. 응답 본문의 값에 대한 자세한 내용은 다음 섹션을 참조하세요.
{
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
}
응답 본문
| 값 | 형식 | 설명 |
|---|---|---|
| 상태 | 문자열 | 제출 상태. 이는 다음 값 중 하나일 수 있습니다.
|
| statusDetails | 개체 | 오류에 대한 정보를 포함하는 제출 상태에 대한 추가 세부 정보를 포함합니다. 자세한 정보는 상태 세부 정보 리소스를 참조하세요. |
오류 코드
요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.
| 오류 코드 | 설명 |
|---|---|
| 404 | 제출을 찾을 수 없습니다. |
| 409 | 추가 기능이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다. |