사용자의 경험을 개선하고 이 부가기능 가이드를 따라 전반적인 사용자 환경을 개선할 수 있습니다 설계했습니다.
일반 권장사항
모든 부가기능에 대해 다음 권장사항을 따르는 것이 좋습니다. 있습니다.
시작하기 전에 부가기능 소유권 확인
부가기능은 특정 관리자 또는 팀원이 소유해야 하는 Apps Script 프로젝트에 의해 공유 드라이브에 저장할 수 있습니다. 부가기능을 코딩하기 전에 프로젝트를 소유할 계정을 결정하고 확인할 수 있습니다. 어떤 계정에 조치를 취할지 결정합니다. 해당 계정이 스크립트에 액세스할 수 있는지 프로젝트와 연결된 Cloud Platform 프로젝트.
복제하지 않고 Google Workspace 확장
새로운 기능을 제공하도록 설계되었습니다. 확장 가능한 Google Workspace 애플리케이션 복잡한 작업을 자동화합니다 기능을 복제만 하는 부가기능은 크게 개선되지 않는 것들은 부가기능 검토를 통과하지 못할 가능성이 간행물
범위 좁게 유지
범위를 명시적으로 정의할 때는
항상 가능한 가장 낮은 허용 범위 집합을 선택합니다. 예를 들어
부가기능 요청에 사용자 캘린더에 대한 전체 액세스 권한이 있어야 합니다.
읽기만 필요한 경우 범위 https://www.googleapis.com/auth/calendar개
액세스할 수 있습니다 읽기 전용 액세스의 경우
https://www.googleapis.com/auth/calendar.readonly 범위.
라이브러리에 너무 많이 의존하지 않기
Apps Script 라이브러리를 사용하면 이 부가기능보다 더 느리게 실행되는 부가기능 를 사용해야 할 수도 있습니다. Apps Script 라이브러리는 부가기능에서 작동하지만 성능이 저하될 수 있습니다. 줄일 수 있습니다. 부가기능에 대한 애드온 의존도를 줄이는 방법을 고려해 보세요.
위에 설명된 지연 시간은 사용 중인 Apps Script 프로젝트에만 적용됩니다. 서버 측 라이브러리로 사용할 수 있습니다 다음과 같은 클라이언트 측 JavaScript 라이브러리를 사용할 수 있습니다. 이러한 지연 시간 없이 자유롭게 jQuery를 사용할 수 있습니다.
Google Workspace 부가기능 권장사항
다음 권장사항은 Google Workspace 부가기능 및 사용 카드 서비스의 인스턴스입니다.
몇 개의 카드만 사용
부가기능에서 너무 많은 카드를 사용하면 탐색 구성에서 복잡해지고 관리하기 어려워집니다
필요 이상으로 많은 카드를 만들려고 하지 마세요.
위젯 생성 함수 사용
Card를 생성하는 코드를 작성할 때
또는 다른 복잡한 UI 객체를 포함하는 경우 해당 코드를 자체 함수에 넣는 것이 좋습니다.
이 생성 함수는 객체를 빌드하고 반환하기만 하면 됩니다. 이를 통해
UI를 새로고침해야 할 때마다 이 객체를 빠르게 다시 생성할 수 있습니다. 유의사항
다음에서 빌더 클래스를 사용한 후 build()를 호출하도록
카드 서비스.
카드를 단순하게 유지하기
특정 카드에 위젯이 너무 많으면 화면을 너무 많이 채우고 덜 유용해질 것입니다. 큰 카드 섹션은 접을 수 있는 UI 요소로 렌더링되지만 이렇게 하면 사용자에게 정보가 표시되지 않습니다. 부가 채널을 간소화하고 사용자가 필요로 하는 것을 정확하게 이해할 수 있습니다
오류 카드 사용
오류 조건에 대한 카드를 만듭니다. 부가기능에서 오류가 발생하는 경우 오류 정보와 해결 방법이 포함된 카드를 표시합니다. 할 수 있습니다. 예: 부가기능을 Google 외부 네트워크에 연결할 수 없는 경우 고객에게 이를 설명하는 카드를 표시하고 사용자가 사용 중인 계정 정보를 확인해야 합니다.
테스트 및 테스트 메시지 작성
만드는 모든 부가기능은 철저히 테스트해야 합니다. 다음과 같은 테스트 함수를 빌드합니다. 테스트 데이터를 사용하여 카드와 위젯을 만든 다음 객체가 생성할 수 있습니다
작업 콜백 함수를 사용하는 경우 일반적으로 응답 객체를 구성해야 합니다. 다음과 같은 문을 사용할 수 있습니다. 응답이 올바르게 구성되었는지 확인합니다.
Logger.log(response.printJson());
Apps Script에서 직접 만든 테스트 기능 실행 Run(실행) 메뉴를 사용하여 편집기를 실행합니다. 실행 가능한 부가기능이 있다면 게시되지 않은 버전을 설치해야 합니다. 테스트할 수 있습니다
부가기능이 확장하는 각 호스트 애플리케이션에 적합한 테스트 데이터를 사용합니다. 대상 예를 들어 부가기능이 Gmail을 확장하는 경우 테스트 이메일이 몇 개 필요할 수 있습니다. 메시지 ID를 확인하여 부가기능이 예상되는 오류입니다. 포드의 메시지 ID를 가져와서 사용하여 주어진 메시지를 Gmail API Users.messages.list 또는 Apps Script의 Gmail 서비스.
캘린더 회의 권장사항
부가기능이 서드 파티와 통합되는 경우 캘린더 회의 옵션을 Google Calendar에 가져오려면 다음 추가 권장사항을 따르세요.
onCreateFunction 조명 유지
각 onCreateFunction
사용자가 다른 컨테이너에서 코드를 실행하려고 하면
컨퍼런스 솔루션을 만들 수 있습니다. 이러한 함수가
회의 생성에 필요한 최소한의 작업만 남겨두었습니다. 이러한 작업을 너무 많이 함
함수를 사용하면 부가기능의 사용자 환경이 느려질 수 있습니다.
회의 데이터에 적절한 ConferenceData 필드 사용
빌드 시
ConferenceData
컨퍼런스에 대한 세부정보로 채울 수 있습니다 (액세스 가능).
개인 식별 번호, 전화번호, PIN, URI 등). 해당하는
EntryPoint 필드
를 참조하세요. 이러한 세부정보를 ConferenceData에 배치하지 마세요.
있습니다.
Google Calendar 일정에 회의 세부정보 추가 안함
부가기능에 생성된 서드 파티에 관한 정보는 추가할 필요가 없습니다. 일정을 Google Calendar 일정 설명에 추가합니다. Google Calendar가 제공하는 기능 이를 자동으로 수행합니다