> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 添加、获取及删除日程参与者
> 演示通过日程相关 API 完成参与者管理的完整流程，包括获取应用凭证、添加接口权限、创建日程、添加获取删除参与者及设置响应状态。
本文档介绍了如何调用日程相关接口实现日程参与者的相关流程。首先创建一个企业内部应用，再使用日程提供的API，实现创建日程、添加日程参与者、获取日程参与者、设置日程响应邀请状态、删除日程参与者流程。
## 预期效果
* 日程创建成功后，如下图所示：
* 添加日程参与者界面，如下图所示：
* 查看日程响应状态，如下图所示：
## 接入流程简介
本文档展示了创建一个企业内部应用，再使用日程提供的API，实现日程参与者的相关操作流程。
前提条件：完成[应用创建与配置](/zh/open/dingstart/create-application)的流程。
步骤一：获取应用凭证信息，获取应用 Client ID 和 Client Secret。
步骤二：申请接口权限，申请日程相关接口的权限。
步骤三：获取应用访问凭证[获取企业内部应用的accessToken](/zh/open/development/obtain-the-access-token-of-an-internal-app)，调用接口时，通过accessToken鉴权调用者身份。
步骤四：调用服务端日程相关API。
1. 调用服务端API-[创建日程](/zh/open/development/create-schedule)接口，进行创建日程。获取日程`id`。
2. 根据日程`id`，调用服务端API-[添加日程参与者](/zh/open/development/add-schedule-participant)接口，进行日程参与者的添加操作。
3. 根据日程`id`，调用服务端API-[获取日程参与者](/zh/open/development/get-the-participants-of-a-schedule)接口，获取日程参与人的信息。
4. 根据日程`id`，调用服务端API-[设置日程响应邀请状态](/zh/open/development/configure-response-status)接口，进行日程参与者响应的邀请状态。
5. 根据日程`id`，调用服务端API-[删除日程参与者](/zh/open/development/delete-schedule-participant)接口，进行日程参与者的删除操作。
## 前提条件
完成[应用创建与配置](/zh/open/dingstart/create-application)的流程。
## 步骤一：获取应用凭证
1. 选择目标应用，进入应用详情页，单击**基础信息** > **凭证与基础信息**。
2. 获取应用 Client ID 和 Client Secret。
## 步骤二：添加接口权限
单击**开发配置** > **权限管理**，在权限搜索框中分别输入`Calendar.Event.Write`和`Calendar.Event.Read`，并申请权限。
## 步骤三：获取应用访问凭证accessToken
服务端API差异详情参见旧版API VS 新版API。以下接口均使用服务端API接口，SDK下载详情参见服务端SDK下载。
根据步骤一中 的 Client ID 和 Client Secret，获取应用访问凭证[获取企业内部应用的access\_token](/zh/open/development/obtain-orgapp-token)。
```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
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
1. 调用服务端API-[创建日程](/zh/open/development/create-schedule)接口，进行创建日程，获取日程`id`。
```java lines theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 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);
}
}
}
```
2. 根据日程`id`，调用服务端API-[添加日程参与者](/zh/open/development/add-schedule-participant)接口，进行日程参与者的添加操作。
```java lines theme={"theme":{"light":"github-light","dark":"github-dark"}}
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);
}
}
}
```
3. 根据日程`id`，调用服务端API-[获取日程参与者](/zh/open/development/get-the-participants-of-a-schedule)接口，获取日程参与人的信息。
```java lines theme={"theme":{"light":"github-light","dark":"github-dark"}}
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);
}
}
}
```
4. 根据日程`id`，调用服务端API-[设置日程响应邀请状态](/zh/open/development/configure-response-status)接口，进行日程参与者响应的邀请状态。
```java lines theme={"theme":{"light":"github-light","dark":"github-dark"}}
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);
}
}
}
```
5. 根据日程`id`，调用服务端API-[删除日程参与者](/zh/open/development/delete-schedule-participant)接口，进行日程参与者的删除操作。
```java lines theme={"theme":{"light":"github-light","dark":"github-dark"}}
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);
}
}
}
```