预览版 — BigQuery 连接器

此功能受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

Google 云端硬盘连接器

借助 Google 云端硬盘连接器，您可以在 Integration Connectors 中创建和配置 Google 云端硬盘连接。您可以在业务应用中使用此连接，以便与 Google 云端硬盘安全地交换数据和执行操作。

如需查看受支持的实体和操作的列表，请参阅受支持的实体和操作。如需了解支持的连接器专用操作，请参阅支持的操作。

Integration Connectors 中的所有连接都为底层服务对象提供了一个抽象层。这些对象会作为可管理的实体公开，以便您执行标准操作或使用连接器特定的操作。

Google 云端硬盘连接器版本

Google 云端硬盘连接器支持两个版本：

• Google Drive v1：使用此连接器版本可访问 Google Drive v3 API。
• Google Drive v2：使用此连接器版本可访问 Google Drive v2 API。

如需了解如何创建 Google 云端硬盘连接，请参阅创建和配置 Google 云端硬盘连接器。

支持的实体和操作

Google 云端硬盘连接器支持以下实体和操作：

实体	说明	运维
File	表示 Google 云端硬盘中的文件。	Get、List、Create、Update、Delete
Folder	表示 Google 云端硬盘中的文件夹。	Get、List、Create、Update、Delete
Permission	表示 Google 云端硬盘中文件或文件夹的权限。	Get、List、Create、Update、Delete
Drive	表示 Google 云端硬盘中的云端硬盘。	Get、List、Create、Update、Delete

如需查看 Application Integration 用例示例，请参阅 Application Integration 中的用例示例。

支持的操作

Google 云端硬盘连接器支持以下操作：

CopyResource

说明：在 Google 云端硬盘中创建指定资源的副本。您可以提供父文件夹 ID 列表，为复制的文件定义新名称并指定其目标文件夹。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要复制的资源的 ID。
NewName	字符串	是	复制文件的新名称。
ParentIDs	字符串	否	以逗号分隔列表形式提供的父文件夹 ID，复制的文件将放置在这些文件夹中。如果未指定，系统会将文件复制到该文件所在的文件夹。
IgnoreDefaultVisibility	布尔值	否	确定是否绕过新创建文件的默认公开范围设置。如果网域配置为默认情况下使所有上传的文件可见，则将此参数设置为 true 会针对此特定请求替换该行为。 默认值为 false。
IncludeLabels	字符串	否	以逗号分隔的标签 ID 列表，用于指定要在响应的 labelInfo 部分中包含的标签。
IncludePermissionsForView	字符串	是	此字段用于指定要在响应中包含哪些额外的查看权限。支持的值已发布。
KeepRevisionForever	布尔值	否	指示是否永久保留文件的修订版本。 此功能仅适用于 Google 云端硬盘中包含二进制内容的文件。每个文件最多可永久保留 200 个修订版本。如果达到此限制，您必须删除现有修订版本才能添加新修订版本。默认值为 false。
OCRLanguage	字符串	否	此字段在导入图片文件时为 OCR（光学字符识别）提供语言提示。 使用 ISO 639-1 双字母语言代码指定语言，例如 en 表示英语，de 表示德语。
SupportsAllDrives	布尔值	是	此参数用于指示是否跟踪“我的云端硬盘”和共享云端硬盘中的更改。 将此参数设置为 true 可启用对共享云端硬盘的访问权限。默认值为 false。

输出参数

参数名称	数据类型	说明
CopiedFileID	字符串	复制文件的 ID。
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 CopyResource 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 CopyResource 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

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

   如果操作成功，连接器任务的 connectorOutputPayload 响应参数将具有类似以下的值：

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

---

CreateFolder

说明：在 Google 云端硬盘中创建新文件夹。您必须为新文件夹提供名称，并通过提供其父文件夹的 ID 来指定其位置。您还可以添加可选说明，并将文件夹标记为已加星标。

输入参数

参数名称	数据类型	必需	说明
Name	字符串	是	文件夹的标题。
Description	字符串	否	文件夹的说明。
Starred	布尔值	否	此参数用于指示相应文件夹是否已加星标。 默认值为 false。
ParentIds	字符串	是	以逗号分隔的父文件夹 ID 列表，新文件夹将创建在这些父文件夹中。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。
Id	字符串	新文件夹的 ID。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 CreateFolder 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 CreateFolder 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

           { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
         

   如果操作成功，连接器任务的 connectorOutputPayload 响应参数将具有类似以下的值：

           [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
         

---

DeleteResource

说明：从 Google 云端硬盘中永久移除文件或文件夹。如需使用此操作，您需要提供要删除的资源的唯一 ID。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要删除的资源的 ID。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 DeleteResource 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 DeleteResource 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
         

   如果操作成功，连接器任务的 connectorOutputPayload 响应参数将具有类似以下的值：

           [{"Success": "TRUE"}]
         

---

DownloadFile

说明：从 Google 云端硬盘下载文件

输入参数

参数名称	数据类型	必需	说明
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 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 DownloadFile 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 云端硬盘中的其他位置。您需要提供要移动的资源的 ID 和新父文件夹的 ID。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要移动的资源的 ID。
ParentIDs	字符串	是	要用作父文件夹的 ID 的逗号分隔列表。 共享云端硬盘中的资源必须只有一个父文件夹，并且只有拥有“文件整理者”或“整理者”角色的用户才能在共享云端硬盘中移动文件和文件夹。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 MoveResource 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 MoveResource 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
         

   如果操作成功，连接器任务的 connectorOutputPayload 响应参数将具有类似以下的值：

           [{"Success": "TRUE"}]
         

---

UpdateResource

说明：更新 Google 云端硬盘中文件或文件夹的元数据。您可以修改其名称、说明、MIME 类型以及是否已加星标。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要更新的资源的 ID。
Name	字符串	是	更新后文件的新名称。
Description	字符串	否	文件或文件夹的说明。
MIMEType	字符串	否	文件的 MIME 类型。
Starred	字符串	否	此参数用于指示资源是否已加星标。 默认值为 false。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 UpdateResource 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 UpdateResource 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 云端硬盘。您必须提供文件数据及其 MIME 类型。您还可以指定要将文件放置到的父文件夹以及上传文件的文件名。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要上传的文件的 ID。
FileData	字符串	是	要上传的文件数据。
MIMEType	字符串	是	文件的 MIME 类型。
ParentIDs	字符串	否	以逗号分隔列表形式提供的父文件夹 ID，上传的文件将放置在这些文件夹中。如果未指定，文件将上传到用户的“我的云端硬盘”根文件夹。
Filename	字符串	否	要上传的文件的名称。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 UploadFile 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 UploadFile 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 云端硬盘中特定文件的更改通知。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要订阅的文件的 ID。
Token	字符串	是	用于订阅文件更改的令牌。

输出参数

参数名称	数据类型	说明
Success	字符串	此参数用于指示操作是否成功。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 SubscribeToFileChanges 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 SubscribeToFileChanges 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 云端硬盘中特定用户所做更改的通知。

输入参数

参数名称	数据类型	必需	说明
Id	字符串	是	要订阅的用户的 ID。
Token	字符串	是	用于订阅用户更改的令牌。

使用场景示例

以下示例展示了如何在 Application Integration 中配置 SubscribeToUserChanges 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 SubscribeToUserChanges 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 操作：

1. 在配置连接器任务对话框中，点击操作。
2. 选择 StopWatchingResources 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 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 云端硬盘连接器每个节点每秒最多可处理 2 个 QPS 事务，超出此限制的任何事务都会受到限制。默认情况下，Integration Connectors 会为连接分配 2 个节点（以提高可用性）。

如需了解适用于 Integration Connectors 的限制，请参阅限制。

注意：Integration Connectors 节点的数量会根据您的使用情况动态自动扩缩。不过，如果您想为大量连接预留容量，而不希望等待自动扩缩，可以调整连接的最小节点值。连接处理的事务越多，需要的节点就越多。相反，如果连接处理的事务较少，则需要的节点也较少。如需配置节点值，请执行以下操作：

• 如果您是随用随付客户，请在“修改连接”页面中配置最小和最大节点值。
• 如果您是订阅客户，请与支持团队联系。

一个节点可以处理的最大交易数取决于多种因素。因此，在调整最小节点数以提高吞吐量之前，建议您先检查后端系统是否已设置为最佳状态，以处理所需的流量。

后续步骤

• 了解如何创建和配置 Google 云端硬盘连接。
• 了解如何暂停和恢复连接。
• 了解如何监控连接器使用情况。
• 了解如何查看连接器日志。

向 Google Cloud 社区寻求帮助

您可以在 Google Cloud 社区的 Cloud 论坛中发布您的问题以及讨论此连接器。