日程参与者操作流程

本文档介绍了如何调用日程相关接口实现日程参与者的相关流程。首先创建一个企业内部应用，再使用日程提供的API，实现创建日程、添加日程参与者、获取日程参与者、设置日程响应邀请状态、删除日程参与者流程。

预期效果

日程展示

日程添加参与者

日程响应状态

接入流程简介

本文档展示了创建一个企业内部应用，再使用日程提供的API，实现日程参与者的相关操作流程。

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取AppKey和AppSecret。

步骤三：添加接口权限申请。查找“日程”，申请相应的权限。

步骤四：获取应用访问凭证获取企业内部应用的accessToken，调用接口时，通过accessToken鉴权调用者身份。

步骤五：调用服务端日程相关API。

调用服务端API-创建日程接口，进行创建日程，获取日程id。

根据日程id，调用服务端API-添加日程参与者接口，进行日程参与者的添加操作。

根据日程id，调用服务端API-获取日程参与者接口，获取日程参与人的信息。

根据日程id，调用服务端API-设置日程响应邀请状态接口，进行日程参与者响应的邀请状态。

根据日程id，调用服务端API-删除日程参与者接口，进行日程参与者的删除操作。

步骤一：创建企业内部应用

登录开发者后台，创建企业内部应用。

填写应用的基本信息，然后单击确定创建。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取AppKey和AppSecret。

步骤三：添加接口权限

添加接口权限申请，查找“个人权限”，选择日程相关接口权限并申请。

步骤四：获取应用访问凭证accessToken

重要

服务端API差异详情参见新旧版规范服务端API区别。

服务端API接口SDK下载，详情参见服务端SDK下载。

新版服务端API接口SDK下载，详情参见新版服务端SDK下载。

以下接口均使用新版服务端API接口，SDK下载详情参见新版服务端SDK下载。

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的accessToken。

 public void getAccessToken() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
        GetAccessTokenRequest accessTokenRequest = new GetAccessTokenRequest()
                .setAppKey("ding*********hgn")
                .setAppSecret("9G_O**********xamBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

步骤五：调用服务端日程相关API

调用服务端API-创建日程接口，进行创建日程，获取日程id。

public void createCalendar() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcalendar_1_0.Client client = new com.aliyun.dingtalkcalendar_1_0.Client(config);
        CreateEventHeaders createEventHeaders = new CreateEventHeaders();
        createEventHeaders.xAcsDingtalkAccessToken = "accessToken";
        java.util.Map<String, String> extra = TeaConverter.buildMap(
                new TeaPair("noChatNotification", "false"),
                new TeaPair("noPushNotification","false")
        );
        CreateEventRequest.CreateEventRequestOnlineMeetingInfo onlineMeetingInfo = new CreateEventRequest.CreateEventRequestOnlineMeetingInfo()
                .setType("dingtalk");
        CreateEventRequest.CreateEventRequestReminders reminders0 = new CreateEventRequest.CreateEventRequestReminders()
                .setMethod("dingtalk")
                .setMinutes(15);
        CreateEventRequest.CreateEventRequestLocation location = new CreateEventRequest.CreateEventRequestLocation()
                .setDisplayName("********A座9F");
        CreateEventRequest.CreateEventRequestAttendees attendees0 = new CreateEventRequest.CreateEventRequestAttendees()
                .setId("日程参与者unionId")
                .setIsOptional(false);
        CreateEventRequest.CreateEventRequestRecurrenceRange recurrenceRange = new CreateEventRequest.CreateEventRequestRecurrenceRange()
                .setType("numbered")
                .setNumberOfOccurrences(1);
        CreateEventRequest.CreateEventRequestRecurrencePattern recurrencePattern = new CreateEventRequest.CreateEventRequestRecurrencePattern()
                .setType("daily")
                .setInterval(1);
        CreateEventRequest.CreateEventRequestRecurrence recurrence = new CreateEventRequest.CreateEventRequestRecurrence()
                .setPattern(recurrencePattern)
                .setRange(recurrenceRange);
        CreateEventRequest.CreateEventRequestEnd end = new CreateEventRequest.CreateEventRequestEnd()
                .setDate("2022-09-07");
//                .setDateTime("2021-09-20T10:15:30+08:00")
//                .setTimeZone("Asia/Shanghai");
        CreateEventRequest.CreateEventRequestStart start = new CreateEventRequest.CreateEventRequestStart()
                .setDate("2022-09-07");
//                .setDateTime("2021-09-20T10:15:30+08:00")
//                .setTimeZone("Asia/Shanghai");
        CreateEventRequest createEventRequest = new CreateEventRequest()
                .setSummary("创建日程")
                .setDescription("这是创建的一个日程")
                .setStart(start)
                .setEnd(end)
                .setIsAllDay(true)
                .setRecurrence(recurrence)
                .setAttendees(java.util.Arrays.asList(
                        attendees0
                ))
                .setLocation(location)
                .setReminders(java.util.Arrays.asList(
                        reminders0
                ))
                .setOnlineMeetingInfo(onlineMeetingInfo)
                .setExtra(extra);
        try {
            CreateEventResponse eventWithOptions = client.createEventWithOptions("日程组织者unionId", "primary", createEventRequest, createEventHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(eventWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据日程id，调用服务端API-添加日程参与者接口，进行日程参与者的添加操作。

public void addCalendarParticipants() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcalendar_1_0.Client client  = new com.aliyun.dingtalkcalendar_1_0.Client(config);
        AddAttendeeHeaders addAttendeeHeaders = new AddAttendeeHeaders();
        addAttendeeHeaders.xAcsDingtalkAccessToken = "accessToken";
        AddAttendeeRequest.AddAttendeeRequestAttendeesToAdd attendeesToAdd0 = new AddAttendeeRequest.AddAttendeeRequestAttendeesToAdd()
                .setId("日程参与者unionId")
                .setIsOptional(false);
        AddAttendeeRequest.AddAttendeeRequestAttendeesToAdd attendeesToAdd1 = new AddAttendeeRequest.AddAttendeeRequestAttendeesToAdd()
                .setId("日程参与者unionId")
                .setIsOptional(false);
        AddAttendeeRequest addAttendeeRequest = new AddAttendeeRequest()
                .setAttendeesToAdd(java.util.Arrays.asList(
                        attendeesToAdd0,
                        attendeesToAdd1
                ));
        try {
            client.addAttendeeWithOptions("日程组织者unionId", "primary", "日程id", addAttendeeRequest, addAttendeeHeaders, new RuntimeOptions());
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }

        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据日程id，调用服务端API-获取日程参与者接口，获取日程参与人的信息。

public void getCalendarParticipants() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcalendar_1_0.Client client  = new com.aliyun.dingtalkcalendar_1_0.Client(config);
        ListAttendeesHeaders listAttendeesHeaders = new ListAttendeesHeaders();
        listAttendeesHeaders.xAcsDingtalkAccessToken = "accessToken";
        ListAttendeesRequest listAttendeesRequest = new ListAttendeesRequest()
                .setMaxResults(100);
        try {
            ListAttendeesResponse listAttendeesResponse = client.listAttendeesWithOptions("日程组织者unionId", "primary", "日程id", listAttendeesRequest, listAttendeesHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(listAttendeesResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据日程id，调用服务端API-设置日程响应邀请状态接口，进行日程参与者响应的邀请状态。

public void setCalendarResponseStatus() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcalendar_1_0.Client client  = new com.aliyun.dingtalkcalendar_1_0.Client(config);
        RespondEventHeaders respondEventHeaders = new RespondEventHeaders();
        respondEventHeaders.xAcsDingtalkAccessToken = "accessToken";
        RespondEventRequest respondEventRequest = new RespondEventRequest()
                .setResponseStatus("accepted");
        try {
            client.respondEventWithOptions("日程参与者unionId", "primary", "日程id", respondEventRequest, respondEventHeaders, new RuntimeOptions());
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据日程id，调用服务端API-删除日程参与者接口，进行日程参与者的删除操作。

public void deleteCalendarParticipants() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcalendar_1_0.Client client  = new com.aliyun.dingtalkcalendar_1_0.Client(config);
        RemoveAttendeeHeaders removeAttendeeHeaders = new RemoveAttendeeHeaders();
        removeAttendeeHeaders.xAcsDingtalkAccessToken = "accessToken";
        RemoveAttendeeRequest.RemoveAttendeeRequestAttendeesToRemove attendeesToRemove0 = new RemoveAttendeeRequest.RemoveAttendeeRequestAttendeesToRemove()
                .setId("日程参与者unionId");
        RemoveAttendeeRequest removeAttendeeRequest = new RemoveAttendeeRequest()
                .setAttendeesToRemove(java.util.Arrays.asList(
                        attendeesToRemove0
                ));
        try {
            client.removeAttendeeWithOptions("日程组织者unionId", "primary", "日程id", removeAttendeeRequest, removeAttendeeHeaders, new RuntimeOptions());
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }

        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

日程参与者操作流程

预期效果#

日程展示#

日程添加参与者#

日程响应状态#

接入流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

步骤四：获取应用访问凭证accessToken#

步骤五：调用服务端日程相关API#