Drive - 나열 태스크

Drive - 나열 태스크를 사용하면 Google Drive 계정에 저장된 파일과 폴더를 검색하고 가져올 수 있습니다.

Google Drive는 클라우드의 공동작업 공유 파일 및 폴더에 저장하고 액세스할 수 있는 개인 저장공간을 제공하는 클라우드 파일 스토리지 서비스입니다.

시작하기 전에

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

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

Drive - 나열 태스크 구성

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

태스크 입력 매개변수

다음 표에서는 Drive - 나열 태스크의 입력 매개변수를 설명합니다.

속성	데이터 유형	설명
`Corpora`	문자열	코퍼스 내에서 파일을 검색하는 선택적 매개변수입니다.
`DriveId`	문자열	Google 공유 드라이브의 ID입니다.
`IncludeItemsFromAllDrives`	불리언	검색 결과에 개인 드라이브 및 공유 드라이브 항목을 모두 포함하려면 값을 `true`로 설정합니다. 기본값은 `false`입니다.
`IncludeLabels`	문자열	응답의 `labelInfo` 부분에 포함된 라벨 ID를 쉼표로 구분한 목록입니다. 라벨 ID에 대한 자세한 내용은 라벨 개요를 참조하세요.
`IncludePermissionsForView`	문자열	`published`을 지정합니다. 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요.
`OrderBy`	문자열	파일이 정렬되는 순서입니다. 허용되는 값은 다음과 같습니다. `createdTime` `folder` `modifiedByMeTime` `modifiedTime` `name` `name_natural` `quotaBytesUsed` `recency` `sharedWithMeTime` `starred` `viewedByMeTime`
`PageSize`	정수	페이지당 반환할 최대 파일 수입니다. 허용되는 값은 `1`~`1000`입니다. 기본값은 `100`입니다.
`PageToken`	문자열	이전 Drive - 나열 태스크를 계속하기 위한 토큰입니다. 이 값을 이전 응답의 `nextPageToken` 값으로 설정합니다.
`Q`	문자열	파일 결과를 필터링하는 쿼리입니다. 자세한 내용은 파일 검색을 참조하세요.
`Spaces`	문자열	코퍼스 내의 쿼리할 쉼표로 구분된 공간 목록입니다. 허용되는 값은 `drive` 및 `appDataFolder`입니다.
`SupportsAllDrives`	불리언	요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는 경우 값을 `true`로 설정합니다. 기본값은 `false`입니다.

태스크 출력

Drive - 나열 태스크는 파일 목록이 포함된 응답 출력을 반환합니다. 다음은 샘플 출력입니다.

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

오류 처리 전략

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