Debian Codegraph @

src/Microsoft365/common/e-m365-connection.h

raw
1 /*
2 * SPDX-FileCopyrightText: (C) 2020 Red Hat (www.redhat.com)
3 * SPDX-License-Identifier: LGPL-2.1-or-later
4 */
5
6 #ifndef E_M365_CONNECTION_H
7 #define E_M365_CONNECTION_H
8
9 #include <glib-object.h>
10
11 #include <libebackend/libebackend.h>
12 #include <libecal/libecal.h>
13 #include <json-glib/json-glib.h>
14 #include <libsoup/soup.h>
15
16 #include "camel-m365-settings.h"
17 #include "e-m365-enums.h"
18 #include "e-m365-json-utils.h"
19
20 #define E_M365_ARTIFICIAL_FOLDER_ID_ORG_CONTACTS "folder-id::orgContacts"
21 #define E_M365_ARTIFICIAL_FOLDER_ID_USERS "folder-id::users"
22 #define E_M365_ARTIFICIAL_FOLDER_ID_PEOPLE "folder-id::people"
23
24 /* Currently, as of 2020-06-17, there is a limitation to 20 requests:
25 https://docs.microsoft.com/en-us/graph/known-issues#json-batching */
26 #define E_M365_BATCH_MAX_REQUESTS 20
27
28 /* Standard GObject macros */
29 #define E_TYPE_M365_CONNECTION \
30 (e_m365_connection_get_type ())
31 #define E_M365_CONNECTION(obj) \
32 (G_TYPE_CHECK_INSTANCE_CAST \
33 ((obj), E_TYPE_M365_CONNECTION, EM365Connection))
34 #define E_M365_CONNECTION_CLASS(cls) \
35 (G_TYPE_CHECK_CLASS_CAST \
36 ((cls), E_TYPE_M365_CONNECTION, EM365ConnectionClass))
37 #define E_IS_M365_CONNECTION(obj) \
38 (G_TYPE_CHECK_INSTANCE_TYPE \
39 ((obj), E_TYPE_M365_CONNECTION))
40 #define E_IS_M365_CONNECTION_CLASS(cls) \
41 (G_TYPE_CHECK_CLASS_TYPE \
42 ((cls), E_TYPE_M365_CONNECTION))
43 #define E_M365_CONNECTION_GET_CLASS(obj) \
44 (G_TYPE_INSTANCE_GET_CLASS \
45 ((obj), E_TYPE_M365_CONNECTION))
46
47 G_BEGIN_DECLS
48
49 typedef enum _EM365ApiVersion {
50 E_M365_API_V1_0,
51 E_M365_API_BETA
52 } EM365ApiVersion;
53
54 typedef enum {
55 E_M365_ERROR_ID_MALFORMED,
56 E_M365_ERROR_SYNC_STATE_NOT_FOUND,
57 E_M365_ERROR_ITEM_NOT_FOUND
58 } EM365Error;
59
60 #define E_M365_ERROR e_m365_error_quark ()
61 GQuark e_m365_error_quark (void) G_GNUC_CONST;
62
63 typedef struct _EM365Connection EM365Connection;
64 typedef struct _EM365ConnectionClass EM365ConnectionClass;
65 typedef struct _EM365ConnectionPrivate EM365ConnectionPrivate;
66
67 /* Returns whether can continue */
68 typedef gboolean (* EM365ConnectionJsonFunc) (EM365Connection *cnc,
69 const GSList *results, /* JsonObject * - the returned objects from the server */
70 gpointer user_data,
71 GCancellable *cancellable,
72 GError **error);
73
74 typedef gboolean (* EM365ConnectionRawDataFunc) (EM365Connection *cnc,
75 SoupMessage *message,
76 GInputStream *raw_data_stream,
77 gpointer user_data,
78 GCancellable *cancellable,
79 GError **error);
80
81 struct _EM365Connection {
82 GObject parent;
83 EM365ConnectionPrivate *priv;
84 };
85
86 struct _EM365ConnectionClass {
87 GObjectClass parent_class;
88 };
89
90 gboolean e_m365_connection_util_delta_token_failed
91 (const GError *error);
92 void e_m365_connection_util_set_message_status_code
93 (SoupMessage *message,
94 gint status_code);
95 gint e_m365_connection_util_get_message_status_code
96 (SoupMessage *message);
97 gboolean e_m365_connection_util_read_raw_data_cb
98 (EM365Connection *cnc,
99 SoupMessage *message,
100 GInputStream *raw_data_stream,
101 gpointer user_data, /* CamelStream * */
102 GCancellable *cancellable,
103 GError **error);
104 gboolean e_m365_connection_util_reencode_parts_to_base64_sync
105 (CamelMimePart *part, /* it can be a CamelMimeMessage */
106 GCancellable *cancellable,
107 GError **error);
108 GType e_m365_connection_get_type (void) G_GNUC_CONST;
109
110 EM365Connection *
111 e_m365_connection_new (ESource *source,
112 CamelM365Settings *settings);
113 EM365Connection *
114 e_m365_connection_new_for_backend
115 (EBackend *backend,
116 ESourceRegistry *registry,
117 ESource *source,
118 CamelM365Settings *settings);
119 EM365Connection *
120 e_m365_connection_new_full (ESource *source,
121 CamelM365Settings *settings,
122 gboolean allow_reuse);
123 ESource * e_m365_connection_get_source (EM365Connection *cnc);
124 CamelM365Settings *
125 e_m365_connection_get_settings (EM365Connection *cnc);
126 guint e_m365_connection_get_concurrent_connections
127 (EM365Connection *cnc);
128 void e_m365_connection_set_concurrent_connections
129 (EM365Connection *cnc,
130 guint concurrent_connections);
131 GProxyResolver *e_m365_connection_ref_proxy_resolver
132 (EM365Connection *cnc);
133 void e_m365_connection_set_proxy_resolver
134 (EM365Connection *cnc,
135 GProxyResolver *proxy_resolver);
136 ESourceAuthenticationResult
137 e_m365_connection_authenticate_sync
138 (EM365Connection *cnc,
139 const gchar *user_override,
140 EM365FolderKind kind,
141 const gchar *group_id,
142 const gchar *folder_id,
143 gchar **out_certificate_pem,
144 GTlsCertificateFlags *out_certificate_errors,
145 GCancellable *cancellable,
146 GError **error);
147 gboolean e_m365_connection_disconnect_sync
148 (EM365Connection *cnc,
149 GCancellable *cancellable,
150 GError **error);
151 gchar * e_m365_connection_construct_uri (EM365Connection *cnc,
152 gboolean include_user,
153 const gchar *user_override,
154 EM365ApiVersion api_version,
155 const gchar *api_part, /* NULL for 'users', empty string to skip */
156 const gchar *resource,
157 const gchar *id, /* NULL to skip */
158 const gchar *path,
159 ...) G_GNUC_NULL_TERMINATED;
160 gboolean e_m365_connection_json_node_from_message
161 (SoupMessage *message,
162 GInputStream *input_stream,
163 JsonNode **out_node,
164 GCancellable *cancellable,
165 GError **error);
166 gboolean e_m365_connection_batch_request_sync
167 (EM365Connection *cnc,
168 EM365ApiVersion api_version,
169 GPtrArray *requests, /* SoupMessage * */
170 GCancellable *cancellable,
171 GError **error);
172 gboolean e_m365_connection_call_gather_into_slist
173 (EM365Connection *cnc,
174 const GSList *results, /* JsonObject * - the returned objects from the server */
175 gpointer user_data, /* expects GSList **, aka pointer to a GSList *, where it copies the 'results' */
176 GCancellable *cancellable,
177 GError **error);
178 gboolean e_m365_connection_get_categories_sync
179 (EM365Connection *cnc,
180 const gchar *user_override,
181 GSList **out_categories, /* EM365Category * */
182 GCancellable *cancellable,
183 GError **error);
184 gboolean e_m365_connection_list_mail_folders_sync
185 (EM365Connection *cnc,
186 const gchar *user_override, /* for which user, NULL to use the account user */
187 const gchar *from_path, /* path for the folder to read, NULL for top user folder */
188 const gchar *select, /* nullable - properties to select */
189 GSList **out_folders, /* EM365MailFolder * - the returned mailFolder objects */
190 GCancellable *cancellable,
191 GError **error);
192 gboolean e_m365_connection_get_folders_delta_sync
193 (EM365Connection *cnc,
194 const gchar *user_override, /* for which user, NULL to use the account user */
195 EM365FolderKind kind,
196 const gchar *select, /* nullable - properties to select */
197 const gchar *delta_link, /* previous delta link */
198 guint max_page_size, /* 0 for default by the server */
199 EM365ConnectionJsonFunc func, /* function to call with each result set */
200 gpointer func_user_data, /* user data passed into the 'func' */
201 gchar **out_delta_link,
202 GCancellable *cancellable,
203 GError **error);
204 gboolean e_m365_connection_get_mail_folder_sync
205 (EM365Connection *cnc,
206 const gchar *user_override, /* for which user, NULL to use the account user */
207 const gchar *folder_id, /* nullable - then the 'inbox' is used */
208 const gchar *select, /* nullable - properties to select */
209 EM365MailFolder **out_folder,
210 GCancellable *cancellable,
211 GError **error);
212 gboolean e_m365_connection_create_mail_folder_sync
213 (EM365Connection *cnc,
214 const gchar *user_override, /* for which user, NULL to use the account user */
215 const gchar *parent_folder_id, /* NULL for the folder root */
216 const gchar *display_name,
217 EM365MailFolder **out_mail_folder,
218 GCancellable *cancellable,
219 GError **error);
220 gboolean e_m365_connection_delete_mail_folder_sync
221 (EM365Connection *cnc,
222 const gchar *user_override, /* for which user, NULL to use the account user */
223 const gchar *folder_id,
224 GCancellable *cancellable,
225 GError **error);
226 gboolean e_m365_connection_copy_move_mail_folder_sync
227 (EM365Connection *cnc,
228 const gchar *user_override, /* for which user, NULL to use the account user */
229 const gchar *src_folder_id,
230 const gchar *des_folder_id,
231 gboolean do_copy,
232 EM365MailFolder **out_mail_folder,
233 GCancellable *cancellable,
234 GError **error);
235 gboolean e_m365_connection_rename_mail_folder_sync
236 (EM365Connection *cnc,
237 const gchar *user_override, /* for which user, NULL to use the account user */
238 const gchar *folder_id,
239 const gchar *display_name,
240 EM365MailFolder **out_mail_folder,
241 GCancellable *cancellable,
242 GError **error);
243 gboolean e_m365_connection_list_messages_sync
244 (EM365Connection *cnc,
245 const gchar *user_override, /* for which user, NULL to use the account user */
246 const gchar *folder_id,
247 const gchar *select, /* nullable - properties to select */
248 const gchar *filter, /* nullable - filter which events to list */
249 GSList **out_messages, /* EM365MailMessage * - the returned objects */
250 GCancellable *cancellable,
251 GError **error);
252 gboolean e_m365_connection_get_objects_delta_sync
253 (EM365Connection *cnc,
254 const gchar *user_override, /* for which user, NULL to use the account user */
255 EM365FolderKind kind,
256 const gchar *folder_id, /* folder ID to get delta messages in */
257 const gchar *select, /* nullable - properties to select */
258 const gchar *delta_link, /* previous delta link */
259 guint max_page_size, /* 0 for default by the server */
260 EM365ConnectionJsonFunc func, /* function to call with each result set */
261 gpointer func_user_data, /* user data passed into the 'func' */
262 gchar **out_delta_link,
263 GCancellable *cancellable,
264 GError **error);
265 gboolean e_m365_connection_get_mail_message_sync
266 (EM365Connection *cnc,
267 const gchar *user_override, /* for which user, NULL to use the account user */
268 const gchar *folder_id,
269 const gchar *message_id,
270 EM365ConnectionRawDataFunc func,
271 gpointer func_user_data,
272 GCancellable *cancellable,
273 GError **error);
274 gboolean e_m365_connection_create_mail_message_sync
275 (EM365Connection *cnc,
276 const gchar *user_override, /* for which user, NULL to use the account user */
277 const gchar *folder_id, /* if NULL, then goes to the Drafts folder */
278 JsonBuilder *mail_message, /* filled mailMessage object */
279 EM365MailMessage **out_created_message, /* free with json_object_unref() */
280 GCancellable *cancellable,
281 GError **error);
282 gboolean e_m365_connection_upload_mail_message_sync
283 (EM365Connection *cnc,
284 const gchar *user_override, /* for which user, NULL to use the account user */
285 const gchar *folder_id, /* if NULL, then goes to the Drafts folder */
286 CamelMimeMessage *mime_message,
287 EM365MailMessage **out_created_message, /* free with json_object_unref() */
288 GCancellable *cancellable,
289 GError **error);
290 gboolean e_m365_connection_add_mail_message_attachment_sync
291 (EM365Connection *cnc,
292 const gchar *user_override, /* for which user, NULL to use the account user */
293 const gchar *message_id, /* the message to add it to */
294 JsonBuilder *attachment, /* filled attachment object */
295 gchar **out_attachment_id,
296 GCancellable *cancellable,
297 GError **error);
298 SoupMessage * e_m365_connection_prepare_update_mail_message
299 (EM365Connection *cnc,
300 const gchar *user_override, /* for which user, NULL to use the account user */
301 const gchar *message_id,
302 JsonBuilder *mail_message, /* values to update, as a mailMessage object */
303 GError **error);
304 gboolean e_m365_connection_update_mail_message_sync
305 (EM365Connection *cnc,
306 const gchar *user_override, /* for which user, NULL to use the account user */
307 const gchar *message_id,
308 JsonBuilder *mail_message, /* values to update, as a mailMessage object */
309 GCancellable *cancellable,
310 GError **error);
311 gboolean e_m365_connection_copy_move_mail_messages_sync
312 (EM365Connection *cnc,
313 const gchar *user_override, /* for which user, NULL to use the account user */
314 const GSList *message_ids, /* const gchar * */
315 const gchar *des_folder_id,
316 gboolean do_copy,
317 GSList **out_des_message_ids, /* Camel-pooled gchar *, can be partial */
318 GCancellable *cancellable,
319 GError **error);
320 gboolean e_m365_connection_delete_mail_messages_sync
321 (EM365Connection *cnc,
322 const gchar *user_override, /* for which user, NULL to use the account user */
323 const GSList *message_ids, /* const gchar * */
324 GSList **out_deleted_ids, /* (transfer container): const gchar *, borrowed from message_ids */
325 GCancellable *cancellable,
326 GError **error);
327 gboolean e_m365_connection_send_mail_message_sync
328 (EM365Connection *cnc,
329 const gchar *user_override, /* for which user, NULL to use the account user */
330 const gchar *message_id,
331 GCancellable *cancellable,
332 GError **error);
333 gboolean e_m365_connection_send_mail_sync
334 (EM365Connection *cnc,
335 const gchar *user_override, /* for which user, NULL to use the account user */
336 JsonBuilder *request, /* filled sendMail object */
337 GCancellable *cancellable,
338 GError **error);
339 gboolean e_m365_connection_send_mail_mime_sync
340 (EM365Connection *cnc,
341 const gchar *user_override, /* for which user, NULL to use the account user */
342 const gchar *base64_mime,
343 gssize base64_mime_length,
344 GCancellable *cancellable,
345 GError **error);
346 gboolean e_m365_connection_get_contacts_folder_sync
347 (EM365Connection *cnc,
348 const gchar *user_override, /* for which user, NULL to use the account user */
349 const gchar *folder_id, /* nullable - then the default 'contacts' folder is returned */
350 const gchar *select, /* nullable - properties to select */
351 EM365Folder **out_folder,
352 GCancellable *cancellable,
353 GError **error);
354 gboolean e_m365_connection_get_contact_photo_sync
355 (EM365Connection *cnc,
356 const gchar *user_override, /* for which user, NULL to use the account user */
357 const gchar *folder_id,
358 const gchar *contact_id,
359 GByteArray **out_photo,
360 GCancellable *cancellable,
361 GError **error);
362 gboolean e_m365_connection_update_contact_photo_sync
363 (EM365Connection *cnc,
364 const gchar *user_override, /* for which user, NULL to use the account user */
365 const gchar *folder_id,
366 const gchar *contact_id,
367 const GByteArray *jpeg_photo, /* nullable - to remove the photo */
368 GCancellable *cancellable,
369 GError **error);
370 gboolean e_m365_connection_get_contact_sync
371 (EM365Connection *cnc,
372 const gchar *user_override, /* for which user, NULL to use the account user */
373 const gchar *folder_id,
374 const gchar *contact_id,
375 EM365Contact **out_contact,
376 GCancellable *cancellable,
377 GError **error);
378 gboolean e_m365_connection_get_contacts_sync
379 (EM365Connection *cnc,
380 const gchar *user_override, /* for which user, NULL to use the account user */
381 const gchar *folder_id,
382 GPtrArray *ids, /* const gchar * */
383 GPtrArray **out_contacts, /* EM365Contact * */
384 GCancellable *cancellable,
385 GError **error);
386 gboolean e_m365_connection_create_contact_sync
387 (EM365Connection *cnc,
388 const gchar *user_override, /* for which user, NULL to use the account user */
389 const gchar *folder_id, /* if NULL, then goes to the Drafts folder */
390 JsonBuilder *contact, /* filled contact object */
391 EM365Contact **out_created_contact, /* free with json_object_unref() */
392 GCancellable *cancellable,
393 GError **error);
394 gboolean e_m365_connection_update_contact_sync
395 (EM365Connection *cnc,
396 const gchar *user_override, /* for which user, NULL to use the account user */
397 const gchar *folder_id,
398 const gchar *contact_id,
399 JsonBuilder *contact, /* values to update, as a contact object */
400 GCancellable *cancellable,
401 GError **error);
402 gboolean e_m365_connection_delete_contact_sync
403 (EM365Connection *cnc,
404 const gchar *user_override, /* for which user, NULL to use the account user */
405 const gchar *folder_id,
406 const gchar *contact_id,
407 GCancellable *cancellable,
408 GError **error);
409 gboolean e_m365_connection_get_org_contacts_accessible_sync
410 (EM365Connection *cnc,
411 const gchar *user_override, /* for which user, NULL to use the account user */
412 GCancellable *cancellable,
413 GError **error);
414 gboolean e_m365_connection_get_org_contact_sync
415 (EM365Connection *cnc,
416 const gchar *user_override, /* for which user, NULL to use the account user */
417 const gchar *contact_id,
418 EM365Contact **out_contact,
419 GCancellable *cancellable,
420 GError **error);
421 gboolean e_m365_connection_get_org_contacts_sync
422 (EM365Connection *cnc,
423 const gchar *user_override, /* for which user, NULL to use the account user */
424 GPtrArray *ids, /* const gchar * */
425 GPtrArray **out_contacts, /* EM365Contact * */
426 GCancellable *cancellable,
427 GError **error);
428 gboolean e_m365_connection_get_users_accessible_sync
429 (EM365Connection *cnc,
430 const gchar *user_override, /* for which user, NULL to use the account user */
431 GCancellable *cancellable,
432 GError **error);
433 gboolean e_m365_connection_get_user_sync (EM365Connection *cnc,
434 const gchar *user_override, /* for which user, NULL to use the account user */
435 const gchar *user_id,
436 EM365Contact **out_contact,
437 GCancellable *cancellable,
438 GError **error);
439 gboolean e_m365_connection_get_users_sync(EM365Connection *cnc,
440 const gchar *user_override, /* for which user, NULL to use the account user */
441 GPtrArray *ids, /* const gchar * */
442 GPtrArray **out_contacts, /* EM365Contact * */
443 GCancellable *cancellable,
444 GError **error);
445 gboolean e_m365_connection_search_contacts_sync
446 (EM365Connection *cnc,
447 const gchar *user_override, /* for which user, NULL to use the account user */
448 EM365FolderKind kind,
449 const gchar *folder_id,
450 const gchar *search_text,
451 GSList **out_contacts, /* transfer full, EM365Contact * */
452 GCancellable *cancellable,
453 GError **error);
454 gboolean e_m365_connection_get_people_accessible_sync
455 (EM365Connection *cnc,
456 const gchar *user_override, /* for which user, NULL to use the account user */
457 GCancellable *cancellable,
458 GError **error);
459 gboolean e_m365_connection_get_people_sync
460 (EM365Connection *cnc,
461 const gchar *user_override, /* for which user, NULL to use the account user */
462 guint max_entries,
463 GPtrArray **out_contacts, /* EM365Contact * */
464 GCancellable *cancellable,
465 GError **error);
466 gboolean e_m365_connection_list_calendar_groups_sync
467 (EM365Connection *cnc,
468 const gchar *user_override, /* for which user, NULL to use the account user */
469 GSList **out_groups, /* EM365CalendarGroup * - the returned calendarGroup objects */
470 GCancellable *cancellable,
471 GError **error);
472 gboolean e_m365_connection_create_calendar_group_sync
473 (EM365Connection *cnc,
474 const gchar *user_override, /* for which user, NULL to use the account user */
475 const gchar *name,
476 EM365CalendarGroup **out_created_group,
477 GCancellable *cancellable,
478 GError **error);
479 gboolean e_m365_connection_get_calendar_group_sync
480 (EM365Connection *cnc,
481 const gchar *user_override, /* for which user, NULL to use the account user */
482 const gchar *group_id,
483 EM365CalendarGroup **out_group,
484 GCancellable *cancellable,
485 GError **error);
486 gboolean e_m365_connection_update_calendar_group_sync
487 (EM365Connection *cnc,
488 const gchar *user_override, /* for which user, NULL to use the account user */
489 const gchar *group_id,
490 const gchar *name,
491 GCancellable *cancellable,
492 GError **error);
493 gboolean e_m365_connection_delete_calendar_group_sync
494 (EM365Connection *cnc,
495 const gchar *user_override, /* for which user, NULL to use the account user */
496 const gchar *group_id,
497 GCancellable *cancellable,
498 GError **error);
499 gboolean e_m365_connection_list_calendars_sync
500 (EM365Connection *cnc,
501 const gchar *user_override, /* for which user, NULL to use the account user */
502 const gchar *group_id, /* nullable - calendar group for group calendars */
503 const gchar *select, /* nullable - properties to select */
504 GSList **out_calendars, /* EM365Calendar * - the returned calendar objects */
505 GCancellable *cancellable,
506 GError **error);
507 gboolean e_m365_connection_create_calendar_sync
508 (EM365Connection *cnc,
509 const gchar *user_override, /* for which user, NULL to use the account user */
510 const gchar *group_id, /* nullable - then the default group is used */
511 JsonBuilder *calendar,
512 EM365Calendar **out_created_calendar,
513 GCancellable *cancellable,
514 GError **error);
515 gboolean e_m365_connection_get_calendar_folder_sync
516 (EM365Connection *cnc,
517 const gchar *user_override, /* for which user, NULL to use the account user */
518 const gchar *group_id, /* nullable - then the default group is used */
519 const gchar *calendar_id, /* nullable - then the default calendar is used */
520 const gchar *select, /* nullable - properties to select */
521 EM365Calendar **out_calendar,
522 GCancellable *cancellable,
523 GError **error);
524 gboolean e_m365_connection_update_calendar_sync
525 (EM365Connection *cnc,
526 const gchar *user_override, /* for which user, NULL to use the account user */
527 const gchar *group_id, /* nullable - then the default group is used */
528 const gchar *calendar_id,
529 const gchar *name, /* nullable - to keep the existing name */
530 EM365CalendarColorType color,
531 GCancellable *cancellable,
532 GError **error);
533 gboolean e_m365_connection_delete_calendar_sync
534 (EM365Connection *cnc,
535 const gchar *user_override, /* for which user, NULL to use the account user */
536 const gchar *group_id, /* nullable - then the default group is used */
537 const gchar *calendar_id,
538 GCancellable *cancellable,
539 GError **error);
540 gboolean e_m365_connection_list_calendar_permissions_sync
541 (EM365Connection *cnc,
542 const gchar *user_override, /* for which user, NULL to use the account user */
543 const gchar *group_id, /* nullable - calendar group for group calendars */
544 const gchar *calendar_id,
545 GSList **out_permissions, /* EM365CalendarPermission * */
546 GCancellable *cancellable,
547 GError **error);
548 gboolean e_m365_connection_create_calendar_permission_sync
549 (EM365Connection *cnc,
550 const gchar *user_override, /* for which user, NULL to use the account user */
551 const gchar *group_id, /* nullable, then the default group is used */
552 const gchar *calendar_id,
553 JsonBuilder *permission,
554 EM365CalendarPermission **out_created_permission,
555 GCancellable *cancellable,
556 GError **error);
557 gboolean e_m365_connection_get_calendar_permission_sync
558 (EM365Connection *cnc,
559 const gchar *user_override, /* for which user, NULL to use the account user */
560 const gchar *group_id, /* nullable, then the default group is used */
561 const gchar *calendar_id,
562 const gchar *permission_id,
563 EM365CalendarPermission **out_permission,
564 GCancellable *cancellable,
565 GError **error);
566 gboolean e_m365_connection_update_calendar_permission_sync
567 (EM365Connection *cnc,
568 const gchar *user_override, /* for which user, NULL to use the account user */
569 const gchar *group_id, /* nullable - then the default group is used */
570 const gchar *calendar_id,
571 const gchar *permission_id,
572 JsonBuilder *permission,
573 GCancellable *cancellable,
574 GError **error);
575 gboolean e_m365_connection_delete_calendar_permission_sync
576 (EM365Connection *cnc,
577 const gchar *user_override, /* for which user, NULL to use the account user */
578 const gchar *group_id, /* nullable - then the default group is used */
579 const gchar *calendar_id,
580 const gchar *permission_id,
581 GCancellable *cancellable,
582 GError **error);
583 gboolean e_m365_connection_list_events_sync
584 (EM365Connection *cnc,
585 const gchar *user_override, /* for which user, NULL to use the account user */
586 const gchar *group_id, /* nullable - calendar group for group calendars */
587 const gchar *calendar_id,
588 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
589 const gchar *select, /* nullable - properties to select */
590 const gchar *filter, /* nullable - filter which events to list */
591 GSList **out_events, /* EM365Event * - the returned event objects */
592 GCancellable *cancellable,
593 GError **error);
594 gboolean e_m365_connection_create_event_sync
595 (EM365Connection *cnc,
596 const gchar *user_override, /* for which user, NULL to use the account user */
597 const gchar *group_id, /* nullable, then the default group is used */
598 const gchar *calendar_id,
599 JsonBuilder *event,
600 EM365Event **out_created_event,
601 GCancellable *cancellable,
602 GError **error);
603 SoupMessage * e_m365_connection_prepare_get_event
604 (EM365Connection *cnc,
605 const gchar *user_override, /* for which user, NULL to use the account user */
606 const gchar *group_id, /* nullable, then the default group is used */
607 const gchar *calendar_id,
608 const gchar *event_id,
609 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
610 const gchar *select, /* nullable - properties to select */
611 GError **error);
612 gboolean e_m365_connection_get_event_sync
613 (EM365Connection *cnc,
614 const gchar *user_override, /* for which user, NULL to use the account user */
615 const gchar *group_id, /* nullable, then the default group is used */
616 const gchar *calendar_id,
617 const gchar *event_id,
618 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
619 const gchar *select, /* nullable - properties to select */
620 EM365Event **out_event,
621 GCancellable *cancellable,
622 GError **error);
623 gboolean e_m365_connection_get_events_sync
624 (EM365Connection *cnc,
625 const gchar *user_override, /* for which user, NULL to use the account user */
626 const gchar *group_id, /* nullable, then the default group is used */
627 const gchar *calendar_id,
628 const GSList *event_ids, /* const gchar * */
629 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
630 const gchar *select, /* nullable - properties to select */
631 GSList **out_events, /* EM365Event *, in the same order as event_ids; can return partial list */
632 GCancellable *cancellable,
633 GError **error);
634 gboolean e_m365_connection_get_event_instance_id_sync
635 (EM365Connection *cnc,
636 const gchar *user_override, /* for which user, NULL to use the account user */
637 const gchar *group_id, /* nullable, then the default group is used */
638 const gchar *calendar_id,
639 const gchar *event_id,
640 ICalTime *instance_time,
641 gchar **out_instance_id,
642 GCancellable *cancellable,
643 GError **error);
644 gboolean e_m365_connection_update_event_sync
645 (EM365Connection *cnc,
646 const gchar *user_override, /* for which user, NULL to use the account user */
647 const gchar *group_id, /* nullable - then the default group is used */
648 const gchar *calendar_id,
649 const gchar *event_id,
650 JsonBuilder *event,
651 GCancellable *cancellable,
652 GError **error);
653 gboolean e_m365_connection_delete_event_sync
654 (EM365Connection *cnc,
655 const gchar *user_override, /* for which user, NULL to use the account user */
656 const gchar *group_id, /* nullable - then the default group is used */
657 const gchar *calendar_id,
658 const gchar *event_id,
659 GCancellable *cancellable,
660 GError **error);
661 gboolean e_m365_connection_response_event_sync
662 (EM365Connection *cnc,
663 const gchar *user_override, /* for which user, NULL to use the account user */
664 const gchar *group_id, /* nullable - then the default group is used */
665 const gchar *calendar_id,
666 const gchar *event_id,
667 EM365ResponseType response, /* uses only accepted/tentatively accepted/declined values */
668 const gchar *comment, /* nullable */
669 gboolean send_response,
670 GCancellable *cancellable,
671 GError **error);
672 gboolean e_m365_connection_cancel_event_sync
673 (EM365Connection *cnc,
674 const gchar *user_override, /* for which user, NULL to use the account user */
675 const gchar *group_id, /* nullable, then the default group is used */
676 const gchar *calendar_id,
677 const gchar *event_id,
678 const gchar *comment,
679 GCancellable *cancellable,
680 GError **error);
681 gboolean e_m365_connection_dismiss_reminder_sync
682 (EM365Connection *cnc,
683 const gchar *user_override, /* for which user, NULL to use the account user */
684 const gchar *group_id, /* nullable - then the default group is used */
685 const gchar *calendar_id,
686 const gchar *event_id,
687 GCancellable *cancellable,
688 GError **error);
689 gboolean e_m365_connection_list_event_attachments_sync
690 (EM365Connection *cnc,
691 const gchar *user_override, /* for which user, NULL to use the account user */
692 const gchar *group_id, /* nullable, then the default group is used */
693 const gchar *calendar_id,
694 const gchar *event_id,
695 const gchar *select, /* nullable - properties to select */
696 GSList **out_attachments, /* EM365Attachment * */
697 GCancellable *cancellable,
698 GError **error);
699 gboolean e_m365_connection_get_event_attachment_sync
700 (EM365Connection *cnc,
701 const gchar *user_override, /* for which user, NULL to use the account user */
702 const gchar *group_id, /* nullable, then the default group is used */
703 const gchar *calendar_id,
704 const gchar *event_id,
705 const gchar *attachment_id,
706 EM365ConnectionRawDataFunc func,
707 gpointer func_user_data,
708 GCancellable *cancellable,
709 GError **error);
710 gboolean e_m365_connection_add_event_attachment_sync
711 (EM365Connection *cnc,
712 const gchar *user_override, /* for which user, NULL to use the account user */
713 const gchar *group_id, /* nullable, then the default group is used */
714 const gchar *calendar_id,
715 const gchar *event_id,
716 JsonBuilder *in_attachment,
717 EM365Attachment **out_attachment, /* nullable */
718 GCancellable *cancellable,
719 GError **error);
720 gboolean e_m365_connection_delete_event_attachment_sync
721 (EM365Connection *cnc,
722 const gchar *user_override, /* for which user, NULL to use the account user */
723 const gchar *group_id, /* nullable, then the default group is used */
724 const gchar *calendar_id,
725 const gchar *event_id,
726 const gchar *attachment_id,
727 GCancellable *cancellable,
728 GError **error);
729 gboolean e_m365_connection_get_schedule_sync
730 (EM365Connection *cnc,
731 const gchar *user_override, /* for which user, NULL to use the account user */
732 gint interval_minutes, /* between 5 and 1440, -1 to use the default (30) */
733 time_t start_time,
734 time_t end_time,
735 const GSList *email_addresses, /* const gchar * - SMTP addresses to query */
736 GSList **out_infos, /* EM365ScheduleInformation * */
737 GCancellable *cancellable,
738 GError **error);
739 gboolean e_m365_connection_list_task_lists_sync
740 (EM365Connection *cnc,
741 const gchar *user_override, /* for which user, NULL to use the account user */
742 GSList **out_task_lists, /* EM365TaskList * - the returned todoTaskList objects */
743 GCancellable *cancellable,
744 GError **error);
745 gboolean e_m365_connection_get_task_list_sync
746 (EM365Connection *cnc,
747 const gchar *user_override, /* for which user, NULL to use the account user */
748 const gchar *task_list_id,
749 EM365TaskList **out_task_list,
750 GCancellable *cancellable,
751 GError **error);
752 gboolean e_m365_connection_create_task_list_sync
753 (EM365Connection *cnc,
754 const gchar *user_override, /* for which user, NULL to use the account user */
755 JsonBuilder *task_list,
756 EM365TaskList **out_created_task_list,
757 GCancellable *cancellable,
758 GError **error);
759 gboolean e_m365_connection_update_task_list_sync
760 (EM365Connection *cnc,
761 const gchar *user_override, /* for which user, NULL to use the account user */
762 const gchar *task_list_id,
763 const gchar *display_name,
764 GCancellable *cancellable,
765 GError **error);
766 gboolean e_m365_connection_delete_task_list_sync
767 (EM365Connection *cnc,
768 const gchar *user_override, /* for which user, NULL to use the account user */
769 const gchar *task_list_id,
770 GCancellable *cancellable,
771 GError **error);
772 gboolean e_m365_connection_get_task_lists_delta_sync
773 (EM365Connection *cnc,
774 const gchar *user_override, /* for which user, NULL to use the account user */
775 const gchar *delta_link, /* previous delta link */
776 guint max_page_size, /* 0 for default by the server */
777 EM365ConnectionJsonFunc func, /* function to call with each result set */
778 gpointer func_user_data, /* user data passed into the 'func' */
779 gchar **out_delta_link,
780 GCancellable *cancellable,
781 GError **error);
782 gboolean e_m365_connection_list_tasks_sync
783 (EM365Connection *cnc,
784 const gchar *user_override, /* for which user, NULL to use the account user */
785 const gchar *group_id, /* unused, always NULL */
786 const gchar *task_list_id,
787 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
788 const gchar *select, /* nullable - properties to select */
789 const gchar *filter, /* nullable - filter which tasks to list */
790 GSList **out_tasks, /* EM365Task * - the returned task objects */
791 GCancellable *cancellable,
792 GError **error);
793 gboolean e_m365_connection_create_task_sync
794 (EM365Connection *cnc,
795 const gchar *user_override, /* for which user, NULL to use the account user */
796 const gchar *group_id, /* unused, always NULL */
797 const gchar *task_list_id,
798 JsonBuilder *task,
799 EM365Task **out_created_task,
800 GCancellable *cancellable,
801 GError **error);
802 SoupMessage * e_m365_connection_prepare_get_task
803 (EM365Connection *cnc,
804 const gchar *user_override, /* for which user, NULL to use the account user */
805 const gchar *group_id, /* unused, always NULL */
806 const gchar *task_list_id,
807 const gchar *task_id,
808 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
809 const gchar *select, /* nullable - properties to select */
810 GError **error);
811 gboolean e_m365_connection_get_task_sync (EM365Connection *cnc,
812 const gchar *user_override, /* for which user, NULL to use the account user */
813 const gchar *group_id, /* unused, always NULL */
814 const gchar *task_list_id,
815 const gchar *task_id,
816 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
817 const gchar *select, /* nullable - properties to select */
818 EM365Task **out_task,
819 GCancellable *cancellable,
820 GError **error);
821 gboolean e_m365_connection_get_tasks_sync(EM365Connection *cnc,
822 const gchar *user_override, /* for which user, NULL to use the account user */
823 const gchar *group_id, /* unused, always NULL */
824 const gchar *task_list_id,
825 const GSList *task_ids, /* const gchar * */
826 const gchar *prefer_outlook_timezone, /* nullable - then UTC, otherwise that zone for the returned times */
827 const gchar *select, /* nullable - properties to select */
828 GSList **out_tasks, /* EM365Task *, in the same order as task_ids; can return partial list */
829 GCancellable *cancellable,
830 GError **error);
831 gboolean e_m365_connection_update_task_sync
832 (EM365Connection *cnc,
833 const gchar *user_override, /* for which user, NULL to use the account user */
834 const gchar *group_id, /* unused, always NULL */
835 const gchar *task_list_id,
836 const gchar *task_id,
837 JsonBuilder *task,
838 GCancellable *cancellable,
839 GError **error);
840 gboolean e_m365_connection_delete_task_sync
841 (EM365Connection *cnc,
842 const gchar *user_override, /* for which user, NULL to use the account user */
843 const gchar *group_id, /* unused, always NULL */
844 const gchar *task_list_id,
845 const gchar *task_id,
846 GCancellable *cancellable,
847 GError **error);
848 gboolean e_m365_connection_get_tasks_delta_sync
849 (EM365Connection *cnc,
850 const gchar *user_override, /* for which user, NULL to use the account user */
851 const gchar *task_list_id,
852 const gchar *delta_link, /* previous delta link */
853 guint max_page_size, /* 0 for default by the server */
854 EM365ConnectionJsonFunc func, /* function to call with each result set */
855 gpointer func_user_data, /* user data passed into the 'func' */
856 gchar **out_delta_link,
857 GCancellable *cancellable,
858 GError **error);
859 gboolean e_m365_connection_list_checklist_items_sync
860 (EM365Connection *cnc,
861 const gchar *user_override, /* for which user, NULL to use the account user */
862 const gchar *task_list_id,
863 const gchar *task_id,
864 const gchar *select, /* nullable - properties to select */
865 GSList **out_items, /* EM365ChecklistItem * */
866 GCancellable *cancellable,
867 GError **error);
868 gboolean e_m365_connection_get_checklist_item_sync
869 (EM365Connection *cnc,
870 const gchar *user_override, /* for which user, NULL to use the account user */
871 const gchar *task_list_id,
872 const gchar *task_id,
873 const gchar *item_id,
874 EM365ChecklistItem **out_item, /* nullable */
875 GCancellable *cancellable,
876 GError **error);
877 gboolean e_m365_connection_create_checklist_item_sync
878 (EM365Connection *cnc,
879 const gchar *user_override, /* for which user, NULL to use the account user */
880 const gchar *task_list_id,
881 const gchar *task_id,
882 JsonBuilder *in_item,
883 EM365ChecklistItem **out_item, /* nullable */
884 GCancellable *cancellable,
885 GError **error);
886 gboolean e_m365_connection_update_checklist_item_sync
887 (EM365Connection *cnc,
888 const gchar *user_override, /* for which user, NULL to use the account user */
889 const gchar *task_list_id,
890 const gchar *task_id,
891 const gchar *item_id,
892 JsonBuilder *in_item,
893 GCancellable *cancellable,
894 GError **error);
895 gboolean e_m365_connection_delete_checklist_item_sync
896 (EM365Connection *cnc,
897 const gchar *user_override, /* for which user, NULL to use the account user */
898 const gchar *task_list_id,
899 const gchar *task_id,
900 const gchar *item_id,
901 GCancellable *cancellable,
902 GError **error);
903 gboolean e_m365_connection_list_linked_resources_sync
904 (EM365Connection *cnc,
905 const gchar *user_override, /* for which user, NULL to use the account user */
906 const gchar *task_list_id,
907 const gchar *task_id,
908 const gchar *select, /* nullable - properties to select */
909 GSList **out_resources, /* EM365LinkedResource * */
910 GCancellable *cancellable,
911 GError **error);
912 gboolean e_m365_connection_get_linked_resource_sync
913 (EM365Connection *cnc,
914 const gchar *user_override, /* for which user, NULL to use the account user */
915 const gchar *task_list_id,
916 const gchar *task_id,
917 const gchar *resource_id,
918 EM365LinkedResource **out_resource, /* nullable */
919 GCancellable *cancellable,
920 GError **error);
921 gboolean e_m365_connection_create_linked_resource_sync
922 (EM365Connection *cnc,
923 const gchar *user_override, /* for which user, NULL to use the account user */
924 const gchar *task_list_id,
925 const gchar *task_id,
926 JsonBuilder *in_resource,
927 EM365LinkedResource **out_resource, /* nullable */
928 GCancellable *cancellable,
929 GError **error);
930 gboolean e_m365_connection_update_linked_resource_sync
931 (EM365Connection *cnc,
932 const gchar *user_override, /* for which user, NULL to use the account user */
933 const gchar *task_list_id,
934 const gchar *task_id,
935 const gchar *resource_id,
936 JsonBuilder *in_resource,
937 GCancellable *cancellable,
938 GError **error);
939 gboolean e_m365_connection_delete_linked_resource_sync
940 (EM365Connection *cnc,
941 const gchar *user_override, /* for which user, NULL to use the account user */
942 const gchar *task_list_id,
943 const gchar *task_id,
944 const gchar *resource_id,
945 GCancellable *cancellable,
946 GError **error);
947
948 G_END_DECLS
949
950 #endif /* E_M365_CONNECTION_H */