내용 x
    Google 캘린더 커넥터
    • 21 Oct 2024
    • 5 읽을 분
    • 기여자
    • 인쇄
    내용

    Google 캘린더 커넥터

    • 업데이트 날짜 21 Oct 2024
    • 5 읽을 분
    • 기여자
    • 인쇄
    기사 요약

    Google 캘린더 커넥터

    Tulip과 Google 캘린더 통합

    소개

    구글 캘린더 API는 사용자가 구글 계정에 대한 올바른 액세스 권한으로 구글 캘린더 이벤트를 생성, 읽기 및 편집할 수 있도록 합니다. 이 커넥터의 목표는 OAuth 인증을 사용하고 HTTP 커넥터를 사용하여 Tulip과 Google 캘린더 V3 API를 통합하고 고객에게 인스턴스로 가져올 수 있는 즉시 사용 가능한 커넥터를 제공하는 것입니다.

    목적

    이 문서는 다양한 사용 사례에 활용할 수 있는 캘린더의 다양한 읽기 및 쓰기 작업을 시도하기 위해 Google 캘린더 V3 API 엔드포인트에 HTTP 호출을 수행하여 Google 캘린더와 상호 작용할 수 있는 다양한 HTTP 커넥터 기능을 중점적으로 설명합니다.

    API 문서

    1. 구글 캘린더

    사전 요구 사항

    1. Google의 클라우드 콘솔에서 계정을 만들고 OAuth 2.0 자격 증명을 구성합니다. 자세한 내용은 Google의 API 문서에서 확인할 수 있습니다.
    2. Google API 콘솔에서 Google 캘린더 API를 활성화합니다.

    튤립 연결 세부 정보

    Tulip의 커넥터에 다음 정보를 구성해야 합니다.

    1. 실행 대상: 클라우드 커넥터 호스트
    2. 호스트:www.googleapis.com
    3. 포트:443
    4. TLS: 예
    5. 커넥터 인증: OAuth2.0(관리자/운영자)
    6. 전달해야 하는 범위는 다음과 같습니다:
    7. https://www.googleapis.com/auth/calendar
    8. https://www.googleapis.com/auth/calendar.events

    커넥터 기능

    모든 캘린더 가져오기

    목적

    이 커넥터는 사용자의 구글 캘린더에 존재하는 모든 캘린더를 가져옵니다.

    엔드포인트

    엔드포인트 https://www.googleapis.com:443/calendar/v3/users/me/calendarList 에 대한 HTTP GET 호출

    필수 입력

    입력 필요 없음

    필수 출력 추출기

    1. 캘린더 ID: 다른 작업을 수행하는 데 사용되는 캘린더의 고유 식별자입니다.
    2. 제목: 제목: 캘린더의 제목입니다.
    3. 응답과 함께 반환되는 추가 매개변수는 출력 매개변수의 일부로 포함될 수 있습니다.

    모든 이벤트 가져오기

    목적

    이 커넥터는 특정 캘린더의 모든 이벤트를 가져옵니다.

    엔드포인트

    엔드포인트 -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events에 대한 HTTP GET 호출

    필수 입력

    전달할 URL 매개변수는 다음과 같습니다.

    1. 캘린더 아이디- 캘린더 아이디/ 캘린더 아이디 매개변수에 "primary"를 값으로 전달합니다. "기본"을 지정하면 사용자의 기본 캘린더의 모든 이벤트를 가져옵니다.

    필수 출력 추출기

    1. 캘린더 ID: 다른 작업을 수행하는 데 사용되는 캘린더의 고유 식별자입니다.
    2. 이벤트 ID: 특정 이벤트에 대한 세부 정보를 가져오는 데 사용되는 이벤트의 고유 식별자입니다.
    3. 제목: 이벤트의 제목
    4. 응답과 함께 반환되는 추가 매개변수는 출력 매개변수의 일부로 포함될 수 있습니다.

    필터로 이벤트 가져오기

    Purpose

    이 커넥터는 쿼리 파라미터에 지정된 날짜 범위에 해당하는 모든 이벤트를 가져옵니다.

    엔드포인트

    엔드포인트에 대한 HTTP GET 호출 -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

    필수 입력

    전달할 URL 매개 변수는 다음과 같습니다.

    1. 캘린더 ID: 캘린더 ID
    2. MaxResults: 가져올 레코드 수
    3. MinTime: 가져오려는 이벤트의 시작 날짜 시간
    4. MaxTime: 가져올 이벤트의 종료 날짜 시간

    필수 출력 추출기

    1. 캘린더 ID: 다른 작업을 수행하는 데 사용되는 캘린더의 고유 식별자입니다.
    2. 이벤트 ID: 다른 작업을 수행하는 데 사용될 이벤트의 고유 식별자입니다.
    3. 제목: 이벤트의 제목
    4. 응답과 함께 반환되는 추가 매개변수는 출력 매개변수의 일부로 포함될 수 있습니다.

    단일/그룹/다수 사용자를 위한 새 이벤트 만들기

    목적

    1. 사용자가 이벤트 제목, 설명, 시작 날짜/시간, 종료 날짜/시간을 입력으로 전달하면 Tulip이 제공된 이벤트 제목으로 새 이벤트를 생성합니다. API의 응답은 파일의 메타데이터와 다양한 속성입니다.
    2. Google 캘린더 V3 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

    엔드포인트

    엔드포인트 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events에 대한 HTTP POST 호출

    필수 입력

    요청 본문으로 전송되는 파라미터는 다음과 같습니다.

    1. 캘린더 ID - 선택한 캘린더 ID
    2. 이벤트 제목 - 이벤트 제목
    3. 시작 날짜 시간 - 이벤트 시작 날짜 시간
    4. 종료 날짜 시간- 이벤트 종료 날짜 시간
    5. 시간대- 이벤트 시간대
    6. 참석자- 이벤트 참석자
    7. 위치 - 이벤트 위치
    8. 설명 - 이벤트 설명

    필수 출력 추출기

    1. 이벤트 ID: 다른 작업을 수행하는 데 사용되는 이벤트의 고유 식별자입니다.
    2. 이벤트 제목: 이벤트 제목: 이벤트의 제목
    3. 주최자: 이벤트의 주최자 이름
    4. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함될 수 있습니다.

    단일/그룹/다수 사용자를 위한 새 반복 이벤트 만들기

    목적

    1. 사용자가 이벤트 제목, 설명, 시작 날짜 시간, 종료 날짜 시간, 반복 종료 날짜 시간, 반복 유형 및 기타 매개 변수를 입력으로 전달하면 Tulip은 제공된 이벤트 제목으로 새 이벤트를 생성합니다. API의 응답은 파일의 메타데이터와 다양한 속성이 됩니다.
    2. Google 캘린더 V3 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

    엔드포인트

    엔드포인트 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events에 대한 HTTP POST 호출

    필수 입력

    요청 본문으로 전송되는 파라미터는 다음과 같습니다.

    1. 캘린더 ID - 선택한 캘린더 ID
    2. 이벤트 제목 - 이벤트 제목
    3. 시작 날짜 시간 - 이벤트 시작 날짜 시간
    4. 종료 날짜 시간- 이벤트 종료 날짜 시간
    5. 시간대- 이벤트 시간대
    6. 참석자- 이벤트 참석자
    7. 설명 - 이벤트 설명
    8. 위치 - 이벤트 위치
    9. 반복 규칙- 반복 규칙에는 이벤트가 언제 어떻게 반복되어야 하는지에 대한 모든 세부 정보가 포함되어 있습니다. 다음은 앱에 추가된 몇 가지 리커버리 규칙 목록입니다([RFC5545](https://tools.ietf.org/html/rfc5545

    섹션-3.8.5) 문서 참조):

    발생에 대해 매일:

    RRULE:FREQ=매일;카운트=

    예: RRULE:FREQ=DAILY;COUNT=5

    이벤트 시작일로부터 5일 동안 동일한 시작 시간과 종료 시간으로 이벤트가 발생합니다.

    까지 매일:

    RRULE:FREQ=매일;까지=

    Ex: RRULE:FREQ=DAILY;UNTIL=20210924T000000Z

    이벤트 시작일로부터 "2021년 9월 24일"까지 매일 동일한 시작 시간과 종료 시간으로 이벤트가 발생합니다.

    발생 시 매주:

    RRULE:FREQ=주간;카운트=

    예: RRULE:FREQ=WEEKLY;COUNT=3

    이벤트 시작일과 동일한 요일, 동일한 시작 시간과 종료 시간에 대해 3주 동안 매주 이벤트가 발생합니다.

    까지 매주:

    RRULE:FREQ=주간;때까지=

    Ex: RRULE:FREQ=WEEKLY;UNTIL=20210924T000000Z

    이벤트 시작일과 동일한 요일, 동일한 시작 시간과 종료 시간에 대해 "2021년 9월 24일"까지 매주 이벤트가 진행됩니다.

    매주 화요일, 격월:(이)

    RRULE:FREQ=월별;간격=;BYDAY=

    예: RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU

    이벤트는 격월 화요일에 시작 시간과 종료 시간이 동일하게 발생합니다.

    필수 출력 추출기

    1. 이벤트 아이디: 다른 작업을 수행하는 데 사용되는 이벤트의 고유 식별자입니다.
    2. 이벤트 제목: 이벤트 제목: 이벤트의 제목
    3. 주최자: 이벤트의 주최자 이름
    4. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함될 수 있습니다.

    이벤트 메타데이터 업데이트

    목적

    1. 사용자는 이벤트 제목, 설명, 시작 날짜/시간, 종료 날짜/시간 및 기타 파라미터를 입력으로 전달할 수 있으며, Tulip은 제공된 입력으로 기존 이벤트를 업데이트합니다. API의 응답은 파일의 메타데이터와 다양한 속성이 됩니다.
    2. Google 캘린더 V3 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

    엔드포인트

    엔드포인트 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*에 대한 HTTP PATCH 호출

    필수 입력

    요청 본문으로 전송되는 파라미터는 다음과 같습니다.

    1. 캘린더 ID-선택한 캘린더 ID
    2. 이벤트 ID - 선택한 이벤트 ID
    3. 이벤트 제목 - 이벤트 제목
    4. 시작 날짜 시간 - 이벤트 시작 날짜 시간
    5. 종료 날짜 시간- 이벤트 종료 날짜 시간
    6. 시간대- 이벤트 시간대
    7. Location- 이벤트 위치
    8. Description - 이벤트 설명

    필수 출력 추출기

    1. 이벤트 ID: 다른 작업을 수행하는 데 사용되는 이벤트의 고유 식별자입니다.
    2. 이벤트 제목: 이벤트 제목: 이벤트의 제목
    3. 이벤트 설명: 이벤트의 제목
    4. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함될 수 있습니다.

    반복 이벤트 업데이트

    목적

    1. 사용자는 이벤트 제목, 설명, 시작 날짜/시간, 종료 날짜/시간, 반복 규칙 및 기타 파라미터를 입력으로 전달할 수 있으며, Tulip은 제공된 입력으로 기존 이벤트를 업데이트합니다. API의 응답은 파일의 메타데이터와 다양한 속성이 됩니다.
    2. Google 캘린더 V3 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

    엔드포인트

    엔드포인트 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*에 대한 HTTP PATCH 호출

    필수 입력

    요청 본문으로 전송되는 파라미터는 다음과 같습니다.

    1. 캘린더 ID-선택한 캘린더 ID
    2. 이벤트 ID - 선택한 이벤트 ID
    3. 이벤트 제목 - 이벤트 제목
    4. 시작 날짜 시간 - 이벤트 시작 날짜 시간
    5. 종료 날짜 시간- 이벤트 종료 날짜 시간
    6. 시간대- 이벤트 시간대
    7. Location- 이벤트 위치
    8. Description- 이벤트 설명
    9. 반복 규칙- 반복 규칙에는 이벤트가 언제 어떻게 반복되어야 하는지에 대한 모든 세부 정보가 포함되어 있습니다. 자세한 반복 규칙은 위 문서에 언급된 인앱에 추가된 몇 가지 반복 규칙 목록을 참조하세요.)

    필수 출력 추출기

    1. 이벤트 ID: 다른 작업을 수행하는 데 사용되는 이벤트의 고유 식별자입니다.
    2. 이벤트 제목: 이벤트 제목: 이벤트의 제목
    3. 이벤트 설명: 이벤트의 제목
    4. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함될 수 있습니다.

    이벤트 삭제

    목적

    1. 사용자가 캘린더 ID와 이벤트 ID를 입력으로 전달하면 튤립이 구글 캘린더에서 이벤트를 삭제합니다.

    엔드포인트

    엔드포인트 -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}에 대한 HTTP DELETE 호출

    필수 입력

    요청 본문으로 전송되는 파라미터는 다음과 같습니다.

    1. 캘린더 ID-선택한 캘린더 ID
    2. 이벤트 ID- 선택한 이벤트 ID
    이 문서가 도움이 되었습니까?
    What's Next
    Platform
    Library
    Products
    Resources
    Existing Users
    Connect With Us
    Contact Sales
    Copyright © Tulip Interfaces. All Rights Reserved