다음을 통해 공유

앱에 대한 추가 기능 가져오기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱의 추가 기능을 나열합니다.

필수 조건

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

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

Request

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

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

요청 헤더

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

요청 매개 변수

속성 형식 설명 필수
applicationId 문자열 추가 기능을 검색하려는 앱의 Store ID. Store ID에 대한 자세한 정보는 앱 ID 세부 정보 보기를 참조하세요. 예
top int 요청에서 반환할 항목 수(즉, 반환할 추가 기능 수). 앱에 쿼리에서 지정한 값보다 더 많은 추가 기능이 있는 경우 응답 본문에는 메서드 URI에 추가하여 다음 데이터 페이지를 요청할 수 있는 상대 URI 경로가 포함됩니다. 아니요
skip int 남은 항목을 반환하기 전에 쿼리에서 바이패스할 항목 수입니다. 이 매개 변수를 사용하여 데이터 집합을 페이징합니다. 예를 들어 top=10 및 skip=0은 항목 1~10을 검색하고 top=10 및 skip=10은 항목 11~20을 검색하는 식으로 이어집니다. 아니요

요청 본문

이 메서드에 대한 요청 본문을 제공하지 마세요.

요청 예제

다음 예제는 앱에 대한 모든 추가 기능을 나열하는 방법을 보여 줍니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listinappproducts HTTP/1.1
Authorization: Bearer <your access token>

다음 예제는 앱에 대한 첫 10개의 추가 기능을 나열하는 방법을 보여 줍니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listinappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Response

다음 예제는 총 추가 기능이 53개인 앱의 처음 10개 추가 기능에 대한 성공적인 요청으로 반환된 JSON 응답 본문을 보여 줍니다. 간단히 하기 위해 이 예제는 요청에서 반환된 처음 세 가지 추가 기능에 대한 데이터만 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 다음의 섹션을 참조하세요.

{
  "@nextLink": "applications/9NBLGGH4R315/listinappproducts/?skip=10&top=10",
  "value": [
    {
      "inAppProductId": "9NBLGGH4TNMP"
    },
    {
      "inAppProductId": "9NBLGGH4TNMN"
    },
    {
      "inAppProductId": "9NBLGGH4TNNR"
    },
    // Next 7 add-ons  are omitted for brevity ...
  ],
  "totalCount": 53
}

응답 본문

값 형식 설명
@nextLink 문자열 데이터의 추가 페이지가 있는 경우, 이 문자열에는 다음 데이터 페이지를 요청하기 위해 기본 https://manage.devcenter.microsoft.com/v1.0/my/ 요청 URI에 추가할 수 있는 상대 경로가 포함됩니다. 예를 들어 초기 요청 본문의 top 매개 변수는 10으로 설정되어 있지만 앱의 추가 기능이 50개인 경우 응답 본문에는 applications/{applicationid}/listinappproducts/?skip=10&top=10의 @nextLink값이 포함되며 이는 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listinappproducts/?skip=10&top=10을 호출하여 다음 10개의 추가 기능을 호출할 수 있음을 나타냅니다.
값 배열 지정된 앱에 대한 각 추가 기능의 Store ID를 나열하는 개체의 배열. 각 개체의 데이터에 대한 자세한 정보는 추가 기능 리소스를 참조하세요.
totalCount int 쿼리에 대한 데이터 결과의 총 행 수(즉, 지정된 앱의 총 추가 기능 수).

오류 코드

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

오류 코드 설명
404 추가 기능을 찾을 수 없습니다.
409 추가 기능이 현재 Microsoft Store 제출 API에서 지원되지 않는 개발자 센터 대시보드 기능을 사용합니다.