Google Drive模块

通过Adobe Workfront Fusion Google Drive模块,您可以监视、搜索、创建、更新、删除和管理Google Drive中的文件、文件夹或共享驱动器。

在Adobe Workfront Fusion方案中,您可以将Google Drive帐户连接到多个第三方应用程序和服务。

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

访问要求

您必须具有以下权限才能使用本文中的功能:

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

Google驱动器API信息

Google驱动器连接器使用以下对象:

基本URL
https://www.googleapis.com/drive/v3
API版本
v3
API标记
v4.1.22

正在将Google Drive连接到Workfront Fusion

如果您是@gmail.com或@googlemail.com用户,则需要在the Google Cloud Platform上创建OAuth客户端,以获取客户端ID和客户端密钥。

有关如何创建OAuth客户端(并获取客户端ID和客户端密钥)的分步说明,请参阅使用自定义OAuth客户端连接 Adobe Workfront Fusion 到 Google Services 。

有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明

Google Drive模块及其字段

配置Google Drive模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Google Drive字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。

触发器

监视文件夹中的文件

在指定的文件夹中添加或修改文件时检索文件详细信息。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
选择要监视的文件夹
选择驱动器上要监视文件的文件夹。
要查看的文件

选择要监视的文件类型。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
将Google Documents文件转换为格式
选择要将Google Documents转换为的文件格式。
将Google Spreadsheets文件转换为格式
选择要将Google Spreadsheets转换为的文件格式。
将Google Slides文件转换为格式
选择要将Google Slides转换为的文件格式。
将Google Drawings文件转换为格式
选择要将Google Drawings转换为的文件格式。
监视
选择是要监视新文件和所有更改,还是只监视新文件。
最大下载文件数
设置Workfront Fusion在一个周期内下载的最大结果数(每个方案运行的重复次数)。

观看所有文件

在添加或修改您Google Drive中的某个文件时检索文件详细信息。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
要查看的文件

选择要监视的文件类型。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
将Google Documents文件转换为格式
选择要将Google Documents转换为的文件格式。
将Google Spreadsheets文件转换为格式
选择要将Google Spreadsheets转换为的文件格式。
将Google Slides文件转换为格式
选择要将Google Slides转换为的文件格式。
将Google Drawings文件转换为格式
选择要将Google Drawings转换为的文件格式。
监视
选择是要监视新文件和所有更改,还是只监视新文件。
最大下载文件数
设置Workfront Fusion在一个周期内下载的最大结果数(每个方案运行的重复次数)。

观看共享文件

当您共享新文件或更新现有共享文件时,会触发该事件。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
选择要监视的文件夹
选择要监视文件的共享文件夹。
要查看的文件

选择要监视的文件类型。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
将Google Documents文件转换为格式
选择要将Google Documents转换为的文件格式。
将Google Spreadsheets文件转换为格式
选择要将Google Spreadsheets转换为的文件格式。
将Google Slides文件转换为格式
选择要将Google Slides转换为的文件格式。
将Google Drawings文件转换为格式
选择要将Google Drawings转换为的文件格式。
监视
选择是要监视新文件和所有更改,还是只监视新文件。
最大下载文件数
设置Workfront Fusion在一个周期内下载的最大结果数(每个方案运行的重复次数)。

观看评论

在选定文件上添加或修改评论时触发。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
文件
选择要监视其注释的文件。
监视
选择要监视所有更改还是仅监视新注释
返回的最大评论数
设置Workfront Fusion在一个周期内返回的最大评论数(每个方案运行的重复次数)。

操作

上载文件

将文件上传到您的Google Drive。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
Destination

选择要将文件上载到的目标。

  • My Drive
  • Shared with Me
目标文件夹
选择要将文件上传到的文件夹。
Source file
选择是要使用从上一个模块传入的文件,还是要手动映射文件。
文件名
选择文件名。 如果您在源文件字段中选择“映射”,则此选项可用。
数据
选择要上载的数据文件。 如果您在源文件字段中选择“映射”,则此选项可用。
标题
输入新文件的标题。
转换文件
启用此选项将允许模块将文件转换为相应的Google格式。

更新文件

更新文件的元数据或内容。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
目标

选择要将文件上载到的目标。

  • 我的驱动器
  • 与我共享
移至文件夹
如果要将文件移动到其他文件夹,请选择要将文件移动到其中的文件夹。
文件ID
映射要更新的文件的ID。
标题
输入更新文件的标题。
更改文件内容
选择是否要替换文件的内容。
Source file
选择是要使用从上一个模块传入的文件,还是要手动映射文件。 如果您在上一个字段中选择了更改文件的内容,则此字段可用。
文件名
选择文件名。 如果您在源文件字段中选择“映射”,则此选项可用。
数据
选择要上载的数据文件。 如果您在源文件字段中选择“映射”,则此选项可用。

复制文件

将文件复制到新位置。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
目标

选择要将文件上载到的目标。

  • 我的驱动器
  • 与我共享
目标文件夹
选择要复制的文件所在的文件夹/
文件ID
映射要更新的文件的ID。
副本的名称
输入新文件的标题。 如果不想更改原始文件名,请将此字段留空。

删除文件

永久删除文件或文件夹。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
文件ID
映射要删除的文件的ID。

将文件/文件夹移动到垃圾桶

将文件或文件夹移至垃圾桶。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
文件ID
将您要移动的文件的ID映射到垃圾桶。

获取文件

检索具有指定ID的文件。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
将Google Documents文件转换为格式
选择要将Google Documents转换为的文件格式。
将Google Spreadsheets文件转换为格式
选择要将Google Spreadsheets转换为的文件格式。
将Google Slides文件转换为格式
选择要将Google Slides转换为的文件格式。
将Google Drawings文件转换为格式
选择要将Google Drawings转换为的文件格式。
文件ID
映射要检索的文件的ID。

搜索文件/文件夹

根据搜索条件搜索文件或文件夹。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
目标

选择要搜索的目标。

  • 我的驱动器
  • 与我共享
列出文件夹
导航到要搜索文件或文件夹的文件夹。
Retrieve
选择是要搜索文件、文件夹,还是同时搜索两者。
搜索

选择要执行的搜索类型。

  • 在文件/文件夹名称内搜索

    • 查询

      输入要搜索的文件名的一部分或完整文件名(包括后缀)。

    • 搜索选项

      选择是要搜索确切的搜索词,还是要搜索包含该搜索词的名称。

  • Fulltext搜索

    • 查询

      输入要在Google Drive中搜索的任何搜索词。

  • 输入自定义搜索查询

    • 查询

      输入自定义搜索查询。 有关更多详细信息,请参阅本文的搜索文件部分。

    • 将上面选择的文件夹添加到查询

      在父收藏集中搜索文件夹。 这会查找直接位于上面所选文件夹中的所有文件和文件夹。

返回结果的最大数目
设置在一个执行周期内Workfront Fusion将返回的最大文件或文件夹数。
即使模块未返回任何结果,仍继续执行路由
启用此选项以确保在模块未返回任何结果时不会停止该方案。

创建文件夹

在指定位置创建文件夹。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
目标

选择要将文件上载到的目标。

  • 我的驱动器
  • 与我共享
新建文件夹位置
导航到要创建新文件夹的位置。
新文件夹的名称
输入正在创建的文件夹的名称。
共享文件夹
如果要与具有共享链接的任何用户共享文件夹,请选择此选项。 否则,共享链接仅供所有者使用。

获取共享链接

在Google驱动器中检索文件的共享链接。

Connection
有关将Google Drive帐户连接到Workfront Fusion的说明,请参阅将Google Drive连接到Workfront Fusion
文件ID
映射要获取共享链接的文件的ID。

故障排除

无法上传或更新文件

上传或更新文件失败时,可能会出现以下几种情况:

  • 上传的文件太大,超过了您的Google Drive计划允许的最大文件大小限制,或者您已超过Google Drive存储限制。 您可以升级存储计划,也可以从Google Drive服务中删除现有文件。
  • 要将文件上载到的所选文件夹不再存在。 此方案将停止,随后需要再次选择目标文件夹。

搜索文件

在模块的List files in a folder中,您可以使用自己的查询,该查询包含以下部分:

  • 字段 — 正在搜索的文件的属性,例如文件的属性name

  • 运算符 — 对数据执行的测试,用于提供匹配项,例如contains

  • — 测试的属性的内容,例如,文件My cool document的名称。

将子句与连接项andor组合,并使用not否定查询。

字段

字段
值类型
运算符
描述
title
字符串
contains1=!=
文件的名称。
fullText
字符串
contains2, 3
文件的全文,包括名称、描述、内容和可索引文本。
mimeType
字符串
contains=!=
文件的MIME类型。
modifiedDate
日期4
<=<=!=>>=
上次修改文件的日期。
lastViewedByMeDate
日期4
<=<=!=>>=
用户上次查看文件的日期。
trashed
布尔值
=!=
文件是否在垃圾桶中。
starred
布尔值
=, !=
文件是否处于星型状态。
parents
收藏集
in
parents集合是否包含指定的ID。
owners
收藏集
in
拥有文件的用户。
writers
收藏集
in
有权修改文件的用户。
readers
收藏集
in
有权读取文件的用户。
sharedWithMe
布尔值
=, !=
用户“已与我共享”收藏集中的文件。
properties
收藏集
has
公共自定义文件属性。

请考虑以下有关这些字段中的运算符的信息:

  • contains运算符仅对title执行前缀匹配。

    例如,标题“HelloWorld”与title contains 'Hello'匹配,但与title contains 'World'不匹配。

  • contains运算符仅对fullText的整个字符串令牌执行匹配。

    例如,如果文档的全文包含字符串“HelloWorld”,则只有查询fullText contains 'HelloWorld'返回结果。 在此方案中,诸如fullText contains 'Hello'之类的查询不会返回结果。

  • 如果contains运算符由双引号括起来,则它匹配精确字母数字短语。

    例如,如果文档的fullText包含字符串“Hello there world”,则查询fullText contains '"Hello there"'返回结果,但查询fullText contains '"Hello world"'未返回结果。

    此外,由于搜索是字母数字的,因此如果文档的fullText包含字符串“Hello_world”,则查询fullText contains '"Hello world"'将返回结果。

  • type日期的字段当前无法相互比较,只能比较固定日期。

值类型

值类型
注释
字符串
用单引号'. 对包含\'的查询(例如, 'Valentine\'s Day')中的单引号进行转义。
布尔型
true false
日期
RFC 3339格式,默认时区为UTC,例如2012-06-04T12:00:00-08:00

运算符

操作员
注释
contains
一个字符串的内容存在于另一个字符串中。
=
字符串或布尔值的内容等于另一个字符串或布尔值。
!=
字符串或布尔值的内容不等于另一个字符串或布尔值。
<
日期早于另一个日期。
<=
日期早于或等于另一个日期。
>
日期晚于另一个日期。
>=
日期晚于或等于另一个日期。
in
元素包含在收藏集中。
and
返回匹配两个子句的文件。
or
返回与任一子句匹配的文件。
not
使搜索子句无效。
has
收藏集包含与参数匹配的元素。

对于复合子句,可以使用括号将子句组合在一起。 例如:
modifiedDate > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/')此搜索返回其上次修改是在2012年6月4日之后且图像或视频MIME类型的所有文件。 由于andor运算符是从左到右计算的,没有括号,因此上述示例将仅返回在2012年6月4日之后修改的图像,但会返回所有视频,甚至是2012年6月4日之前的视频。

示例

此页面上的所有示例都显示了未编码的<q>q</q>参数,其中title = 'hello'编码为title+%3d+%27hello%27。 客户端库会自动处理此编码。

  • 搜索名为“hello”的文件

    标题= 'hello'
    
  • 使用文件夹特定的MIME类型搜索文件夹

    mimeType = 'application/vnd.google-apps.folder'
    
  • 搜索不是文件夹的文件

    mimeType != 'application/vnd.google-apps.folder'
    
  • 搜索名称中包含“hello”和“goodbye”字样的文件

    标题包含'hello',名称包含'goodbye'
    
  • 搜索名称中不包含单词“hello”的文件

    标题不包含“hello”
    
  • 搜索内容中包含“hello”一词的文件

    全文包含“hello”
    
  • 搜索内容中不包含单词“hello”的文件

    非fullText包含“hello”
    
  • 搜索内容中包含精确短语“hello world”的文件

    全文包含“ hello world”。全文包含“ hello_world”
    
  • 使用包含“\”字符(如“\authors”)的查询搜索文件

    全文包含'\\authors'
    
  • 搜索用户test@example.org可写的文件

    中的“test@example.org” writers
    
  • parents集合中搜索ID 1234567。 这会查找直接位于ID为1234567的文件夹中的所有文件和文件夹。

    父级中的“1234567”
    
  • parents集合中搜索别名ID appDataFolder。 这会查找直接位于应用程序数据文件夹下的所有文件和文件夹。

    父级中的“appDataFolder”
    
  • 搜索用户test@example.orgtest2@example.org可写的文件

    作者中的“test@example.org”和作者中的“test2@example.org”
    
  • 搜索垃圾桶中包含“important”文本的文件

    fullText包含“important”,并且已置入垃圾桶= true
    
  • 搜索在2012年6月4日之后修改的文件

    modifiedDate > '2012-06-04T12:00:00' //默认时区为UTC
    
    modifiedDate > '2012-06-04T12:00:00-08:00'
    
  • 搜索与名称中带有“hello”的授权用户共享的文件

    sharedWithMe,标题包含“hello”
    
  • 搜索具有名为additionalID且值为8e8aceg2af2ge72e78自定义文件属性的文件。

    属性具有{ key='additionalID'和value='8e8aceg2af2ge72e78'和visibility='PRIVATE' }
    

本指南的Source是Google Drive 文档

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43