- API 호출을하기 전에 앱용 Google API 프로젝트를 설정해야하기 때문에 Marketplace 앱을 개발하는 첫 번째 단계입니다.
- 이 프로젝트는 앱에서 사용하는 많은 구성과 서비스를 정의합니다. 프로젝트를 설정하려면 다음을 수행해야합니다.
- Google API 콘솔 에서 프로젝트 만들기
- 앱에서 사용할 Google 서비스를 선택하십시오.
- G Suite Marketplace SDK 및 기타 서비스 구성
- 해당하는 경우 앱을 서비스 계정으로 설정하십시오.
- 앱이 사용해야 할 적절한 ID와 비밀 또는 키 가져 오기
다음 단락에서는 이러한 단계에 대해 자세히 설명합니다. 기존 애플리케이션이있는 경우 1 단계와 2 단계를 건너 뛸 수 있습니다.
- Google Apps Marketplace SDK 문서 : https://developers.google.com/apps-marketplace/?hl=ko
준비 할 리소스
프로젝트를 설정하는 데 필요한 리소스는 다음과 같습니다.
- 다음과 같은 해상도의 앱 아이콘 : 32×32, 48×48, 96×96 및 128×128 픽셀
- 팝업 대화 상자에 사용할 아이콘을 제공 할 수도 있습니다.이 아이콘은 60×120 픽셀 이하 여야합니다.
- 웹 서버 URL, 인증 리디렉션 콜백 및 제품 홈 페이지 (선택 사항)
이러한 각 리소스는 아래에 설명 된 하나 이상의 단계에서 필요합니다.
새 프로젝트 만들기
- Google API 콘솔로 이동하십시오.
- 프로젝트 작성을 클릭 하고 이름을 입력 한 후 작성을 클릭 하십시오.
사용할 서비스 선택
- Google Developers Console로 이동하여 G Suite Marketplace SDK를 사용하도록 설정하고 앱에 필요한 다른 서비스에 대해 API 또는 SDK를 사용하도록 설정해야합니다.
- 앱을 사용 설정하면 Google 서비스에만 액세스 할 수 있습니다.
프로젝트 용 API를 활성화하려면 다음을 수행하십시오.
- Google Developers Console에서 API 라이브러리 를 엽니 다 . 메시지가 나타나면 프로젝트를 선택하거나 새 프로젝트를 만듭니다. API 라이브러리는 제품군 및 인기별로 그룹화 된 사용 가능한 모든 API를 나열합니다.
- 활성화하려는 API가 목록에 표시되지 않으면 검색을 사용하여 찾으십시오.
- 활성화 할 API를 선택한 다음 API 사용 버튼 을 선택하십시오 .
- API를 사용 설정 한 후에 는 콘솔의 API 섹션에 있는 사용 가능한 API 링크를 사용하여 사용 가능한 API 목록을 확인하십시오.
- 목록에서 API를 사용 중지하고 다시 사용할 수 있습니다.
- 일부 API는 활성화하기 전에 서비스 약관에 동의하도록 요청합니다.
G Suite Marketplace SDK 구성
- 많은 서비스에는 추가 구성 단계가 필요합니다. G Suite Marketplace SDK는이 중 하나입니다.
- 사용 가능한 모든 API 목록을 보려면 Google API 콘솔 의 API 섹션에 있는 사용 가능한 API 링크를 사용 하십시오. 목록에서 G Suite Marketplace SDK 를 찾은 다음 해당 구성 아이콘을 클릭하십시오.
- 다음 각 설정을 구성해야합니다.
- 애플리케이션 정보 : 앱에 대한 다음 세부 정보를 입력하십시오.
- 앱에 대한 간단한 설명
- 각 크기의 아이콘
- 이 옵션을 허용하려면 “개별 설치 활성화”를 선택 하십시오 (아래 참조 )
- 지원 URL : 앱의 서비스 약관에 대한 URL을 입력하고, 선택 사항으로 다른 URL 유형에 대해 입력하십시오
- 범위 : 앱에서 액세스 할 서비스의 OAuth2 범위를 입력합니다.
- 확장 프로그램 :이 설정은 앱 확장을 사용 설정합니다 (아래 참조).
- 애플리케이션 정보 : 앱에 대한 다음 세부 정보를 입력하십시오.
- 완료되면 변경 사항 저장을 클릭하십시오.
개별 설치 활성화
- 일반적으로 G Suite Marketplace 앱은 G Suite 도메인 관리자 만 볼 수 있고 설치할 수 있습니다.
- 개별 사용자가 아래 그림과 같이 개별 설치 사용 을 선택하여 앱을 설치할 수 있도록 선택할 수 있습니다 .
이는 Chrome 웹 스토어 개발자 대시 보드 의 표시 옵션 과 상호 작용합니다 .
- 공개 설정이 비공개 인 경우 도메인의 사용자 만 앱을 검색하고 설치할 수 있습니다.
- 공개 설정이 공개 이면 G Suite 도메인이든 다른 Gmail 사용자 이든 관계없이 모든 사용자 가 앱을 검색하고 설치할 수 있습니다.
앱 확장 정보
이 창의 구역에서는 몇 가지 추가 기능 영역을 설정하고 구성 할 수 있습니다.
- 범용 탐색 확장 프로그램은 각 Google 앱의 페이지 상단에 표시되는 범용 탐색 표시 줄에 앱의 메뉴 항목을 배치합니다. 표시되는 입력란에 링크 URL을 포함시켜야합니다.
- 드라이브 확장 프로그램 이 Google 드라이브 앱이됩니다. 또한 서비스 창에서 Google 드라이브 SDK를 사용하도록 설정해야합니다. Google 드라이브 SDK를 구성하지 않은 경우 지금 구성해야합니다.
- COB 확장 프로그램을 사용하면 Gmail Contextual Gadgets에서 앱을 사용할 수 있습니다 . 나타나는 대화 상자에서이 확장에 대한 매개 변수를 구성해야합니다.
- 부가 기능 확장 Google 스프레드 시트, 문서 도구 및 양식에 대한 부가 기능 을 게시 할 수 있습니다 . 이러한 확장 기능을 사용하려면 먼저 스크립트 키와 OAuth 범위 목록이 필요합니다.
추가 서비스 구성
- 구성이 필요한 다른 서비스를 활성화 한 경우 사용 가능한 API 목록 에도 구성 아이콘이 표시 됩니다.
- 이제는이 각각을 구성하십시오.
- 서비스의 구성 옵션에 대한 자세한 내용은 해당 서비스의 설명서를 참조하십시오.
클라이언트 ID 생성
- 응용 프로그램에 대한 클라이언트 ID와 비밀 키를 만들어야합니다.
- 작성하는 유형은 빌드하는 응용 프로그램의 유형에 따라 다릅니다.
- 예를 들어 응용 프로그램을 도메인 관리자가 서비스 계정을 사용하여 insallable하게 만들려면 이 단계에서 서비스 계정 자격 증명을 만들도록해야합니다.
웹 응용 프로그램 클라이언트 ID 만들기
API 액세스 창 에서, OAuth 2.0 클라이언트 ID 만들기를 클릭합니다.
- 클라이언트 ID 작성 대화 상자가 나타납니다. 브랜딩 섹션에 제품 이름 (필수), 제품 로고 및 홈페이지 URL을 입력하십시오. 완료되면 다음을 클릭하십시오.
- 클라이언트 ID 설정 섹션에서 애플리케이션 유형으로 웹 애플리케이션을 선택하고 앱의 기본 URL을 입력하십시오. 승인 된 리디렉션 URI 또는 자바 스크립트 출처를 변경해야하는 경우 추가 옵션을 클릭하십시오. 완료되면 다음을 클릭하십시오.
- 클라이언트 ID 만들기 버튼을 클릭하십시오.
- 서비스 계정의 개인 키를 다운로드 할 수있는 대화 상자가 나타납니다. 개인 키 다운로드를 클릭하십시오.
API 액세스 창 에서, 웹 응용 프로그램 섹션의 클라이언트 ID를 찾아 클라이언트 ID와 클라이언트 비밀번호를 확인합니다. 앱에서 인증요청을 만들려때 필요한 항목입니다.
서비스 계정 클라이언트 ID 만들기
최종 사용자가 응용 프로그램을 개별적으로 설치하게하려는 경우 서비스 계정은 선택 사항입니다.
그러나 도메인 관리자가 G Suite 도메인의 모든 사용자에 대해 응용 프로그램을 설치하려면 서비스 계정을 사용하십시오. 서비스 계정을 사용하면 G Suite 도메인 관리자가 서비스 계정에 도메인 의 사용자 대신 사용자 데이터에 액세스 할 수 있는 도메인 전체 권한 을 부여 할 수 있습니다.
서비스 계정에 대한 자세한 내용은 서버 용 OAuth 2.0 사용 설명서를 참조하십시오.
응용 프로그램에서 서비스 계정을 사용하는 경우 서비스 계정 자격 증명을 만들어야합니다.
- 다른 클라이언트 ID 생성 … 버튼을 클릭하십시오.
- 응용 프로그램 유형에 대한 서비스 계정을 선택하고 응용 프로그램의 기본 URL을 입력하십시오. 승인 된 리디렉션 URI 또는 자바 스크립트 출처를 변경해야하는 경우 추가 옵션을 클릭하십시오.
- 클라이언트 ID 만들기 버튼을 클릭하십시오.
에서 API 액세스 창 , 서비스 계정 클라이언트 ID를 찾아 그것을 기록한다. 앱은 서비스 계정에서 인증 전화를 걸기 위해 방금 다운로드 한 비공개 키와 함께이 ID가 필요합니다.