추가 기능 만들기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱의 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)을 만듭니다.

참고 항목

이 메서드는 제출 없이 추가 기능을 만듭니다. 추가 기능에 대한 제출을 만들려면 추가 기능 제출 관리의 메서드를 참조하세요.

필수 조건

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

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

요청

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

메서드 요청 URI
게시 https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

요청 헤더

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

요청 본문

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

매개 변수 형식 설명 필수
applicationIds 배열 이 추가 기능이 연결된 앱의 스토어 ID를 포함하는 배열입니다. 이 배열에서 하나의 항목만 지원됩니다. 예
productId string 추가 기능의 제품 ID입니다. 코드에서 추가 기능을 참조하는 데 사용할 수 있는 식별자입니다. 자세한 내용은 제품 유형 및 제품 ID 설정을 참조하세요. 예
productType string 추가 기능의 제품 유형입니다. 지원되는 값은 지속성 및 소모성 값입니다. 예

요청 예제

다음의 예제는 앱에 대한 새 소모성 추가 기능을 만드는 방법을 보여 줍니다.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

응답

다음 예제는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 추가 기능 리소스를 참조하세요.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

오류 코드

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

오류 코드 설명
400 요청이 잘못되었습니다.
409 현재 상태 때문에 추가 기능을 만들 수 없거나 추가 기능이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다.