预览版

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

Google 日历

支持的版本

此连接器支持 Google Calendar REST API。

准备工作

在 Google Cloud 项目中，执行以下任务：

• 确保已设置网络连接。如需了解相关信息，请参阅网络连接。
• 向配置连接器的用户授予 roles/connectors.admin IAM 角色。
• 向您要用于连接器的服务账号授予 roles/secretmanager.viewer 和 roles/secretmanager.secretAccessor IAM 角色
• 启用 secretmanager.googleapis.com (Secret Manager API) 和 connectors.googleapis.com (Connectors API)。 如需了解详情，请参阅启用服务。

配置连接器

一个连接需专用于一个数据源。这意味着，如果您有许多数据源，则必须为每个数据源创建单独的连接。如需创建连接，请执行以下操作：

1. 在 Cloud 控制台 中，进入 Integration Connectors > 连接页面，然后选择或创建一个 Google Cloud 项目。

   转到“连接”页面

2. 点击 + 新建以打开创建连接页面。
3. 在位置部分，完成以下操作：
   1. 区域：从下拉列表中选择一个位置。

      如需查看所有受支持区域的列表，请参阅位置。

   2. 点击下一步。
4. 在连接详情部分中，完成以下操作：
   1. 连接器：从可用连接器的列表中选择 Google 日历。
   2. 连接器版本：从可用版本的列表中选择连接器版本。
   3. 在连接名称字段中，输入连接实例的名称。连接名称可以包含小写字母、数字或连字符。名称必须以字母开头，以字母或数字结尾，且不得超过 49 个字符。
   4. 说明：输入连接实例的说明。
   5. 您可以选择启用 Cloud Logging，然后选择日志级别。默认情况下，日志级别设置为 Error。
   6. 服务账号：选择具有所需角色的服务账号。
   7. 连接超时：您可以选择输入连接超时时间（以秒为单位）。
   8. （可选）配置连接节点设置：
      • 节点数下限：输入连接节点数下限。
      • 节点数上限：输入连接节点数上限。

      节点是处理事务的连接单元（或副本）。 连接处理越多事务就需要越多节点，相反，处理越少事务需要越少节点。 如需了解节点如何影响连接器价格，请参阅连接节点的价格。如果未输入任何值，则默认情况下，节点数下限设置为 2（以便提高可用性），节点数上限设置为 50。

   注意：仅当您是随用随付客户时，才能自定义连接节点值。
   9. + 添加标签：点击此按钮可为连接添加标签（以键值对的形式）。
   10. 点击下一步。
5. 在身份验证部分中，输入身份验证详细信息。
   1. 选择身份验证类型，然后输入相关详细信息。

      Google 日历连接支持以下身份验证类型：

      • 服务账号身份验证
      • OAuth 2.0 - JWT 不记名
      • OAuth 2.0 - 授权代码

      如需了解如何配置这些身份验证类型，请参阅配置身份验证。

   2. 点击下一步。
6. 查看：查看您的连接和身份验证详细信息。
7. 点击创建。

配置身份验证

根据您要使用的身份验证输入详细信息。

• 服务账号身份验证：此身份验证类型不需要其他配置。系统将使用您在连接详细信息部分中选择的服务账号进行身份验证。
• OAuth 2.0 - JWT 不记名
  • JWT 证书：选择用于 JWT 身份验证的证书。
  • Secret 版本：输入 JWT 证书的 Secret 版本。
  • JWT 主题：输入 JWT 主题。
• OAuth 2.0 - 授权代码
  • 客户端 ID：输入用于 OAuth 身份验证的客户端 ID。
  • 范围：输入所需范围的列表。
  • 客户端密钥：输入用于 OAuth 身份验证的客户端密钥。
  • 密钥版本：输入客户端密钥的密钥版本。

连接配置示例

本部分列出了创建连接时配置的各个字段的示例值。

服务账号连接类型

字段名称	详细信息
位置	us-central1
连接器	Google 日历
连接器版本	1
连接名称	service-account-auth
启用 Cloud Logging	是
服务账号	iam.gserviceaccount.com
节点数下限	2
节点数上限	50
身份验证	是
服务账号身份验证	是

OAuth 2.0 - JWT 不记名连接类型

字段名称	详细信息
位置	us-central1
连接器	Google 日历
连接器版本	1
连接名称	jwt-bearer-auth
启用 Cloud Logging	是
服务账号	iam.gserviceaccount.com
节点数下限	2
节点数上限	50
身份验证	是
OAuth 2.0 - JWT 不记名	是
JWT 证书	projects/google-cloud-project/secrets/jwt-cert/versions/1
Secret 版本	1

OAuth 2.0 - 授权代码连接类型

字段名称	详细信息
位置	us-central1
连接器	Google 日历
连接器版本	1
连接名称	gcpcloud-googlecalendar-rest-conn
启用 Cloud Logging	是
服务账号	iam.gserviceaccount.com
节点数下限	2
节点数上限	50
身份验证	是
客户端 ID	60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
范围	https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
客户端密钥	ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Secret 版本	1

系统限制

Google 日历连接器每个节点每秒最多可处理 2 个事务，超出此限制的任何事务都会受到限制。默认情况下，Integration Connectors 会为连接分配 2 个节点（以提高可用性）。

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

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

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

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

在集成中使用 Google 日历连接

创建连接后，该连接将在 Apigee Integration 和 Application Integration 中可用。您可以通过“连接器”任务在集成中使用该连接。

• 如需了解如何在 Apigee Integration 中创建和使用连接器任务，请参阅连接器任务。
• 如需了解如何在 Application Integration 中创建和使用连接器任务，请参阅连接器任务。

实体操作示例

本部分介绍如何在此连接器中执行一些 实体操作。

示例 - 列出所有日历

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Calendars。
3. 选择 List 操作，然后点击完成。
4. 在连接器任务的任务输入部分，您可以根据客户要求设置 filterClause。

您必须使用单引号 (') 将 filterClause 的值括起来。

您可以使用 filterClause 根据列过滤记录。

示例 - 获取日历详细信息

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Calendars。
3. 选择 Get 操作，然后点击完成。
4. 将 entityId 设置为要传递的键 "[e-mail]"。
5. 如需设置 entityId，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 "[e-mail]"，并将 entityId 设置为局部变量。

entityId 的值应直接传递，例如 "[e-mail]"。其中，"[e-mail]" 是必须传递的唯一主键值。

在某些情况下，如果实体使用两个复合键，传递 entityId 可能会抛出错误。在这种情况下，您可以使用 filterClause 传递值（例如 id='[e-mail]'）。

示例 - 删除日历

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Calendars。
3. 选择 Delete 操作，然后点击完成。
4. 将 entityId 设置为要传递的键 "[e-mail]"。如需设置 entityId，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 "[e-mail]"，并将 entityId 设置为局部变量。

   如果实体有两个复合业务键或主键，您也可以将 filterClause 设置为 id='[e-mail]'，而不是指定 entityId。

示例 - 创建日历

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Calendars。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "New calendar"
   }
   

   如果集成成功，calendar 任务的 connectorOutputPayload 响应参数将具有类似以下的值：

   {
     "Id": "c_[e-mail]"
   }
   

示例 - 在日历中创建活动

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 AllCalendars。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "New event",
     "CalendarId": "c_[e-mail]",
     "StartDate": "2025-09-01",
     "EndDate": "2025-09-02"
   }
   

   如果集成成功，calendar 任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "fnf0p7292pbm2buk59ubc1a37k",
     "CalendarId": null
   }
   

示例 - 在主日历中创建活动

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择您的电子邮件 ID。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "new event for my calendar",
     "CalendarId": "[e-mail]",
     "StartDate": "2025-09-01",
     "EndDate": "2025-09-02"
   }
   

   如果集成成功，AllCalendars 任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "fnf0p7292pbm2buk59ubc1a37k",
     "CalendarId": null
   }
   

示例 - 在日历中创建一种类型的活动

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 AllCalendars。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "EventType": "outOfOffice",
     "Summary": "outOfOffice",
     "CalendarId": "[e-mail]",
     "StartDateTime": "2025-09-03 14:00:00",
     "EndDateTime": "2025-09-03 15:00:00"
   }
   

   如果集成成功，AllCalendars 任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "fnf0p7292pbm2buk59ubc1a37k",
     "CalendarId": null
   }
   

示例 - 在日历中创建周期性活动

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 AllCalendars。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "Google Cloud Recurring event",
     "CalendarId": "[e-mail]",
     "StartDateTime": "2025-11-2 14:00:00",
     "EndDateTime": "2025-11-2 14:30:00",
     "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
     "StartDateTimeZone": "America/Los_Angeles",
     "EndDateTimeZone": "America/Los_Angeles"
   }
   

   如果集成成功，AllCalendars 任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "fnf0p7292pbm2buk59ubc1a37k",
     "CalendarId": null
   }
   

示例 - 更新日历详细信息

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Calendars。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "Updated from Google Cloud"
   }
   

5. 在数据映射器中，将 entityId 设置为日历的实体。
6. 如需设置 entityId，请点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 entityId 设置为局部变量。

   您也可以将 filterClause 设置为 id='[e-mail]'，而不是指定 entityId。

   运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应：

   {
     "Id": "c_[e-mail]"
   }
   

示例 - 更新所有日历的详细信息

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 AllCalendars。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 connectorInputPayload 设置为局部变量。

   {
     "Summary": "Great event"
   }
   

5. 在数据映射器中，将 entityId 设置为 AllCalendars 的实体。
6. 如需设置 entityId，请点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并将 entityId 设置为局部变量。

   您也可以将 filterClause 设置为 Summary='New sep event'，而不是指定 entityId。

   运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应：

   {
     "Id": "fnf0p7292pbm2buk59ubc1a37k",
     "CalendarId": null
   }
   

向 Google Cloud 社区寻求帮助

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

后续步骤

• 了解如何暂停和恢复连接。
• 了解如何监控连接器使用情况。
• 了解如何查看连接器日志。