文档中心 > API类目 > 钉钉API

dingtalk.oapi.calendar.v2.event.update (日程2.0修改日程)

通过此接口可以修改钉钉日程，在对应的日历中展示该接口处于内部灰度阶段, 申请使用请邮件联系:wusuan.yby@alibaba-inc.com

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	描述
event	Event	必须		日程创建对象
attendees Attendee [] 可选日程参与者，参与人数最多100人，包括组织者 └ userid String 可选 manager8037 员工工号,若通过该接口新增或删除参会人，则该字段必填 └ attendee_status String 可选 add 添加或者删除状态，add:添加；remove:删除；若通过该接口新增或删除参会人，则该字段必填 └ calendar_id String 必须 primary 日历ID,目前仅支持传primary,表示修改当前用户“我的日程”下的日程 └ description String 必须请积极发言日程描述 end DateTime 必须结束时间 └ date String 可选 2019-09-15 日期，全天日程使用，格式必须为'yyyy-mm-dd',和timestamp字段互斥，该字段有值时，则忽略timestamp字段 └ timestamp Number 可选 1570846303 时间戳，单位为秒。非全天日程使用，与date字段互斥 └ timezone String 可选 Asia/Shanghai 时区信息，默认为"Asia/Shanghai"。date有值时，timezone 为 UTC； start DateTime 必须开始时间 └ date String 可选 2019-09-15 日期，全天日程使用，格式必须为'yyyy-mm-dd',和timestamp字段互斥，该字段有值时，则忽略timestamp字段 └ timestamp Number 可选 1570846303 时间戳，单位为秒。非全天日程使用，与date字段互斥 └ timezone String 可选 Asia/Shanghai 时区信息，默认为"Asia/Shanghai"。date有值时，timezone 为 UTC； └ summary String 必须晨会日程主题 └ event_id String 必须 10249057 日程Id reminder OpenCalendarReminderVo 可选会议开始前提醒 └ method String 可选 app 提醒方式.app表示应用内提醒 └ minutes Number 可选 0 开始前提醒的分钟数,有效值为0，5，15，30，60，1440 location LocationVo 可选地址 └ latitude String 可选 30.285228 纬度 └ longitude String 可选 120.017022 经度 └ place String 可选未来park 地址详情
agentid	Number	可选	1212	开放平台应用对应的AgentId

响应参数

名称	类型	示例值	描述
success	Boolean	true	结果是否正确
errcode	Number	0	错误编码
errmsg	String	接收人不能为空	错误信息

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/calendar/v2/event/update");
OapiCalendarV2EventUpdateRequest req = new OapiCalendarV2EventUpdateRequest();
Event obj1 = new Event();
List<Attendee> list3 = new ArrayList<Attendee>();
Attendee obj4 = new Attendee();
list3.add(obj4);
obj4.setUserid("manager8037");
obj4.setAttendeeStatus("add");
obj1.setAttendees(list3);
obj1.setCalendarId("primary");
obj1.setDescription("请积极发言");
DateTime obj5 = new DateTime();
obj5.setDate("2019-09-15");
obj5.setTimestamp(1570846303L);
obj5.setTimezone("Asia/Shanghai");
obj1.setEnd(obj5);
Attendee obj6 = new Attendee();
obj6.setUserid("manager8037");
obj1.setOrganizer(obj6);
DateTime obj7 = new DateTime();
obj7.setDate("2019-09-15");
obj7.setTimestamp(1570846303L);
obj7.setTimezone("Asia/Shanghai");
obj1.setStart(obj7);
obj1.setSummary("晨会");
obj1.setEventId("10249057");
OpenCalendarReminderVo obj8 = new OpenCalendarReminderVo();
obj8.setMethod("app");
obj8.setMinutes(0L);
obj1.setReminder(obj8);
LocationVo obj9 = new LocationVo();
obj9.setLatitude("30.285228");
obj9.setLongitude("120.017022");
obj9.setPlace("未来park");
obj1.setLocation(obj9);
req.setEvent(obj1);
req.setAgentid(1212L);
OapiCalendarV2EventUpdateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/calendar/v2/event/update");
OapiCalendarV2EventUpdateRequest req = new OapiCalendarV2EventUpdateRequest();
OapiCalendarV2EventUpdateRequest.EventDomain obj1 = new OapiCalendarV2EventUpdateRequest.EventDomain();
List<OapiCalendarV2EventUpdateRequest.AttendeeDomain> list3 = new List<OapiCalendarV2EventUpdateRequest.AttendeeDomain>();
OapiCalendarV2EventUpdateRequest.AttendeeDomain obj4 = new OapiCalendarV2EventUpdateRequest.AttendeeDomain();
list3.Add(obj4);
obj4.Userid = "manager8037";
obj4.AttendeeStatus = "add";
obj1.Attendees= list3;
obj1.CalendarId = "primary";
obj1.Description = "请积极发言";
OapiCalendarV2EventUpdateRequest.DateTimeDomain obj5 = new OapiCalendarV2EventUpdateRequest.DateTimeDomain();
obj5.Date = "2019-09-15";
obj5.Timestamp = 1570846303L;
obj5.Timezone = "Asia/Shanghai";
obj1.End= obj5;
OapiCalendarV2EventUpdateRequest.AttendeeDomain obj6 = new OapiCalendarV2EventUpdateRequest.AttendeeDomain();
obj6.Userid = "manager8037";
obj1.Organizer= obj6;
OapiCalendarV2EventUpdateRequest.DateTimeDomain obj7 = new OapiCalendarV2EventUpdateRequest.DateTimeDomain();
obj7.Date = "2019-09-15";
obj7.Timestamp = 1570846303L;
obj7.Timezone = "Asia/Shanghai";
obj1.Start= obj7;
obj1.Summary = "晨会";
obj1.EventId = "10249057";
OapiCalendarV2EventUpdateRequest.OpenCalendarReminderVoDomain obj8 = new OapiCalendarV2EventUpdateRequest.OpenCalendarReminderVoDomain();
obj8.Method = "app";
obj8.Minutes = 0L;
obj1.Reminder= obj8;
OapiCalendarV2EventUpdateRequest.LocationVoDomain obj9 = new OapiCalendarV2EventUpdateRequest.LocationVoDomain();
obj9.Latitude = "30.285228";
obj9.Longitude = "120.017022";
obj9.Place = "未来park";
obj1.Location= obj9;
req.Event_ = obj1;
req.Agentid = 1212L;
OapiCalendarV2EventUpdateResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiCalendarV2EventUpdateRequest;
$event = new Event;
$attendees = new Attendee;
$attendees->userid="manager8037";
$attendees->attendee_status="add";
$event->attendees = array($attendees);
$event->calendar_id="primary";
$event->description="请积极发言";
$end = new DateTime;
$end->date="2019-09-15";
$end->timestamp="1570846303";
$end->timezone="Asia/Shanghai";
$event->end = $end;
$organizer = new Attendee;
$organizer->userid="manager8037";
$event->organizer = $organizer;
$start = new DateTime;
$start->date="2019-09-15";
$start->timestamp="1570846303";
$start->timezone="Asia/Shanghai";
$event->start = $start;
$event->summary="晨会";
$event->event_id="10249057";
$reminder = new OpenCalendarReminderVo;
$reminder->method="app";
$reminder->minutes="0";
$event->reminder = $reminder;
$location = new LocationVo;
$location->latitude="30.285228";
$location->longitude="120.017022";
$location->place="未来park";
$event->location = $location;
$req->setEvent($event);
$req->setAgentid("1212");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/calendar/v2/event/update");

curl -X POST "https://oapi.dingtalk.com/topapi/calendar/v2/event/update" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=45b772dd-6df5-446d-9bf3-f85799ca653c' \
-d 'agentid=1212' \
-d 'event=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiCalendarV2EventUpdateRequest("https://oapi.dingtalk.com/topapi/calendar/v2/event/update")

req.event=""
req.agentid=1212
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.calendar.v2.event.update");
add_param(pRequest,"event","数据结构JSON示例");
add_param(pRequest,"agentid","1212");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.calendar.v2.event.update', {
	'event':'数据结构JSON示例',
	'agentid':'1212'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "success":true,
    "errcode":0,
    "errmsg":"接收人不能为空"
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.calendar.v2.event.update (日程2.0修改日程)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ