按 ID 运行一次计划

版本 4.0.23.4

立即按 ID 运行已安排的方案

此函数将基于现有已安排的方案创建“运行一次”计划，并将修改（如有）应用于新的计划计划，并立即运行新的计划。这对于在提交生产时间表之前测试对现有已安排方案进行的修改非常有用。

此函数在内部执行以下操作：

  1. 将现有安排的方案的属性复制到新的已安排的方案中
  2. 将此请求的 JSON 正文中传递的所有属性复制到新的排定计划中（替换原始值）
  3. 创建新的已安排方案
  4. 运行新的已安排方案

此操作未修改原计划方案。管理员可以指定用户 ID，从而代表其他用户创建、修改和运行已安排的方案。非管理员只能创建、修改和运行他们自己安排的方案。

电子邮件权限：

如需详细了解安排定期发送电子邮件所需的权限，以及 Looker 针对防止将电子邮件发送到未经授权的电子邮件目的地而采取的保护措施，请参阅针对定期查看的电子邮件网域许可名单。

计划的方案目标格式

已排定的方案的目标位置必须指定要生成的数据格式并将其发送到该目标位置。

格式：

格式 说明
json 这个 JSON 对象包含一个 data 属性，该属性包含一个 JSON 对象数组，每行一个无元数据。
json_detail 行数据以及描述查询的字段、数据透视表、表计算和其他方面的元数据
内嵌 json 除了 data 属性是包含 JSON 转义行数据的字符串之外，与 JSON 格式相同。其他属性用于描述数据操作，此格式主要用于将数据发送到网络钩子，这样网络钩子无需对 JSON 行数据进行重新编码，即可将其传递到最终目的地。
csv 以英文逗号分隔的值，带有标题
txt 使用标头制表符分隔值
html 简单 HTML
XX MS Excel 电子表格
所见即所得 PDF 以平铺布局呈现的信息中心，用于生成 PDF 文档
汇编_pdf 以单列布局呈现的信息中心，用于生成 PDF 文档
所见即所得 以平铺布局呈现的信息中心，用于生成 PNG 图片

有效格式因目的地类型和来源对象而异。例如，wysiwyg_pdf 仅对信息中心有效。

此 API 设有速率限制，以防止其用于中继垃圾邮件或 DoS 攻击

请求

POST /scheduled_plans/{scheduled_plan_id}/run_once
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
已安排计划的 ID
字符串
要复制并运行的时间表方案的 ID
body
HTTP 正文
展开 HTTPBody 定义...
body
在运行新复制的计划之前要应用到的属性值
展开 WriteSchedulePlan 定义...
name
字符串
此已安排的方案的名称
user_id
字符串
此安排的方案拥有的用户 ID
run_as_recipient
布尔值
是否以收件人身份运行时间表（仅适用于电子邮件收件人）
已启用
布尔值
是否启用了 SchedulePlan
Look_id
字符串
样式的 ID
信息中心 ID
字符串
信息中心 ID
Lookml_dashboard_id
字符串
LookML 信息中心的 ID
过滤条件_字符串
字符串
用于运行外观或信息中心的查询字符串
信息中心过滤条件
字符串
（已弃用）filter_string 字段的别名
要求结果
布尔值
如果运行信息中心或外观返回结果，则应进行传送
required_no_results
布尔值
如果信息中心外观未返回结果，则应传送消息
要求更改
布尔值
如果自上次运行后数据发生更改，则应发生传送
发送全部结果
布尔值
将运行无限制查询并发送所有结果。
Crontab
字符串
何时运行 Vixie-Style Crontab 规范
数据组
字符串
数据组的名称；如果指定，将在数据组触发时运行（不能与 Cron 字符串配合使用）
timezone
字符串
解读指定 crontab 的时区（默认为 Looker 实例时区）
查询 ID
字符串
查询 ID
已安排的计划目标
运行一次
布尔值
相关方案是否应该仅运行一次（通常用于测试）
添加链接
布尔值
此 SchedulePlan 中是否应包含返回 Looker 的链接
custom_url_base
字符串
预定实体的自定义网址域名
custom_url_params
字符串
已安排的实体的自定义网址路径和参数
自定义网址标签
字符串
预定实体的自定义网址标签
show_custom_url
布尔值
是否显示自定义链接，而不是标准 Looker 链接
pdf_paper_size
字符串
PDF 应采用适合页面大小的格式。有效值为“letter”、“legal”、“tabloid”、“a0”、“a1”、“a2”、“a3”、“a4”、“a5”。
pdf_landscape
布尔值
PDF 的格式是否为横向格式
嵌入
布尔值
此时间表是否位于嵌入上下文中
color_theme
字符串
信息中心的配色方案（如适用）
long_tables
布尔值
是否将表格展开至完整长度
inline_table_width
整数
渲染内嵌表可视化时的像素宽度

响应

200：已安排的方案

数据类型
说明
（对象）
name
字符串
此已安排的方案的名称
user_id
字符串
此安排的方案拥有的用户 ID
run_as_recipient
布尔值
是否以收件人身份运行时间表（仅适用于电子邮件收件人）
已启用
布尔值
是否启用了 SchedulePlan
Look_id
字符串
样式的 ID
信息中心 ID
字符串
信息中心 ID
Lookml_dashboard_id
字符串
LookML 信息中心的 ID
过滤条件_字符串
字符串
用于运行外观或信息中心的查询字符串
信息中心过滤条件
字符串
（已弃用）filter_string 字段的别名
要求结果
布尔值
如果运行信息中心或外观返回结果，则应进行传送
required_no_results
布尔值
如果信息中心外观未返回结果，则应传送消息
要求更改
布尔值
如果自上次运行后数据发生更改，则应发生传送
发送全部结果
布尔值
将运行无限制查询并发送所有结果。
Crontab
字符串
何时运行 Vixie-Style Crontab 规范
数据组
字符串
数据组的名称；如果指定，将在数据组触发时运行（不能与 Cron 字符串配合使用）
timezone
字符串
解读指定 crontab 的时区（默认为 Looker 实例时区）
查询 ID
字符串
查询 ID
已安排的计划目标
展开 SchedulePlanDestination 定义...
id
字符串
唯一 ID
已安排计划的 ID
字符串
您拥有的已安排方案的 ID
格式
字符串
要发送到指定目的地的数据格式。支持的格式因目的地而异，但包括：“txt”“csv”“inline_json”“json”“json_detail”“xlsx”“html”“wysiwyg_pdf”“compiled_pdf”“wysiwyg_png”
apply_formatting
布尔值
值的格式是否正确？（包含货币符号、数字分隔符等）。
apply_vis
布尔值
是否对结果应用可视化选项。
地址
字符串
收件人地址。对于电子邮件（例如“user@example.com”）。对于网络钩子，例如“https://examle.domain/path”。对于 Amazon S3，例如“s3://bucket-name/path/”。对于 SFTP，例如“sftp://host-name/path/”。
Looker_recipient
布尔值
收件人是否为当前实例的 Looker 用户（仅适用于电子邮件收件人）
类型
字符串
地址类型（“email”、“webhook”、“s3”或“sftp”）
参数
字符串
包含外部调度参数的 JSON 对象。对于 Amazon S3，这需要 access_key_id 和区域的键和值。对于 SFTP，您需要提供用户名的键和值。
Secret_parameters
字符串
（只写）包含外部调度的 Secret 参数的 JSON 对象。对于 Amazon S3，这需要 secret_access_key 的键和值。对于 SFTP，这需要密码的密码键和值。
消息
字符串
要包含在定期发送的电子邮件中的可选消息
运行一次
布尔值
相关方案是否应该仅运行一次（通常用于测试）
添加链接
布尔值
此 SchedulePlan 中是否应包含返回 Looker 的链接
custom_url_base
字符串
预定实体的自定义网址域名
custom_url_params
字符串
已安排的实体的自定义网址路径和参数
自定义网址标签
字符串
预定实体的自定义网址标签
show_custom_url
布尔值
是否显示自定义链接，而不是标准 Looker 链接
pdf_paper_size
字符串
PDF 应采用适合页面大小的格式。有效值为“letter”、“legal”、“tabloid”、“a0”、“a1”、“a2”、“a3”、“a4”、“a5”。
pdf_landscape
布尔值
PDF 的格式是否为横向格式
嵌入
布尔值
此时间表是否位于嵌入上下文中
color_theme
字符串
信息中心的配色方案（如适用）
long_tables
布尔值
是否将表格展开至完整长度
inline_table_width
整数
渲染内嵌表可视化时的像素宽度
id
字符串
唯一 ID
创建时间
字符串
SchedulePlan 的创建日期和时间
更新时间
字符串
SchedulePlan 的上次更新日期和时间
title
字符串
职位
位用户
此 SchedulePlan 的所有者
展开 UserPublic 定义...
可以
对象
当前用户可以对此对象执行的操作
id
字符串
唯一 ID
first_name（名字）
字符串
名字
last_name（姓氏）
字符串
姓氏
display_name
字符串
要显示的全名（仅在设置了 first_name 和 last_name 的情况下可用）
头像
字符串
头像图片的网址（可能是通用网址）
网址
字符串
用于获取此商品的链接
next_run_at [下一步运行时间]
字符串
SchedulePlan 的下一次运行时间（如果运行一次，则为 null）
上次运行时间
字符串
SchedulePlan 的上次运行时间
可以
对象
当前用户可以对此对象执行的操作

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

409：资源已存在

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

422：验证错误

数据类型
说明
（对象）
消息
字符串
错误详情
展开 ValidationErrorDetail 定义...
字段
字符串
出错的字段
代码
字符串
错误代码
消息
字符串
错误信息消息
文档网址
字符串
文档链接
文档网址
字符串
文档链接

429：请求数过多

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接