Google 스프레드시트 커넥터

구글 스프레드시트 커넥터

소개

구글 스프레드시트 API를 통해 사용자는 구글 계정에 대한 올바른 액세스 권한으로 구글 스프레드시트를 만들고, 읽고, 편집할 수 있습니다. 이 커넥터의 목표는 Tulip의 Oauth 2.0을 활용하여 HTTP 커넥터를 사용하여 Google 스프레드시트와 통합하고 고객에게 인스턴스로 가져올 수 있는 즉시 사용 가능한 커넥터를 제공하는 것입니다.

목적

1. Google 스프레드시트와 상호 작용하기 위해 Google 스프레드시트 API(v4) 엔드포인트에 HTTP 호출을 수행하여 구축할 수 있는 다양한 HTTP 커넥터 기능을 강조하여 다양한 사용 사례에 활용할 수 있는 다양한 읽기 및 쓰기 작업을 스프레드시트에서 시도해 보겠습니다.

API 문서

1. Google 스프레드시트 API 참조 문서

사전 요구 사항

1. Google 클라우드 콘솔에서 계정을 만들고 OAuth 2.0 자격 증명을 구성합니다. 자세한 내용은 Google의 API 문서에서 확인할 수 있습니다.
2. Google 클라우드 콘솔에 인스턴스 리디렉션 URL 추가하기

튤립 연결 세부 정보

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

1. 실행 대상: 클라우드 커넥터 호스트
2. 호스트:sheets.googleapis.com
3. 포트:443
4. TLS: 예
5. OAuth 2(관리자): 인증은 모든 커넥터 함수에 전달됩니다.

커넥터 함수

구글 새 스프레드시트

목적

1. 사용자가 스프레드시트 이름과 시트명을 입력으로 전달하면 Tulip이 제공된 시트명으로 새 스프레드시트를 생성합니다. API의 응답은 스프레드시트의 메타데이터와 다양한 속성이며, 이를 필터로 사용하여 스프레드시트에서 데이터를 가져오고 업데이트할 수 있습니다.
2. Google 스프레드시트 V4 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

엔드포인트 https://sheets.googleapis.com/v4/spreadsheets 에 대한 HTTP POST 호출

필수 입력

다음은 요청 본문으로 전송되는 매개변수입니다.

1. 스프레드시트 이름 - 스프레드시트 제목
2. 시트 이름 - 초기 시트 제목

출력 추출기

1. 스프레드시트: 다른 작업을 수행하는 데 사용되는 스프레드시트의 고유 식별자입니다.
2. 스프레드시트 URL: 새로 만든 스프레드시트의 URL입니다.

Google 스프레드시트 데이터 가져오기

목적

이 커넥터는 주어진 범위 내에서 제공된 스프레드시트Id에서 데이터를 가져옵니다. 데이터는 커넥터 함수에 제공된 쿼리 매개변수에 따라 행 또는 열의 배열로 제공됩니다.

엔드포인트

엔드포인트 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}에 대한 HTTP GET 호출

필수 입력

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

1. 스프레드시트 ID
2. 범위 - [A1 형식]의 문자열(https://developers.google.com/sheets/api/guides/concepts

A1_notation)

커넥터 함수에서 제공될 추가 쿼리 매개 변수는 다음과 같습니다.

1. 주요 차원 : 내부 데이터 배열을 결정하는 행 또는 열입니다.
2. dateTimeRenderOption은 날짜/시간 필드의 형식을 지정합니다(기본값: FORMATTED_STRING).
3. valueRenderOption은 응답 기본값에서 데이터의 서식을 지정해야 하는지 또는 서식을 지정하지 않아야 하는지를 지정합니다: FORMATTED_VALUE

출력 추출기

1. 값: 배열의 배열이며, 데이터의 각 행은 배열이 됩니다.

구글 스프레드시트 삽입 행

목적

스프레드시트에 값을 추가합니다. 입력 범위는 기존 데이터를 검색하고 해당 범위 내에서 '표'를 찾는 데 사용됩니다. 표의 첫 번째 열부터 시작하여 표의 다음 행에 값이 추가됩니다. 커넥터는 스프레드시트Id, 범위 및 셀에 삽입할 값의 목록을 가져옵니다.

엔드포인트

엔드포인트 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append에 대한 HTTP POST 호출

필수 입력

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

1. 스프레드시트 ID
2. 범위
3. 값: 이 커넥터의 경우, 각 매개변수가 삽입될 열에 대해 이름이 지정된 8개의 열 값을 고려했습니다. 이는 값의 배열로 API에 전달됩니다.

커넥터 함수에서 제공될 추가 쿼리 매개변수는 다음과 같습니다:

1. valueInputOption: 필수 필드이며 커넥터에서 기본값으로 설정되어 전송됩니다: USER_ENTERED

출력 추출기

1. 스프레드시트Id
2. 업데이트된 행: 삽입된 행 수를 지정합니다.

Google 스프레드시트 지우기

목적

스프레드시트에서 값을 지웁니다. 호출자는 스프레드시트 ID와 범위를 지정해야 합니다. 값만 지워지고 셀의 다른 모든 속성(서식, 데이터 유효성 검사 등)은 유지됩니다. 커넥터는 스프레드시트Id, 범위 및 셀에 삽입할 값 목록을 가져옵니다.

엔드포인트

엔드포인트 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear에 대한 HTTP POST 호출

필수 입력

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

1. 스프레드시트 ID
2. 범위

필터로 스프레드시트 세부 정보 가져오기

목적

이 커넥터는 제공된 스프레드시트Id와 데이터 필터 내에 지정된 특정 조건으로 스프레드시트 세부 정보를 가져옵니다.

엔드포인트

엔드포인트 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter에 대한 HTTP POST 호출

필수 입력

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

1. 스프레드시트Id
2. includeGridData: 기본값은 False입니다.

다음 매개변수는 JSON 형식의 요청 본문의 일부로 전송됩니다.

1. gridRange

출력 추출기

1. 스프레드시트아이디
2. 제목
3. 로캘
4. 자동 재계산
5. 시간대
6. sheetId
7. 시트 제목
8. 시트 유형
9. 시트 행 수
10. 시트 열 수
11. 스프레드시트 URL

사용자 사용 사례에 따라 출력의 일부로 포함할 수 있는 다른 매개변수가 있습니다.

Google 배치 데이터 가져오기

목적

이 커넥터는 스프레드시트Id에 제공된 데이터를 가져옵니다. 데이터는 커넥터에 제공된 쿼리 매개변수에 따라 행 또는 열의 배열로 제공됩니다.

엔드포인트

엔드포인트에 대한 HTTP GET 호출 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

필수 입력

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

1. 스프레드시트 ID
2. 범위 - [A1Format]의 문자열(https://developers.google.com/sheets/api/guides/concepts

A1_notation)

커넥터 함수에서 제공될 추가 쿼리 매개 변수는 다음과 같습니다.

1. 주요 차원 : 내부 데이터 배열을 결정하는 행 또는 열입니다.
2. dateTimeRenderOption은 날짜/시간 필드의 형식을 지정합니다(기본값: FORMATTED_STRING).
3. valueRenderOption은 응답에서 데이터의 서식을 지정해야 하는지 또는 서식을 지정하지 않아야 하는지 지정합니다. 기본값:FORMATTED_VALUE

출력 추출기

1. valueRanges: 객체의 배열입니다. 각 개체는 하나의 범위를 자세히 설명합니다.

Google 일괄 데이터 가져오기 필터

목적

이 커넥터는 주어진 필터 조건에 제공된 스프레드시트Id의 데이터를 일괄 데이터로 가져옵니다. 데이터는 커넥터에 제공된 쿼리 매개변수에 따라 행 또는 열의 배열로 제공됩니다.

엔드포인트

엔드포인트 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter에 대한 HTTP POST 호출

필수 입력

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

1. 스프레드시트 ID

커넥터 함수에서 제공될 추가 요청 본문 매개 변수는 다음과 같습니다.

1. 데이터 필터
2. 주요 차원 : 내부 데이터 배열을 결정하는 행 또는 열입니다.
3. dateTimeRenderOption은 날짜/시간 필드의 형식을 지정합니다(기본값: FORMATTED_STRING).
4. valueRenderOption은 응답 기본값에서 데이터의 서식을 지정해야 하는지 또는 서식을 지정하지 않아야 하는지를 지정합니다: FORMATTED_VALUE

출력 추출기

1. valueRanges: 객체의 배열입니다. 각 객체는 하나의 범위를 자세히 설명합니다.

비디오