앱 통합: 설정

이 섹션에서는 앱을 Google Cloud Marketplace와 통합하는 단계를 간략히 설명합니다. 앱을 Google Cloud와 통합하는 개략적인 방법은 다음과 같습니다.

  • 백엔드 통합

    앱의 백엔드를 다음 Google API 및 서비스와 통합해야 합니다.

    • Pub/Sub와 통합하여 사용자가 제품에 등록할 때와 같이 Google Cloud Marketplace에서 알림을 받습니다. 파트너 엔지니어가 Pub/Sub 주제를 만들며, 알림을 받으려면 이 주제를 구독해야 합니다.

      Pub/Sub 주제 구독에 대한 정보는 Pub/Sub 구독자 가이드를 참조하세요.

    • Partner Procurement API와 통합하여 고객을 위한 계정을 만들고 이 계정을 Google Cloud Marketplace 구매와 연결합니다. 또한 사용자가 자신의 구독 요금제를 변경하거나 취소할 때 연결된 계정을 업데이트하려면 Partner Procurement API를 사용해야 합니다.

    • 사용량 기준 가격 책정 모델을 선택한 경우에는 사용량 정보를 보고하도록 Service Control에 통합합니다.

    Google Cloud Marketplace에 앱의 백엔드를 통합하는 방법에 대한 자세한 내용은 앱의 백엔드 통합을 참조하세요.

    기본 제품의 백엔드와 Google Cloud Marketplace를 통합하는 예시와 샘플 코드를 둘러보려면 SaaS 제품 통합 Codelab을 참조하세요.

  • 프런트엔드 통합

    앱의 프런트엔드에서 다음 통합을 설정해야 합니다.

    • Google Cloud Marketplace를 통해 제품을 구매하는 신규 고객을 위한 활성화 페이지를 만듭니다. 신규 고객이 이 페이지로 연결되면 Google은 사용자의 계정 ID가 포함된 JSON 웹 토큰(JWT)도 보냅니다. 이 계정 ID를 사용하여 사용자의 새 계정을 만들고 Google 계정에 연결할 수 있습니다.

    • 사용자가 자신의 Google 계정을 사용하여 앱에 로그인할 수 있도록 SSO(싱글 사인온)를 통합합니다. SSO를 통합하려면 앱에서 사용자 계정 ID가 포함된 JWT를 확인해야 합니다. 앱은 사용자의 연결된 계정으로 계정 ID를 확인해야 합니다.

    Google 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 샘플을 참조하세요.

Cloud Console에서 Partner Procurement API 사용 설정

Producer Portal

Producer Portal을 사용하는 경우 파트너 엔지니어로부터 Partner Procurement API에 대한 액세스 권한을 부여받은 후 Cloud Console에서 API를 사용 설정하기 위한 추가 단계를 수행할 필요가 없습니다.

파트너 포털

파트너 포털을 사용하는 경우 파트너 엔지니어로부터 Partner Procurement API에 대한 액세스 권한을 부여받은 후 Cloud Console에서 API를 사용 설정하려면 다음 URL로 이동합니다.

https://console.cloud.google.com/apis/api/cloudcommerceprocurement.googleapis.com/overview?project=YOUR_PROJECT_ID

YOUR_PROJECT_ID은 솔루션을 호스팅하는 프로젝트이며 환경을 설정할 때 생성한 프로젝트입니다.