추가 기능 제출 만들기
Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱에 대한 새 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함) 제출을 만듭니다. 이 메서드를 사용하여 새 제출을 성공적으로 만든 뒤, 제출 데이터를 변경하도록 제출을 업데이트한 다음 수집 및 게시를 위해 제출을 커밋합니다.
이 메서드가 Microsoft Store 제출 API를 사용하여 추가 기능 제출을 만드는 프로세스에 적용되는 방법은 추가 기능 제출 관리를 참조하세요.
참고 항목
이 메서드는 기존 추가 기능에 대한 제출을 만듭니다. 추가 기능을 만들려면 추가 기능 만들기 메서드를 사용합니다.
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
- 해당 앱 중 하나에 대한 추가 기능을 만듭니다. 이 작업은 파트너 센터에서 수행하거나 추가 기능 만들기 방법을 사용하여 수행할 수 있습니다.
요청
이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 본문에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.
메서드 | 요청 URI |
---|---|
게시 | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions |
요청 헤더
헤더 | 형식 | 설명 |
---|---|---|
권한 부여 | string | 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰. |
요청 매개 변수
속성 | 형식 | 설명 |
---|---|---|
inAppProductId | 문자열 | 필수. 제출을 만들려는 추가 기능의 스토어 ID입니다. Store ID는 파트너 센터에서 사용할 수 있으며 추가 기능 만들기 또는 추가 기능 세부 정보 가져오기 요청에 대한 응답 데이터에 포함되어 있습니다. |
요청 본문
이 메서드에 대한 요청 본문을 제공하지 마세요.
요청 예시
다음 예제는 추가 기능에 대한 새 제출을 만드는 방법을 보여 줍니다.
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions HTTP/1.1
Authorization: Bearer <your access token>
Response
다음 예제는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문에는 새 제출에 대한 정보가 포함됩니다. 응답 본문의 값에 대한 자세한 내용은 추가 기능 제출 리소스를 참조하세요.
{
"id": "1152921504621243680",
"contentType": "EMagazine",
"keywords": [
"books"
],
"lifetime": "FiveDays",
"listings": {
"en": {
"description": "English add-on description",
"icon": {
"fileName": "add-on-en-us-listing2.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (English)"
},
"ru": {
"description": "Russian add-on description",
"icon": {
"fileName": "add-on-ru-listing.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (Russian)"
}
},
"pricing": {
"marketSpecificPricings": {
"RU": "Tier3",
"US": "Tier4",
},
"sales": [
{
"name": "Sale1",
"basePriceId": "Free",
"startDate": "2016-05-21T18:40:11.7369008Z",
"endDate": "2016-05-22T18:40:11.7369008Z",
"marketSpecificPricings": {
"RU": "NotAvailable"
}
}
],
"priceId": "Free",
"isAdvancedPricingModel": true
},
"targetPublishDate": "2016-03-15T05:10:58.047Z",
"targetPublishMode": "Immediate",
"tag": "SampleTag",
"visibility": "Public",
"status": "PendingCommit",
"statusDetails": {
"errors": [
{
"code": "None",
"details": "string"
}
],
"warnings": [
{
"code": "ListingOptOutWarning",
"details": "You have removed listing language(s): []"
}
],
"certificationReports": [
{
}
]
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
"friendlyName": "Submission 2"
}
오류 코드
요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.
오류 코드 | 설명 |
---|---|
400 | 요청이 잘못되었기 때문에 제출을 만들 수 없습니다. |
409 | 앱의 현재 상태 때문에 제출을 만들 수 없거나 앱이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다. |