星期一

使用 Monday 连接器可在 Monday.com 上执行插入、删除、更新和读取操作。

准备工作

在使用 Monday 连接器之前,请先完成以下任务:

  • 在您的 Google Cloud 项目中:
    • 确保已设置网络连接。如需了解网络模式,请参阅网络连接。
    • 向配置连接器的用户授予 roles/connectors.admin IAM 角色。
    • 将以下 IAM 角色授予您要用其来使用连接器的服务账号:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      服务账号是一种特殊类型的 Google 账号,用于表示需要验证身份并获得授权以访问 Google API 数据的非人类用户。如果您没有服务账号,则必须创建一个服务账号。连接器和服务账号必须属于同一项目。如需了解详情,请参阅创建服务账号。

    • 启用以下服务:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      如需了解如何启用服务,请参阅启用服务。

    如果之前没有为您的项目启用这些服务或权限,则在您配置连接器时,系统会提示您启用。

  • 如需了解如何获取用于身份验证的 API 令牌,请参阅 API 令牌。
  • 如需了解如何使用 OAuth 2.0 对 Monday 应用进行身份验证,请参阅 OAuth 2.0。

配置连接器

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

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

    转到“连接”页面

  2. 点击 + 新建以打开创建连接页面。
  3. 在位置部分中,选择连接的位置。
    1. 区域:从下拉列表中选择一个位置。

      连接器支持的区域包括:

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

    2. 点击下一步。
  4. 在连接详情部分中,完成以下操作:
    1. 连接器:从可用连接器的下拉列表中选择 Monday。
    2. 连接器版本:从可用版本的下拉列表中选择一个连接器版本。
    3. 在连接名称字段中,输入连接实例的名称。

      连接名称必须符合以下条件:

      • 连接名称可以使用字母、数字或连字符。
      • 字母必须小写。
      • 连接名称必须以字母开头,以字母或数字结尾。
      • 连接名称不能超过 49 个字符。
    4. (可选)输入连接实例的说明。
    5. 您可以选择启用 Cloud Logging,然后选择日志级别。默认情况下,日志级别设置为 Error。
    6. 服务账号:选择具有所需角色的服务账号。
    7. (可选)配置连接节点设置:

      • 节点数下限:输入连接节点数下限。
      • 节点数上限:输入连接节点数上限。

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

    8. 使用代理:选中此复选框可为连接配置代理服务器。
      • 代理身份验证方案:用于向 ProxyServer 代理进行身份验证的身份验证类型。
      • 代理用户:用于向 ProxyServer 代理进行身份验证的用户名。
      • 代理密码:用于向 ProxyServer 代理进行身份验证的密码。
      • 代理 SSL 类型:连接到 ProxyServer 代理时使用的 SSL 类型。
    9. (可选)点击 + 添加标签,以键值对的形式向连接添加标签。
    10. 点击下一步。
  5. 在目标部分中,输入要连接到的远程主机(后端系统)的详细信息。
    1. 目标类型:您可以将目标详细信息指定为主机地址或服务连接。选择以下任意目标类型:
      • 主机地址:如果要指定目标的主机名或 IP 地址。
      • 服务连接:如果要为内部 IP 地址指定专用端点。使用服务连接,您可以对外部网络隐藏内部 IP 地址。您可以使用 Private Service Connect 功能在 Google Cloud 中创建服务连接。如需了解如何配置 Private Service Connect,请参阅发布托管式服务。

      根据您选择的目标类型,输入主机地址或服务连接名称。

      若要输入其他目标,请点击 + 添加目标。

    2. 点击下一步。
  6. 在身份验证部分中,输入身份验证详细信息。
    1. 选择身份验证类型,然后输入相关详细信息。

      Monday 连接支持以下身份验证类型:

      • OAuth 2.0
      • API 令牌
    2. 如需了解如何配置这些身份验证类型,请参阅配置身份验证。

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

配置身份验证

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

  • OAuth 2.0
    • 客户端 ID:请求访问令牌时所用的客户端 ID。
    • 客户端密钥:请求访问令牌时所用的客户端密钥。
    • OAuth 访问令牌:通过基于 auth-code-flow 的连接对请求进行身份验证时所用的访问令牌。
  • API 令牌

    如果您要使用匿名登录,请选择不可用。

    • API 令牌:从您的 Monday 账号获取的 API 令牌。

连接配置示例

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

API 令牌连接类型

字段名称 详细信息
位置 europe-west1
连接器 星期一
连接器版本 1
连接名称 monday-new-connector
启用 Cloud Logging 是
日志级别 调试
服务账号 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
节点数下限 2
节点数上限 50
目标类型 主机地址
主机 1 https://your-domain.monday.com/
身份验证 是
API 令牌 API_TOKEN
Secret 版本 1

Secret 版本的资源名称采用以下格式:projects/PROJECT_NUMBER/secrets/CONNECTOR/versions/1

OAuth 2.0 连接类型

字段名称 详细信息
位置 europe-west1
连接器 星期一
连接器版本 1
连接名称 monday-oauth-conn
启用 Cloud Logging 是
日志级别 错误
服务账号 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
节点数下限 2
节点数上限 50
目标类型 主机地址
主机 1 https://your-domain.monday.com/
身份验证 是
客户端 ID CLIENT_ID
客户端密钥 CLIENT_SECRET
Secret 版本 1

Secret 版本的资源名称采用以下格式:projects/PROJECT_NUMBER/secrets/CONNECTOR/versions/1

范围 account:read, users:read, assets:read, boards:read, boards:write, docs:read, docs:write, me:read, notifications:write, tags:read, teams:read, updates:read, updates:write, users:read, users:write, workspaces:read, workspaces:write

系统限制

Monday 连接器每个节点每秒最多可处理 1 次查询,并且会限制超出此限制的任何交易。默认情况下,Integration Connectors 会为连接分配 2 个节点(以提高可用性)。

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

在集成中使用 Monday 连接

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

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

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

  • 实体:实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如,在数据库连接器中,表是实体;在文件服务器连接器中,文件夹是实体;在消息传递系统连接器中,队列是实体。

    但可能的情况是,连接器不支持或不具有任何实体,在这种情况下,Entities 列表将为空。

  • 操作:操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作:

    从可用列表中选择一个实体,系统会生成该实体可用的操作列表。如需了解操作的详细说明,请参阅连接器任务的实体操作。不过,如果连接器不支持任何实体操作,则不支持的操作不会列在 Operations 列表中。

  • 动作:动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改,并且动作因连接器而异。通常,操作会包含一些输入参数和一个输出参数。但可能的情况是,连接器不支持任何动作,在这种情况下,Actions 列表将为空。

操作

本部分列出了 Monday 连接器支持的操作。如需了解如何配置操作,请参阅操作示例。

CreateNotification 操作

此操作会创建新的通知。

CreateNotification 操作的输入参数

参数名称 数据类型 必需 说明
UserId 字符串 是 用户的唯一标识符
TargetType 字符串 是 目标类型(项目/帖子)。
TargetId 字符串 是 目标的唯一标识符
文本 字符串 是 通知文本

如需查看有关如何配置 CreateNotification 操作的示例,请参阅 示例。

MoveItemToBoard 操作

此操作会将白板/文件从一个实例移动或转移到另一个实例。

MoveItemToBoard 操作的输入参数

参数名称 数据类型 必需 说明
BoardId 字符串 是 目标 Jamboard 的唯一标识符。
GroupId 字符串 是 目标群组的唯一标识符。
ItemId 字符串 是 要移动的内容的唯一标识符。

如需查看有关如何配置 MoveItemToBoard 操作的示例,请参阅 示例。

DuplicateItem 操作

此操作会复制现有商品。

DuplicateItem 操作的输入参数

参数名称 数据类型 必需 说明
ItemId 字符串 是 相应商品的唯一标识符。
BoardId 字符串 是 Jamboard 的唯一标识符。
WithUpdates 布尔值 是 与商品更新重复。

如需查看有关如何配置 DuplicateItem 操作的示例,请参阅示例。

LikeUpdate 操作

此操作可让您顶帖子。

LikeUpdate 操作的输入参数

参数名称 数据类型 必需 说明
UpdateId 字符串 是 更新标识符

如需查看有关如何配置 LikeUpdate 操作的示例,请参阅 示例。

AddFileToColumn 操作

此操作会将文件添加到列中。

AddFileToColumn 操作的输入参数

参数名称 数据类型 必需 说明
ItemId 字符串 是 相应商品的唯一标识符。
ColumnId 字符串 是 列的唯一标识符。
内容 字符串 是 用于上传文件的字符串内容。

如需查看有关如何配置 AddFileToColumn 操作的示例,请参阅 示例。

AddFileToUpdate 操作

此操作会添加要更新的文件。

AddFileToUpdate 操作的输入参数

参数名称 数据类型 必需 说明
UpdateId 字符串 是 更新标识符
内容 字符串 是 用于上传文件的字符串内容。

如需查看有关如何配置 AddFileToUpdate 操作的示例,请参阅 示例。

DuplicateBoard 操作

此操作会复制特定操作的数据。

DuplicateBoard 操作的输入参数

参数名称 数据类型 必需 说明
BoardId 字符串 是 Jamboard 的唯一标识符
DuplicateType 字符串 是 重复类型。

如需查看有关如何配置 DuplicateBoard 操作的示例,请参阅 示例。

DuplicateGroup 操作

此操作会复制群组的数据。

DuplicateGroup 操作的输入参数

参数名称 数据类型 必需 说明
BoardId 字符串 是 Jamboard 的唯一标识符
GroupId 字符串 是 群组的唯一标识符。
AddToTop 布尔值 是 指明新群组是否添加到顶部。
GroupTitle 字符串 是 群组标题。

如需查看有关如何配置 DuplicateGroup 操作的示例,请参阅 示例。

操作示例

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

示例 - CreateNotification

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 CreateNotification 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
        {
          "UserId": "64384966",
          "TargetType": "Project",
          "TargetId": "1899350039",
          "Text": "This is notification from google Cloud."
        }
        
  4. 如果操作成功,CreateNotification 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

        [{
          "notificationid": "-1"
        }] 
        

示例 - MoveItemToBoard

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 MoveItemToBoard 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
        {
          "BoardId": "1900739644",
          "GroupId": "topics",
          "ItemId": "1901835960"
        }
        
  4. 如果操作成功,MoveItemToBoard 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      
        [{
          "itemid": "1901835960"
        }]
        

示例 - DuplicateItem

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 DuplicateItem 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
     
      {
        "ItemId": "1901835811",
        "BoardId": "1899350039",
        "WithUpdates": true
      }
      
  4. 如果操作成功,DuplicateItem 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "itemid": "1901835960"
      }]
      

示例 - LikeUpdate

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 LikeUpdate 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
      {
        "UpdateId": "18397960"
      }
      
  4. 如果操作成功,LikeUpdate 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "updateid": "690939"
      }] 
      

示例 - AddFileToColumn

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 AddFileToColumn 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
      {
        "ItemId": "1901866680",
        "ColumnId": "files",
        "Content": "HI Team"
      }
      
  4. 如果操作成功,AddFileToColumn 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "assetid": "13325557"
      }]
      

示例 - AddFileToUpdate

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 AddFileToUpdate 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
      {
        "UpdateId": "18397903",
        "Content": "Integration Testing File Updated."
      }
      
  4. 如果操作成功,AddFileToUpdate 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "assetid": "13325933"
      }]
    

示例 - DuplicateGroup

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 DuplicateGroup 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
      {
        "BoardId": "1899350039",
        "GroupId": "new_demo_group4869__1",
        "AddToTop": true,
        "GroupTitle": "Duplicate Group"
      }
    
  4. 如果操作成功,DuplicateGroup 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "assetid": "13325933"
      }]
    

示例 - DuplicateBoard

  1. 在 Configure connector task 对话框中,点击 Actions。
  2. 选择 DuplicateBoard 操作,然后点击完成。
  3. 在连接器任务的任务输入部分中,点击 connectorInputPayload,然后在 Default Value 字段中输入类似于以下内容的值:
      {
        "BoardId": "1900733069",
        "DuplicateType": "duplicate_board_with_structure"
      }
      
  4. 如果操作成功,DuplicateBoard 任务的 connectorOutputPayload 响应参数将具有类似于以下示例的值:

      [{
        "assetid": "13325933"
      }]
      

实体操作示例

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

示例 - 工作区的列表操作

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaces。
  3. 选择 List 操作,然后点击完成。
  4. 连接器任务的任务输入部分中,您可以根据客户要求设置 filterClause。您可以通过指定过滤条件子句来过滤结果集。 请务必使用英文单引号 (') 将过滤条件子句值括起来。

您可以对以下实体执行 List 操作:

文件夹、看板、BoardView、BoardUser、BoardTeam、ActivityLog、Webhook、标记、用户、文档、DocBlock、团队、MoveItemToBoard、群组、更新、WorkspaceTeam、WorkspaceUser、TeamUser、列

GoogleTestingProject 实体是动态公开的实体。使用此实体,您可以对商品和任何列类型执行 CRUD 操作。

示例 - 从工作区获取单个记录

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaces。
  3. 选择 Get 操作,然后点击完成。
  4. 将实体 ID 设置为“961430”,即要传递的键。如需设置实体 ID,请在数据映射的数据映射器部分中,点击打开数据映射编辑器,然后在输入值字段中输入 "961430",并选择 EntityId 作为局部变量。

如果您的实体具有复合主键,则可以指定过滤条件子句。

您可以对以下实体执行 Get 操作:

Boards、BoardViews、ActivityLogs、WebHook、Tags、Asset、Users、Doc、DocBlock、Team、Updates、Columns

示例 - 从实体“工作区”中删除记录

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaces。
  3. 选择 Delete 操作,然后点击完成。
  4. 将实体 ID 设置为“961430”,这是要传递的键。如需设置实体 ID,请在数据映射的数据映射器部分中,点击打开数据映射编辑器,然后在输入值字段中输入 "961430",并选择 EntityId 作为局部变量。

    或者,如果实体有两个复合业务键或主键,您也可以将 filterClause 设置为 id='961430',而不是指定 entityId。

您可以对以下实体执行删除操作:

文件夹、看板、WebHook、群组、子项、DocBlock、TeamUser、WorkspaceUser、看板、BoardTeams、 BoardUsers、更新、列

示例 - 创建实体 Workspace

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspace。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "Name": "Riky's Workspace",
      "Kind": "open",
      "Description": "This is Riky's Workspace"
    }
    

    此示例将创建工作区。如果集成成功,Workspace 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     
    {
      "Id": "964218"
    }
    

示例 - 创建实体 Workspaceuser(单个用户)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaceuser。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "WorkspaceId": "952743",
      "Kind": "subscriber",
      "Id": "'64427450'"
    }

    此示例演示了如何在 Workspace 中添加单个用户。如果集成成功,Workspaceuser 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Success": true
    }
    

示例 - 创建实体 Workspaceuser(多个用户)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaceuser。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "64427450,64426103,65189599"
    }

    此示例演示了如何在工作区中添加多位用户。如果集成成功,Workspaceuser 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "64426103",
      "WorkspaceId": "1027130"
    }
    

示例 - 创建实体 WorkspaceTeams(单个团队)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 WorkspaceTeams。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "16516"
    }

    此示例演示了如何在工作区中添加单个团队。如果集成成功,WorkspaceTeams 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "16516",
      "WorkspaceId": "1027130"
    }
    

示例 - 创建实体 WorkspaceTeams(多个团队)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 WorkspaceTeams。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "16516,15056,14926"
    }

    此示例演示了如何在工作区中添加多个团队。如果集成成功,WorkspaceTeams 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "16516",
      "WorkspaceId": "1027130"
    }

示例 - 创建实体 TeamUser(单个用户)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 TeamUser。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "TeamId": "15056",
      "Id": "64427450"
    }

    此示例演示了如何在团队中添加单个用户。如果集成成功,TeamUser 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "64427450",
      "TeamId": 15056
    }

示例 - 创建实体 TeamUser (MultipleUsers)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 TeamUser。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "TeamId": "16516",
      "Id": "64427450,64426103,65189599"
    }

    此示例演示了如何在团队中添加多位用户。如果集成成功,TeamUser 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "64427450",
      "TeamId": "16516"
    }

示例 - 创建实体 Boards

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Boards。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "Name": "New Demo Board",
      "BoardKind": "public"
    }

    此示例将创建看板。如果集成成功,Boards 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "1900733069"
    }
    

示例 - 创建实体 Boardusers(单个用户)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Boardusers。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1900739644",
      "Id": "64385055",
      "Kind": "subscriber"
    }

    此示例演示了如何向看板添加单个用户。如果集成成功,Boardusers 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "64385055",
      "BoardId": null
    } 
    

示例 - 创建实体 Boardusers(多个用户)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Boardusers。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1899350039",
      "Id": "64427450,64426103,65189599",
      "Kind": "subscriber"
    }
    

    此示例演示了如何向看板添加多位用户。如果集成成功,Boardusers 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
    "Id": "64426103",
    "BoardId": "1899350039"
    }
    

示例 - 创建实体 BoardTeam(单个团队)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 BoardTeam。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1899350039",
      "Id": "14926",
      "Kind": "subscriber"
     }

    此示例演示了如何向看板添加单个团队。如果集成成功,BoardTeam 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "14926",
      "BoardId": null
    }
    

示例 - 创建实体 BoardTeam(多个团队)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 BoardTeam。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
     {
      "BoardId": "1919494280",
      "Id": "16516,15056,14926",
      "Kind": "subscriber"
    }
    

    此示例演示了如何向看板添加多个团队。如果集成成功,BoardTeam 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "16516",
      "BoardId": "1919494280"
    } 
    

示例 - 创建实体组

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Group。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1899350039",
      "Title": "New Demo Group",
      "RelativeTo": "mohit group",
      "PositionRelativeMethod": "after_at",
      "Color": "#FFCB00"
    }
    

    此示例将创建群组。如果集成成功,Group 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "new_demo_group29615__1",
      "BoardId": "1899350039"
    }
    

示例 - 创建实体列

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "people",
      "Title": "PeopleInfo",
      "Id": "people1"
    }
    

    此示例将创建列,如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "people1",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(日期)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "Title": "Date",
      "Type": "date",
      "BoardId": "1922602090",
      "Id": "date"
    }
     

    此示例将创建“日期”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "date",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(下拉菜单)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "dropdown",
      "Title": "Dropdown",
      "Id": "dropdown_1"
    }
    

    此示例将创建“下拉菜单”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "dropdown_1",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(电子邮件)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "email",
      "Title": "Mail",
      "Id": "mail_11"
    }
    

    此示例将创建“电子邮件”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "mail_11",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(LongText)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "long_text",
      "Title": "Longtext",
      "Id": "longtext1"
    }
    

    此示例将创建 LongText 列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "longtext1",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(数字)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
     {
      "BoardId": "1922602090",
      "Type": "numbers",
      "Title": "Number",
      "Id": "number"
    }
    

    此示例将创建“Number”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "number",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(电话)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "phone",
      "Title": "PhoneNumber",
      "Id": "phone43"
    }
    

    此示例将创建“电话”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "phone43",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(文本)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "text",
      "Title": "Text",
      "Id": "text18"
    }
    

    此示例将创建“文本”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "text18",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(依赖项)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
     {
      "BoardId": "1922602090",
      "Type": "dependency",
      "Title": "Dependency",
      "Id": "dependency_1"
    }
     

    此示例将创建“Dependency”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "dependency_1",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(人员)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "people",
      "Title": "PeopleInfo",
      "Id": "people123"
    }
     

    此示例将创建“人员”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "people123",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(国家/地区)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "country",
      "Title": "Country",
      "Id": "country"
    }
    

    此示例将创建“国家/地区”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "country",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(小时)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "hour",
      "Title": "Hour",
      "Id": "hour"
    }
     

    此示例将创建“Hour”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "hour",
      "BoardId": "1922602090"
    }
    
  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "link",
      "Title": "LINK",
      "Id": "linkurl"
    }
     

    此示例将创建“链接”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "linkurl",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(位置)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "location",
      "Title": "Location",
      "Id": "location"
    }
     

    此示例将创建“位置”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "location",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(评分)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "rating",
      "Title": "Rating",
      "Id": "rating123"
    }
     

    此示例将创建“评分”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "rating123",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(时间轴)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
      {
      "BoardId": "1922602090",
      "Type": "timeline",
      "Title": "Timeline",
      "Id": "timeline"
    }
     

    此示例将创建“时间轴”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "timeline",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(周)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
      {
      "BoardId": "1922602090",
      "Type": "week",
      "Title": "Week",
      "Id": "week_12"
    }
    

    此示例将创建“周”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "Id": "week_12",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体列(WorldClock)

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "BoardId": "1922602090",
      "Type": "world_clock",
      "Title": "World Clock",
      "Id": "world_clock1"
    }
    

    此示例将创建“世界时钟”列。如果集成成功,Columns 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

     {
      "Id": "world_clock1",
      "BoardId": "1922602090"
    }
    

示例 - 创建实体 GoogleTestingProject(SubItem)

GoogleTestingProject 实体是动态公开的实体。使用此实体,您可以对商品和任何列类型执行 CRUD 操作。
  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 GoogleTestingProject。
  3. 选择 Create 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为局部变量。
    {
      "ParentItemId": "1901835811",
      "Subitem": "Cloud_Sub-Item NAme"
    }
     

    此示例将创建 SubItem。如果集成成功,GoogleTestingProject 任务的 connectorOutputPayload 响应参数将具有类似以下的值:

    {
      "ItemId": "1901893886"
    }
    

示例 - 更新实体“工作区”

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Workspaces。
  3. 选择 Update 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。
    {
      "Description": "Updated Workspace",
      "Name": "Riky's Updated Workspace"
    }
    
  5. 您也可以将 filterClause 设置为 964218,而不是指定 entityId。

    如果集成成功,连接器任务的 connectorOutputPayload 字段将具有类似以下的值:

    {
      "Id": "964218"
    }
    

示例 - 更新实体“Boards”

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Boards。
  3. 选择 Update 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。
    {
      "State": "archived"
    }
    
  5. 您也可以将 filterClause 设置为 1899875405,而不是指定 entityId。

    如果集成成功,连接器任务的 connectorOutputPayload 字段将具有类似以下的值:

    {
      "Id": "1899875405"
    }
    

示例 - 更新实体组

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Group。
  3. 选择 Update 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。
    {
      "Color": "#FFCB00"
    }
    
  5. 您也可以将 filterClause 设置为 Id='new_demo_group4301__1' 和 BoardId='1899350039',而不是指定 entityId。

    如果集成成功,连接器任务的 connectorOutputPayload 字段将具有类似以下的值:

    {
      "Id": "new_demo_group4301__1",
      "BoardId": "1899350039"
    }
    

示例 - 更新实体列

  1. 在 Configure connector task 对话框中,点击 Entities。
  2. 从 Entity 列表中选择 Columns。
  3. 选择 Update 操作,然后点击完成。
  4. 在数据映射任务的数据映射器部分中,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。
     {
      "Description": "People Information"
    } 
    
  5. 您也可以将 filterClause 设置为 1922602090,而不是指定 entityId。

    如果集成成功,连接器任务的 connectorOutputPayload 字段将具有类似以下的值:

    {
      "Id": "people1",
      "BoardId": "1922602090"
    }
    

使用 Terraform 创建连接

您可以使用 Terraform 资源创建新连接。

如需了解如何应用或移除 Terraform 配置,请参阅基本 Terraform 命令。

如需查看用于创建连接的 Terraform 模板示例,请参阅模板示例。

向 Google Cloud 社区寻求帮助

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

后续步骤