Sheets - 추가 태스크

Sheets - 추가 태스크를 사용하면 Google 스프레드시트에서 지정된 데이터 테이블 다음에 데이터를 추가할 수 있습니다. 지정된 테이블 다음에 생성되는 새 행에 테이블의 첫 번째 열부터 새 값이 추가됩니다.

Google Sheets는 Google Workspace의 여러 클라우드 기반 생산성 솔루션 중 하나입니다. 실시간 공동작업 기능을 사용해 온라인 스프레드시트를 만들고 수정할 수 있습니다.

시작하기 전에

Sheets - 추가 태스크를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.

Google Sheets API(sheets.googleapis.com)를 사용 설정합니다.
Google Sheets API 사용 설정
인증 프로필을 만듭니다. Apigee Integration은 인증 프로필을 사용하여 Sheets - 추가 태스크의 인증 엔드포인트에 연결합니다.
서비스 계정에 추가 역할 또는 권한을 부여하려면 액세스 권한 부여, 변경, 취소를 참조하세요.
Google Sheets에서 사용되는 일반적인 용어를 이해하고 알아보세요.

Sheets - 추가 태스크 구성

Apigee UI에서 Apigee 조직을 선택합니다.
개발 > 통합을 클릭합니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
3. 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
Sheets - 추가 요소를 클릭하고 통합 디자이너에 배치합니다.
디자이너에서 Sheets - 추가 요소를 클릭하여 Sheets - 추가 태스크 구성 창을 봅니다.
인증으로 이동하고 사용하려는 기존 인증 프로필을 선택합니다.
(선택사항) 태스크를 구성하기 전에 인증 프로필을 만들지 않았으면 + 새 인증 프로필을 클릭하고 새 인증 프로필 만들기에 설명된 단계를 따릅니다.
태스크 입력으로 이동하고 다음 태스크 입력 매개변수 표를 사용해 표시된 입력 필드를 구성합니다.
입력 필드의 변경사항은 자동으로 저장됩니다.

태스크 입력 매개변수

다음 표에서는 Sheets - 추가 태스크의 입력 매개변수를 설명합니다.

속성	데이터 유형	설명
SpreadsheetId	문자열	스프레드시트의 ID입니다. 웹 URL에서 스프레드시트의 ID를 찾을 수 있습니다. 예를 들면 `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`입니다.
범위	문자열	시트에서 원하는 테이블을 검색할 범위의 A1 표기법
IncludeValuesInResponse	불리언	반환된 객체에 값이 추가된 셀의 값을 포함할지 여부를 나타냅니다.
InsertDataOption	enum(InsertDataOption)	새 데이터가 추가될 때 기존 데이터가 변경되는 방법을 나타냅니다.
ValueInputOption	enum(ValueInputOption)	데이터가 해석되는 방법을 나타냅니다. 기본값: `INPUT_VALUE_OPTION_UNSPECIFIED`
ResponseDateTimeRenderOption	enum(DateTimeRenderOption)	날짜, 시간, 기간과 관련된 값이 출력에 표시되는 방식을 나타냅니다. 참고: valueRenderOption에 지정된 값이 `FORMATTED_VALUE`인 경우 dateTimeRenderOption은 고려되지 않습니다. 기본값: `SERIAL_NUMBER`
ResponseValueRenderOption	enum(ValueRenderOption)	검색된 값이 출력에 표시되는 방식을 나타냅니다. 기본값: `FORMATTED_VALUE`
요청	JSON	요청 본문은 작성할 범위 값을 설명하는 ValueRange 객체입니다. JSON 구조 요청을 참조하세요.

태스크 출력

Sheets - 추가 태스크는 다음 샘플 출력과 유사하게 AppendValuesResponse 객체가 포함된 응답 출력을 반환합니다.

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

오류 처리 전략

태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.