다음을 통해 공유

스토어 서비스를 사용하여 리뷰에 응답

  • 아티클

Important

이 항목에 설명된 대로 Microsoft Store 리뷰 API는 현재 운영 중 상태가 아닙니다. API를 사용하는 대신 파트너 센터를 사용하여 동일한 작업을 수행할 수 있습니다.

Microsoft Store 리뷰 API를 사용하여 Microsoft Store의 앱 리뷰에 프로그래밍 방식으로 응답할 수 있습니다. 이 API는 파트너 센터를 사용하지 않고 많은 검토에 일괄 응답하려는 개발자에게 특히 유용합니다. 이 API는 Azure AD(Azure Active Directory)를 사용하여 앱 또는 서비스의 호출을 인증합니다.

다음 단계에서는 엔드투엔드 프로세스를 설명합니다.

  1. 모든 필수 조건을 충족하였는지 확인합니다.
  2. Microsoft Store 리뷰 API에서 메서드를 호출하기 전에 Azure AD 액세스 토큰을 가져옵니다. 토큰을 가져온 후 만료되기 전에 이 토큰을 Microsoft Store 리뷰 API에 대한 호출에 사용할 수 있는 시간은 60분입니다. 토큰이 만료된 후 새 토큰을 생성할 수 있습니다.
  3. Microsoft Store 리뷰 API를 호출합니다.

참고 항목

Microsoft Store 리뷰 API를 사용하여 프로그래밍 방식으로 리뷰에 응답하는 것 외에도 파트너 센터를 사용하여 리뷰에 응답할 수 있습니다.

1단계: Microsoft Store 리뷰 API를 사용하기 위한 필수 조건 완료

Microsoft Store 리뷰 API를 호출하는 코드를 작성하기 전에 다음과 같은 필수 조건을 완료했는지 확인합니다.

  • 사용자(또는 조직)에 Azure AD 디렉터리가 있어야 하며 디렉터리에 대한 전역 관리자 권한이 있어야 합니다. Microsoft 365 또는 Microsoft의 기타 비즈니스 서비스를 사용하고 있다면 Azure AD 디렉터리를 이미 보유하고 있습니다. 그렇지 않은 경우 추가 비용 없이 파트너 센터에서 새 Azure AD 만들기를 할 수 있습니다.

  • Azure AD 애플리케이션을 파트너 센터 계정과 연결하고 애플리케이션에 대한 테넌트 ID 및 클라이언트 ID를 검색하고 키를 생성해야 합니다. Azure AD 애플리케이션은 Microsoft Store 리뷰 API를 호출할 앱 또는 서비스입니다. API에 전달하는 Azure AD 액세스 토큰을 가져오려면 테넌트 ID, 클라이언트 ID 및 키가 필요합니다.

    참고 항목

    이 작업은 한 번만 수행하면 됩니다. 테넌트 ID, 클라이언트 ID 및 키가 있으면 새 Azure AD 액세스 토큰을 만들어야 할 때마다 다시 사용할 수 있습니다.

Azure AD 애플리케이션을 파트너 센터 계정에 연결하고 필요한 값을 검색하려면 다음을 수행합니다.

  1. 파트너 센터에서 조직의 Azure AD 디렉터리에 조직의 파트너 센터 계정을 연결합니다.

  2. 그런 다음, 파트너 센터의 계정 설정의 사용자 페이지에서 리뷰에 응답하는 데 사용할 앱 또는 서비스를 나타내는 Azure AD 애플리케이션을 추가합니다. 이 응용 프로그램에 관리자 역할을 할당해야 합니다. 애플리케이션이 Azure AD 디렉터리에 아직 없는 경우에는 파트너 센터에서 새 Azure AD 애플리케이션 만들기로 진행할 수 있습니다.

  3. 사용자 페이지로 돌아가서 Azure AD 응용 프로그램의 이름을 클릭하여 응용 프로그램 설정으로 이동하고 테넌트 ID 및 클라이언트 ID 값을 복사합니다.

  4. 새 키 추가를 클릭합니다. 다음 화면에서 키 값을 복사합니다. 이 페이지를 나간 후에는 이 정보에 다시 액세스할 수 없습니다. 자세한 내용은 Azure AD 애플리케이션에 대한 키 관리를 참조하세요.

2단계: Azure AD 액세스 토큰 가져오기

Microsoft Store 리뷰 API에서 메서드를 호출하기 전에 먼저 API에 있는 각 메서드의 Authorization 헤더에 전달하는 Azure AD 액세스 토큰을 가져와야 합니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 API에 대한 추가 호출에서 계속 사용할 수 있도록 토큰을 새로 고칠 수 있습니다.

액세스 토큰을 가져오려면 클라이언트 자격 증명을 사용하여 서비스 간 호출의 지침에 따라 HTTP POST를 엔드포인트 https://login.microsoftonline.com/<tenant_id>/oauth2/token(으)로 보냅니다. 샘플 요청은 다음과 같습니다.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

POST URI의 tenant_id 값, client_id 및 client_secret 매개 변수에는 이전 섹션의 파트너 센터에서 검색한 애플리케이션의 테넌트 ID, 클라이언트 ID 및 키를 지정합니다. 리소스 매개 변수의 경우에는 https://manage.devcenter.microsoft.com을 지정해야 합니다.

액세스 토큰이 만료되면 여기에 있는 지침에 따라 새로 고칠 수 있습니다.

3단계: Microsoft Store 리뷰 API 호출

Azure AD 액세스 토큰이 있으면 Microsoft Store 리뷰 API를 호출할 준비가 된 것입니다. 액세스 토큰을 각 메서드의 권한 부여 헤더에 전달해야 합니다.

Microsoft Store 리뷰 API에는 주어진 리뷰에 대한 응답이 허용되는지 여부 및 하나 이상의 리뷰에 대한 응답 제출이 허용되는지 여부를 결정하는 데 사용할 수 있는 몇 가지 메서드가 포함되어 있습니다. 이 API를 사용하려면 다음 과정에 따릅니다.

  1. 응답하려는 리뷰의 ID를 가져옵니다. 리뷰 ID는 Microsoft Store 분석 API에서 앱 리뷰 가져오기 메서드의 응답 데이터와 [리뷰 보고서](/windows/apps/publish/reviews-report)의 오프라인 다운로드에서 사용할 수 있습니다.
  2. 앱 리뷰용 응답 정보 가져오기 메서드를 호출해 리뷰에 응답할 수 있는지 여부를 결정합니다. 리뷰를 제출하는 고객은 해당 리뷰에 대한 응답을 받지 않기로 선택할 수 있습니다. 리뷰 응답을 받지 않기로 선택한 고객이 제출한 리뷰에는 응답할 수 없습니다.
  3. 앱 리뷰에 대한 응답 제출 메서드를 호출하여 프로그래밍 방식으로 리뷰에 응답합니다.