이 페이지에서는 Google Workspace 부가기능 이벤트 객체의 구조를 간략하게 설명합니다.
이벤트 객체는 사용자가 부가기능과 상호작용할 때 트리거하거나 콜백 함수를 실행하기 위한 매개변수로 자동 구성되고 전달되는 JSON 구조입니다. 이벤트 객체는 호스트 앱과 현재 컨텍스트에 대한 클라이언트 측 정보를 부가기능의 서버 측 콜백 함수에 전달합니다.
Google Workspace 부가기능은 다음 위치에서 이벤트 객체를 사용합니다.
홈페이지 트리거. 정의하는 모든
homepageTrigger
함수는 홈페이지 트리거 함수가 실행될 때 이벤트 객체를 자동으로 전달합니다. 홈페이지 트리거 함수에서 이 객체를 사용하여 활성 호스트 앱, 클라이언트의 플랫폼, 사용자 언어, 기타 정보를 식별할 수 있습니다.홈페이지 트리거가 실행될 때 생성된 이벤트 객체에는 다른 두 경우에 포함된 모든 필드가 포함되지는 않습니다. 위젯 및 컨텍스트 정보와 관련된 필드는 생략됩니다.
문맥 트리거. 각 호스트 애플리케이션은 사용자가 특정 컨텍스트로 들어갈 때 실행되는 서로 다른 컨텍스트 트리거 집합을 제공합니다. 예를 들면 다음과 같습니다.
- Gmail은 사용자가 메시지를 열 때와 사용자가 메시지를 작성할 때를 위한 컨텍스트 트리거를 제공합니다.
- Google Calendar는 사용자가 이벤트를 열 때에 대한 컨텍스트 트리거를 제공합니다.
- Google Drive는 사용자가 Drive 파일을 선택할 때 컨텍스트 트리거를 제공합니다.
컨텍스트 트리거가 실행되면 호스트 애플리케이션이 부가기능 매니페스트에 나열된 상응하는
runFunction
를 호출하여 이벤트 객체를 매개변수로 전달합니다. 문맥 트리거가 발생할 때 생성된 이벤트 객체에는 홈페이지 트리거 이벤트 객체에 포함된 모든 필드와 문맥 정보가 포함된 필드가 포함됩니다.위젯 작업. 이벤트 객체는 Gmail 부가기능에서 사용하는 것과 동일한 작업 모델을 사용하여 위젯 상호작용을 제공하는 데도 사용됩니다. Google Workspace 부가기능은 동일한 위젯 핸들러 함수,
Action
객체, 작업 응답을 모두 사용합니다. 그러나 Google Workspace 부가기능의 작업 이벤트 객체에는 콜백 함수가 작동할 수 있는 추가 정보가 포함되어 있습니다.위젯 작업의 결과로 생성된 이벤트 객체에는 컨텍스트 트리거 이벤트 객체에 포함된 모든 필드와 위젯 정보가 포함된 필드가 포함됩니다.
링크 트리거 미리보기 (개발자 프리뷰). Google Docs에서 특정 URL 패턴을 기반으로 타사 서비스의 링크 미리보기를 구성할 수 있습니다. 사용자가 패턴을 충족하는 링크와 상호작용하면
previewLinkTrigger
가 실행되고 링크가 포함된 이벤트 객체가 트리거의 콜백 함수에 전달됩니다. 부가기능은 이 이벤트 객체를 사용하여 호스트 애플리케이션 내 링크 관련 정보를 표시하는 스마트 칩과 카드를 구성할 수 있습니다. 사용자가 미리보기 카드 및 카드 콘텐츠와 상호작용할 수 있도록 위젯 작업을 빌드할 수도 있습니다.
이벤트 객체 구조
다음 표에서는 Google Workspace 부가기능 이벤트 객체의 최상위 구조를 설명합니다. 이벤트 객체 구조에는 호스트와 무관한 정보를 위한 commonEventObject
필드가 포함되어 있습니다. 각 이벤트 객체는 활성 호스트 앱에 의해 결정되는 호스트별 최상위 필드 중 하나(gmailEventObject
, calendarEventObject
또는 driveEventObject
)를 가질 수도 있습니다.
이전 버전과의 호환성을 위해 Google Workspace 부가기능 이벤트 객체에는 Gmail 부가기능 작업 이벤트 객체에 사용된 모든 원본 필드도 포함됩니다. 이러한 필드는 아래 표의 '기존 Gmail 부가기능 필드' 아래 나열됩니다. 이러한 필드의 정보는 새로운 객체 구조로 재현됩니다.
이벤트 객체 | |
---|---|
eventObject.commonEventObject |
Common fields object
호스트 애플리케이션에 관계없이 모든 이벤트 객체에 공통된 정보가 포함된 객체입니다. |
eventObject.calendar |
Calendar event object
통화 호스트가 Google Calendar인 경우에만 표시됩니다. 캘린더 및 일정 정보가 포함된 객체입니다. |
eventObject.drive |
Drive event object
통화 호스트가 Google Drive인 경우에만 표시됩니다. Drive 정보가 포함된 객체입니다. |
eventObject.gmail |
Gmail event object
통화 호스트가 Gmail인 경우에만 표시됩니다. Gmail 정보가 포함된 객체입니다. |
eventObject.docs |
Docs event object
통화 호스트가 Google Docs인 경우에만 표시 문서 정보가 포함된 객체입니다. |
eventObject.sheets |
Sheets event object
통화 호스트가 Google Sheets인 경우에만 표시됩니다. Sheets 정보가 포함된 객체입니다. |
eventObject.slides |
Slides event object
통화 호스트가 Google Slides인 경우에만 표시 Slides 정보가 포함된 객체입니다. |
기존 Gmail 부가기능 필드 | |
eventObject.messageMetadata.accessToken |
string 지원 중단됨 액세스 토큰 이를 사용하여 임시 Gmail 부가기능 범위를 사용하는 사용자 데이터에 대한 액세스를 사용 설정할 수 있습니다.
Google Workspace 부가기능의 경우 |
eventObject.messageMetadata.messageId |
string 지원 중단됨 Gmail UI에서 열린 대화목록의 메시지 ID입니다.
Google Workspace 부가기능의 경우 |
eventObject.clientPlatform |
string 지원 중단됨 이벤트가 발생한 위치 (웹, iOS 또는 Android)를 나타냅니다.
Google Workspace 부가기능의 경우 |
eventObject.formInput |
object 지원 중단됨 카드에 있는 모든 양식 위젯의 현재 값 맵으로, 위젯당 하나의 값으로 제한됩니다. 키는 위젯과 연결된 문자열 ID이고 값은 문자열입니다. 이벤트 객체는 텍스트 입력 및 스위치와 같은 예상 단수형 값을 갖는 여러 위젯에서 데이터를 읽어야 할 때 편리하게 사용할 수 있도록 formInput 를 제공합니다. 체크박스와 같은 다중 값 위젯의 경우 대신 formInputs 에서 각 값을 읽을 수 있습니다.
Google Workspace 부가기능의 경우 대신 |
eventObject.formInputs |
object 지원 중단됨 카드에 있는 위젯의 현재 값의 맵으로, 문자열 목록으로 표시됩니다. 키는 위젯과 연결된 문자열 ID입니다. 단일 값 위젯의 경우 값이 단일 요소 배열로 표시됩니다. 체크박스 그룹과 같은 다중 값 위젯의 경우 모든 값이 목록에 표시됩니다.
Google Workspace 부가기능의 경우 |
eventObject.parameters |
object 지원 중단됨 Action.setParameters() 를 사용하여
Action 에 제공하는 추가 매개변수의 맵. 맵 키와 값은 문자열입니다.
Google Workspace 부가기능의 경우 |
eventObject.userCountry |
string 기본적으로 지원 중단되었으며 사용 중지되었습니다. 사용자의 국가 또는 지역을 나타내는 2자리 코드입니다. 숫자 UN M49 국가 코드일 수도 있습니다.
Google Workspace 부가기능의 경우 |
eventObject.userLocale |
string 기본적으로 지원 중단되었으며 사용 중지되었습니다. 사용자의 언어를 나타내는 두 글자 ISO 639 코드입니다. 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.
Google Workspace 부가기능의 경우 |
eventObject.userTimezone.id |
string 기본적으로 지원 중단되었으며 사용 중지되었습니다. 사용자 시간대의 시간대 식별자 예를 들면 America/New_York , Europe/Vienna , Asia/Seoul 가 있습니다. 자세한 내용은
사용자 언어 및 시간대 액세스를 참고하세요.
Google Workspace 부가기능의 경우 |
eventObject.userTimezone.offset |
string 기본적으로 지원 중단되었으며 사용 중지되었습니다. 사용자 시간대의 협정 세계시(UTC)를 기준으로 한 시차(밀리초 단위)입니다. 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.
Google Workspace 부가기능의 경우 |
공통 이벤트 객체
공통 이벤트 객체는 사용자 클라이언트의 부가기능에 일반적인 호스트 독립 정보를 전달하는 전체 이벤트 객체의 일부입니다. 이 정보에는 사용자의 언어, 호스트 앱, 플랫폼과 같은 세부정보가 포함됩니다.
부가기능은 홈페이지 및 컨텍스트 트리거 외에도 사용자가 위젯을 사용할 때 이벤트 객체를 구성하여 작업 콜백 함수에 전달합니다. 부가기능의 콜백 함수는 공통 이벤트 객체를 쿼리하여 사용자의 클라이언트에 열려 있는 위젯의 콘텐츠를 파악할 수 있습니다. 예를 들어 부가기능은 사용자가 eventObject.commentEventObject.formInputs
객체의 TextInput
위젯에 입력한 텍스트를 찾을 수 있습니다.
공통 이벤트 객체 필드 | |
---|---|
commonEventObject.platform |
string 이벤트의 출처를 나타냅니다 (예: '웹', 'iOS' 또는 'Android'). |
commonEventObject.formInputs |
object 표시된 카드에 있는 위젯의 현재 값이 포함된 지도입니다. 맵 키는 각 위젯에 할당된 문자열 ID입니다. 지도 값 객체의 구조는 위젯 유형에 따라 다릅니다.
|
commonEventObject.hostApp |
string 이벤트 객체가 생성될 때 부가기능이 활성인 호스트 앱을 나타냅니다. 가능한 값은 다음과 같습니다.
|
commonEventObject.parameters |
object
Action.setParameters() 를 사용하여
Action 에 제공하는 모든 추가 매개변수.
|
commonEventObject.userLocale |
string 기본적으로 사용 중지됨. ISO 639 언어 코드-ISO 3166 국가/지역 코드 형식의 사용자 언어 및 국가/지역 식별자입니다. 예를 들면 en-US 입니다.
이 필드를 사용 설정하려면 부가기능 매니페스트에서 |
commonEventObject.timeZone |
string 기본적으로 사용 중지됨. 시간대 ID 및 오프셋입니다. 이 필드를 사용 설정하려면 부가기능의 매니페스트에서 addOns.common.useLocaleFromApp 를 true 로 설정해야 합니다.
부가기능의 범위 목록에도 https://www.googleapis.com/auth/script.locale 가 포함되어야 합니다.
자세한 내용은
사용자 언어 및 시간대 액세스를 참고하세요.
|
commonEventObject.timeZone.id |
string 사용자 시간대의 시간대 식별자입니다. 예를 들면 America/New_York , Europe/Vienna , Asia/Seoul 가 있습니다. 이 필드를 사용 설정하려면 부가기능의 매니페스트에서 addOns.common.useLocaleFromApp 를 true 로 설정해야 합니다.
부가기능의 범위 목록에도 https://www.googleapis.com/auth/script.locale 가 포함되어야 합니다. 자세한 내용은
사용자 언어 및 시간대 액세스를 참고하세요.
|
commonEventObject.timeZone.offset |
string 사용자 시간대의 협정 세계시(UTC) 기준의 시차(밀리초 단위)입니다. 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요. |
날짜/시간 선택 도구 양식 입력
작업 콜백 함수는 commonEventObject.formInputs
필드에서 현재 위젯 값을 수신할 수 있습니다.
여기에는 날짜 또는 시간 선택 도구 위젯에서 사용자가 선택한 날짜 또는 시간 값이 포함됩니다.
그러나 정보의 구조는 위젯이 날짜/시간 선택 도구로 구성되었는지, 날짜 전용 선택 도구로 구성되었는지, 시간 전용 선택 도구로 구성되었는지에 따라 다릅니다. 구조상의 차이는 다음 표에 설명되어 있습니다.
캘린더 일정 객체
캘린더 이벤트 객체는 사용자의 캘린더 및 캘린더 일정에 관한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션이 Google Calendar인 경우에만 이벤트 객체에 표시됩니다.
다음 표에는 이벤트 객체의 calendarEventObject
필드에 있는 필드가 나와 있습니다. 사용자 생성 데이터로 표시된 필드는 데이터가 Calendar 일정에 있고 부가기능에서 addOns.calendar.currentEventAccess
매니페스트 필드를 READ
또는 READ_WRITE
로 설정한 경우에만 이벤트 객체에 표시됩니다.
캘린더 일정 객체 | |
---|---|
calendar.attendees[] |
list of attendee objects 사용자 생성 데이터. 캘린더 일정의 참석자 목록입니다. |
calendar.calendarId |
string 캘린더 ID입니다. |
calendar.capabilities |
object 사용자 제작 데이터. 이벤트 정보를 보거나 업데이트하는 부가기능 기능을 설명하는 객체입니다. |
calendar.capabilities.canAddAttendees |
boolean 사용자 제작 데이터. true
부가기능이 이벤트 참석자 목록에 새 참석자를 추가할 수 있는 경우 true , 그렇지 않은 경우 false 입니다. |
calendar.capabilities.canSeeAttendees |
boolean 사용자 제작 데이터. true
부가기능이 일정 참석자 목록을 읽을 수 있는 경우 false
그렇지 않은 경우 |
calendar.capabilities.canSeeConferenceData |
boolean 사용자 제작 데이터. 부가기능이 이벤트 회의 데이터를 읽을 수 있는 경우에는 true 이고, 그렇지 않은 경우에는 false 입니다. |
calendar.capabilities.canSetConferenceData |
boolean 사용자 제작 데이터. true
부가기능이 일정 회의 데이터를 업데이트할 수 있는 경우 false
그렇지 않은 경우 |
calendar.capabilities.canAddAttachments |
boolean 사용자 제작 데이터. true
부가기능이 일정에 새 첨부파일을 추가할 수 있는 경우 true , 그렇지 않은 경우 false
|
calendar.conferenceData |
Conference data object 사용자 생성 데이터. Google Meet 회의 세부정보와 같이 이 이벤트와 연결된 모든 회의 데이터를 나타내는 객체입니다. |
calendar.id |
string 이벤트 ID입니다. |
calendar.organizer |
object 이벤트의 주최자를 나타내는 객체입니다. |
calendar.organizer.email |
string 일정 주최자의 이메일 주소입니다. |
calendar.recurringEventId |
string 반복 이벤트의 ID입니다. |
참석자
참석자 객체는 개별 참석자에 대한 정보를 Google Calendar 일정에 전달합니다. 이 정보는 데이터가 캘린더 일정에 있고 부가기능에서 addOns.calendar.currentEventAccess
매니페스트 필드를 READ
또는 READ_WRITE
로 설정한 경우에만 이벤트 객체에 표시됩니다.
참석자 객체 | |
---|---|
attendee.additionalGuests |
number 참석자가 참석한다고 표시한 추가 참석자 수입니다. 기본값은 0입니다. |
attendee.comment |
string 참석자의 응답 댓글(있는 경우) |
attendee.displayName |
string 참석자 표시 이름입니다. |
attendee.email |
string 참석자 이메일 주소입니다. |
attendee.optional |
boolean 참석자가 선택사항으로 표시된 경우 true , 그렇지 않은 경우 false 입니다.
|
attendee.organizer |
boolean true (참석자가 이 일정의 주최자인 경우)
|
attendee.resource |
boolean true 은 참석자가 회의실 또는 장비와 같은 리소스를 나타내는 경우 표시되며 그 외의 경우에는 false 입니다.
|
attendee.responseStatus |
string 참석자의 응답 상태입니다. 가능한 값은 다음과 같습니다.
|
attendee.self |
boolean true 참석자가 이 이벤트가 표시되는 캘린더를 나타내는 경우이며, 그렇지 않은 경우 false 입니다.
|
회의 데이터
회의 데이터 객체는 Google Calendar 일정에 연결된 회의에 대한 정보를 전달합니다. Google Meet과 같은 Google 컨퍼런스 솔루션 또는 서드 파티 회의일 수 있습니다. 이 정보는 데이터가 캘린더 일정에 있고 부가기능에서 addOns.calendar.currentEventAccess
매니페스트 필드를 READ
또는 READ_WRITE
로 설정한 경우에만 이벤트 객체에 표시됩니다.
회의 데이터 객체 | |
---|---|
conferenceData.conferenceId |
string 회의 ID입니다. 이 ID는 애플리케이션에서 회의를 추적할 수 있도록 하기 위한 것으로 사용자에게 ID를 표시해서는 안 됩니다. |
conferenceData.conferenceSolution |
object 회의 솔루션(예: 행아웃, Google Meet)을 나타내는 객체입니다. |
conferenceData.conferenceSolution.iconUri |
string 이 회의 솔루션을 나타내는 사용자에게 표시되는 아이콘의 URI입니다. |
conferenceData.conferenceSolution.key |
object 이 이벤트의 회의 솔루션을 고유하게 식별하는 키입니다. |
conferenceData.conferenceSolution.key.type |
string 회의 솔루션 유형 가능한 값은 다음과 같습니다.
|
conferenceData.conferenceSolution.name |
string 회의 솔루션의 사용자 표시 이름으로, 현지화되지 않았습니다. |
conferenceData.entryPoints[] |
list of entry point objects
URL 또는 전화번호와 같은 컨퍼런스 진입점의 목록입니다. |
conferenceData.notes |
string 사용자에게 표시할 회의에 대해 추가 메모 (도메인 관리자의 안내 또는 법적 고지) HTML을 포함할 수 있습니다. 최대 길이는 2,048자(영문 기준)입니다. |
conferenceData.parameters |
object 부가기능에서 사용할 수 있도록 정의된 매개변수 데이터 맵이 포함된 객체입니다. |
conferenceData.parameters.addOnParameters |
object 매개변수 문자열 키와 값의 맵입니다. 이러한 키 및 값은 부가기능 개발자가 사용할 수 있도록 특정 회의에 정보를 연결하기 위해 부가기능 개발자가 정의합니다. |
진입점
진입점 객체는 전화 또는 동영상과 같이 지정된 회의에 액세스하는 기존 수단에 관한 정보를 전달합니다. 이 정보는 데이터가 캘린더 일정에 있고 부가기능에서 addOns.calendar.currentEventAccess
매니페스트 필드를 READ
또는 READ_WRITE
로 설정한 경우에만 이벤트 객체에 표시됩니다.
진입점 객체 | |
---|---|
entryPoint.accessCode |
string 회의에 액세스하는 데 사용되는 액세스 코드입니다. 최대 길이는 128자(영문 기준)입니다. 일반적으로 회의 제공업체는 { accessCode , meetingCode , passcode , password , pin }의 하위 집합만 사용하여 회의 액세스를 제공합니다. 회의 제공업체가 사용하는 필드만 일치하여 표시합니다.
|
entryPoint.entryPointFeatures |
list 진입점의 특징 현재 다음 기능은 phone 진입점에만 적용됩니다.
|
entryPoint.entryPointType |
string 진입점의 유형입니다. 가능한 값은 다음과 같습니다.
|
entryPoint.label |
string 사용자에게 표시되는 진입점 URI(라벨 아님)의 라벨입니다. |
entryPoint.meetingCode |
string 회의에 사용되는 회의 코드입니다. 최대 길이는 128자(영문 기준)입니다. 일반적으로 회의 제공업체는 { accessCode , meetingCode , passcode , password , pin }의 하위 집합만 사용하여 회의 액세스를 제공합니다. 회의 제공업체가 사용하는 필드만 일치하여 표시합니다.
|
entryPoint.passcode |
string 회의에 액세스하는 데 사용되는 비밀번호입니다. 최대 길이는 128자(영문 기준)입니다. 일반적으로 회의 제공업체는 { accessCode , meetingCode , passcode , password , pin }의 하위 집합만 사용하여 회의 액세스를 제공합니다. 회의 제공업체가 사용하는 필드만 일치하여 표시합니다.
|
entryPoint.password |
string 회의에 액세스하는 데 사용되는 비밀번호입니다. 최대 길이는 128자(영문 기준)입니다. 일반적으로 회의 제공업체는 { accessCode , meetingCode , passcode , password , pin }의 하위 집합만 사용하여 회의 액세스를 제공합니다. 회의 제공업체가 사용하는 필드만 일치하여 표시합니다.
|
entryPoint.pin |
string 회의에 액세스하는 데 사용된 PIN입니다. 최대 길이는 128자(영문 기준)입니다. 일반적으로 회의 제공업체는 { accessCode , meetingCode , passcode , password , pin }의 하위 집합만 사용하여 회의 액세스를 제공합니다. 회의 제공업체가 사용하는 필드만 일치하여 표시합니다.
|
entryPoint.regionCode |
string 전화번호의 지역 코드입니다. URI에 국가 코드가 포함되지 않은 경우 필요합니다. 값은 공개 CLDR 지역 코드 목록을 기반으로 합니다. |
entryPoint.uri |
string 진입점의 URI 최대 길이는 1,300자(영문 기준)입니다. 형식은 진입점 유형에 따라 다릅니다.
|
Drive 이벤트 객체
Drive 이벤트 객체는 사용자의 Google Drive 및 콘텐츠에 대한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션이 Google Drive인 경우에만 이벤트 객체에 표시됩니다.
Drive 이벤트 객체 | |
---|---|
drive.activeCursorItem |
Drive item object 현재 Drive 항목이 활성 상태입니다. |
drive.selectedItems[] |
list of Drive item objects Drive에서 선택된 항목 (파일 또는 폴더) 목록. |
Drive 항목
Drive 항목 객체에는 파일 또는 폴더와 같은 특정 Drive 항목에 관한 정보가 포함됩니다.
Drive 항목 객체 | |
---|---|
item.addonHasFileScopePermission |
boolean true 인 경우 부가기능에서 이 항목의 https://www.googleapis.com/auth/drive.file 범위 승인을 요청했고 수신한 것입니다. 그렇지 않은 경우 이 필드는 false 입니다.
|
item.id |
string 선택한 항목의 ID입니다. |
item.iconUrl |
string 선택한 항목을 나타내는 아이콘의 URL입니다. |
item.mimeType |
string 선택한 항목의 MIME 유형입니다. |
item.title |
string 선택한 항목의 제목입니다. |
Gmail 이벤트 객체
Gmail 이벤트 객체는 사용자의 Gmail 메시지에 관한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션에서 Gmail을 사용하는 경우에만 이벤트 객체에 표시됩니다.
Gmail 이벤트 객체 | |
---|---|
gmail.accessToken |
string Gmail 전용 액세스 토큰입니다. 이 토큰을 GmailApp.setCurrentMessageAccessToken(accessToken) 메서드와 함께 사용하여 사용자가 현재 연 Gmail 메시지에 대한 임시 액세스 권한을 부여하거나 부가기능이 새 초안을 작성하도록 할 수 있습니다.
|
gmail.bccRecipients[] |
list of strings 기본적으로 사용 중지됨. 현재 부가기능이 작성 중인 초안에 포함된 'BCC:' 수신자 이메일 주소의 목록. 이 필드를 사용 설정하려면 매니페스트에서 addOns.gmail.composeTrigger.draftAccess 필드를 METADATA 로 설정해야 합니다.
|
gmail.ccRecipients[] |
list of strings 기본적으로 사용 중지됨. 현재 부가기능에 작성 중인 초안에 포함된 'CC:' 수신자 이메일 주소의 목록 이 필드를 사용 설정하려면 매니페스트에서 addOns.gmail.composeTrigger.draftAccess 필드를 METADATA 로 설정해야 합니다.
|
gmail.messageId |
string 현재 열려 있는 Gmail 메시지의 ID입니다. |
gmail.threadId |
string 현재 열려 있는 Gmail 대화목록 ID |
gmail.toRecipients[] |
list of strings 기본적으로 사용 중지됨. 부가기능이 작성 중인 초안에 현재 포함되어 있는 '받는사람:' 수신자 이메일 주소의 목록 이 필드를 사용 설정하려면 매니페스트에서 addOns.gmail.composeTrigger.draftAccess 필드를 METADATA 로 설정해야 합니다.
|
Docs 이벤트 객체
Docs 이벤트 객체는 사용자의 문서 및 콘텐츠에 관한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션이 Google Docs인 경우에만 이벤트 객체에 표시됩니다.
Docs 이벤트 객체 | |
---|---|
docs.id |
string
https://www.googleapis.com/auth/drive.file 범위가 사용자가 승인한 경우에만 표시됩니다.문서 UI에서 열린 문서의 ID입니다. |
docs.title |
string 사용자가
https://www.googleapis.com/auth/drive.file 범위를 승인한 경우에만 표시됩니다.문서 제목이 문서 UI에서 열립니다. |
docs.addonHasFileScopePermission |
boolean true 인 경우, 부가기능이 문서 UI에서 열린 문서에 대한 https://www.googleapis.com/auth/drive.file 범위 승인을 요청하고 수신한 경우, 그렇지 않으면 이 필드는 false 입니다.
|
docs.matchedUrl.url |
string
다음 조건을 충족하는 경우에만 표시됩니다.
Google Docs에서 미리보기를 생성하는 링크의 URL입니다. 이 필드를 사용하려면 부가기능의 매니페스트에서 LinkPreviewTriggers 를 구성해야 합니다. 자세한 내용은 Google Docs에서 링크 미리보기를 참고하세요.
|
Sheets 이벤트 객체
Sheets 이벤트 객체는 사용자의 문서 및 콘텐츠에 대한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션이 Google Sheets인 경우에만 이벤트 객체에 표시됩니다.
Sheets 이벤트 객체 | |
---|---|
sheets.id |
string
https://www.googleapis.com/auth/drive.file 범위가 사용자가 승인한 경우에만 표시됩니다. Sheets UI에서 열리는 스프레드시트 ID입니다.
|
sheets.title |
string
https://www.googleapis.com/auth/drive.file 범위가 사용자가 승인한 경우에만 표시됩니다. Sheets UI에서 스프레드시트의 제목이 열립니다.
|
sheets.addonHasFileScopePermission |
boolean true 인 경우 부가기능이 Sheets UI에서 열린 스프레드시트에 대해 https://www.googleapis.com/auth/drive.file 범위 승인을 요청하고 수신한 경우, 그렇지 않으면 이 필드는 false 입니다.
|
Slides 이벤트 객체
Slides 이벤트 객체는 사용자의 문서 및 콘텐츠에 관한 정보를 전달하는 전체 이벤트 객체의 일부입니다. 호스트 애플리케이션이 Google Slides인 경우에만 이벤트 객체에 표시됩니다.
Slides 이벤트 객체 | |
---|---|
slides.id |
string
https://www.googleapis.com/auth/drive.file 범위가 사용자가 승인한 경우에만 표시됩니다. Slides UI에서 열리는 프레젠테이션 ID입니다.
|
slides.title |
string
https://www.googleapis.com/auth/drive.file 범위가 사용자가 승인한 경우에만 표시됩니다. Slides UI에서 열리는 프레젠테이션의 제목입니다.
|
slides.addonHasFileScopePermission |
boolean true 인 경우 부가기능에서 Slides UI에 열린 프레젠테이션에 대해 https://www.googleapis.com/auth/drive.file 범위 승인을 요청하고 수신한 경우, 그렇지 않은 경우에는 이 필드가 false 입니다.
|