애플리케이션 통합: 설정

이 섹션에서는 애플리케이션을 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와 통합하고 샘플 코드를 연습하는 예시는 관리형 서비스를 통합하는 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에서 API 사용 설정

파트너 엔지니어가 Partner Procurement API에 대한 액세스를 활성화하면 다음 URL로 이동하여 Cloud Console에서 API를 활성화하세요.

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

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