แสดงกิจกรรมในปฏิทินรายการเดียว
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
addEmailReminder(minutesBefore) | CalendarEvent | เพิ่มการช่วยเตือนทางอีเมลใหม่ไปยังกิจกรรม |
addGuest(email) | CalendarEvent | เพิ่มผู้เข้าร่วมในกิจกรรม |
addPopupReminder(minutesBefore) | CalendarEvent | เพิ่มการแจ้งเตือนแบบป๊อปอัปใหม่ในกิจกรรม |
addSmsReminder(minutesBefore) | CalendarEvent | เพิ่มการแจ้งเตือนทาง SMS ใหม่ไปยังกิจกรรม |
anyoneCanAddSelf() | Boolean | กำหนดว่าผู้ใช้สามารถเพิ่มตนเองเป็นผู้เข้าร่วมในกิจกรรมของปฏิทินได้หรือไม่ |
deleteEvent() | void | ลบกิจกรรมในปฏิทิน |
deleteTag(key) | CalendarEvent | ลบแท็กคีย์/ค่าออกจากเหตุการณ์ |
getAllDayEndDate() | Date | รับวันที่ที่กิจกรรมแบบตลอดวันนี้สิ้นสุดลง |
getAllDayStartDate() | Date | รับวันที่กิจกรรมแบบตลอดวันนี้เริ่มต้น |
getAllTagKeys() | String[] | รับคีย์ทั้งหมดสำหรับแท็กที่กำหนดไว้ในเหตุการณ์ |
getColor() | String | แสดงสีของกิจกรรมในปฏิทิน |
getCreators() | String[] | รับผู้สร้างกิจกรรม |
getDateCreated() | Date | รับข้อมูลวันที่สร้างกิจกรรม |
getDescription() | String | รับคำอธิบายกิจกรรม |
getEmailReminders() | Integer[] | รับค่านาทีสำหรับการช่วยเตือนทางอีเมลทั้งหมดสำหรับกิจกรรม |
getEndTime() | Date | รับข้อมูลวันที่และเวลาที่กิจกรรมในปฏิทินนี้สิ้นสุด |
getEventSeries() | CalendarEventSeries | รับชุดกิจกรรมที่เกิดซ้ำที่มีกิจกรรมนี้อยู่ |
getGuestByEmail(email) | EventGuest | รับผู้เข้าร่วมทางอีเมล |
getGuestList() | EventGuest[] | รับผู้เข้าร่วมกิจกรรม แต่ไม่รวมเจ้าของกิจกรรม |
getGuestList(includeOwner) | EventGuest[] | รับผู้เข้าร่วมกิจกรรม ซึ่งอาจรวมถึงเจ้าของกิจกรรม |
getId() | String | รับ iCalUID ที่ไม่ซ้ำกันของเหตุการณ์ |
getLastUpdated() | Date | รับวันที่ที่กิจกรรมได้รับการอัปเดตล่าสุด |
getLocation() | String | รับข้อมูลตำแหน่งของกิจกรรม |
getMyStatus() | GuestStatus | ดูสถานะกิจกรรม (เช่น เข้าร่วมหรือได้รับเชิญ) ของผู้ใช้ที่มีผล |
getOriginalCalendarId() | String | รับรหัสของปฏิทินที่สร้างกิจกรรมนี้ขึ้นในตอนแรก |
getPopupReminders() | Integer[] | รับค่านาทีสำหรับการแจ้งเตือนแบบป๊อปอัปทั้งหมดของกิจกรรม |
getSmsReminders() | Integer[] | รับค่านาทีสำหรับการช่วยเตือนทาง SMS ทั้งหมดสำหรับกิจกรรม |
getStartTime() | Date | รับข้อมูลวันที่และเวลาที่กิจกรรมในปฏิทินนี้เริ่มต้น |
getTag(key) | String | รับค่าแท็กของเหตุการณ์ |
getTitle() | String | รับชื่อกิจกรรม |
getVisibility() | Visibility | รับข้อมูลระดับการเข้าถึงกิจกรรม |
guestsCanInviteOthers() | Boolean | กำหนดว่าผู้เข้าร่วมสามารถเชิญผู้เข้าร่วมอื่นได้หรือไม่ |
guestsCanModify() | Boolean | กำหนดว่าผู้เข้าร่วมจะแก้ไขกิจกรรมได้หรือไม่ |
guestsCanSeeGuests() | Boolean | กำหนดว่าผู้เข้าร่วมจะเห็นผู้เข้าร่วมคนอื่นๆ หรือไม่ |
isAllDayEvent() | Boolean | กำหนดว่าเป็นกิจกรรมตลอดทั้งวันหรือไม่ |
isOwnedByMe() | Boolean | กำหนดว่าคุณเป็นเจ้าของกิจกรรมหรือไม่ |
isRecurringEvent() | Boolean | กำหนดว่ากิจกรรมเป็นส่วนหนึ่งของชุดกิจกรรมหรือไม่ |
removeAllReminders() | CalendarEvent | ลบการแจ้งเตือนทั้งหมดออกจากกิจกรรม |
removeGuest(email) | CalendarEvent | นำผู้เข้าร่วมออกจากกิจกรรม |
resetRemindersToDefault() | CalendarEvent | รีเซ็ตการช่วยเตือนโดยใช้การตั้งค่าเริ่มต้นของปฏิทิน |
setAllDayDate(date) | CalendarEvent | กำหนดวันที่ของกิจกรรม |
setAllDayDates(startDate, endDate) | CalendarEvent | กำหนดวันที่ของกิจกรรม |
setAnyoneCanAddSelf(anyoneCanAddSelf) | CalendarEvent | ตั้งค่าว่าผู้ที่ไม่ใช่ผู้เข้าร่วมจะเพิ่มตนเองในกิจกรรมได้หรือไม่ |
setColor(color) | CalendarEvent | ตั้งค่าสีของกิจกรรมในปฏิทิน |
setDescription(description) | CalendarEvent | ตั้งค่าคำอธิบายกิจกรรม |
setGuestsCanInviteOthers(guestsCanInviteOthers) | CalendarEvent | ตั้งค่าว่าผู้เข้าร่วมสามารถเชิญผู้เข้าร่วมอื่นได้หรือไม่ |
setGuestsCanModify(guestsCanModify) | CalendarEvent | ตั้งค่าว่าผู้เข้าร่วมจะแก้ไขกิจกรรมได้หรือไม่ |
setGuestsCanSeeGuests(guestsCanSeeGuests) | CalendarEvent | ตั้งค่าว่าผู้เข้าร่วมจะเห็นผู้เข้าร่วมรายอื่นหรือไม่ |
setLocation(location) | CalendarEvent | ตั้งค่าสถานที่ของกิจกรรม |
setMyStatus(status) | CalendarEvent | ตั้งค่าสถานะกิจกรรม (เช่น เข้าร่วมหรือได้รับเชิญ) ของผู้ใช้ที่มีผล |
setTag(key, value) | CalendarEvent | ตั้งค่าแท็กคีย์/ค่าในเหตุการณ์เพื่อจัดเก็บข้อมูลเมตาที่กำหนดเอง |
setTime(startTime, endTime) | CalendarEvent | ตั้งค่าวันที่และเวลาสำหรับการเริ่มต้นและสิ้นสุดของกิจกรรม |
setTitle(title) | CalendarEvent | ตั้งชื่อกิจกรรม |
setVisibility(visibility) | CalendarEvent | ตั้งค่าระดับการเข้าถึงกิจกรรม |
เอกสารโดยละเอียด
addEmailReminder(minutesBefore)
เพิ่มการช่วยเตือนทางอีเมลใหม่ไปยังกิจกรรม การช่วยเตือนต้องมีความยาวอย่างน้อย 5 นาทีและไม่เกิน 4 นาที สัปดาห์ (40320 นาที) ก่อนเริ่มกิจกรรม
// Gets an event by its ID. For an event series, use getEventSeriesById(iCalId) instead. // TODO(developer): Replace the string with the event ID that you want to get. const event = CalendarApp.getEventById('abc123456'); // Adds an email notification for 15 minutes before the event. event.addEmailReminder(15);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
minutesBefore | Integer | จำนวนนาทีก่อนกิจกรรม |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การขว้าง
Error
— หากมีการช่วยเตือนในกิจกรรมมากกว่า 5 รายการ หรือไม่มีเวลา
ภายในช่วงทางกฎหมาย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addGuest(email)
เพิ่มผู้เข้าร่วมในกิจกรรม
// Example 1: Add a guest to one event function addAttendeeToEvent() { // Replace the below values with your own let attendeeEmail = 'user@example.com'; // Email address of the person you need to add let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar containing event let eventId = '123abc'; // ID of event instance let calendar = CalendarApp.getCalendarById(calendarId); if (calendar === null) { // Calendar not found console.log('Calendar not found', calendarId); return; } let event = calendar.getEventById(eventId); if (event === null) { // Event not found console.log('Event not found', eventId); return; } event.addGuest(attendeeEmail); } // Example 2: Add a guest to all events on a calendar within a specified timeframe function addAttendeeToAllEvents(){ // Replace the following values with your own let attendeeEmail = 'user@example.com'; // Email address of the person you need to add let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar with the events let startDate = new Date("YYYY-MM-DD"); // The first date to add the guest to the events let endDate = new Date("YYYY-MM-DD"); // The last date to add the guest to the events let calendar = CalendarApp.getCalendarById(calendarId); if (calendar === null) { // Calendar not found console.log('Calendar not found', calendarId); return; } // Get the events within the specified timeframe let calEvents = calendar.getEvents(startDate,endDate); console.log(calEvents.length); // Checks how many events are found // Loop through all events and add the attendee to each of them for (var i = 0; i < calEvents.length; i++) { let event = calEvents[i]; event.addGuest(attendeeEmail); } }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
email | String | อีเมลของผู้เข้าร่วม |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำสายโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addPopupReminder(minutesBefore)
เพิ่มการแจ้งเตือนแบบป๊อปอัปใหม่ในกิจกรรม การแจ้งเตือนต้องมีความยาวอย่างน้อย 5 นาที และ ล่วงหน้าไม่เกิน 4 สัปดาห์ (40,320 นาที) ก่อนกิจกรรมเริ่ม
// Gets an event by its ID. For an event series, use getEventSeriesById(iCalId) instead. // TODO(developer): Replace the string with the event ID that you want to get. const event = CalendarApp.getEventById('abc123456'); // Adds a pop-up notification for 15 minutes before the event. event.addPopupReminder(15);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
minutesBefore | Integer | จำนวนนาทีก่อนกิจกรรม |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addSmsReminder(minutesBefore)
เพิ่มการแจ้งเตือนทาง SMS ใหม่ไปยังกิจกรรม การช่วยเตือนต้องมีความยาวอย่างน้อย 5 นาทีและไม่เกิน 4 นาที สัปดาห์ (40320 นาที) ก่อนเริ่มกิจกรรม
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
minutesBefore | Integer | จำนวนนาทีก่อนกิจกรรม |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การขว้าง
Error
— หากมีการช่วยเตือนในกิจกรรมมากกว่า 5 รายการ หรือไม่มีเวลา
ภายในช่วงทางกฎหมาย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
anyoneCanAddSelf()
กำหนดว่าผู้ใช้สามารถเพิ่มตนเองเป็นผู้เข้าร่วมในกิจกรรมของปฏิทินได้หรือไม่
// Gets an event by its ID. For an event series, use getEventSeriesById(iCalId) instead. // TODO(developer): Replace the string with the event ID that you want to get. const event = CalendarApp.getEventById('abc123456'); // Determines whether people can add themselves as guests to the event and logs it. console.log(event.anyoneCanAddSelf());
รีเทิร์น
Boolean
— true
หากผู้ที่ไม่ใช่ผู้เข้าร่วมเพิ่มตนเองลงในกิจกรรมได้ false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
deleteEvent()
ลบกิจกรรมในปฏิทิน
// Gets an event by its ID. // TODO(developer): Replace the string with the ID of the event that you want to delete. const event = CalendarApp.getEventById('abc123456'); // Deletes the event. event.deleteEvent();
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
deleteTag(key)
ลบแท็กคีย์/ค่าออกจากเหตุการณ์
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์แท็ก |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
getAllDayEndDate()
รับวันที่ที่กิจกรรมแบบตลอดวันนี้สิ้นสุดลง (หากไม่ใช่กิจกรรมตลอดทั้งวัน
วิธีนี้มีข้อยกเว้น) Date
ที่แสดงผลแสดงถึงเที่ยงคืนเวลา
เริ่มต้นของวันหลังจากที่กิจกรรมสิ้นสุดลงในเขตเวลาของสคริปต์ วิธีใช้
เขตเวลาของปฏิทิน โปรดโทร getEndTime()
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Creates an event named 'My all-day event' for May 16, 2023. const event = calendar.createAllDayEvent('My all-day event', new Date('May 16, 2023')); // Gets the event's end date and logs it. const endDate = event.getAllDayEndDate(); console.log(endDate);
รีเทิร์น
Date
— วันที่สิ้นสุดของกิจกรรมเต็มวันในปฏิทินนี้
การขว้าง
Error
— หากกิจกรรมนี้ไม่ใช่กิจกรรมตลอดทั้งวัน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getAllDayStartDate()
รับวันที่กิจกรรมแบบตลอดวันนี้เริ่มต้น (ถ้าไม่ใช่กิจกรรมเต็มวัน
วิธีนี้จะมีข้อยกเว้น) Date
ที่แสดงผลแสดงถึงเที่ยงคืนเวลา
เวลาเริ่มต้นของวันที่กิจกรรมเริ่มต้นในเขตเวลาของสคริปต์ วิธีใช้
เขตเวลาของปฏิทิน โปรดโทร getStartTime()
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Creates an event named 'My all-day event' for May 16, 2023. const event = calendar.createAllDayEvent('My all-day event', new Date('May 16, 2023')); // Gets the event's start date and logs it. const startDate = event.getAllDayStartDate(); console.log(startDate);
รีเทิร์น
Date
— วันที่เริ่มต้นของกิจกรรมในปฏิทินตลอดทั้งวันนี้
การขว้าง
Error
— หากกิจกรรมนี้ไม่ใช่กิจกรรมตลอดทั้งวัน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getAllTagKeys()
รับคีย์ทั้งหมดสำหรับแท็กที่กำหนดไว้ในเหตุการณ์
รีเทิร์น
String[]
— อาร์เรย์ของคีย์สตริง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getColor()
แสดงสีของกิจกรรมในปฏิทิน
// Gets an event by its ID. For an event series, use getEventSeriesById(iCalId) instead. // TODO(developer): Replace the string with the event ID that you want to get. const event = CalendarApp.getEventById('abc123456'); // Gets the color of the calendar event and logs it. const eventColor = event.getColor(); console.log(eventColor);
รีเทิร์น
String
— ค่าแทนสตริงของสีเหตุการณ์ เป็นดัชนี (1-11) ของค่าจาก CalendarApp.EventColor
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getCreators()
รับผู้สร้างกิจกรรม
// Gets an event by its ID. For an event series, use getEventSeriesById(iCalId) instead. // TODO(developer): Replace the string with the event ID that you want to get. const event = CalendarApp.getEventById('abc123456'); // Gets a list of the creators of the event and logs it. console.log(event.getCreators());
รีเทิร์น
String[]
— อีเมลผู้สร้างกิจกรรม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getDateCreated()
รับข้อมูลวันที่สร้างกิจกรรม คุณต้องมีสิทธิ์เข้าถึงปฏิทิน
// Opens the calendar by using its ID. // To get the user's default calendar use CalendarApp.getDefault() instead. // TODO(developer): Replace the calendar ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 8:10 AM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 08:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, gets the date that the event // was created and logs it. const eventCreated = event.getDateCreated(); console.log(eventCreated); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Date
— วันที่สร้าง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getDescription()
รับคำอธิบายกิจกรรม คุณต้องมีสิทธิ์แก้ไขปฏิทิน
// Opens the calendar by its ID. // To get the user's default calendar use CalendarApp.getDefault() instead. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 4th, 2023 that takes place between 4:00 PM and 5:00 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 04, 2023 16:00:00'), new Date('Feb 04, 2023 17:00:00'))[0]; if (event) { // If an event exists within the given time frame, sets the description of the event. event.setDescription('Important meeting'); // Gets the description of the event and logs it. const description = event.getDescription(); console.log(description); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
String
— คำอธิบาย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEmailReminders()
รับค่านาทีสำหรับการช่วยเตือนทางอีเมลทั้งหมดสำหรับกิจกรรม คุณต้องมีสิทธิ์แก้ไข ปฏิทิน
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 4th, 2023 that takes place between 5:00 PM and 6:00 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 04, 2023 15:00:00'), new Date('Feb 04, 2023 18:00:00'))[0]; if (event) { // If an event exists within the given time frame, adds email reminders for the user to be // sent at 4 and 7 minutes before the event. event.addEmailReminder(4); event.addEmailReminder(7); // Gets the minute values for all email reminders that are set up for the user for this event // and logs it. const emailReminder = event.getEmailReminders(); console.log(emailReminder); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Integer[]
— อาร์เรย์ที่แต่ละค่าตรงกับจำนวนนาทีก่อนเกิดเหตุการณ์ที่
ทริกเกอร์การช่วยเตือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEndTime()
รับข้อมูลวันที่และเวลาที่กิจกรรมในปฏิทินนี้สิ้นสุด คุณต้องมีสิทธิ์เข้าถึงปฏิทิน สำหรับกิจกรรมที่ไม่ใช่กิจกรรมตลอดทั้งวัน นี่คือเวลาทันทีที่มีการกำหนดกิจกรรมไว้ที่ สิ้นสุด นี่หมายถึงเที่ยงคืนสำหรับกิจกรรมตลอดทั้งวันซึ่งเก็บเฉพาะวันที่สิ้นสุด (ไม่ใช่วันที่และเวลา) ในช่วงต้นวันหลังจากที่กิจกรรมสิ้นสุดลงในเขตเวลาของปฏิทิน ช่วงเวลานี้ ช่วยให้เปรียบเทียบเวลาสิ้นสุดของกิจกรรมทุกประเภทได้อย่างมีความหมาย แต่ไม่ได้ จะต้องคงวันของปีเดิมไว้และไม่มีการแก้ไข
สำหรับกิจกรรมตลอดทั้งวัน getAllDayEndDate()
ควร
จะเรียกใช้วิธีนี้เสมอ
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:00 PM and 5:00 PM. const event = calendar.getEvents(new Date('Feb 01, 2023 16:00:00'), new Date('Feb 01, 2023 17:00:00'))[0]; if (event) { // If an event exists within the given time frame, gets the date and time at which the // event ends and logs it. console.log(event.getEndTime()); } else { // If no event exists within the given time frame, logs that info to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Date
— เวลาสิ้นสุดของกิจกรรมนี้ในปฏิทิน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventSeries()
รับชุดกิจกรรมที่เกิดซ้ำที่มีกิจกรรมนี้อยู่ คุณต้องมีสิทธิ์เข้าถึง
ปฏิทิน ระบบแสดงผลออบเจ็กต์ CalendarEventSeries
แม้ว่าเหตุการณ์นี้จะไม่ได้อยู่ในกลุ่ม
เพื่อให้คุณเพิ่มการตั้งค่าการเกิดซ้ำใหม่ได้
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 18th, 2023 that takes place between // 1:00 PM and 2:00 PM. const event = calendar.getEvents(new Date('Feb 18, 2023 13:00:00'), new Date('Feb 18, 2023 14:00:00'))[0]; if (event) { // If an event exists within the given time frame, gets the event series for the event // and sets the color to pale green. event.getEventSeries().setColor(CalendarApp.EventColor.PALE_GREEN); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
CalendarEventSeries
— ชุดกิจกรรมที่เป็นเจ้าของกิจกรรมนี้ หรือชุดกิจกรรมใหม่หากยังไม่มี
ลงในชุด
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getGuestByEmail(email)
รับผู้เข้าร่วมทางอีเมล
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 25th, 2023 that takes place // between 5:00 PM and 5:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 25,2023 17:00:00'), new Date('Feb 25,2023 17:25:00'))[0]; // Gets a guest by email address. const guestEmailId = event.getGuestByEmail('alex@example.com'); // If the email address corresponds to an event guest, logs the email address. if (guestEmailId) { console.log(guestEmailId.getEmail()); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
email | String | ที่อยู่ของผู้เข้าร่วม |
รีเทิร์น
EventGuest
— ผู้มาเยือนหรือมีค่าว่างหากอีเมลไม่ตรงกับผู้มาเยือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
getGuestList()
รับผู้เข้าร่วมกิจกรรม แต่ไม่รวมเจ้าของกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 25th, 2023 that takes place // between 5:00 PM and 5:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 25,2023 17:00:00'), new Date('Feb 25,2023 17:25:00'))[0]; // Adds two guests to the event by using their email addresses. event.addGuest('alex@example.com'); event.addGuest('cruz@example.com'); // Gets the guests list for the event. const guestList = event.getGuestList(); // Loops through the list to get all the guests and logs their email addresses. for (const guest of guestList){ console.log(guest.getEmail()); }
รีเทิร์น
EventGuest[]
— อาร์เรย์ของผู้มาเยือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getGuestList(includeOwner)
รับผู้เข้าร่วมกิจกรรม ซึ่งอาจรวมถึงเจ้าของกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 25th, 2023 that takes place // between 5:00 PM and 5:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 25,2023 17:00:00'), new Date('Feb 25,2023 17:25:00'))[0]; // Gets the guests list for the event, including the owner of the event. const guestList = event.getGuestList(true); // Loops through the list to get all the guests and logs it. for (const guest of guestList) { console.log(guest.getEmail()); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
includeOwner | Boolean | จะรวมเจ้าของเป็นผู้มาเยือนหรือไม่ |
รีเทิร์น
EventGuest[]
— อาร์เรย์ของผู้มาเยือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getId()
รับ iCalUID ที่ไม่ซ้ำกันของเหตุการณ์ โปรดทราบว่า iCalUID และเหตุการณ์ id
ที่ใช้โดย
ปฏิทิน v3 API และบริการขั้นสูงของปฏิทินไม่เหมือนกันและ
ไม่สามารถใช้แทนกันได้ ความแตกต่างอย่างหนึ่งในความหมายของคำเหล่านี้ก็คือ ในกิจกรรมที่เกิดซ้ำ
ทุกรายการของเหตุการณ์หนึ่งมี ids
ที่แตกต่างกันในขณะที่ทั้งหมดใช้ iCalUID เดียวกัน
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for January 5th, 2023 that takes place // between 9:00 AM and 9:25 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Jan 05, 2023 09:00:00'), new Date('Jan 05, 2023 09:25:00'))[0]; // Gets the ID of the event and logs it. console.log(event.getId());
รีเทิร์น
String
— iCalUID ของเหตุการณ์
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getLastUpdated()
รับวันที่ที่กิจกรรมได้รับการอัปเดตล่าสุด
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place between 4:00 PM and 5:00 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:00:00'), new Date('Feb 01, 2023 17:00:00'))[0]; // Gets the date the event was last updated and logs it. const eventUpdatedDate = event.getLastUpdated(); console.log(eventUpdatedDate);
รีเทิร์น
Date
— วันที่อัปเดตล่าสุด
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getLocation()
รับข้อมูลตำแหน่งของกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, sets the location of the event to Mumbai. event.setLocation('Mumbai'); // Gets the location of the event and logs it. const eventLocation = event.getLocation(); console.log(eventLocation); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
String
— สถานที่จัดกิจกรรม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getMyStatus()
ดูสถานะกิจกรรม (เช่น เข้าร่วมหรือได้รับเชิญ) ของผู้ใช้ที่มีผล แสดงผลเสมอ
GuestStatus.OWNER
หากผู้ใช้ที่มีผลเป็นเจ้าของกิจกรรม
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, gets the event status of // the effective user and logs it. const myStatus = event.getMyStatus(); console.log(myStatus.toString()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
GuestStatus
— สถานะ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getOriginalCalendarId()
รับรหัสของปฏิทินที่สร้างกิจกรรมนี้ขึ้นในตอนแรก
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 25th, 2023 that takes place // between 4:00 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 25,2023 16:00:00'), new Date('Feb 25,2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, gets the ID of the calendar where the // event was originally created and logs it. const calendarId = event.getOriginalCalendarId(); console.log(calendarId); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
String
— รหัสของปฏิทินเดิม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getPopupReminders()
รับค่านาทีสำหรับการแจ้งเตือนแบบป๊อปอัปทั้งหมดของกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 4th, 2023 that takes place // between 5:05 PM and 5:35 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 04, 2023 17:05:00'), new Date('Feb 04, 2023 17:35:00'))[0]; if (event) { // If an event exists within the given time frame, adds two pop-up reminders to the event. // The first reminder pops up 5 minutes before the event starts and the second reminder // pops up 3 minutes before the event starts. event.addPopupReminder(3); event.addPopupReminder(5); // Gets the minute values for all pop-up reminders for the event and logs it. const popUpReminder = event.getPopupReminders(); console.log(popUpReminder); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Integer[]
— อาร์เรย์ที่แต่ละค่าตรงกับจำนวนนาทีก่อนเกิดเหตุการณ์ที่
ทริกเกอร์การช่วยเตือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getSmsReminders()
รับค่านาทีสำหรับการช่วยเตือนทาง SMS ทั้งหมดสำหรับกิจกรรม
รีเทิร์น
Integer[]
— อาร์เรย์ที่แต่ละค่าตรงกับจำนวนนาทีก่อนเกิดเหตุการณ์ที่
ทริกเกอร์การช่วยเตือน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getStartTime()
รับข้อมูลวันที่และเวลาที่กิจกรรมในปฏิทินนี้เริ่มต้น สำหรับกิจกรรมที่ไม่ใช่กิจกรรมตลอดทั้งวัน ค่านี้ คือช่วงเวลาที่เหตุการณ์ถูกกำหนดให้เริ่มต้น สำหรับกิจกรรมตลอดทั้งวัน เก็บวันที่เริ่มต้น (ไม่ใช่วันที่และเวลา) ซึ่งก็คือเที่ยงคืนของช่วงต้นวันที่ซึ่ง กิจกรรมจะเริ่มต้นในเขตเวลาของปฏิทิน ซึ่งช่วยให้สามารถเปรียบเทียบ เวลาเริ่มต้นสำหรับกิจกรรมทุกประเภท แต่ไม่ได้เก็บต้นฉบับไว้ วันของปีที่ไม่มีการแก้ไข
สำหรับกิจกรรมตลอดทั้งวัน getAllDayStartDate()
ควร
มักจะถูกเรียกใช้มากกว่าวิธีนี้
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; // Gets the date and time at which this calendar event begins and logs it. const startTime = event.getStartTime(); console.log(startTime);
รีเทิร์น
Date
— เวลาเริ่มต้นของกิจกรรมนี้ในปฏิทิน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getTag(key)
รับค่าแท็กของเหตุการณ์
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์ |
รีเทิร์น
String
— ค่าแท็ก
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getTitle()
รับชื่อกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for January 31st, 2023 that takes place // between 9:05 AM and 9:15 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Jan 31, 2023 09:05:00'), new Date('Jan 31, 2023 09:15:00'))[0]; if (event) { // If an event exists within the given time frame, logs the title of the event. console.log(event.getTitle()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
String
— ชื่อ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getVisibility()
รับข้อมูลระดับการเข้าถึงกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, gets the visibility of the event // and logs it. const eventVisibility = event.getVisibility(); console.log(eventVisibility.toString()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Visibility
— ค่าการแสดงผล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
guestsCanInviteOthers()
กำหนดว่าผู้เข้าร่วมสามารถเชิญผู้เข้าร่วมอื่นได้หรือไม่
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 9:35 AM and 9:40 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 09:35:00'), new Date('Feb 01, 2023 09:40:00'))[0]; if (event) { // If an event exists within the given time frame, determines whether guests can invite // other guests and logs it. console.log(event.guestsCanInviteOthers()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Boolean
— true
หากผู้เข้าร่วมสามารถเชิญคนอื่นได้ false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
guestsCanModify()
กำหนดว่าผู้เข้าร่วมจะแก้ไขกิจกรรมได้หรือไม่
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 9:35 AM and 9:40 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 09:35:00'), new Date('Feb 01, 2023 09:40:00'))[0]; if (event) { // If an event exists within the given time frame, sets the event so that guests can't // modify it. event.setGuestsCanModify(false); // Determines whether guests can modify the event and logs it. console.log(event.guestsCanModify()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Boolean
— true
หากผู้เข้าร่วมแก้ไขกิจกรรมได้ false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
guestsCanSeeGuests()
กำหนดว่าผู้เข้าร่วมจะเห็นผู้เข้าร่วมคนอื่นๆ หรือไม่
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 9:35 AM and 9:40 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 09:35:00'), new Date('Feb 01, 2023 09:40:00'))[0]; if (event) { // If an event exists within the given time frame, determines whether guests can see other // guests and logs it. console.log(event.guestsCanSeeGuests()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Boolean
— true
หากผู้เข้าร่วมมองเห็นผู้เข้าร่วมรายอื่นได้ false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isAllDayEvent()
กำหนดว่าเป็นกิจกรรมตลอดทั้งวันหรือไม่
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for January 31st, 2023 that takes place // between 9:05 AM and 9:15 AM. const event = calendar.getEvents(new Date('Jan 31, 2023 09:05:00'), new Date('Jan 31, 2023 09:15:00'))[0]; // Determines whether this event is an all-day event and logs it. console.log(event.isAllDayEvent());
รีเทิร์น
Boolean
— true
หากเป็นกิจกรรมตลอดทั้งวัน false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isOwnedByMe()
กำหนดว่าคุณเป็นเจ้าของกิจกรรมหรือไม่
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for January 31st, 2023 that takes place // between 9:05 AM and 9:15 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Jan 31, 2023 09:05:00'), new Date('Jan 31, 2023 09:15:00'))[0]; if (event) { // If an event exists within the given time frame, determines whether you're the owner // of the event and logs it. console.log(event.isOwnedByMe()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Boolean
— true
หากกิจกรรมเป็นของผู้ใช้ที่มีผล false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isRecurringEvent()
กำหนดว่ากิจกรรมเป็นส่วนหนึ่งของชุดกิจกรรมหรือไม่
// Opens the calendar by its ID. You must have view access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for Januart 31st, 2023 that takes place // between 9:00 AM and 10:00 AM. const event = calendar.getEvents(new Date('Jan 31, 2023 09:00:00'), new Date('Jan 31, 2023 10:00:00'))[0]; if (event) { // If an event exists within the given time frame, determines whether the event is part of an // event series and logs it. console.log(event.isRecurringEvent()); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
Boolean
— true
หากกิจกรรมเป็นส่วนหนึ่งของชุดกิจกรรม false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
removeAllReminders()
ลบการแจ้งเตือนทั้งหมดออกจากกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 1,2023 16:10:00'), new Date('Feb 1,2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, removes all reminders from the event. event.removeAllReminders(); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
removeGuest(email)
นำผู้เข้าร่วมออกจากกิจกรรม
// Example 1: Remove a guest from one event function removeGuestFromEvent() { // Replace the below values with your own let attendeeEmail = 'user@example.com'; // Email address of the person you need to remove let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar containing event let eventId = '123abc'; // ID of event instance let calendar = CalendarApp.getCalendarById(calendarId); if (calendar === null) { // Calendar not found console.log('Calendar not found', calendarId); return; } let event = calendar.getEventById(eventId); if (event === null) { // Event not found console.log('Event not found', eventId); return; } event.removeGuest(attendeeEmail); } // Example 2: Remove a guest from all events on a calendar within a specified timeframe function removeGuestFromAllEvents(){ // Replace the following values with your own let attendeeEmail = 'user@example.com'; // Email address of the person you need to remove let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar with the events let startDate = new Date("YYYY-MM-DD"); // The first date to remove the guest from the events let endDate = new Date("YYYY-MM-DD"); // The last date to remove the attendee from the events let calendar = CalendarApp.getCalendarById(calendarId); if (calendar === null) { // Calendar not found console.log('Calendar not found', calendarId); return; } // Get the events within the specified timeframe let calEvents = calendar.getEvents(startDate,endDate); console.log(calEvents.length); // Checks how many events are found // Loop through all events and remove the attendee from each of them for (var i = 0; i < calEvents.length; i++) { let event = calEvents[i]; event.removeGuest(attendeeEmail); } }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
email | String | อีเมลของผู้เข้าร่วม |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
resetRemindersToDefault()
รีเซ็ตการช่วยเตือนโดยใช้การตั้งค่าเริ่มต้นของปฏิทิน
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 1, 2023 16:10:00'), new Date('Feb 1, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, resets the reminders using the calendar's // default settings. event.resetRemindersToDefault(); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setAllDayDate(date)
กำหนดวันที่ของกิจกรรม การใช้วิธีนี้จะเปลี่ยนกิจกรรมปกติเป็นกิจกรรมตลอดทั้งวัน
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 17th, 2023 that takes place // between 4:00 PM and 5:00 PM. const event = calendar.getEvents(new Date('Feb 17, 2023 16:00:00'), new Date('Feb 17, 2023 17:00:00'))[0]; if (event) { // If an event exists within the given time frame, sets the date of the event and updates // it to an all-day event. event.setAllDayDate(new Date('Feb 17, 2023')); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ของเหตุการณ์ (ไม่สนใจเวลา) |
รีเทิร์น
CalendarEvent
— CalendarEvent สำหรับห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setAllDayDates(startDate, endDate)
กำหนดวันที่ของกิจกรรม การใช้วิธีนี้จะเปลี่ยนกิจกรรมปกติเป็นกิจกรรมตลอดทั้งวัน กิจกรรม
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 18th, 2023 that takes place // between 4:00 PM and 5:00 PM. const event = calendar.getEvents(new Date('Feb 18, 2023 16:00:00'), new Date('Feb 18, 2023 17:00:00'))[0]; if (event) { // If an event exists within the given time frame, sets the event to be an all-day event from // Feb 18th, 2023 until Feb 25th, 2023. Applying this method changes a regular event into an // all-day event. event.setAllDayDates(new Date('Feb 18, 2023'), new Date('Feb 25, 2023')); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
startDate | Date | วันที่ที่กิจกรรมเริ่มต้น (ไม่สนใจเวลา) |
endDate | Date | วันที่ที่กิจกรรมสิ้นสุดลง (ไม่สนใจเวลา) |
รีเทิร์น
CalendarEvent
— CalendarEvent สำหรับห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setAnyoneCanAddSelf(anyoneCanAddSelf)
ตั้งค่าว่าผู้ที่ไม่ใช่ผู้เข้าร่วมจะเพิ่มตนเองในกิจกรรมได้หรือไม่
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 15th, 2023 that takes place // between 3:30 PM and 4:30 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 15, 2023 15:30:00'), new Date('Feb 15, 2023 16:30:00'))[0]; if (event) { // If an event exists within the given time frame, sets the event so that non-guests // can't add themselves to the event. event.setAnyoneCanAddSelf(false); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
anyoneCanAddSelf | Boolean | ทุกคนสามารถเชิญตัวเอง |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setColor(color)
ตั้งค่าสีของกิจกรรมในปฏิทิน
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, sets the color of the calendar event to // green. event.setColor(CalendarApp.EventColor.GREEN); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | ดัชนีสีแบบจำนวนเต็มเป็นสตริง หรือค่าจาก CalendarApp.EventColor |
รีเทิร์น
CalendarEvent
— กิจกรรมในปฏิทินนี้สำหรับเชนธุรกิจ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setDescription(description)
ตั้งค่าคำอธิบายกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 4th, 2023 that takes place // between 5:05 PM and 5:35 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 04, 2023 17:05:00'), new Date('Feb 04, 2023 17:35:00'))[0]; if (event) { // If an event exists within the given time frame, sets the description of the event to // 'Meeting.' event.setDescription('Meeting'); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
description | String | คำอธิบายใหม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setGuestsCanInviteOthers(guestsCanInviteOthers)
ตั้งค่าว่าผู้เข้าร่วมสามารถเชิญผู้เข้าร่วมอื่นได้หรือไม่
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. You must have edit access to the calendar. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 9:35 AM and 9:40 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 09:35:00'), new Date('Feb 01, 2023 09:40:00'))[0]; if (event) { // If an event exists within the given time frame, sets the event so that guests can invite // other guests. event.setGuestsCanInviteOthers(true); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
guestsCanInviteOthers | Boolean | ผู้เข้าร่วมสามารถเชิญบุคคลอื่นได้หรือไม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setGuestsCanModify(guestsCanModify)
ตั้งค่าว่าผู้เข้าร่วมจะแก้ไขกิจกรรมได้หรือไม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
guestsCanModify | Boolean | ผู้เข้าร่วมจะแก้ไขกิจกรรมได้หรือไม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setGuestsCanSeeGuests(guestsCanSeeGuests)
ตั้งค่าว่าผู้เข้าร่วมจะเห็นผู้เข้าร่วมรายอื่นหรือไม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
guestsCanSeeGuests | Boolean | ผู้เข้าร่วมจะเห็นผู้อื่นได้หรือไม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setLocation(location)
ตั้งค่าสถานที่ของกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, sets the location of the event to Noida. event.setLocation('Noida'); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
location | String | สถานที่ใหม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setMyStatus(status)
ตั้งค่าสถานะกิจกรรม (เช่น เข้าร่วมหรือได้รับเชิญ) ของผู้ใช้ที่มีผล
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for February 1st, 2023 that takes place // between 4:10 PM and 4:25 PM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Feb 01, 2023 16:10:00'), new Date('Feb 01, 2023 16:25:00'))[0]; if (event) { // If an event exists within the given time frame, sets the event status for the current user to maybe. event.setMyStatus(CalendarApp.GuestStatus.MAYBE); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
status | GuestStatus | สถานะใหม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
setTag(key, value)
ตั้งค่าแท็กคีย์/ค่าในเหตุการณ์เพื่อจัดเก็บข้อมูลเมตาที่กำหนดเอง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์แท็ก |
value | String | ค่าแท็ก |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setTime(startTime, endTime)
ตั้งค่าวันที่และเวลาสำหรับการเริ่มต้นและสิ้นสุดของกิจกรรม การใช้วิธีการนี้จะเปลี่ยนแปลง กิจกรรมตลอดทั้งวันเป็นกิจกรรมปกติ
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Declares a start time of 11:00 AM on February 20th, 2023 and an end time of 12:00 PM on // February 20th, 2023. const startTime = new Date('Feb 20,2023 11:00:00'); const endTime = new Date('Feb 20, 2023 12:00:00'); // Creates an all-day event on February 20th, 2023. const event = calendar.createAllDayEvent('Meeting', new Date('Feb 20,2023')); // Updates the all-day event to a regular event by setting a start and end time for the event. event.setTime(startTime, endTime);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
startTime | Date | การเริ่มต้นกิจกรรมใหม่ |
endTime | Date | ตอนจบใหม่ของกิจกรรม |
รีเทิร์น
CalendarEvent
— CalendarEvent สำหรับห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setTitle(title)
ตั้งชื่อกิจกรรม
// Opens the calendar by its ID. You must have edit access to the calendar. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Gets the first event from the calendar for January 31st, 2023 that takes place // between 9:05 AM and 9:15 AM. // For an event series, use calendar.getEventSeriesById('abc123456@google.com'); // and replace the series ID with your own. const event = calendar.getEvents(new Date('Jan 31, 2023 09:05:00'), new Date('Jan 31, 2023 09:15:00'))[0]; if (event) { // If an event exists within the given time frame, changes its title to Event1. event.setTitle('Event1'); } else { // If no event exists within the given time frame, logs that information to the console. console.log('No events exist for the specified range'); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | ชื่อใหม่ |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setVisibility(visibility)
ตั้งค่าระดับการเข้าถึงกิจกรรม
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
visibility | Visibility |
รีเทิร์น
CalendarEvent
— CalendarEvent
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds