Google Workspace 부가기능 빌드

새 Google Workspace 부가기능을 빌드하려면 이 일반사항을 따르세요. 절차:

  1. 부가기능의 프로젝트 설정 및 소유자 선택 협업할 수 있습니다
  2. 부가기능의 모양과 동작을 디자인합니다.
  3. 부가기능의 프로젝트 매니페스트를 구성하거나 배포할 수 있습니다
  4. 부가기능의 모양을 정의하고 있습니다.
  5. 부가기능의 OAuth 범위를 확인합니다.
  6. 다음 내에서 부가기능을 테스트합니다. 애플리케이션이나 확장됩니다.
  7. 부가기능을 게시합니다.

부가기능의 프로젝트 설정 및 소유자 및 공동작업자 선택

Apps Script에서 부가기능을 빌드하는 경우 Apps Script 프로젝트와 Google Cloud 프로젝트를 모두 만듭니다. 다음 언어 이외의 언어로 부가기능을 빌드하는 경우 Google Cloud 프로젝트만 만들면 됩니다.

부가기능 개발을 시작하기 전에 다음 중 하나를 선택하세요. 프로젝트를 소유하고 할당받을 다른 계정을 결정 있습니다. 프로젝트 소유자가 프로젝트 파일을 만들고 관리합니다. 공동작업자는 코딩과 테스트를 지원할 수 있습니다.

Apps Script 프로젝트

부가기능의 Apps Script를 빌드할 수 있습니다. 프로젝트 파일을 공유 계정 하나에만 소유권이 있습니다. 부가기능 배치 중 여러 공동작업자가 액세스할 수 있도록 하는 공유 드라이브의 스크립트 파일 캡션을 생성할 수 있습니다

부가기능을 게시하면 단일 사용자 계정이 작동합니다. 있습니다. 게시 계정에 스크립트에 대한 수정 액세스 권한이 있어야 합니다. 하지만 소유자가 될 필요는 없습니다.

Apps Script 프로젝트를 만들려면 스크립트 프로젝트를 참고하세요.

Google Cloud 프로젝트

프로젝트에 공동작업자를 부가기능 Cloud 프로젝트를 참고하세요. 이렇게 하면 팀의 누군가가 항상 Google Cloud 콘솔로 이동합니다

Google Cloud 프로젝트를 만들려면 Google Cloud 프로젝트 만들기를 참고하세요.

부가기능의 모양과 동작 설계

부가기능이 표시되는 모양과 방식을 결정하세요. 작동해야 합니다 Kubernetes가 어떤 사용 사례를 부가기능이 솔루션을 제공하려고 시도해야 합니다. 시작 작업을 먼저 시작한 다음 더 미세하게 조정할 수 있습니다.

Google Workspace 부가기능 스타일 가이드를 참고하세요. 부가기능 사용자 설계 방법에 관한 가이드라인을 확인하세요. 경험해 볼 수 있습니다

부가기능 프로젝트 매니페스트 구성

Apps Script 프로젝트에서 프로젝트 매니페스트는 특수한 JSON입니다. 파일에서 참조됩니다. 라이브러리 등 프로젝트에 대한 다양한 세부정보를 지정합니다. 종속 항목이 포함됩니다 Google Workspace 부가기능의 경우 매니페스트가 기본 호스트 애플리케이션이 있습니다.

매니페스트를 구성하는 방법에 관한 자세한 내용은 매니페스트를 참고하세요. 부가기능 매니페스트를 참조하세요.

부가기능에 코드와 기능을 추가할 때 필요한 부가기능을 생성하기 위해 필요에 따라 매니페스트를 확인할 수 있습니다.

부가기능 코딩

먼저 카드 기반 인터페이스를 구현해야 합니다. 부가기능 Apps Script 사용 카드 서비스를 사용하거나 다른 코드 언어로 작성하는 경우 다음을 반환합니다. 인터페이스가 카드로 렌더링되도록 올바른 형식의 JSON을 작성해야 합니다.

또한 트리거는 함수가 할 수 있습니다 만약 부가기능이 Google 이외의 서드 파티 서비스에 연결되는 경우 사용하려면 OAuth를 구성해야 합니다. 서비스도 제공합니다

구성 카드

부가기능 사용자 인터페이스를 정의하는 방법은 Card 객체를 만들고 위젯을 사용해 보세요. 다음에 지정된 트리거 함수: 매니페스트는 단일 포드 또는 Card 객체 또는 다음을 나타내는 Card 객체 다른 '페이지' 자세히 살펴보겠습니다 내 부가기능은 새 카드를 만들어 표시할 수도 있습니다. 자동으로 수집됩니다

Apps Script에서는 CardBuilder 클래스 각 카드에 CardHeader 필요 및 1개 이상 CardSections 해야 할 일 각 카드 섹션을 부가기능 인터페이스입니다. 상호작용 위젯이 일반적으로 작업에 연결되어 영향을 미칩니다.

카드를 통해 모든 섹션과 위젯을 카드에 추가한 후에는 CardBuilder, 다음을 호출해야 합니다. CardBuilder.build() 상응하는 Card 객체를 만듭니다.

기본 제공 Apps Script를 사용하여 서비스(예: 가져올 CalendarApp 만드는 부가기능 카드에 표시할 정보를 선택합니다. Google 이외의 서비스에서 가져온 데이터를 사용할 수 있습니다.

Google Workspace 부가기능에서 OAuth가 필요한 Google 이외의 API에 액세스해야 하는 경우 이 서비스를 구성하고 연결해야 합니다. 자세한 내용은 Google 이외의 서비스 가이드: 확인하세요.

공사 주문

카드를 만들 때는 맨 위부터 빌드해야 합니다. 즉, 구성 주문:

  1. 위젯을 빌드합니다.
  2. 카드 섹션에 위젯을 추가합니다.
  3. 카드 섹션에 모든 위젯이 포함될 때까지 반복합니다.
  4. 카드에 카드 섹션을 추가합니다.

이는 카드 또는 카드 섹션에 위젯을 추가할 때 해당 위젯의 사본을 추가하고 있습니다. 위젯에 대한 모든 변경사항 객체는 최종 카드에 반영되지 않습니다.

유니버설 액션

범용 작업을 사용하여 컨텍스트와 무관한 기능을 제공합니다 범용 작업은 메뉴 항목임 현재 사용 중인 카드와 관계없이 부가기능 UI에서 사용할 수 있는 표시됩니다. 정의된 모든 범용 작업은 항상 부가기능 카드 메뉴

자세한 내용은 범용 작업을 참고하세요. 확인하세요.

부가기능 OAuth 범위 확인

범위는 사용자를 대신하여 작업을 수행할 수 있습니다. 이것은 애드온이 작업 범위만 갖도록 하기 위한 권장사항 순서가 있어야 하고 그 이상의 것은 없습니다.

부가기능 프로젝트에서 명시적으로 부가기능 보장하도록 부가기능은 최소 허용 범위 집합을 사용합니다. 있습니다. 부가기능이 사용하는 범위를 직접 정의합니다. 부가기능 매니페스트).

자세한 내용은 범위를 참고하세요.

부가기능 테스트

게시되지 않은 부가기능은 먼저 게시 취소됨 부가기능을 설치합니다. 설치 및 승인되면 부가기능을 사용할 수 있습니다. 호스트 애플리케이션에서 디자인과 동작을 테스트하고 확장됩니다. 부가기능이 제대로 작동하는지 API에 액세스할 수 있습니다

자세한 내용은 Google Workspace 부가기능 테스트를 참고하세요.

부가기능 게시

부가기능을 게시하면 다른 사용자가 할 수 있습니다. 게시를 시작하기 전에 간행물 개요를 검토하세요. 게시는 복잡한 과정이며 시간이 얼마나 걸릴까요?

Google Workspace 부가기능은 Google Workspace Marketplace에 게시됩니다. 공개적으로 사용 가능 부가기능은 사용자가 앱 검토를 완료해야 확인할 수 있습니다

다음 내용은 Google Workspace 부가기능 게시를 참고하세요. 확인하세요.