다음을 통해 공유

추가 기능 모두 가져오기

  • 아티클

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

필수 조건

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

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

Request

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

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

요청 헤더

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

요청 매개 변수

이 메서드에는 모든 요청 매개 변수가 선택 사항입니다. 매개 변수 없이 이 메서드를 호출하면 계정에 등록된 모든 앱의 모든 추가 기능에 대한 데이터가 응답에 포함됩니다.

매개 변수 형식 설명 필수
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/inappproducts HTTP/1.1
Authorization: Bearer <your access token>

다음 예제는 처음 10개의 추가 기능만 검색하는 방법을 보여 줍니다.

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

Response

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

{
  "@nextLink": "inappproducts/?skip=5&top=5",
  "value": [
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMP",
      "productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243619",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243705",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
      }
    },
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMN",
      "productId": "6a3c9788-a350-448a-bd32-16160a13018a",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243538",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243106",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
      }
    },

  // Other add-ons omitted for brevity...
  ],
  "totalCount": 1072
}

응답 본문

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

오류 코드

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

오류 코드 설명
404 추가 기능을 찾을 수 없습니다.
409 앱 또는 추가 기능이 현재 Microsoft 스토어 제출 API에서 지원되지 않는 파트너 센터 대시보드 기능을 사용합니다.