Application Integration에 지원되는 커넥터를 참조하세요.

Sheets - 일괄 가져오기 태스크

Sheets - 일괄 가져오기 태스크를 사용하면 Google 스프레드시트에서 여러 개의 불규칙한 값을 읽고 검색할 수 있습니다.

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

시작하기 전에

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

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

Sheets - 일괄 가져오기 태스크 구성

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 창에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
  참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
4. 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
통합 편집기 탐색 메뉴에서 태스크를 클릭하여 사용 가능한 태스크 및 커넥터 목록을 확인합니다.
Sheets - 일괄 가져오기 요소를 클릭하여 통합 편집기에 배치합니다.
디자이너에서 Sheets - 일괄 가져오기 요소를 클릭하여 Sheets - 일괄 가져오기 태스크 구성 창을 표시합니다.
인증으로 이동하고 사용하려는 기존 인증 프로필을 선택합니다.
선택사항입니다. 태스크를 구성하기 전에 인증 프로필을 만들지 않았으면 + 새 인증 프로필을 클릭하고 새 인증 프로필 만들기에 설명된 단계를 따릅니다.
태스크 입력으로 이동하고 다음 태스크 입력 매개변수 표를 사용해 표시된 입력 필드를 구성합니다.
입력 필드의 변경사항은 자동으로 저장됩니다.

태스크 입력 매개변수

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

속성	데이터 유형	설명
SpreadsheetId	문자열	스프레드시트의 ID입니다. 웹 URL에서 스프레드시트의 ID를 찾을 수 있습니다. 예를 들면 `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`입니다.
MajorDimension	열거형(Dimension)	적용해야 하는 기본 카테고리 또는 측정기준입니다. 예를 들면 `ROWS` 또는 `COLUMNS`입니다. 기본값: `DIMENSION_UNSPECIFIED`
범위	문자열	값을 검색할 범위의 A1 표기법 또는 R1C1 표기법입니다.
DateTimeRenderOption	열거형(DateTimeRenderOption)	날짜, 시간, 기간과 관련된 값이 출력에 표시되는 방식을 나타냅니다. 참고: valueRenderOption에 지정된 값이 `FORMATTED_VALUE`인 경우 dateTimeRenderOption은 고려되지 않습니다. 기본값: `SERIAL_NUMBER`
ValueRenderOption	열거형(ValueRenderOption)	검색된 값이 출력에 표시되는 방식을 나타냅니다. 기본값: `FORMATTED_VALUE`

태스크 출력

Sheets - 일괄 가져오기 태스크는 스프레드시트 ID가 있는 객체와 요청된 순서대로 나열된 각 요청된 범위에 해당하는 ValueRange 객체의 배열이 포함된 응답 출력을 반환합니다. 다음은 샘플 출력입니다.

{
        "spreadsheetId": SPREADSHEET_ID,
        "valueRanges": [
          {
            "range": "Sheet1!B1:B1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Cost",20.5,15,100,135.5]
            ]
          },
          {
            "range": "Sheet1!D1:D1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Ship Date",42430,42444,42449,42449]
            ]
          }
        ]
      }

오류 처리 전략

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