Administrar Google Calendars usando el cliente Gmail
Agregar, editar y eliminar calendarios de Gmail
Aspose.Email permite a las aplicaciones gestionar los calendarios de Gmail usando IGmailClient que ofrece funciones como agregar, eliminar y actualizar calendarios de Gmail. Esta clase cliente devuelve una lista de objetos de tipo ExtendedCalendar que contienen información sobre los elementos del calendario de Gmail. IGmailClient la clase expone las siguientes funciones para calendarios:
- CreateCalendar Puede usarse para insertar un nuevo calendario
- ListCalendars Puede usarse para obtener la lista de todos los calendarios de un cliente
- DeleteCalendar Puede usarse para eliminar un calendario
- FetchCalendar Puede usarse para obtener un calendario concreto de un cliente
- UpdateCalendar Esta función se usa para volver a insertar un calendario modificado de un cliente
Para acceder a los calendarios, GoogleTestUser se inicializa usando credenciales de cuenta de Gmail. GoogleOAuthHelper se utiliza para obtener el token de acceso del usuario, que luego se usa para inicializar IGmailClient.
Insertar, obtener y actualizar calendarios de Gmail
Para insertar un calendario, inicialice un objeto de tipo Calendar e insértelo usando CreateCalendar() función. CreateCalendar() devuelve el id del calendario recién insertado. Este id puede usarse para obtener el calendario del servidor. El siguiente fragmento de código muestra cómo insertar, obtener y actualizar un calendario.
Eliminar calendarios específicos de Google
Para eliminar un calendario concreto, necesitamos obtener la lista de todos los calendarios de un cliente y luego eliminar según sea necesario. ListCalendars() devuelve la lista de ExtendedCalendar que contiene calendarios de Gmail. El siguiente fragmento de código muestra cómo eliminar un calendario concreto.
Control de acceso al calendario
Aspose.Email brinda control total sobre el acceso a los elementos del calendario. ListAccessRules() función está expuesta por IGmailClient que devuelve la lista de AccessControlRule. La información individual de la regla puede ser recuperada, modificada y guardada de nuevo para el calendario de un cliente. IGmailClient contiene las siguientes funciones para gestionar las reglas de control de acceso.
- ListAccessRules Esta función proporciona la lista de AccessControlRule
- CreateAccessRule Esta función crea una nueva regla de acceso para un calendario.
- UpdateAccessRule Esta función se utiliza para actualizar una regla de acceso.
- FetchAccessRule Puede usarse para obtener una regla de acceso particular para el calendario de un cliente
- DeleteAccessRule Esta función se utiliza para eliminar una regla de acceso.
El siguiente fragmento de código muestra cómo usar funciones para gestionar las reglas de acceso:
Configuración del cliente de calendario e información de colores
Aspose.Email permite acceder a la configuración del Cliente mediante IGmailClient.GetSettings(). Devuelve la lista de configuraciones como se muestra a continuación:
- dateFieldOrder
- displayAllTimezones
- hideInvitations
- format24HourTime
- defaultCalendarMode
- defaultEventLength
- locale
- remindOnRespondedEventsOnly
- alternateCalendar
- ubicaciónUsuario
- hideWeekends
- showDeclinedEvents
- inicioDeSemana
- clima
- customCalendarMode
- timezoneLabel
- zona horaria
- useKeyboardShortcuts
- país
De manera similar, la información de color para clientes también se puede obtener usando IGmailClient.GetColors(). Este objeto de información de color devuelve la lista de colores de primer plano, colores de fondo y la fecha y hora de actualización.
Acceder a la Configuración del Cliente
El siguiente fragmento de código muestra cómo pueden usarse las funciones para acceder a la configuración del cliente:
Acceder a la información de colores
El siguiente fragmento de código muestra cómo pueden usarse las funciones para acceder a la configuración de colores del cliente.
Administrar citas de Google Calendar
Aspose.Email ofrece funcionalidades para trabajar con citas en calendarios de Google. Las siguientes tareas se pueden realizar con citas en Google Calendar:
- Agregar citas.
- Obtener lista de citas.
- Obtener una cita en particular.
- Actualizar una cita.
- Mover cita de un calendario a otro.
- Eliminar cita.
IGmailClient proporciona funciones como CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment y DeleteAppointment.
Agregar citas a Google Calendar
El siguiente ejemplo de código muestra la función de agregar una cita en un calendario. Para lograrlo, siga los pasos:
- Crear e insertar un calendario.
- Recuperar la lista de citas de un calendario nuevo.
- Crear una cita.
- Insertar una cita.
Obtener y actualizar citas de Google Calendar
Aquí se demuestran la recuperación y actualización del calendario de la siguiente manera:
- Recuperar una cita particular.
- Modificar la cita.
- Actualizar la cita en el calendario.
Se asume que ya se han extraído un calendario con id "calendarId" y el id único de la cita "AppointmentUniqueId". El siguiente fragmento de código muestra cómo obtener y actualizar una cita.
Mover y eliminar citas en Google Calendar
Una cita puede moverse proporcionando el calendario de origen, el calendario de destino y el id único de una cita en el calendario de origen. El siguiente fragmento de código muestra cómo mover y eliminar una cita.
Consulta FreeBusy para Google Calendar
Aspose.Email proporciona un mecanismo de consulta para verificar si una cita está programada según los criterios. La clase FreebusyQuery se ofrece para este propósito y permite preparar una consulta para un calendario en particular.
Este ejemplo de código demuestra la funcionalidad de consultar un calendario. En este ejemplo se realizan las siguientes tareas:
- Crear e insertar un calendario
- Crear una cita
- Insertar cita
- Preparar una consulta FreeBusyQuery
- Obtener la respuesta FreebusyResponse
// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Use the GoogleUser and GoogleOAuthHelper classes below to receive an access token
using (IGmailClient client = GmailClient.GetInstance(accessToken, user.Email))
{
// Initialize calendar item
Aspose.Email.Clients.Google.Calendar calendar1 = new Aspose.Email.Clients.Google.Calendar("summary - " + Guid.NewGuid().ToString(), null, null, "Europe/Kiev");
// Insert calendar and get back id of newly inserted calendar and Fetch the same calendar using calendar id
string id = client.CreateCalendar(calendar1);
Aspose.Email.Clients.Google.Calendar cal1 = client.FetchCalendar(id);
string calendarId1 = cal1.Id;
try
{
// Get list of appointments in newly inserted calendar. It should be zero
Appointment[] appointments = client.ListAppointments(calendarId1);
if (appointments.Length != 0)
{
Console.WriteLine("Wrong number of appointments");
return;
}
// Create a new appointment and Calculate appointment start and finish time
DateTime startDate = DateTime.Now;
DateTime endDate = startDate.AddHours(1);
// Create attendees list for appointment
MailAddressCollection attendees = new MailAddressCollection();
attendees.Add("user1@domain.com");
attendees.Add("user2@domain.com");
// Create appointment
Appointment app1 = new Appointment("Location - " + Guid.NewGuid().ToString(), startDate, endDate, "user2@domain.com", attendees);
app1.Summary = "Summary - " + Guid.NewGuid().ToString();
app1.Description = "Description - " + Guid.NewGuid().ToString();
app1.StartTimeZone = "Europe/Kiev";
app1.EndTimeZone = "Europe/Kiev";
// Insert the newly created appointment and get back the same in case of successful insertion
Appointment app2 = client.CreateAppointment(calendarId1, app1);
// Create Freebusy query by setting min/max timeand time zone
FreebusyQuery query = new FreebusyQuery();
query.TimeMin = DateTime.Now.AddDays(-1);
query.TimeMax = DateTime.Now.AddDays(1);
query.TimeZone = "Europe/Kiev";
// Set calendar item to search and Get the reponse of query containing
query.Items.Add(cal1.Id);
FreebusyResponse resp = client.GetFreebusyInfo(query);
// Delete the appointment
client.DeleteAppointment(calendarId1, app2.UniqueId);
}
finally
{
// Delete the calendar
client.DeleteCalendar(cal1.Id);
}
}