跳转到内容

创建一次性任务计划

Request

保存云手机,任务已安排。

模板参数 参数规范

  1. 参数来源

参数键必须从以下 API 返回的 parameter 字段中提取:

  • 获取市场模板页面

  • 获取个人模板页面

  1. 数据结构
  • 以 JSON 对象格式提交参数:{"key1": "value1", "key2": "value2"}

  • 最终参数值必须根据业务逻辑在使用前进行反序列化

  1. 通用类型参数

对于以下参数类型,请直接以相应格式传递值:

  • 字符串:{"name": "John"}

  • 小数/数字:{"amount": 100.50}

  • 布尔值:{"enabled": true}

  1. 媒体类型参数

对于图像 (pic) 或视频 (video) 等媒体参数,除了基本信息外,还必须包含一个固定键 "__Extra__"。示例格式:

{
"__Extra__": {

"pic": {

"name": "pic_name",

"size": 204800

},

"video": {
"name": "video_name",

"size": 204800000

}
},

"pic": "https://get.morelogin.com/prod/cloudPhoneTaskVideo/1556061681934880/1c62314c7e2b4d298abe8d5452d7c050/test.png",

"video": "morelogin://cloudfile?ids=1,2"

}

如果文件已经上传到 MoreLogin 网盘,媒体或文件参数可以使用网盘文件协议作为参数值: morelogin://cloudfile?ids=1,2ids 是网盘文件 ID 集合,多个 ID 使用英文逗号分隔。 5. 参数配置示例

以下示例演示了在使用市场模板保存套餐时如何配置 templateParameter 参数:

  • 步骤 1:检索模板参数

调用市场模板 API:

GET /api/cloudphone/rpa/template/market/page

从响应中提取 parameter 字段,例如:


"parameter": "{\"videoDownloadUrl\":{\"type\":\"video\",\"extra\":{\"name\":\"Select视频","type":"视频","required":true","defaultValue":{"enabled":false}","index":1","sizeLimit":{"value":200","unit":"MB"},"formatType":["mp4","mov"]}},"videoDescription":{"type":"string","extra":{"name":"视频" “标题”",“类型”:“字符串”",“必填”:false,“字符有效”:{“启用”:true,“值”:1000},“多行”:{“启用”:true,“值”:3},“默认值”:{“启用”:false},“索引”:2}},“封面网址”:{“类型”:“图像”,“额外”:{“名称”:“封面” “图像”,“类型”:“图像”,“必填”:false,“默认值”:{“启用”:false},“索引”:3,“大小限制”:{“值”:5,“单位”:“MB”},“格式类型”:[“jpg”,“png”,“jpeg”]}},“启用AIGC”:{“类型”:“布尔值”,“附加信息”:{“名称”:“AI标签”,“类型”:“布尔值”,“必填”:false,“默认值”:{“启用”:false},“索引”:4}},“产品ID”:{“类型”:“字符串”,“附加信息”:{“名称”:“产品” ID", "type": "string", "required": false", "charValid": { "enabled": true, "value": 50}", "placeholder": "产品 ID 仅支持数字,最多 50 个字符。", "defaultValue": { "enabled": false}, "index": 5}}, "productTitle": { "type": "string", "extra": { "name": "产品标题", "type": "string", "required": false, "charValid": { "enabled": true, "value": 30}, "defaultValue": { "enabled": false}, "index": 6}}, "getLeads": { "type": "boolean", "extra": { "name": "获取Leads\",\"type\":\"boolean\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":7}},\"comment\":{\"type\":\"string\",\"extra\":{\"name\":\"Comment\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":200},\"multiline\":{\"enabled\":true,\"value\":3},\"defaultValue\":{\"enabled\":false},\"index\":8}}}"
  • 步骤 2:构建参数 JSON

根据参数要求构建 JSON 对象:


{
"__Extra__": {

"videoDownloadUrl": {

"name": "video_name.mp4",

"size": 204800000

}
},

"videoDownloadUrl": "morelogin://cloudfile?ids=1,2"

}
  • 步骤 3:转义 JSON 字符串

将 JSON 对象转换为转义字符串格式:


"{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video_name.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1,2\"}"
  • 步骤 4:API 调用

将转义后的字符串作为 templateParameter 参数的值传递给目标 API。

Bodyapplication/jsonrequired
cloudPhoneIdintegerrequired

云手机ID

scheduleNamestringrequired

日程名称

templateIdintegerrequired

模板 ID、个人模板或市场模板 ID

templateParameterstring

模板参数在个人模板或市场模板中定义。模板中的参数定义如下:{"Test":{"extra":{"type":"string","required":true,"multiline":{"enabled":false},"name":"Test","index":1},"type":"string"}} 请求参数时,传递的参数为:{"Test":"xxxx"}

descriptionstring

日程安排说明

POST
/api/cloudphone/rpa/onceTask/save
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/rpa/onceTask/save \
  -H 'Content-Type: application/json' \
  -d '{
    "cloudPhoneId": 1678331966138097,
    "scheduleName": "test",
    "templateId": 1678347487160296,
    "templateParameter": "{\"keyword\": \"abc\"}",
    "description": "日程安排说明"
  }'

Responses

Headers
any
Bodyapplication/json
codeintegerrequired

响应代码,0 表示成功,大于 0 表示失败

msgstringrequired

错误信息

requestIdstringrequired

请求跟踪 ID

dataintegerrequired

日程编号

Response
{ "code": 0, "msg": "string", "requestId": "string", "data": 0 }