通过高级日历服务，您可以在 Apps 脚本中使用公共 Google Calendar API。与 Apps 脚本的内置日历服务非常相似，此 API 允许脚本访问和修改用户的 Google 日历，包括用户订阅的其他日历。在大多数情况下，内置服务更易于使用，但此高级服务提供了一些额外的功能，包括为各个活动设置背景颜色。
参考
如需详细了解此服务，请参阅公共 Google 日历 API 的参考文档。与 Apps 脚本中的所有高级服务一样，高级日历服务使用的对象、方法和参数均与公共 API 相同。如需了解详情，请参阅方法签名是如何确定的。
/** * Creates an event in the user's default calendar. * @see https://developers.google.com/calendar/api/v3/reference/events/insert */functioncreateEvent(){constcalendarId='primary';conststart=getRelativeDate(1,12);constend=getRelativeDate(1,13);// event details for creating event.letevent={summary:'Lunch Meeting',location:'The Deli',description:'To discuss our plans for the presentation next week.',start:{dateTime:start.toISOString()},end:{dateTime:end.toISOString()},attendees:[{email:'[email protected]'},{email:'[email protected]'}],// Red background. Use Calendar.Colors.get() for the full list.colorId:11};try{// call method to insert/create new event in provided calandarevent=Calendar.Events.insert(event,calendarId);console.log('Event ID: '+event.id);}catch(err){console.log('Failed with error %s',err.message);}}/** * Helper function to get a new Date object relative to the current date. * @param {number} daysOffset The number of days in the future for the new date. * @param {number} hour The hour of the day for the new date, in the time zone * of the script. * @return {Date} The new date. */functiongetRelativeDate(daysOffset,hour){constdate=newDate();date.setDate(date.getDate()+daysOffset);date.setHours(hour);date.setMinutes(0);date.setSeconds(0);date.setMilliseconds(0);returndate;}
/** * Lists the calendars shown in the user's calendar list. * @see https://developers.google.com/calendar/api/v3/reference/calendarList/list */functionlistCalendars(){letcalendars;letpageToken;do{calendars=Calendar.CalendarList.list({maxResults:100,pageToken:pageToken});if(!calendars.items||calendars.items.length===0){console.log('No calendars found.');return;}// Print the calendar id and calendar summaryfor(constcalendarofcalendars.items){console.log('%s (ID: %s)',calendar.summary,calendar.id);}pageToken=calendars.nextPageToken;}while(pageToken);}
/** * Creates an event in the user's default calendar, waits 30 seconds, then * attempts to update the event's location, on the condition that the event * has not been changed since it was created. If the event is changed during * the 30-second wait, then the subsequent update will throw a 'Precondition * Failed' error. * * The conditional update is accomplished by setting the 'If-Match' header * to the etag of the new event when it was created. */functionconditionalUpdate(){constcalendarId='primary';conststart=getRelativeDate(1,12);constend=getRelativeDate(1,13);letevent={summary:'Lunch Meeting',location:'The Deli',description:'To discuss our plans for the presentation next week.',start:{dateTime:start.toISOString()},end:{dateTime:end.toISOString()},attendees:[{email:'[email protected]'},{email:'[email protected]'}],// Red background. Use Calendar.Colors.get() for the full list.colorId:11};event=Calendar.Events.insert(event,calendarId);console.log('Event ID: '+event.getId());// Wait 30 seconds to see if the event has been updated outside this script.Utilities.sleep(30*1000);// Try to update the event, on the condition that the event state has not// changed since the event was created.event.location='The Coffee Shop';try{event=Calendar.Events.update(event,calendarId,event.id,{},{'If-Match':event.etag});console.log('Successfully updated event: '+event.id);}catch(e){console.log('Fetch threw an exception: '+e);}}
/** * Creates an event in the user's default calendar, then re-fetches the event * every second, on the condition that the event has changed since the last * fetch. * * The conditional fetch is accomplished by setting the 'If-None-Match' header * to the etag of the last known state of the event. */functionconditionalFetch(){constcalendarId='primary';conststart=getRelativeDate(1,12);constend=getRelativeDate(1,13);letevent={summary:'Lunch Meeting',location:'The Deli',description:'To discuss our plans for the presentation next week.',start:{dateTime:start.toISOString()},end:{dateTime:end.toISOString()},attendees:[{email:'[email protected]'},{email:'[email protected]'}],// Red background. Use Calendar.Colors.get() for the full list.colorId:11};try{// insert eventevent=Calendar.Events.insert(event,calendarId);console.log('Event ID: '+event.getId());// Re-fetch the event each second, but only get a result if it has changed.for(leti=0;i < 30;i++){Utilities.sleep(1000);event=Calendar.Events.get(calendarId,event.id,{},{'If-None-Match':event.etag});console.log('New event description: '+event.start.dateTime);}}catch(e){console.log('Fetch threw an exception: '+e);}}
/** * Retrieve and log events from the given calendar that have been modified * since the last sync. If the sync token is missing or invalid, log all * events from up to a month ago (a full sync). * * @param {string} calendarId The ID of the calender to retrieve events from. * @param {boolean} fullSync If true, throw out any existing sync token and * perform a full sync; if false, use the existing sync token if possible. */functionlogSyncedEvents(calendarId,fullSync){constproperties=PropertiesService.getUserProperties();constoptions={maxResults:100};constsyncToken=properties.getProperty('syncToken');if(syncToken && !fullSync){options.syncToken=syncToken;}else{// Sync events up to thirty days in the past.options.timeMin=getRelativeDate(-30,0).toISOString();}// Retrieve events one page at a time.letevents;letpageToken;do{try{options.pageToken=pageToken;events=Calendar.Events.list(calendarId,options);}catch(e){// Check to see if the sync token was invalidated by the server;// if so, perform a full sync instead.if(e.message==='Sync token is no longer valid, a full sync is required.'){properties.deleteProperty('syncToken');logSyncedEvents(calendarId,true);return;}thrownewError(e.message);}if(events.items && events.items.length===0){console.log('No events found.');return;}for(consteventofevents.items){if(event.status==='cancelled'){console.log('Event id %s was cancelled.',event.id);return;}if(event.start.date){conststart=newDate(event.start.date);console.log('%s (%s)',event.summary,start.toLocaleDateString());return;}// Events that don't last all day; they have defined start times.conststart=newDate(event.start.dateTime);console.log('%s (%s)',event.summary,start.toLocaleString());}pageToken=events.nextPageToken;}while(pageToken);properties.setProperty('syncToken',events.nextSyncToken);}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-04。"],[[["\u003cp\u003eThe Advanced Calendar service in Apps Script allows you to access and modify Google Calendar data using the public Google Calendar API.\u003c/p\u003e\n"],["\u003cp\u003eIt offers features beyond the built-in Calendar service, such as setting event background colors and using HTTP request headers for conditional updates and retrievals.\u003c/p\u003e\n"],["\u003cp\u003eSample code snippets demonstrate various functionalities like creating, listing, and syncing calendar events, and conditionally modifying or retrieving specific events.\u003c/p\u003e\n"],["\u003cp\u003eBefore using this advanced service, ensure it's enabled in your Apps Script project settings.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the Google Calendar API reference documentation and support guide for detailed information and troubleshooting.\u003c/p\u003e\n"]]],[],null,[]]
