이 섹션에서는 앱을 Cloud Marketplace와 통합하는 단계를 간략히 설명합니다. 앱을 Google Cloud와 통합하는 개략적인 방법은 다음과 같습니다.
백엔드 통합
앱의 백엔드를 다음 Google API 및 서비스와 통합해야 합니다.
Pub/Sub와 통합하여 사용자가 자신의 제품에 등록할 때와 같이 Cloud Marketplace에서 알림을 받습니다. 파트너 엔지니어가 Pub/Sub 주제를 만들며, 알림을 받으려면 이 주제를 구독해야 합니다.
Pub/Sub 주제 구독에 대한 정보는 Pub/Sub 구독자 가이드를 참조하세요.
Partner Procurement API와 통합하여 고객 계정을 만들고 이러한 계정을 Cloud Marketplace 구매와 연결합니다. 또한 사용자가 자신의 구독 요금제를 변경하거나 취소할 때 연결된 계정을 업데이트하려면 Partner Procurement API를 사용해야 합니다.
사용량 기반 가격 책정 모델을 선택한 경우에는 사용량 정보를 보고하도록 Service Control과 통합합니다.
앱의 백엔드를 Cloud Marketplace와 통합하는 방법에 대한 자세한 내용은 앱의 백엔드 통합을 참조하세요.
기본 제품의 백엔드와 Cloud Marketplace를 통합하는 예시와 샘플 코드를 보려면 SaaS 제품 통합 Codelab을 참조하세요.
프런트엔드 통합
앱의 프런트엔드에서 다음 통합을 설정해야 합니다.
Cloud Marketplace를 통해 제품을 구매하는 신규 고객의 계정을 등록하려면 가입 페이지를 제공합니다. 사용자가 이 페이지를 방문하면 Google이 사용자의 계정 ID가 포함된 JSON 웹 토큰(JWT)을 전송합니다. 이 계정 ID를 사용하여 제품의 사용자 계정을 Google 계정과 Identity and Access Management(IAM)에 연결합니다.
고객을 위한 로그인 페이지를 제공합니다.
다음 중 하나를 선택할 수 있습니다.
- 고객이 자신의 Google 계정을 사용하여 앱에 로그인할 수 있도록 싱글 사인온(SSO)을 통합합니다. SSO를 통합한 경우 사용자가 SSO를 사용하여 로그인하면 확인할 사용자에 대한 정보가 포함된 JSON 웹 토큰(JWT)이 전송됩니다.
앱의 프런트엔드를 Cloud Marketplace와 통합하는 방법에 대한 자세한 내용은 앱의 프런트엔드 통합을 참조하세요.
시작하기 전에
- 파트너 엔지니어가 Cloud Commerce Partner Procurement API에 대한 액세스를 사용 설정했는지 확인합니다.
Google API에 통합
Google 제품에 대해 프로그래매틱 액세스를 제공하는 클라이언트 라이브러리를 사용하여 Google API에 앱을 통합할 수 있습니다. 클라이언트 라이브러리는 자바, Python, .NET과 같이 일반적으로 많이 사용되는 개발 플랫폼에서 사용할 수 있습니다.
API 클라이언트 라이브러리 페이지에서 해당 플랫폼을 위한 클라이언트 라이브러리를 설치합니다.
클라이언트 라이브러리에서는 다음을 수행할 수 있습니다.
Pub/Sub 구독에 연결하고 수신 메시지를 처리합니다.
사용량 기반 가격 책정을 선택한 경우 Service Control API에 연결하여 Google에 사용량 데이터를 보고합니다.
고객에 대해 연결된 계정을 만들고 사용자 계정에 대한 업데이트를 보내고 받으려면 Partner Procurement API에도 통합해야 합니다. Partner Procurement API는 제한적이기 때문에 API를 위한 새로운 클라이언트 라이브러리를 빌드해야 합니다.
새 클라이언트 라이브러리를 빌드하려면 Google 클라이언트 라이브러리를 설치하고 API 탐색 문서에 새 라이브러리를 빌드해야 합니다. Partner Procurement API의 탐색 문서는 다음 URL에 있습니다.
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
예를 들어, Partner Procurement API용 Python 클라이언트 라이브러리를 빌드하는 경우 build()
메서드를 사용합니다. 클라이언트 라이브러리를 빌드하는 샘플 코드는 GitHub의 Codelab 샘플을 참조하세요.
Google Cloud 콘솔에서 Partner Procurement API 사용 설정
파트너 엔지니어로부터 Partner Procurement API에 대한 액세스 권한을 부여받은 후에는 Google Cloud 콘솔에서 API를 사용 설정하기 위해 추가 단계를 수행할 필요가 없습니다.