모든 추가 기능 가져오기Get all add-ons

파트너 센터 계정에 등록 된 모든 앱에 대 한 모든 추가 기능에 대 한 데이터를 검색할 Microsoft Store 제출 API에서에서이 메서드를 사용 합니다.Use this method in the Microsoft Store submission API to retrieve data for all add-ons for all the apps that are registered to your Partner Center account.

사전 요구 사항Prerequisites

이 메서드를 사용하려면 다음을 먼저 수행해야 합니다.To use this method, you need to first do the following:

  • 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다.Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.After the token expires, you can obtain a new one.

요청Request

이 메서드에는 다음 구문이 있습니다.This method has the following syntax. 헤더 및 요청 본문의 사용 예제와 설명은 다음 섹션을 참조하세요.See the following sections for usage examples and descriptions of the header and request body.

메서드Method 요청 URIRequest URI
가져오기GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

요청 헤더Request header

헤더Header 형식Type 설명Description
AuthorizationAuthorization stringstring 필수 사항입니다.Required. 폼에서 Azure AD 액세스 토큰 전달자 < 토큰>합니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

모든 요청 매개 변수는 이 메서드에 대한 옵션입니다.All request parameters are optional for this method. 매개 변수 없이 이 메서드를 호출하는 경우 응답에는 계정에 등록된 모든 앱의 모든 추가 기능에 대한 데이터가 포함됩니다.If you call this method without parameters, the response contains data for all add-ons for all apps that are registered to your account.

매개 변수Parameter 형식Type 설명Description 필수Required
toptop ssNoversionint 요청에 반환할 항목 수(즉, 반환할 추가 기능 수)입니다.The number of items to return in the request (that is, the number of add-ons to return). 계정에 쿼리에서 지정한 값보다 더 많은 추가 기능이 있을 경우 응답 본문에는 데이터의 다음 페이지를 요청하기 위해 메서드 URI에 추가할 수 있는 상대 URI 경로가 포함됩니다.If your account has more add-ons than the value you specify in the query, the response body includes a relative URI path that you can append to the method URI to request the next page of data. 아니요No
skipskip ssNoversionint 나머지 항목을 반환하기 전에 쿼리에서 바이패스할 항목 수입니다.The number of items to bypass in the query before returning the remaining items. 이 매개 변수를 사용하여 데이터 집합의 페이지를 탐색합니다.Use this parameter to page through data sets. 예를 들어 top=10이고 skip=0이면 1-10 항목을 검색하고 top=10이고 skip=10이면 11-20 항목을 검색합니다.For example, top=10 and skip=0 retrieves items 1 through 10, top=10 and skip=10 retrieves items 11 through 20, and so on. 아니요No

요청 본문Request body

이 메서드에 대한 요청 본문을 제공하지 않습니다.Do not provide a request body for this method.

요청 예제Request examples

다음 예제에서는 계정에 등록된 모든 앱의 모든 추가 기능 데이터를 검색하는 방법을 보여 줍니다.The following example demonstrates how to retrieve all add-on data for all the apps that are registered to your account.

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

다음 예제에서는 처음 10개의 추가 기능만 검색하는 방법을 보여 줍니다.The following example demonstrates how to retrieve the first 10 add-ons only.

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

응답Response

다음 예제에서는 개발자 계정에 등록된 총 1072개의 추가 기능에서 처음 5개의 추가 기능을 성공적으로 요청하여 반환된 JSON 응답 본문을 보여 줍니다.The following example demonstrates the JSON response body returned by a successful request for the first 5 add-ons that are registered to a developer account with 1072 total add-ons. 편의를 위해 이 예제에서는 요청으로 반환된 처음 두 개의 추가 기능에 대한 데이터만 보여 줍니다.For brevity, this example only shows the data for the first two add-ons returned by the request. 응답 본문의 값에 대한 자세한 내용은 다음 섹션을 참조하세요.For more details about the values in the response body, see the following section.

{
  "@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
}

응답 본문Response body

Value 형식Type 설명Description
@nextLink stringstring 데이터의 추가 페이지가 있는 경우 이 문자열에는 데이터의 다음 페이지를 요청하기 위해 기본 https://manage.devcenter.microsoft.com/v1.0/my/ 요청 URI를 추가할 수 있는 상대 경로가 포함됩니다.If there are additional pages of data, this string contains a relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to request the next page of data. 예를 들어 초기 요청 본문의 top 매개 변수는 10으로 설정되어 있지만 계정에 등록된 추가 기능이 100개인 경우 응답 본문에는 inappproducts?skip=10&top=10의 @nextLink 값이 포함되며 이는 https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10을 호출하여 다음 10개의 추가 기능을 호출할 수 있음을 나타냅니다.For example, if the top parameter of the initial request body is set to 10 but there are 100 add-ons registered to your account, the response body will include a @nextLink value of inappproducts?skip=10&top=10, which indicates that you can call https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 to request the next 10 add-ons.
valuevalue 배열array 각 추가 기능에 대한 정보를 제공하는 개체가 들어 있는 배열입니다.An array that contains objects that provide information about each add-on. 자세한 내용은 추가 기능 리소스를 참조하세요.For more information, see add-on resource.
totalCounttotalCount ssNoversionint 응답 본문의 value 배열에서 앱 개체의 수입니다.The number of app objects in the value array of the response body.

오류 코드Error codes

요청을 성공적으로 완료할 수 없으면 응답에 다음 HTTP 오류 코드 중 하나가 포함됩니다.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

오류 코드Error code 설명Description
404404 추가 기능이 없습니다.No add-ons were found.
409409 앱 또는 추가 기능에는 파트너 센터 기능을 사용할 현재 Microsoft Store 전송 API에 의해 지원 되지 않습니다합니다.The apps or add-ons use Partner Center features that are currently not supported by the Microsoft Store submission API.