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`입니다.
MajorDimension	열거형(Dimension)	적용해야 하는 기본 카테고리 또는 측정기준입니다. 예를 들면 `ROWS` 또는 `COLUMNS`입니다. 기본값: `DIMENSION_UNSPECIFIED`
범위	문자열	값을 검색할 범위의 A1 표기법 또는 R1C1 표기법입니다.
dateTimeRenderOption	열거형(DateTimeRenderOption)	날짜, 시간, 기간과 관련된 값이 출력에 표시되는 방식을 나타냅니다. 참고: valueRenderOption에 지정된 값이 `FORMATTED_VALUE`인 경우 dateTimeRenderOption은 고려되지 않습니다. 기본값: `SERIAL_NUMBER`
ValueRenderOption	열거형(ValueRenderOption)	검색된 값이 출력에 표시되는 방식을 나타냅니다. 기본값: `FORMATTED_VALUE`

태스크 출력

Sheets - 가져오기 태스크는 요청된 범위에 해당하는 ValueRange 객체가 포함된 응답 출력을 반환합니다. 다음은 샘플 출력입니다.

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

오류 처리 전략

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