如何在 Google 文档中插入文本时引用人物资料？

Question

我正在尝试使用 Google Doc API 创建一个项目符号列表，并想在项目符号中标记一个人的个人资料。例如，我想在 GDoc 中实现以下内容：

• 待办事项一：李四

可以通过@在 Google 文档上手动解析 John Doe 的个人资料并输入电子邮件 ID，但是当我使用

insertText

请求并使用像

'@[email protected]'

这样的电子邮件 ID 时，API 输入原始文本而不是解析发送给 John 的电子邮件Doe的个人资料

Answer 1

不幸的是，Google Docs API 没有提供在项目符号列表项中标记个人资料的直接方法。您提到的“@”提及功能仅适用于 Google 文档用户界面，无法使用 API 复制。

但是，您可以通过使用指向此人电子邮件地址的超链接来获得类似的结果。下面是一个示例，说明如何使用 Google Docs API 创建带有指向 John Doe 电子邮件地址的超链接的项目符号列表项：

requests = [{
    'insertText': {
        'location': {
            'index': 1
        },
        'text': 'To-do item 1:'
    }
}, {
    'createParagraphBullets': {
        'range': {
            'startIndex': 0,
            'endIndex': 12
        },
        'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
        'textStyle': {}
    }
}]

将超链接添加到 John Doe 的电子邮件地址：

requests.append({
    'updateTextStyle': {
        'range': {
            'startIndex': 12,
            'endIndex': 21
        },
        'textStyle': {
            'link': {
                'url': 'mailto:[email protected]'
            }
        },
        'fields': 'link'
    }
})

这将创建一个带有文本“待办事项 1：”的项目符号列表项，后跟指向 John Doe 的电子邮件地址的超链接。当用户单击超链接时，它将打开他们的默认电子邮件客户端并使用 John Doe 的电子邮件地址填充“收件人”字段。

请注意，可以使用 updateTextStyle 请求自定义超链接的样式，以设置字体颜色、下划线等属性