Events

첨부파일을 수정하려면 supportsAttachments 요청 매개변수를 true로 설정해야 합니다.

이벤트당 첨부파일은 최대 25개까지 가능합니다.

Google Drive 파일의 경우 Drive API에 있는 해당 Files 리소스 항목의 ID입니다.

Google Drive 파일 첨부파일을 추가하려면 Drive API의 Files 리소스의 alternateLink 속성과 동일한 형식을 사용합니다.

첨부파일을 추가할 때 필요합니다.

참석자를 추가할 때 필요합니다.

• 'needsAction' - 참석자가 초대에 응답하지 않았습니다 (신규 일정에 권장됨).
• 'declined' - 참석자가 초대를 거부했습니다.
• "tentative" - 참석자가 미정 상태로 초대를 수락했습니다.
• "accepted" - 참석자가 초대를 수락했습니다.

• "anniversary" - 생일이 아닌 기념일입니다. 항상 contact가 있습니다.
• "birthday" - 생일 이벤트입니다. 기본값입니다.
• "custom" - customTypeName 필드에서 라벨이 추가로 지정된 특수 날짜입니다. 항상 contact가 있습니다.
• "other" - 다른 카테고리에 속하지 않고 맞춤 라벨이 없는 특별한 날짜입니다. 항상 contact가 있습니다.
• "self" - 캘린더 소유자의 생일입니다. contact가 있을 수 없습니다.

개발자가 회의를 추적하는 데 사용할 수 있으며 사용자에게 표시해서는 안 됩니다.

ID 값은 회의 솔루션 유형마다 다르게 구성됩니다.

• eventHangout: ID가 설정되지 않았습니다. 이 회의 유형은 지원 중단되었습니다.
• eventNamedHangout: ID가 행아웃의 이름입니다. (이 회의 유형은 지원 중단되었습니다.)
• hangoutsMeet: ID는 10자리 회의 코드입니다(예: aaa-bbbb-ccc).
• addOn: 서드 파티 제공업체에서 정의한 ID입니다.

생성 요청이 실패한 회의의 경우 설정을 해제합니다.

conferenceSolution 및 entryPoint 1개 이상 또는 createRequest가 필요합니다.

클라이언트가 익숙하지 않거나 빈 유형을 만나는 경우에도 여전히 진입점을 표시할 수 있어야 합니다. 하지만 수정은 허용해서는 안 됩니다.

사용할 수 있는 값은 다음과 같습니다.

• 소비자용 행아웃의 경우 "eventHangout" (지원 중단됨, 기존 일정에는 이 회의 솔루션 유형이 표시될 수 있지만 새 회의는 만들 수 없음)
• Google Workspace 사용자용 기존 행아웃의 경우 "eventNamedHangout" (지원 중단됨, 기존 일정에는 이 회의 솔루션 유형이 표시될 수 있지만 새 회의는 만들 수 없음)
• Google Meet용 "hangoutsMeet" (http://meet.google.com)
• 서드 파티 회의 제공업체의 경우 "addOn"

conferenceSolution 및 하나 이상의 entryPoint 또는 createRequest가 필요합니다.

클라이언트가 익숙하지 않거나 빈 유형을 만나는 경우에도 여전히 진입점을 표시할 수 있어야 합니다. 하지만 수정은 허용해서는 안 됩니다.

사용할 수 있는 값은 다음과 같습니다.

• 소비자용 행아웃의 경우 "eventHangout" (지원 중단됨, 기존 일정에는 이 회의 솔루션 유형이 표시될 수 있지만 새 회의는 만들 수 없음)
• Google Workspace 사용자용 기존 행아웃의 경우 "eventNamedHangout" (지원 중단됨, 기존 일정에는 이 회의 솔루션 유형이 표시될 수 있지만 새 회의는 만들 수 없음)
• Google Meet용 "hangoutsMeet" (http://meet.google.com)
• 서드 파티 회의 제공업체용 "addOn"

클라이언트는 새 요청이 있을 때마다 이 ID를 다시 생성해야 합니다. 제공된 ID가 이전 요청과 동일하면 요청이 무시됩니다.

사용할 수 있는 값은 다음과 같습니다.

• "pending": 회의 생성 요청이 아직 처리 중입니다.
• "success": 회의 생성 요청이 성공했으며 진입점이 채워집니다.
• "failure": 회의 생성 요청이 실패했습니다. 진입점이 없습니다.

모든 사용자가 동일한 회의에 속해 있어야 합니다.

conferenceSolution 및 entryPoint 1개 이상 또는 createRequest가 필요합니다.

새 회의 데이터를 만들 때 회의 제공업체에서 사용하는 용어와 일치하는 {meetingCode, accessCode, passcode, password, pin} 필드의 하위 집합만 채웁니다. 채워진 필드만 표시되어야 합니다.

선택사항입니다.

가능한 값은 다음과 같습니다.

• "video" - HTTP를 통해 회의에 참여합니다. 회의에는 video 진입점이 0개 또는 1개 있을 수 있습니다.
• "phone": 전화번호로 회의에 참여합니다. 회의에는 0개 이상의 phone 진입점이 있을 수 있습니다.
• "sip" - SIP를 통해 회의에 참여합니다. 회의에는 0개 또는 1개의 sip 진입점이 있을 수 있습니다.
• "more": 추가 전화번호와 같은 추가 회의 참여 안내입니다. 회의에는 more 진입점이 0개 또는 1개 있을 수 있습니다. more 진입점만 있는 회의는 유효한 회의가 아닙니다.

예:

• video: meet.google.com/aaa-bbbb-ccc
• phone: +1 123 268 2601
• sip: [email protected]
• more의 경우: 채워서는 안 됩니다.

선택사항입니다.

새 회의 데이터를 만들 때 회의 제공업체에서 사용하는 용어와 일치하는 {meetingCode, accessCode, passcode, password, pin} 필드의 하위 집합만 채웁니다. 채워진 필드만 표시되어야 합니다.

선택사항입니다.

새 회의 데이터를 만들 때는 회의 제공업체에서 사용하는 용어와 일치하는 {meetingCode, accessCode, passcode, password, pin} 입력란의 하위 집합만 채웁니다. 채워진 필드만 표시되어야 합니다.

새 회의 데이터를 만들 때 회의 제공업체에서 사용하는 용어와 일치하는 {meetingCode, accessCode, passcode, password, pin} 필드의 하위 집합만 채웁니다. 채워진 필드만 표시되어야 합니다.

선택사항입니다.

새 회의 데이터를 만들 때 회의 제공업체에서 사용하는 용어와 일치하는 {meetingCode, accessCode, passcode, password, pin} 필드의 하위 집합만 채웁니다. 채워진 필드만 표시되어야 합니다.

선택사항입니다.

형식:

• video, http: 또는 https: 스키마의 경우 필요합니다.
• phone의 경우 tel: 스키마가 필요합니다. URI에는 전체 다이얼 시퀀스가 포함되어야 합니다 (예: tel:+12345678900,,,123456789;1234).
• sip의 경우 sip: 스키마(예: sip:[email protected])가 필요합니다.
• more, http: 또는 https: 스키마는 필수 항목입니다.

서버 측에서 생성됩니다.

생성 요청이 실패한 회의의 경우 설정을 해제합니다.

대기 중인 생성 요청이 있는 회의의 경우 선택사항입니다.

• 'birthday': 매년 반복되는 특별한 종일 일정입니다.
• 'default' - 일반 이벤트 또는 추가로 지정되지 않은 이벤트입니다.
• 'focusTime': 방해 금지 시간 이벤트입니다.
• 'fromGmail': Gmail의 일정입니다. 만들 수 없는 이벤트 유형입니다.
• 'outOfOffice' - 부재중 일정입니다.
• 'workingLocation': 근무 위치 이벤트입니다.

• 'icon' - 캘린더 보기의 일정 제목 옆에 가젯이 표시됩니다.
• 'chip' - 이벤트를 클릭하면 가젯이 표시됩니다.

iCalUID와 id는 동일하지 않으며 이벤트 생성 시 둘 중 하나만 제공해야 합니다. 시맨틱스의 한 가지 차이점은 반복 이벤트에서 한 이벤트의 모든 발생 횟수에 서로 다른 id가 있지만 모두 동일한 iCalUID를 공유한다는 점입니다. iCalUID를 사용하여 이벤트를 검색하려면 iCalUID 매개변수를 사용하여 events.list 메서드를 호출합니다. id를 사용하여 이벤트를 가져오려면 events.get 메서드를 호출합니다.

• ID에 허용되는 문자는 base32hex 인코딩에 사용되는 문자(소문자 a~v 및 숫자 0~9)입니다.RFC2938의 3. 1.2 섹션을 참고하세요.
• ID 길이는 5~1,024자(영문 기준)여야 합니다.
• ID는 캘린더마다 고유해야 합니다.

ID를 지정하지 않으면 서버에서 자동으로 생성합니다.

icalUID와 id는 동일하지 않으며 이벤트 생성 시 둘 중 하나만 제공해야 합니다. 시맨틱스의 한 가지 차이점은 반복 이벤트에서 한 이벤트의 일치하는 모든 일치하는 id가 모두 동일한 icalUID를 공유한다는 것입니다.

• 'email' - 알림이 이메일을 통해 전송됩니다.
• 'popup' - UI 팝업을 통해 리마인더가 전송됩니다.

알림을 추가할 때 필요합니다.

알림을 추가할 때 필요합니다.

• 'confirmed' - 이벤트가 확인되었습니다. 이는 기본 상태입니다.
• 'tentative' - 이벤트가 잠정적으로 확인되었습니다.
• 'cancelled' - 이벤트가 취소 (삭제됨)되었습니다. list 메서드는 증분 동기화 (syncToken 또는 updatedMin가 지정된 경우) 또는 showDeleted 플래그가 true로 설정된 경우에만 취소된 이벤트를 반환합니다. get 메서드는 항상 이를 반환합니다.

  취소된 상태는 이벤트 유형에 따라 두 가지 상태를 나타냅니다.

  1. 취소되지 않은 반복 일정의 취소된 예외는 이 인스턴스를 더 이상 사용자에게 표시해서는 안 된다는 것을 나타냅니다. 클라이언트는 상위 반복 일정의 전체 기간 동안 이러한 이벤트를 저장해야 합니다.

     취소된 예외는 id, recurringEventId, originalStartTime 필드의 값만 채워집니다. 다른 필드는 비어 있을 수 있습니다.

  2. 취소된 다른 모든 이벤트는 삭제된 이벤트를 나타냅니다. 클라이언트는 로컬에서 동기화된 사본을 삭제해야 합니다. 이러한 취소된 이벤트는 결국 사라지므로 무기한 사용할 수 있다고 기대하지 마세요.

     삭제된 이벤트는 id 필드만 채워집니다.

  주최자의 캘린더에서 취소된 일정은 복원 (삭제 취소)할 수 있도록 일정 세부정보 (요약, 위치 등)를 계속 표시합니다. 마찬가지로 사용자가 초대된 일정 및 사용자가 직접 삭제한 일정은 계속해서 세부정보를 제공합니다. 그러나 showDeleted가 false로 설정된 증분 동기화 요청은 이러한 세부정보를 반환하지 않습니다.

  이벤트의 주최자가 변경되고 (예: 이동 작업을 통해) 원래 주최자가 참석자 목록에 없으면 id 필드만 채워지는 취소된 이벤트가 남게 됩니다.

• 'opaque' - 기본값입니다. 일정이 캘린더에서 시간을 차단합니다. 이는 캘린더 UI에서 나를 바쁨으로 설정하는 것과 같습니다.
• "transparent" - 일정이 캘린더의 시간을 차단하지 않습니다. 이는 캘린더 UI에서 나를 표시를 사용 가능으로 설정하는 것과 같습니다.

• 'default' - 캘린더의 일정에 기본 공개 상태를 사용합니다. 기본값입니다.
• 'public': 일정이 공개되어 있으며 캘린더의 모든 독자가 일정 세부정보를 볼 수 있습니다.
• 'private': 비공개 일정으로, 일정 참석자만 일정 세부정보를 볼 수 있습니다.
• 'confidential' - 비공개 일정입니다. 이 값은 호환성을 위해 제공됩니다.

• 'homeOffice' - 사용자가 집에서 작업 중입니다.
• "officeLocation" - 사용자가 사무실에서 일하고 있습니다.
• "customLocation" - 사용자가 맞춤 위치에서 근무하고 있습니다.

근무 위치 속성을 추가할 때 필요합니다.