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

Drive - 나열 태스크

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

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

시작하기 전에

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

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

Drive - 나열 태스크 구성

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

태스크 입력 매개변수

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

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

태스크 출력

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

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

오류 처리 전략

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

할당량 및 한도

할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.