הוספת יומן קיים לרשימת היומנים של המשתמש. אפשר לנסות עכשיו או לראות דוגמה.
בקשה
בקשת HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList
פרמטרים
שם הפרמטר | Value | התיאור |
---|---|---|
פרמטרים אופציונליים של שאילתה | ||
colorRgbFormat |
boolean |
האם להשתמש בשדות foregroundColor ו-backgroundColor כדי לכתוב את צבעי היומן (RGB). אם נעשה שימוש בתכונה הזו, הערך בשדה colorId שמבוסס על אינדקס יוגדר באופן אוטומטי לאפשרות ההתאמה הטובה ביותר. אפשרות. ברירת המחדל היא False.
|
הרשאות
בקשה זו מחייבת הרשאה בהיקף הבא:
היקף |
---|
https://www.googleapis.com/auth/calendar |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מספקים משאב CalendarList עם המאפיינים הבאים:
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
מאפיינים נדרשים | |||
id |
string |
מזהה היומן. | |
מאפיינים אופציונליים | |||
backgroundColor |
string |
הצבע הראשי של היומן בפורמט ההקסדצימלי "#0088aa ". המאפיין הזה מחליף את המאפיין colorId שמבוסס על אינדקס. כדי להגדיר או לשנות את המאפיין הזה, צריך לציין colorRgbFormat=true בפרמטרים של השיטות insert, update ו-תיקון. אפשרות. |
ניתן לכתיבה |
colorId |
string |
צבע היומן. זהו מזהה שמפנה לרשומה בקטע calendar של הגדרת הצבעים (אפשר לעיין בנקודת הקצה של הצבעים). המאפיין הזה מוחלף במאפיינים backgroundColor ו-foregroundColor , וניתן להתעלם ממנו כשמשתמשים במאפיינים האלה. אפשרות. |
ניתן לכתיבה |
defaultReminders[] |
list |
תזכורות ברירת המחדל שיש למשתמש המאומת עבור היומן הזה. | ניתן לכתיבה |
defaultReminders[].method |
string |
השיטה שבה נעשה שימוש בתזכורת הזו. הערכים האפשריים הם:
חובה כשמוסיפים תזכורת. |
ניתן לכתיבה |
defaultReminders[].minutes |
integer |
מספר הדקות לפני תחילת האירוע שבהן התזכורת צריכה להתחיל. הערכים החוקיים הם בין 0 ל-40320 (4 שבועות בדקות). חובה כשמוסיפים תזכורת. |
ניתן לכתיבה |
foregroundColor |
string |
הצבע הקדמי של היומן בפורמט ההקסדצימלי '#ffffff '. המאפיין הזה מחליף את המאפיין colorId שמבוסס על אינדקס. כדי להגדיר או לשנות את המאפיין הזה, צריך לציין colorRgbFormat=true בפרמטרים של השיטות insert, update ו-תיקון. אפשרות. |
ניתן לכתיבה |
notificationSettings |
object |
ההתראות שהמשתמש המאומת מקבל עבור היומן הזה. | ניתן לכתיבה |
notificationSettings.notifications[].method |
string |
השיטה ששימשה להעברת ההתראה. הערך האפשרי הוא:
חובה כשמוסיפים תזכורת. |
ניתן לכתיבה |
notificationSettings.notifications[].type |
string |
סוג ההתראה. הערכים האפשריים הם:
חובה כשמוסיפים תזכורת. |
ניתן לכתיבה |
selected |
boolean |
האם תוכן היומן מופיע בממשק המשתמש של היומן. אפשרות. ברירת המחדל היא False. | ניתן לכתיבה |
summaryOverride |
string |
הסיכום שהמשתמש המאומת הגדיר עבור היומן הזה. אפשרות. | ניתן לכתיבה |
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב CalendarList בגוף התגובה.
דוגמאות
הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).
Java
משתמש בספריית הלקוח של Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.CalendarListEntry; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create a new calendar list entry CalendarListEntry calendarListEntry = new CalendarListEntry(); calendarListEntry.setId("calendarId"); // Insert the new calendar list entry CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute(); System.out.println(createdCalendarListEntry.getSummary());
Python
עושה שימוש בספריית הלקוח של Python.
calendar_list_entry = { 'id': 'calendarId' } created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute() print created_calendar_list_entry['summary']
PHP
נעשה שימוש בספריית הלקוח של PHP.
$calendarListEntry = new Google_Service_Calendar_CalendarListEntry(); $calendarListEntry->setId("calendarId"); $createdCalendarListEntry = $service->calendarList->insert($calendarListEntry); echo $createdCalendarListEntry->getSummary();
Ruby
נעשה שימוש בספריית הלקוח של Ruby.
entry = Google::Apis::CalendarV3::CalendarListEntry.new( id: 'calendarId' ) result = client.insert_calendar_list(entry) print result.summary
רוצה לנסות?
ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.