사용자의 구독 가져오기

Microsoft Store 구매 API에서 이 메서드를 사용하여 특정 사용자에게 사용 권한이 부여된 구독 추가 기능을 가져옵니다.

Microsoft.StoreServices 라이브러리는 StoreServicesClient.RecurrenceQueryAsync API를 통해 이 메서드의 기능을 제공합니다.

필수 조건

이 메서드를 사용하려면 다음이 필요합니다.

• 대상 URI 값이 https://onestore.microsoft.com인 Azure AD 액세스 토큰입니다.
• 가져오려는 구독을 소유한 사용자의 ID를 나타내는 Microsoft Store ID 키입니다.

자세한 정보는 서비스에서 제품 권리 유형 관리하기를 참조하세요.

요청

요청 구문

요청 헤더

요청 본문

요청 예시

다음 예시는 이 메서드를 사용하여 특정 사용자에게 사용 권한이 부여된 구독 추가 기능을 가져오는 방법을 보여 줍니다. b2bKey 값을 가져오려는 구독의 사용자 ID를 나타내는 Microsoft Store ID 키로 바꿉니다.

POST https://purchase.mp.microsoft.com/v8.0/b2b/recurrences/query HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
Host: purchase.mp.microsoft.com

{
  "b2bKey":  "eyJ0eXAiOiJ..."
}

Response

이 메서드는 사용자가 사용 권한을 갖고 있는 구독 추가 기능에 대해 설명하는 데이터 개체 컬렉션이 포함된 JSON 응답 본문을 반환합니다. 다음 예시는 하나의 구독에 대한 권한을 갖고 있는 사용자에 대한 응답 본문을 보여줍니다.

{
  "items": [
    {
      "autoRenew":true,
      "beneficiary":"pub:gFVuEBiZHPXonkYvtdOi+tLE2h4g2Ss0ZId0RQOwzDg=",
      "expirationTime":"2017-06-11T03:07:49.2552941+00:00",
      "id":"mdr:0:bc0cb6960acd4515a0e1d638192d77b7:77d5ebee-0310-4d23-b204-83e8613baaac",
      "lastModified":"2017-01-08T21:07:51.1459644+00:00",
      "market":"US",
      "productId":"9NBLGGH52Q8X",
      "skuId":"0024",
      "startTime":"2017-01-10T21:07:49.2552941+00:00",
      "recurrenceState":"Active"
    }
  ]
}

응답 본문

응답 본문에는 다음의 데이터가 포함됩니다.

항목 배열의 각 개체에는 다음의 값이 포함됩니다.

관련 항목

• 서비스에서 제품 권한 관리하기
• 사용자의 구독 청구 상태 변경하기
• 제품에 대한 쿼리 보내기
• 소모성 제품을 처리됨으로 보고하기
• Microsoft Store ID 키 갱신하기
• Microsoft.StoreServices 라이브러리(GitHub)