Google Docs模块
- 主题:
- 数字内容和文档
创建对象:
- 用户
通过Adobe Workfront Fusion Google Docs模块,您可以在Google Docs和Google Docs(针对Google Workspace用户)中监视、创建、编辑和检索文档。
要将Google Docs与Adobe Workfront Fusion一起使用,需要具有Google帐户。 如果您还没有Google帐户,则可以在Google帐户帮助页面中创建一个帐户。
如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。
有关模块的信息,请参阅 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 Docs模块,您必须拥有Google帐户。
Google文档API信息
Google Docs连接器使用以下对象:
Google Docs模块及其字段
在配置Google Docs模块时,Workfront Fusion显示以下列出的字段。 除此以外,可能还会显示其他Google Docs字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。
如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。
文档
观看文档
在所选文件夹中创建或修改新文档时,此触发器模块返回文档详细信息。
选择要监视的驱动器类型。
-
我的驱动器
选择要监视创建或修改文档的文件夹。
-
已与我共享
选择要监视创建或修改文档的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要监视的共享驱动器。
注意:如果您在此字段中选择了Google Shared Drive选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
列出文档
此操作模块从选定的文件夹中检索文档列表。
选择要从中列出文档的驱动器类型。
-
我的驱动器
选择要从中列出文档的文件夹。
-
已与我共享
选择要从中列出文档的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要从中列出文档的共享驱动器。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
获取文档的内容
此操作模块检索指定文档。
您可能需要扩展您的权限。
选择包含要检索的文档的驱动器类型。
-
我的驱动器
选择包含要检索的文档的文件夹。
-
已与我共享
选择包含要检索的文档的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择包含要检索的文档的共享驱动器。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
选择您希望模块输出中返回的对象。
- Image(默认)
- Drawing
- 图表
注意:
要进一步映射这些对象,请在此模块的输出中使用Inline Objects Array值(而不是inlineObjects)。
Inline Objects Array对象按照它们在文档中的显示顺序排序。 这将使任何进一步的处理更容易。
创建文档
此操作模块允许您在选定文件夹中创建新文档。
选择要创建文档的驱动器类型。
-
我的驱动器
选择要创建文档的文件夹。
-
已与我共享
选择要创建文档的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要创建文档的共享驱动器。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
从模板创建文档
此操作模块会创建现有模板文档的副本并替换任何标记。 此模块还允许用户按URL将图像替换为新图像。
- By Mapping
选择此选项以映射文档模板。 - By Dropdown
选择此选项可从下拉菜单中选择文档模板。
选择模板所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择模板所在的文件夹。
-
已与我共享
选择模板所在的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择模板所在的共享驱动器。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
输入将输入的值,而不是新文档的变量。
- 标记
输入文档模板中包含的标记。 不要使用{{}}
。 示例:使用name
而不是{{name}}
。 - 替换的值
输入标记的值。
例如,源文档中的 {{name}}
变量将显示为此处的name字段,可以插入该值,如John
。
输入要替换当前图像的图像对象ID和图像URL的链接。
注意:您可以使用获取文档模块检索图像ID,其中ID包含在数组内联对象数组中。
我们建议您向Google文档中的图像添加替换文字。
向Google Docs图像添加替换文本:
- 右键单击图像。
- 选择替换文本选项。
- 在标题字段中输入替换文本,然后单击确定。
将ALT文本添加到图像后,ALT文本显示在括号中的字段名称中。
选择模板所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要创建文档的文件夹。
-
已与我共享
选择要创建文档的文件夹。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要创建文档的共享驱动器。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
向文档插入段落
此操作模块可在现有文档中添加或插入新段落。
- By Mapping
选择此选项以映射文档。 - By Dropdown
选择此选项可从下拉菜单中选择文档。
选择要添加段落的文档所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要添加段落的文档所在的文件夹,然后选择文档。
-
已与我共享
选择要添加段落的文档所在的文件夹,然后选择文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要向其添加段落的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
选择希望新文本插入文档的方式。
-
,按位置规范
-
,按索引
-
索引
输入要插入文本的索引编号。 您可以使用Get a Document模块检索索引号。
要显示文档中的所有字符(包括隐藏字符),您可以使用Show加载项。 您可以在Add-ons > Get add-ons下找到该加载项。 搜索Show并安装Show加载项。
-
插入文本
输入要插入到文档的文本。
-
-
,按区段ID
选择要插入文本内容的页眉和页脚,并输入要插入到相应字段中的文本。
如果页眉或页脚已包含文本,则新文本将添加到现有文本之前。
-
-
,附加到文档正文中
在文档正文内容的末尾附加输入的文本。
新段落的样式将从当前插入索引处的段落中复制,包括列表和项目符号。
-
,附加到区段(页眉和页脚)的末尾
选择要插入文本内容的页眉和页脚,并输入要插入到相应字段中的文本。
如果页眉或页脚已包含文本,则新文本将添加到现有文本之后。
将图像插入文档
此操作模块会将图像从URL插入到文档。
- By Mapping
选择此选项以映射文档模板。 - By Dropdown
选择此选项可从下拉菜单中选择文档。
选择要添加图像的文档所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要添加图像的文档所在的文件夹,然后选择文档。
-
已与我共享
选择要添加图像的文档所在的文件夹,然后选择文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要添加图像的文档所在的共享驱动器,然后选择文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
选择您希望新图像插入到文档中的方式。
-
,按位置规范
-
,按索引
-
索引
输入要插入图像的索引编号。 您可以使用Get a Document模块检索索引号。
要显示文档中的所有字符(包括隐藏字符),您可以使用Show加载项。 您可以在Add-ons > Get add-ons下找到该加载项。 搜索Show并安装Show加载项。
-
图像URL
输入要插入文档的图像的URL。
最大图像大小为50 MB。 不得超过2500万像素。 仅支持PNG、JPEG或GIF格式。
-
-
,按区段ID
选择要将图像插入到的页眉和页脚,并在相应的字段中输入图像URL。
最大图像大小为50 MB。 图像不能超过2500万像素。 仅支持PNG、JPEG或GIF格式。
-
-
,附加到文档正文中
在文档正文内容的末尾附加特定图像。
-
,附加到区段(页眉和页脚)的末尾
选择要插入图像的页眉和页脚,并输入要插入到相应字段的图像URL。
用新图像替换图像
此操作模块替换现有图像。 将保持原始图像的纵横比。
- By Mapping
选择此选项以映射文档模板。 - By Dropdown
选择此选项可从下拉菜单中选择文档。
选择要替换图像的文档所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要替换图像的文档所在的文件夹,然后选择该文档。
-
已与我共享
选择要替换图像的文档所在的文件夹,然后选择该文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要替换图像的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
输入或映射将替换现有图像的新图像的URL。
图像按其在文档中的显示顺序列出。 例如,Body: Image No. 1
是文档中的第一个图像。
替换文档中的文本
此操作模块替换文档中的文本。
- By Mapping
选择此选项以映射文档模板。 - By Dropdown
选择此选项可从下拉菜单中选择文档。
选择要向其添加文本的文档所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要向其添加文本的文档所在的文件夹,然后选择该文档。
-
已与我共享
选择要向其添加文本的文档所在的文件夹,然后选择该文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要向其添加文本的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
添加要替换的每个文本。
-
要替换的旧文本
输入要替换的文本。
-
要插入的新文本
输入新文本。
下载文档
此操作模块转换并下载所选文档。
选择要下载的文档所在的驱动器类型。
-
我的驱动器
选择要下载的文档所在的文件夹,然后选择该文档。
-
已与我共享
选择要下载的文档所在的文件夹,然后选择该文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要下载的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
删除文档
此操作模块删除文档。
选择要删除的文档所在的驱动器类型。
-
我的驱动器
选择要删除的文档所在的文件夹,然后选择该文档。
-
已与我共享
选择要删除的文档所在的文件夹,然后选择该文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要删除的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。
其他
进行API调用
此操作模块允许您执行自定义API调用。
https://docs.googleapis.com/
的路径。 示例: /v1/documents/{presentationID}
。选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。
{"Content-type":"application/json"}
。 Workfront Fusion为您添加授权标头。以标准JSON对象的形式添加API调用的正文内容。
注意:
在JSON中使用条件语句(如if
)时,请将引号放在条件语句之外。
示例: 以下API调用检索Google文档中指定文档的详细信息:
URL:
/v1/documents/1ujkf-GDgB0TQSYPrxbCSK4Uso54tHVMqHZEVZZxB6aY
方法:
GET
在包 > 正文下的模块输出中可找到检索文档的详细信息。
使文档中的所有链接都可点击
此操作模块查找文档中的所有链接并使它们可点击。
- By Mapping
选择此选项以映射文档模板。 - By Dropdown
选择此选项可从下拉菜单中选择文档。
选择要使链接可点击的文档所在的驱动器类型。 如果您在上一个字段中选择了By Dropdown ,则此选项可用。
-
我的驱动器
选择要使链接可点击的文档所在的文件夹,然后选择该文档。
-
已与我共享
选择要使链接可点击的文档所在的文件夹,然后选择该文档。
-
Google共享驱动器 (仅适用于Google Workspace用户)
选择是否希望使用域管理员访问权限。 选择是会以域管理员身份发出请求,并且会返回请求者是管理员的所有共享驱动器。
选择要使链接可点击的文档所在的共享驱动器,然后选择该文档。
注意:如果您在此字段中选择了Google Docs选项,并且您不是Google Workspace用户,则会返回错误
[400] Invalid Value
。