다음을 통해 공유

추가 기능 제출 업데이트하기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 기존 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함) 제출을 업데이트합니다. 이 메서드를 사용하여 제출을 성공적으로 업데이트한 후에는 수집 및 게시를 위해 제출을 커밋해야 합니다.

이 메서드가 Microsoft Store 제출 API를 사용하여 추가 기능 제출을 만드는 프로세스에 적용되는 방법은 추가 기능 제출 관리를 참조하세요.

필수 조건

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

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

요청

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

메서드 요청 URI
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

요청 헤더

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

요청 매개 변수

속성 형식 설명
inAppProductId 문자열 필수입니다. 제출을 업데이트하려는 추가 기능의 스토어 ID입니다. Store ID는 파트너 센터에서 사용할 수 있으며 추가 기능 만들기 또는 추가 기능 세부 정보 가져오기 요청에 대한 응답 데이터에 포함되어 있습니다.
submissionId 문자열 필수입니다. 업데이트할 제출의 ID입니다. 이 ID는 추가 기능 제출 만들기 요청에 대한 응답 데이터에서 사용할 수 있습니다. 파트너 센터에서 만든 제출의 경우, 파트너 센터의 제출 페이지 URL에서도 이 ID를 사용할 수 있습니다.

요청 본문

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

값 형식 설명
contentType string 추가 기능에 제공되는 콘텐츠의 형식입니다. 이는 다음 값 중 하나일 수 있습니다.
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • ASP
  • OnlineDownload
키워드 배열 추가 기능에 대해 최대 10개의 키워드를 포함하는 문자열 배열입니다. 앱은 이러한 키워드를 사용하여 추가 기능을 쿼리할 수 있습니다.
수명(lifetime) string 추가 기능의 수명입니다. 이는 다음 값 중 하나일 수 있습니다.
  • 계속 허용됩니다.
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ThreeMonths
  • SixMonths
  • OneYear
목록 개체 추가 기능에 대한 목록 정보가 포함된 개체입니다. 자세한 내용은 목록 리소스를 참조하세요.
가격 책정 개체 추가 기능에 대한 가격 책정 정보가 포함된 개체입니다. 상세한 정보는 가격 책정 리소스를 참조하세요.
targetPublishMode string 제출에 대한 게시 모드입니다. 이는 다음 값 중 하나일 수 있습니다.
  • Immediate
  • 수동
  • SpecificDate
targetPublishDate string targetPublishMode가 SpecificDate로 설정된 경우 ISO 8601 형식의 제출에 대한 게시 날짜입니다.
tag string 추가 기능에 대한 사용자 지정 개발자 데이터입니다(이 정보는 이전에 태그라고 함).
visibility string 추가 기능의 가시성입니다. 이는 다음 값 중 하나일 수 있습니다.
  • Hidden
  • 공공 사업
  • 프라이빗
  • NotSet

요청 예시

다음 예제는 추가 기능 제출을 업데이트하는 방법을 보여 줍니다.

PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "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": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
}

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": [],
    "priceId": "Free"
  },
  "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에서 지원되지 않는 파트너 센터 기능을 사용합니다.