ניהול Google Calendars באמצעות לקוח Gmail

הוספה, עריכה ומחיקה של לוחות השנה של Gmail

Aspose.Email מאפשרת ליישומים לנהל את לוחות השנה של Gmail באמצעות IGmailClient שמספקת תכונות כגון הוספה, מחיקה ועדכון של לוחות השנה של Gmail. מחלקת לקוח זו מחזירה רשימה של אובייקטים מטיפוס ExtendedCalendar המכילים מידע על פריטי לוח השנה של Gmail. IGmailClient המחלקה מציגה את הפונקציות הבאות עבור לוחות שנה:

• CreateCalendar ניתן להשתמש בו להוספת לוח שנה חדש
• ListCalendars ניתן להשתמש בו לקבלת רשימת כל לוחות השנה של לקוח
• DeleteCalendar ניתן להשתמש בה כדי למחוק לוח שנה
• FetchCalendar ניתן להשתמש בה כדי לקבל לוח שנה ספציפי של לקוח
• UpdateCalendar פונקציה זו משמשת להוספת לוח שנה משוכנע של לקוח

כדי לגשת ללוחות השנה, המזהה GoogleTestUser מאותחל באמצעות פרטי חשבון Gmail. GoogleOAuthHelper משמש לקבלת אסימון הגישה של המשתמש, אשר משמש לאחר מכן לאתחול IGmailClient.

הוספה, אחזור ועדכון לוחות שנה של Gmail

להוספת לוח שנה, אתחל אובייקט מטיפוס Calendar והכנס אותו באמצעות CreateCalendar() פונקציה. CreateCalendar() מחזירה את המזהה של לוח השנה החדש שנוסף. מזהה זה יכול לשמש לקבלת לוח השנה מהשרת. קטע הקוד הבא מציג כיצד להוסיף, לקבל ולעדכן לוח שנה.

מחיקת לוחות שנה ספציפיים של Google

כדי למחוק לוח שנה ספציפי, עלינו לקבל את רשימת כל לוחות השנה של לקוח ולאחר מכן למחוק לפי הצורך. ListCalendars() מחזירה את הרשימה של ExtendedCalendar שכוללת לוחות שנה של Gmail. קטע הקוד הבא מציג כיצד למחוק לוח שנה ספציפי.

בקרת גישה ליומן

Aspose.Email מספק שליטה מלאה על הגישה לפריטי היומנונים. ListAccessRules() פונקציה נחשפת על ידי IGmailClient שמחזירה את הרשימה של AccessControlRule. ניתן לקבל, לשנות ולשמור בחזרה מידע של חוק יחיד עבור לוח השנה של לקוח. IGmailClient מכילה את הפונקציות הבאות לניהול כללי בקרת הגישה.

• ListAccessRules פונקציה זו מספקת את רשימת AccessControlRule
• CreateAccessRule פונקציה זו יוצרת חוק גישה חדש עבור לוח שנה.
• UpdateAccessRule פונקציה זו משמשת לעדכון חוק גישה.
• FetchAccessRule ניתן להשתמש בה כדי לקבל חוק גישה ספציפי עבור לוח השנה של לקוח.
• DeleteAccessRule פונקציה זו משמשת למחיקת חוק גישה.

קטע הקוד למטה מראה כיצד להשתמש בפונקציות לניהול כללי הגישה:

הגדרות לקוח היומן ומידע על צבעים

Aspose.Email תומכת בגישה להגדרות הלקוח באמצעות IGmailClient.GetSettings(). היא מחזירה את רשימת ההגדרות כפי שמופיעה למטה:

1. סדר השדה תאריך
2. הצג את כל אזורי הזמן
3. הסתר הזמנות
4. פורמט זמן 24 שעות
5. מצב לוח שנה ברירת מחדל
6. אורך אירוע ברירת מחדל
7. שפה
8. remindOnRespondedEventsOnly
9. לוח שנה חלופי
10. מיקום משתמש
11. הסתר סופי שבוע
12. showDeclinedEvents
13. התחלת שבוע
14. מזג אוויר
15. customCalendarMode
16. timezoneLabel
17. אזור זמן
18. useKeyboardShortcuts
19. מדינה

באופן דומה ניתן לקבל מידע צבע עבור לקוחות באמצעות IGmailClient.GetColors(). אובייקט מידע הצבע הזה מחזיר את רשימת צבעי חזית, צבעי רקע ותאריך ושעת העדכון.

גישה להגדרות לקוח

קטע הקוד למטה מראה כיצד ניתן להשתמש בפונקציות לגישה להגדרות הלקוח:

גישה למידע על צבעים

קטע הקוד למטה מראה כיצד ניתן להשתמש בפונקציות לגישה להגדרות הצבע של הלקוח.

נהל פגישות בלוח השנה של Google

Aspose.Email מספקת תכונות לעבודה עם פגישות בלוח השנה של Google. המשימות הבאות ניתנות לביצוע עם פגישות בלוח השנה של Google:

1. הוספת פגישות.
2. קבל רשימת פגישות.
3. קבל פגישה ספציפית.
4. עדכון פגישה.
5. העברת פגישה מלוח שנה אחד לאחר.
6. מחיקת פגישה.

IGmailClient מספקת פונקציות כגון CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment ו DeleteAppointment.

הוספת פגישות ל-Google Calendar

דוגמת הקוד למטה מציגה את הפונקציה של הוספת פגישה בלוח שנה. כדי לבצע זאת, פעל לפי הצעדים:

1. צור והוסף לוח שנה.
2. קבלת רשימת הפגישות מלוח שנה חדש.
3. צור פגישה.
4. הוספת פגישה.

קבל ועדכן פגישות בלוח השנה של Google

כאן מודגמים האחזור והעדכון של לוח השנה כדלקמן:

1. קבל פגישה ספציפית.
2. שנה את הפגישה.
3. עדכן את הפגישה בלוח השנה.

נניח כי לוח שנה עם מזהה "calendarId" ומזהה ייחודי של פגישה "AppointmentUniqueId" כבר נלקחו. הקטע הקוד הבא מראה כיצד לקבל ולעדכן פגישה.

העבר ומחק פגישות בלוח השנה של Google

ניתן להעביר פגישה על ידי מתן לוח השנה המקור, לוח השנה יעד והמזהה הייחודי של הפגישה בלוח המקור. הקטע הקוד הבא מראה כיצד להעביר ולמחוק פגישה.

שאילתת FreeBusy בלוח השנה של Google

Aspose.Email מספקת מנגנון שאילתות לבדיקת האם פגישה נדרשת לפי קריטריונים. מחלקת FreebusyQuery מסופקת למטרה זו ומאפשרת להכין שאילתה עבור לוח שנה ספציפי.

דוגמת קוד זו מציגה את המאפיין של שאילת לוח שנה. המשימות הבאות מתבצעות בדוגמה:

1. צור והוסף לוח שנה
2. צור פגישה
3. הוסף פגישה
4. הכן שאילתת FreeBusy
5. קבל את 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("[e-mail]");
        attendees.Add("[e-mail]");

        // Create appointment
        Appointment app1 = new Appointment("Location - " + Guid.NewGuid().ToString(), startDate, endDate, "[e-mail]", 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);
    }
}