이벤트 객체

이 페이지에서는 Google Workspace 부가기능 이벤트 객체의 구조를 간략히 설명합니다.

이벤트 객체는 자동으로 구성되고 전달되는 JSON 구조입니다. 이를 매개변수로, 사용자가 특정 웹사이트와 상호작용할 때 함수를 트리거하거나 부가기능 이벤트 객체는 호스트 앱과 부가기능의 서버 측 콜백 함수에 추가합니다.

Google Workspace 부가기능은 다음 위치에서 이벤트 객체를 사용합니다.

  • 홈페이지 트리거. 정의한 모든 homepageTrigger 함수는 이벤트를 자동으로 전달함 객체가 됩니다. 이 객체는 홈페이지 트리거 함수를 사용하여 활성 호스트 앱, 클라이언트의 플랫폼, 사용자 언어, 기타 정보가 포함됩니다.

    홈페이지 트리거가 실행될 때 생성된 이벤트 객체에는 필드가 포함되어 있습니다 Kubernetes에 적용되는 생략됩니다.

  • 컨텍스트 트리거. 각 호스트 애플리케이션은 애플리케이션이 실행되는 다른 사용자가 특정 컨텍스트를 입력하면 실행됩니다. 예를 들면 다음과 같습니다.

    상황별 트리거가 실행되면 호스트 애플리케이션은 상응하는 runFunction를 호출하여 이벤트 객체를 매개변수로 전달합니다. 컨텍스트 기반일 때 생성되는 이벤트 객체입니다. 화재 트리거에는 홈페이지 트리거 이벤트에 포함된 모든 필드가 포함됨 객체, 그리고 문맥 정보가 포함된 필드를 가립니다.

  • 위젯 작업. 이벤트 객체 widget을 제공하는 데도 사용됩니다 같은 상호작용성도 Gmail 부가기능이 제공하는 작업 모델 사용합니다 Google Workspace 부가기능은 동일한 위젯 핸들러 기능을 모두 사용합니다. Action 객체 및 작업 확인할 수 있습니다 하지만 Google Workspace 부가기능에서 액션 이벤트 객체 콜백 함수가 작동할 수 있는 더 많은 정보를 포함합니다.

    위젯 작업의 결과로 생성되는 이벤트 객체에는 문맥 트리거 이벤트 객체에 포함된 필드와 위젯 정보

  • 링크 트리거 미리보기. Google Docs, Sheets, Slides에서 다음 작업을 할 수 있습니다. 서드 파티 서비스의 링크 미리보기 구성 특정 URL 패턴에 따라 달라집니다. 사용자가 패턴, linkPreviewTriggers 드림 이 트리거되고 링크가 포함된 이벤트 객체가 트리거의 콜백함수로 전달하세요. 부가기능은 이 이벤트 객체를 사용하여 호스트 내의 링크에 대한 정보를 표시하는 스마트 칩 및 카드 애플리케이션입니다. 사용자가 상호작용할 수 있는 위젯 작업을 만들 수도 있습니다. 미리보기 카드와 그 콘텐츠를 보여줍니다.

이벤트 객체 구조

다음 표에서는 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인 경우에만 표시됩니다. 객체 드라이브 정보가 포함되어 있습니다.
eventObject.gmail Gmail event object
호출 호스트가 Gmail인 경우에만 표시됩니다. 객체 Gmail 정보를 포함할 수 있습니다.
eventObject.docs Docs event object
호출 호스트가 Google Docs인 경우에만 표시됩니다. 객체 문서 정보를 포함합니다.
eventObject.sheets Sheets event object
호출 호스트가 Google Sheets인 경우에만 표시됩니다. 객체 스프레드시트 정보가 포함되어 있습니다.
eventObject.slides Slides event object
호출 호스트가 Google Slides인 경우에만 표시됩니다. 객체 슬라이드 정보가 포함되어 있습니다.
기존 Gmail 부가기능 입력란
eventObject.messageMetadata.accessToken string
지원 중단되었습니다. 액세스 토큰 이때 임시 Gmail 부가기능 범위를 사용하여 사용자 데이터에 액세스하도록 사용 설정합니다.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.gmail.accessToken 드림 필드를 확인합니다.

eventObject.messageMetadata.messageId string
지원 중단되었습니다. 대화목록의 메시지 ID Gmail UI에서 열립니다.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.gmail.messageId 드림 필드를 확인합니다.

eventObject.clientPlatform string
지원 중단되었습니다. 이벤트 위치를 나타냅니다. 출처 (웹, iOS 또는 Android)를 확인할 수 있습니다

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.platform 드림 필드를 확인합니다.

eventObject.formInput object
지원 중단되었습니다. 현재 값의 맵입니다. 카드에 있는 모든 양식 위젯의 총합으로, 위젯당 하나의 값으로 제한됩니다. 이 키는 위젯과 연결된 문자열 ID이며, 값은 합니다. 이벤트 객체는 formInput를 다음과 같이 제공합니다. 여러 위젯에서 데이터를 읽어야 할 때 예상되는 단일 값(예: 텍스트 입력 및 스위치) 대상 여러 값을 가진 위젯의 경우 각 값을 대신 formInputs하세요.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.formInputs 드림 필드를 사용해야 합니다. 단일 값을 가진 위젯은 할 수 있습니다.

eventObject.formInputs object
지원 중단되었습니다. 현재 값 맵은 문자열 목록으로 표시되는 카드의 위젯입니다. 키는 위젯과 연결된 문자열 ID입니다. 단일 값 위젯의 경우 값이 단일 요소 배열로 표시됩니다. 다중 값 위젯의 경우 모든 값이 목록에 표시됩니다.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.formInputs 드림 필드를 확인합니다.

eventObject.parameters object
지원 중단되었습니다. 추가적인 에 제공하는 매개변수를 <ph type="x-smartling-placeholder"></ph> Action 사용 <ph type="x-smartling-placeholder"></ph> Action.setParameters() 매핑 키와 값은 합니다.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.parameters 드림 필드를 확인합니다.

eventObject.userCountry string
지원 중단되었으며 기본적으로 사용 중지되어 있습니다. 이 사용자의 국가 또는 지역을 나타내는 두 글자 코드입니다. 또한 숫자 UN M49 국가 코드입니다.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.userLocale 드림 필드를 확인합니다.

eventObject.userLocale string
지원 중단되었으며 기본적으로 사용 중지되어 있습니다. 이 두 글자 ISO 639 사용자 언어를 나타내는 코드입니다. 자세한 내용은 사용자 액세스 언어 및 시간대를 참고하세요.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.userLocale 드림 필드를 확인합니다.

eventObject.userTimezone.id string
지원 중단되었으며 기본적으로 사용 중지되어 있습니다. 이 <ph type="x-smartling-placeholder"></ph> 시간대 식별자입니다. 예를 들면 다음과 같습니다. America/New_York, Europe/ViennaAsia/Seoul입니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.timeZone.id 드림 필드를 확인합니다.

eventObject.userTimezone.offset string
지원 중단되었으며 기본적으로 사용 중지되어 있습니다. 이 <ph type="x-smartling-placeholder"></ph> 사용자의 협정 세계시 (UTC)를 기준으로 밀리초 단위로 측정된 시간대입니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.

Google Workspace 부가기능의 경우 다음에서 이 정보를 확인하세요. eventObject.commonEventObject.timeZone.offset 드림 필드를 확인합니다.

공통 이벤트 객체

공통 이벤트 객체는 전체 이벤트 객체에서 호스트와 무관한 일반적인 정보를 사용자 클라이언트에서 부가기능으로 전송합니다. 이 정보에는 사용자의 언어, 호스트 앱, 플랫폼과 같은 세부정보가 포함됩니다.

홈페이지와 문맥 트리거 외에도 애드온은 이벤트 객체를 작업 콜백 함수로 사용자가 위젯과 상호작용할 때. 부가기능의 콜백 함수는 공통 이벤트 객체를 사용하여 사용자의 있습니다 예를 들어 부가기능은 사용자가 앱에 입력한 텍스트를 TextInput 위젯 eventObject.commentEventObject.formInputs 객체.

일반적인 이벤트 객체 필드
commonEventObject.platform string
이벤트가 발생한 위치를 나타냅니다 (`WEB`, `IOS` 또는 `ANDROID`)
commonEventObject.formInputs object
위젯을 사용할 수 있습니다. 맵 키는 할당할 수 있습니다.

맵 값 객체의 구조는 다음과 같습니다. 다음과 같습니다.

  • 단일 값 위젯 (예: 텍스트 상자): 문자열 목록 (하나의 요소만)

    : employeeName를 ID로 사용하고 텍스트에 액세스 입력 값: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • 다중 값 위젯 (예: 체크박스 그룹): 합니다.

    : participants를 ID로 사용하면 값에 액세스합니다. 다음으로 배열: e.commonEventObject.formInputs.participants.stringInputs.value입니다.

  • A date-time picker: a DateTimeInput object

    : ID가 myDTPicker인 선택 도구의 경우 먼저 DateTimeInput 객체 사용 e.commonEventObject.formInputs.myDTPicker.dateTimeInput

  • A date-only picker: a DateInput object

    : ID가 myDatePicker인 선택 도구의 경우 먼저 DateInput 객체를 e.commonEventObject.formInputs.myDatePicker.dateInput

  • A time-only picker: a TimeInput object

    : ID가 myTimePicker인 선택 도구의 경우 먼저 TimeInput 객체를 e.commonEventObject.formInputs.myTimePicker.timeInput

commonEventObject.hostApp string
부가기능이 활성화된 호스트 앱을 나타냅니다. 이벤트 객체가 생성될 때 가능한 값은 다음과 같습니다. 있습니다. <ph type="x-smartling-placeholder">
    </ph>
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
적용한 추가 매개변수 다음을 사용하여 Action에 제공합니다. Action.setParameters()입니다.
commonEventObject.userLocale string
기본적으로 사용 중지되어 있습니다. 사용자의 언어 국가/지역 식별자를 ISO 639 언어 코드-ISO 3166 국가/지역 코드 예를 들면 en-US입니다.

이 필드를 사용하려면 addOns.common.useLocaleFromApptrue를 설정하세요. 부가기능의 범위 목록은 https://www.googleapis.com/auth/script.locale를 포함합니다. 를 참조하세요. 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.

commonEventObject.timeZone string
기본적으로 사용 중지되어 있습니다. 시간대 ID 오프셋입니다. 이 필드를 사용하려면 addOns.common.useLocaleFromApptrue로 설정합니다. 부가기능의 범위 목록에는 https://www.googleapis.com/auth/script.locale 를 참조하세요. 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.
commonEventObject.timeZone.id string
<ph type="x-smartling-placeholder"></ph> 사용자 시간대의 시간대 식별자입니다. 예를 들면 다음과 같습니다. America/New_York, Europe/ViennaAsia/Seoul입니다. 이 필드를 사용하려면 addOns.common.useLocaleFromApptrue로 설정합니다. 부가기능의 범위 목록에는 https://www.googleapis.com/auth/script.locale 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.
commonEventObject.timeZone.offset string
<ph type="x-smartling-placeholder"></ph> 사용자 시간대의 협정 세계시 (UTC)를 기준으로 밀리초 단위로 측정된 시간대입니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.

날짜/시간 선택 도구 양식 입력

작업 콜백 함수 commonEventObject.formInputs 필드에 현재 위젯 값을 수신할 수 있습니다. 날짜 또는 시간 선택 도구에서 사용자가 선택한 날짜 또는 시간 값이 포함됩니다. 있습니다. 그러나 정보의 구조는 정보가 서로 일치하는지 여부에 따라 위젯이 날짜/시간 선택 도구, 날짜 전용 선택 도구 또는 시간 전용 선택 도구로 구성되었는지 여부 선택 도구를 클릭합니다. 구조적 차이점은 다음 표에 설명되어 있습니다.

DateTimeInput 객체
dateTimeInput.hasDate 입력 날짜 시간이 boolean
true이면 날짜가 있어야 합니다. false인 경우 시간만 포함됩니다.
dateTimeInput.hasTime 입력 날짜 시간이 boolean
true이면 시간을 포함합니다. false인 경우 날짜만 포함됩니다.
dateTimeInput.msSinceEpoch string
사용자가 선택한 시간(밀리초) 에포크 (1970년 1월 1일 00:00:00 UTC)부터 시작됩니다.
DateInput 객체
dateInput.msSinceEpoch string
사용자가 선택한 시간(밀리초) 에포크 (1970년 1월 1일 00:00:00 UTC)부터 시작됩니다.
TimeInput 객체
timeInput.hours number
사용자가 선택한 시간 번호입니다.
timeInput.minutes number
사용자가 선택한 분 숫자입니다.

캘린더 일정 객체

캘린더 이벤트 객체는 전체 이벤트 객체에서 사용자의 캘린더 및 캘린더 일정에 대한 정보를 전달합니다. 그것은 단지 호스트 애플리케이션이 Google Calendar인 경우 이벤트 객체에 표시됩니다.

다음 표에는 calendarEventObject에 있는 필드가 나와 있습니다. 이벤트 객체의 필드 값을 설정합니다. 사용자 생성 데이터로 표시된 입력란은 데이터가 캘린더에 있는 경우에만 이벤트 객체에 있음 이벤트를 설정하고 부가기능이 addOns.calendar.currentEventAccess를 설정합니다. 매니페스트 필드를 READ 또는 READ_WRITE입니다.

캘린더 일정 객체
calendar.attendees[] list of attendee objects
사용자 제작 데이터. 캘린더 참석자 목록 이벤트를 처리합니다.
calendar.calendarId string
캘린더 ID
calendar.capabilities object
사용자 제작 데이터 객체 이벤트를 보거나 업데이트하는 부가기능의 기능 설명 확인할 수 있습니다
calendar.capabilities.canAddAttendees boolean
사용자 제작 데이터 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 부가기능에서 일정에 새 첨부파일을 추가할 수 있는지 여부 그 외에는 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
참석자의 응답 상태입니다. 가능 값에는 다음이 포함됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • accepted: 참석자가 일정을 수락했습니다. 있습니다.
  • declined: 참석자가 일정을 거부했습니다. 있습니다.
  • needsAction: 참석자가 아직 응답하지 않았습니다. 이벤트 초대장
  • tentative: 참석자가 미정 상태로 이벤트 초대장
attendee.self boolean
true(이 참석자가 다음을 대표하는 경우) 이 일정이 표시되는 캘린더 그 외에는 false입니다.

회의 데이터

회의 데이터 객체는 연결된 회의에 대한 정보를 전달함 Google Calendar 일정에 추가할 수 있습니다 다음과 같은 Google 회의 솔루션이 될 수 있습니다. Google Meet, 서드 파티 회의 등 이 정보는 데이터가 캘린더 일정에 있고 해당 데이터가 부가기능이 addOns.calendar.currentEventAccess를 설정합니다. 매니페스트 필드를 READ 또는 READ_WRITE입니다.

회의 데이터 객체
conferenceData.conferenceId string
회의 ID입니다. 이 ID는 애플리케이션이 회의를 계속 추적할 수 있도록 합니다. 해서는 안 되는 작업 사용자에게 이 ID를 표시합니다.
conferenceData.conferenceSolution object
회의를 나타내는 객체 행아웃이나 Google Meet과 같은 Google Meet의 솔루션에도 액세스할 수 있습니다.
conferenceData.conferenceSolution.iconUri string
사용자에게 표시되는 아이콘의 URI는 회의용 솔루션입니다.
conferenceData.conferenceSolution.key object
사용할 수 있습니다.
conferenceData.conferenceSolution.key.type string
회의 솔루션 유형입니다. 가능한 값 다음이 포함됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • 일반 사용자를 위한 행아웃: eventHangout (http://hangouts.google.com).
  • eventNamedHangout용 기본 행아웃: Google Workspace 사용자 (http://hangouts.google.com)
  • Google Meet용 hangoutsMeet (http://meet.google.com).
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 진입점에만 적용됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • toll: 진입점이 유료 전화입니다.
  • toll_free: 진입점이 수신자 부담 전화입니다.
entryPoint.entryPointType string
진입점 유형입니다. 가능한 값은 다음과 같습니다. 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • more: 회의 참여 추가 안내 알려주지 않습니다. 하나의 회의에는 하나의 회의만 있을 수 있습니다. more 진입점 다른 유형이 하나 이상 있는 경우 필수 입력란입니다
  • phone: 전화번호로 회의에 참여합니다. 가 회의에는 0개 이상의 phone 진입점이 있을 수 있습니다. Google 캘린더는 처음 두 개의 전화 진입점만 표시합니다. 알파벳순으로 정렬한 후
  • sip: SIP를 통해 회의에 참여합니다. 회의는 sip 진입점은 최대 1개입니다.
  • video: HTTP를 통해 회의에 참여합니다. 가 회의에는 최대 1개의 video 진입점이 있을 수 있습니다.
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
전화번호의 지역 코드입니다. 필요 사용자에게 요청을 보낼 수 있습니다. 값은 공개 <ph type="x-smartling-placeholder"></ph> 지역 코드의 CLDR 목록입니다.
entryPoint.uri string
진입점의 URI입니다. 최대 길이는 1,300자(영문 기준)입니다. 형식은 진입점에 따라 다릅니다. 유형: <ph type="x-smartling-placeholder">
    </ph>
  • more: http: 또는 https: 스키마는 필수 항목입니다.
  • phone: tel: 스키마는 필수 항목입니다. 이 URI에는 전체 다이얼 시퀀스 (예: 'tel:+12345678900,,,12345678;1234')
  • sip: sip: 또는 sips: 스키마는 필수 항목입니다. 예: 'sip:12345678@myprovider.com'
  • video: http: 또는 https: 스키마는 필수 항목입니다.

Drive 이벤트 객체

Drive 이벤트 객체는 전체 이벤트 객체 중에서 사용자의 Google Drive 및 콘텐츠에 대한 정보를 전달합니다. 그것은 단지 호스트 애플리케이션이 Google Drive인 경우 이벤트 객체에 표시됩니다.

Drive 이벤트 객체
drive.activeCursorItem Drive item object
현재 활성 상태인 드라이브 항목
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
선택한 항목을 선택합니다.
item.mimeType string
선택한 항목의 MIME 유형입니다.
item.title string
선택한 항목의 제목입니다.

Gmail 이벤트 객체

Gmail 이벤트 객체는 전체 이벤트 객체에서 Gmail 메일에 대한 정보입니다. 이벤트 객체에만 있습니다. 호스트 애플리케이션이 Gmail인 경우입니다.

Gmail 이벤트 객체
gmail.accessToken string
Gmail 전용 액세스 토큰 이때 이 토큰을 <ph type="x-smartling-placeholder"></ph> GmailApp.setCurrentMessageAccessToken(accessToken) 메서드를 사용하여 부가기능에 사용자의 현재 Gmail 메일을 열거나 부가기능으로 새 임시보관 메일을 작성하도록 할 수 있습니다.
gmail.bccRecipients[] list of strings
기본적으로 사용 중지되어 있습니다. 목록 중 '숨은참조:' 현재 임시보관함에 포함된 수신자의 이메일 주소를 구성 중일 수 있습니다. 이 입력란을 사용하려면 먼저 매니페스트의 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 이벤트 객체
docs.id string
https://www.googleapis.com/auth/drive.file 범위가 모든 문서가 승인됩니다.
Docs UI에서 열리는 문서의 ID입니다.
docs.title string
https://www.googleapis.com/auth/drive.file 범위가 모든 문서가 승인됩니다.
Docs UI에서 문서의 제목이 열립니다.
docs.addonHasFileScopePermission boolean
true인 경우 부가기능에서 요청한 것입니다. 및 https://www.googleapis.com/auth/drive.file을(를) 받음 Docs UI에 열려 있는 문서에 대한 범위 승인 그렇지 않으면 이 필드가 false입니다.
docs.matchedUrl.url string
다음 조건이 충족되는 경우에만 표시됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • 사용자가 https://www.googleapis.com/auth/workspace.linkpreview을(를) 승인했습니다.
  • URL은 LinkPreviewTriggers 트리거에 지정된 호스트 패턴과 일치합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
Google Docs에서 미리보기를 생성하는 링크의 URL입니다. 이 입력란을 사용하려면 부가기능의 매니페스트에서 LinkPreviewTriggers를 구성해야 합니다. 자세한 내용은 스마트 칩이 포함된 링크 미리보기를 참고하세요.

사용자가 https://www.example.com/12345 링크를 미리 볼 때의 페이로드 예시:

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

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에서 열린 스프레드시트의 제목 있습니다.
sheets.addonHasFileScopePermission boolean
true인 경우 부가기능에서 요청한 것입니다. 및 https://www.googleapis.com/auth/drive.file을(를) 받음 Sheets UI에서 스프레드시트에 대한 범위 권한 부여가 열립니다. 그렇지 않은 경우 이 필드는 false입니다.
sheets.matchedUrl.url string
다음 조건이 충족되는 경우에만 표시됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • 사용자가 https://www.googleapis.com/auth/workspace.linkpreview을(를) 승인했습니다.
  • URL은 LinkPreviewTriggers 트리거에 지정된 호스트 패턴과 일치합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
Google Sheets에서 미리보기를 생성하는 링크의 URL입니다. 이 입력란을 사용하려면 부가기능의 매니페스트에서 LinkPreviewTriggers를 구성해야 합니다. 자세한 내용은 스마트 칩이 포함된 링크 미리보기를 참고하세요.

사용자가 https://www.example.com/12345 링크를 미리 볼 때의 페이로드 예시:

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

Slides 이벤트 객체

Slides 이벤트 객체는 전체 이벤트 객체 중에서 사용자 문서 및 콘텐츠에 대한 정보입니다. 그것은 단지 . 호스트 애플리케이션이 Google Slides인 경우 이벤트 객체에 응답합니다.

Slides 이벤트 객체
slides.id string
https://www.googleapis.com/auth/drive.file 범위가 승인해야 합니다. Slides에서 열리는 프레젠테이션의 ID 있습니다.
slides.title string
https://www.googleapis.com/auth/drive.file 범위가 승인해야 합니다. Slides UI
slides.addonHasFileScopePermission boolean
true인 경우 부가기능에서 요청한 것입니다. 및 https://www.googleapis.com/auth/drive.file을(를) 받음 프레젠테이션의 범위 승인이 Slides UI에서 열립니다. 그렇지 않은 경우 이 필드는 false입니다.
slides.matchedUrl.url string
다음 조건이 충족되는 경우에만 표시됩니다. <ph type="x-smartling-placeholder">
    </ph>
  • 사용자가 https://www.googleapis.com/auth/workspace.linkpreview을(를) 승인했습니다.
  • URL은 LinkPreviewTriggers 트리거에 지정된 호스트 패턴과 일치합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
Google Slides에서 미리보기를 생성하는 링크의 URL입니다. 이 입력란을 사용하려면 부가기능의 매니페스트에서 LinkPreviewTriggers를 구성해야 합니다. 자세한 내용은 스마트 칩이 포함된 링크 미리보기를 참고하세요.

사용자가 https://www.example.com/12345 링크를 미리 볼 때의 페이로드 예시:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}