이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Drive 커넥터

Google Drive 커넥터를 사용하면 Integration Connectors에서 Google Drive 연결을 만들고 구성할 수 있습니다. 비즈니스 애플리케이션에서 이 연결을 사용하여 Google Drive와 데이터를 안전하게 교환하고 작업을 실행할 수 있습니다.

지원되는 항목 및 작업 목록은 지원되는 항목 및 작업을 참고하세요. 지원되는 커넥터별 작업에 대한 자세한 내용은 지원되는 작업을 참고하세요.

Google Drive 커넥터 버전

Google Drive 커넥터는 다음 두 가지 버전을 지원합니다.

Google Drive v1: 이 커넥터 버전을 사용하여 Google Drive v3 API에 액세스합니다.
Google Drive v2: Google Drive v2 API에 액세스하려면 이 커넥터 버전을 사용하세요.

Google Drive 연결을 만드는 방법에 대한 자세한 내용은 Google Drive 커넥터 만들기 및 구성을 참고하세요.

지원되는 항목 및 작업

Google Drive 커넥터는 다음 항목과 작업을 지원합니다.

항목	설명	작업
`File`	Google Drive의 파일을 나타냅니다.	`Get`, `List`, `Create`, `Update`, `Delete`
`Folder`	Google Drive의 폴더를 나타냅니다.	`Get`, `List`, `Create`, `Update`, `Delete`
`Permission`	Google Drive의 파일 또는 폴더에 대한 권한을 나타냅니다.	`Get`, `List`, `Create`, `Update`, `Delete`
`Drive`	Google Drive의 드라이브를 나타냅니다.	`Get`, `List`, `Create`, `Update`, `Delete`

Application Integration 사용 사례 예시는 Application Integration의 사용 사례 예시를 참고하세요.

지원되는 작업

Google Drive 커넥터는 다음 작업을 지원합니다.

CopyResource

설명: Google Drive에서 지정된 리소스의 사본을 만듭니다. 상위 폴더 ID 목록을 제공하여 복사된 파일의 새 이름을 정의하고 대상 폴더를 지정할 수 있습니다 .

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	복사할 리소스의 ID입니다.
`NewName`	문자열	예	복사된 파일의 새 이름입니다.
`ParentIDs`	문자열	아니요	복사된 파일이 배치될 상위 폴더 ID의 쉼표로 구분된 목록입니다. 지정하지 않으면 파일이 파일이 있던 동일한 폴더에 복사됩니다.
`IgnoreDefaultVisibility`	불리언	아니요	새로 만든 파일의 기본 공개 상태 설정을 우회할지 여부를 결정합니다. 도메인이 업로드된 모든 파일을 기본적으로 표시하도록 구성된 경우 이 매개변수를 true로 설정하면 이 특정 요청에 대해 해당 동작이 재정의됩니다. 기본값은 false입니다.
`IncludeLabels`	문자열	아니요	응답의 labelInfo 부분에 포함할 라벨 ID의 쉼표로 구분된 목록입니다.
`IncludePermissionsForView`	문자열	예	이 필드는 응답에 포함할 추가 보기 권한을 지정합니다. 지원되는 값이 게시됩니다.
`KeepRevisionForever`	불리언	아니요	파일의 수정사항을 영원히 보관할지 여부를 나타냅니다. 이 기능은 Google Drive의 바이너리 콘텐츠가 있는 파일에만 적용됩니다. 파일당 최대 200개의 버전이 영구적으로 보관될 수 있습니다. 한도에 도달하면 기존 버전을 삭제하여 새 버전을 추가해야 합니다. 기본값은 false입니다.
`OCRLanguage`	문자열	아니요	이 필드는 이미지 파일을 가져올 때 OCR (광학 문자 인식)을 위한 언어 힌트를 제공합니다. ISO 639-1 두 글자 언어 코드(예: 영어의 경우 `en`, 독일어의 경우 `de`)를 사용하여 언어를 지정합니다.
`SupportsAllDrives`	불리언	예	이 매개변수는 내 드라이브 및 공유 드라이브의 변경사항을 추적할지 여부를 나타냅니다. 공유 드라이브에 대한 액세스를 사용 설정하려면 이 매개변수를 true로 설정합니다. 기본값은 false입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`CopiedFileID`	문자열	복사된 파일의 ID입니다.
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 CopyResource 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
CopyResource 조치를 선택한 다음 완료를 클릭합니다.

커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}

작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.

        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]

CreateFolder

설명: Google Drive에 새 폴더를 만듭니다. 새 폴더의 이름을 제공하고 상위 폴더의 ID를 제공하여 위치를 지정해야 합니다. 선택사항으로 설명을 추가하고 폴더를 별표표시할 수도 있습니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Name`	문자열	예	폴더의 제목입니다.
`Description`	문자열	아니요	폴더에 대한 설명입니다.
`Starred`	불리언	아니요	이 매개변수는 폴더에 별표가 표시되어 있는지 여부를 나타냅니다. 기본값은 false입니다.
`ParentIds`	문자열	예	새 폴더가 생성될 상위 폴더의 ID를 쉼표로 구분한 목록입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.
`Id`	문자열	새 폴더의 ID입니다.

사용 사례 예

다음 예시에서는 Application Integration에서 CreateFolder 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
CreateFolder 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

설명: Google Drive에서 파일 또는 폴더를 완전히 삭제합니다. 이 작업을 사용하려면 삭제하려는 리소스의 고유 ID를 제공해야 합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	삭제할 리소스의 ID입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 DeleteResource 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
DeleteResource 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

설명: Google Drive에서 파일을 다운로드합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	다운로드할 파일의 ID입니다.
`LocalFile`	문자열	아니요	파일이 저장될 파일 경로 및 파일 이름입니다. 메모리에 파일을 저장하려면 비워 두세요.
`Encoding`	문자열	아니요	파일 데이터의 인코딩 유형입니다. LocalFile이 비어 있으면 파일 데이터가 지정된 인코딩으로 반환됩니다. 허용되는 값은 NONE 및 BASE64입니다. 기본값은 BASE64입니다.
`Overwrite`	불리언	아니요	이 매개변수는 다운로드 시 파일이 이미 있는 경우 파일을 덮어쓸지 여부를 결정합니다. 기본값은 false입니다. 파일을 덮어쓰려면 매개변수를 TRUE로 설정하세요.
`FileFormat`	문자열	아니요	파일을 다운로드할 수 있는 형식입니다. 파일의 최대 크기는 10MB입니다. 원본 형식으로 다운로드하려면 이 매개변수를 공백으로 둡니다. 지원되는 형식은 DOCX, ODT, RTF, HTML, TXT, PDF입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`FileData`	문자열	LocalFile이 제공되지 않으면 지정된 인코딩을 사용하여 파일 데이터가 반환됩니다.
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 DownloadFile 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
DownloadFile 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

설명: Google Drive 내의 다른 위치로 파일 또는 폴더를 이동합니다. 이동할 리소스의 ID와 새 상위 폴더의 ID를 제공해야 합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	이동할 리소스의 ID입니다.
`ParentIDs`	문자열	예	상위 폴더로 사용할 ID의 쉼표로 구분된 목록입니다. 공유 드라이브 내의 리소스에는 상위 폴더가 하나만 있어야 하며 '파일 정리자' 또는 '정리자' 역할이 있는 사용자만 공유 드라이브 내에서 파일과 폴더를 이동할 수 있습니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 MoveResource 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
MoveResource 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

설명: Google Drive의 파일 또는 폴더의 메타데이터를 업데이트합니다. 이름, 설명, MIME 유형, 별표표시 여부를 수정할 수 있습니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	업데이트할 리소스의 ID입니다.
`Name`	문자열	예	업데이트된 파일의 새 이름입니다.
`Description`	문자열	아니요	파일 또는 폴더에 대한 설명입니다.
`MIMEType`	문자열	아니요	파일의 MIME 유형입니다.
`Starred`	문자열	아니요	이 매개변수는 리소스가 별표표시되었는지 여부를 나타냅니다. 기본값은 false입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 UpdateResource 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
UpdateResource 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"Success": "TRUE"}]
      
```

UploadFile

설명: Google Drive에 파일을 업로드합니다. 파일 데이터와 MIME 유형을 제공해야 합니다. 파일이 배치될 상위 폴더와 업로드된 파일의 파일 이름을 지정할 수도 있습니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	업로드할 파일의 ID입니다.
`FileData`	문자열	예	업로드할 파일 데이터입니다.
`MIMEType`	문자열	예	파일의 MIME 유형입니다.
`ParentIDs`	문자열	아니요	업로드된 파일이 배치될 상위 폴더 ID의 쉼표로 구분된 목록입니다. 지정하지 않으면 파일이 사용자의 내 드라이브 루트 폴더에 업로드됩니다.
`Filename`	문자열	아니요	업로드할 파일의 이름입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 UploadFile 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
UploadFile 조치를 선택한 다음 완료를 클릭합니다.
커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

설명: Google Drive의 특정 파일 변경사항에 대한 알림을 구독합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	구독할 파일의 ID입니다.
`Token`	문자열	예	파일 변경사항을 구독하는 데 사용할 토큰입니다.

출력 파라미터

매개변수 이름	데이터 유형	설명
`Success`	문자열	이 매개변수는 작업이 성공했는지 여부를 나타냅니다.

사용 사례 예

다음 예시에서는 Application Integration에서 SubscribeToFileChanges 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
SubscribeToFileChanges 조치를 선택한 다음 완료를 클릭합니다.

커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

설명: Google Drive에서 특정 사용자가 변경한 사항에 대한 알림을 구독합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	구독할 사용자의 ID입니다.
`Token`	문자열	예	사용자 변경사항을 구독하는 데 사용할 토큰입니다.

사용 사례 예

다음 예시에서는 Application Integration에서 SubscribeToUserChanges 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
SubscribeToUserChanges 조치를 선택한 다음 완료를 클릭합니다.

커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

설명: 이전에 시청한 리소스의 알림 수신을 해제합니다.

입력 매개변수

매개변수 이름	데이터 유형	필수	설명
`Id`	문자열	예	감시를 중지할 리소스의 ID입니다.
`Token`	문자열	예	리소스 시청을 중지하는 데 사용되는 토큰입니다.

사용 사례 예

다음 예시에서는 Application Integration에서 StopWatchingResources 작업을 구성하는 방법을 보여줍니다.

커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
StopWatchingResources 조치를 선택한 다음 완료를 클릭합니다.

커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 Default Value 필드에 다음과 유사한 값을 입력합니다.

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

작업이 성공하면 커넥터 태스크의 connectorOutputPayload 응답 매개변수가 다음과 비슷한 값을 갖습니다.

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

시스템 제한사항

Google Drive 커넥터는 노드별로 초당 최대 2QPS 트랜잭션을 처리할 수 있으며 이 한도를 초과하는 모든 트랜잭션을 제한할 수 있습니다. 기본적으로 Integration Connectors는 가용성을 높이기 위해 연결에 2개의 노드를 할당합니다.

Integration Connectors에 적용되는 한도에 대한 자세한 내용은 한도를 참조하세요.

참고: Integration Connectors 노드 수는 사용량에 따라 동적으로 자동 확장됩니다. 하지만 자동 확장을 기다리지 않고 대용량을 예약하려면 연결의 최소 노드 값을 조정하면 됩니다. 연결에 대해 더 많은 트랜잭션을 처리하려면 더 많은 노드가 필요합니다. 이와 반대로 더 적은 트랜잭션을 처리하려면 더 적은 노드가 필요합니다. 노드 값을 구성하려면 다음 안내를 따르세요.

사용한 만큼만 지불 고객인 경우 연결 수정 페이지에서 최소 및 최대 노드 값을 구성합니다.
정기 결제 기반 고객인 경우 지원팀에 문의하세요.

노드에서 처리할 수 있는 최대 트랜잭션은 다양한 요소에 따라 달라집니다. 따라서 처리량을 늘리기 위해 최소 노드를 조정하기 전에 백엔드 시스템이 필요한 트래픽을 처리하도록 최적으로 설정되었는지 확인하는 것이 좋습니다.

다음 단계

Google Drive 연결을 만들고 구성하는 방법을 알아보세요.
연결 일시중지 및 재개 방법 알아보기
커넥터 사용량 모니터링 방법 알아보기
커넥터 로그 확인 방법 알아보기

Google Cloud 커뮤니티에서 도움 받기

Google Cloud 커뮤니티에서 Cloud 포럼에 질문을 게시하고 이 커넥터에 대해 토론할 수 있습니다.