云手机更新属性

接口说明

对指定id的云手机执行更新属性操作。任务执行成功且重启云手机后,更新的属性才能生效。 注意: 1. 本接口属于异步任务接口,返回结果只有任务id。查询该任务的执行状态需要客户配置回调信息,或者根据任务id调用“查询任务执行状态详情/列表”接口来实现;


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/update

请求参数

Body

参数名称
类型
必填
描述
req
OpenapiCloudPhoneAttributeReq
是

req

byte_os_mainkeys
integer(int32)
否

隐藏虚拟按键,默认为1。0为不隐藏,1为隐藏。

callbackUrl
string
否

回调url,如http://192.168.0.1:5556/api/callback,needCallback为true才能生效

disable_status_bar
integer(int32)
否

是否禁用状态栏,默认为0。1禁用,0不禁用。

gsm_operator_alpha
string
否

⽹络运营商名称,默认为CMCC

gsm_operator_iso_country
string
否

⽹络运营商国家代码,默认为cn

gsm_operator_numeric
string
否

⽹络提供商的标识码,默认为46000

gsm_sim_operator_alpha
string
否

SIM卡的运营商,默认为CMCC

gsm_sim_operator_iso_country
string
否

SIM卡归属国家,默认为cn

gsm_sim_operator_numeric
string
否

SIM卡提供商的标识码,默认为46000

id
string
是

云手机实例ID

needAuth
boolean
否

是否需要鉴权

needCallback
boolean
否

是否需要回调

ro_byte_os_notification_disable
integer(int32)
否

是否禁用消息通知,默认为0。1禁用,0不禁用。

ro_byte_os_toast_enable
integer(int32)
否

是否启用Toast消息提示框,默认为0。1为启用,0为不启用。

ro_horizontal_screen
integer(int32)
否

是否横屏显示,默认为0。1为有横屏显示,0为没有横屏显示。

ro_install_auto
integer(int32)
否

是否在App安装时自动确认安装,默认为0。1为确认,0为不确认

ro_permission_changed
integer(int32)
否

是否在安装app时自动赋予App请求的所有权限,默认为0。1赋予,0不赋予。

sys_prop_imeid
string
否

MEID(Mobile Equipment Identifier)是用于标识CDMA(Code Division Multiple Access)移动设备的唯⼀标识符

sys_prop_writeimsi
string
否

IMSI(International Mobile Subscriber Identity,国际移动用户识别码)

sys_prop_writephonenum
string
否

⼿机号码

sys_prop_writewifibssid
string
否

在⽆线局域⽹(WLAN)中⽤于唯⼀标识基本服务集(BSS)的MAC地址

sys_prop_writewifissid
string
否

⽆线⽹络名称

请求示例

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/update
{
	"byte_os_mainkeys":0,
	"disable_status_bar":1,
	"id":"1895478838969253891",
	"needCallback":true,
	"callbackUrl":"http://192.168.0.1:5556/api/callback",
	"needAuth":false
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
OpenapiCloudphoneJobDto

响应体

errorCode
string

任务错误码

errorMsg
string

任务错误码说明

id
string

云手机ID

jobId
string

任务ID

errorCode
string

错误编码

errorMessage
string

错误信息

requestId
string

请求id

state
string

状态值

返回示例

返回码:200
OK
{
	"errorCode":"00000000",
	"errorMessage":"请求成功",
	"requestId":"14ed88ea-9231-4ce9-92c4-97560e0b8835",
	"state":"OK",
	"body":{
		"id":"1895478838969253891",
		"jobId":"1900011392968523777",
		"errorMsg":null,
		"errorCode":null
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。