创建活动

假设有一款应用可以帮助用户查找最佳徒步路线。通过将徒步计划添加为日历活动，用户可以获得很多帮助来自动保持井然有序。Google 日历可以帮助他们分享和提醒他们， 让他们可以放心使用。此外，得益于 Google 产品的无缝集成，Google 即时会 ping 他们出发的时间，而 Google 地图会引导他们准时到达会面地点。

本文介绍了如何创建日历活动并将其添加到用户的日历中。

添加活动

如需创建事件，请调用 events.insert() 方法，并至少提供以下参数：

• calendarId 是日历标识符，可以是要在其中创建事件的日历的电子邮件地址，也可以是将使用登录用户的主日历的特殊关键字 'primary'。如果您不知道要使用的日历的电子邮件地址，可以在 Google 日历网页界面的日历设置（在“日历网址”部分）中查看，也可以在 calendarList.list() 调用的结果中查找。
• event 是要创建的事件，其中包含所有必要的详细信息，例如 start 和 end。仅有的两个必填字段是 start 和 end。如需了解完整的事件字段集，请参阅 event 参考文档。
  使用 start.dateTime 和 end.dateTime 字段指定计时事件。对于全天活动，请改用 start.date 和 end.date。

要成功创建事件，您需要：

• 将 OAuth 范围设置为 https://www.googleapis.com/auth/calendar，以便拥有对用户日历的修改权限。
• 通过您提供的 calendarId，确保经过身份验证的用户拥有对该日历的写入权限（例如，通过针对 calendarId 调用 calendarList.get() 并检查 accessRole）。

添加事件元数据

您可以在创建日历活动时选择添加活动元数据。如果您选择不在创建过程中添加元数据，可以使用 events.update() 更新许多字段；不过，事件 ID 等某些字段只能在 events.insert() 操作执行期间设置。

位置

在位置字段中添加地址可启用一些功能，例如：

“该出发了”或显示一幅包含路线的地图。

事件 ID

创建活动时，您可以选择生成自己的活动 ID

并且符合我们的格式要求这样，您就可以使本地数据库中的实体与 Google 日历中的活动保持同步。在日历后端成功执行某项操作后，如果该操作在某一时刻失败，还可以防止重复创建活动。如果未提供事件 ID，服务器会为您生成一个。如需了解详情，请参阅事件 ID 参考。

参加者

您创建的活动会显示在以下所有主 Google 日历中：

同一活动 ID 所关联的参加者。如果您在插入请求中将 sendNotifications 设置为 true，则参与者还会收到针对您的活动的电子邮件通知。如需了解详情，请参阅有多位参加者的活动指南。

以下示例演示了如何创建事件并设置其元数据：

Go

// Refer to the Go quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/go
// Change the scope to calendar.CalendarScope and delete any stored credentials.

event := &calendar.Event{
  Summary: "Google I/O 2015",
  Location: "800 Howard St., San Francisco, CA 94103",
  Description: "A chance to hear more about Google's developer products.",
  Start: &calendar.EventDateTime{
    DateTime: "2015-05-28T09:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  End: &calendar.EventDateTime{
    DateTime: "2015-05-28T17:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  Recurrence: []string{"RRULE:FREQ=DAILY;COUNT=2"},
  Attendees: []*calendar.EventAttendee{
    &calendar.EventAttendee{Email:"[e-mail]"},
    &calendar.EventAttendee{Email:"[e-mail]"},
  },
}

calendarId := "primary"
event, err = srv.Events.Insert(calendarId, event).Do()
if err != nil {
  log.Fatalf("Unable to create event. %v\n", err)
}
fmt.Printf("Event created: %s\n", event.HtmlLink)

Java

// Refer to the Java quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/java
// Change the scope to CalendarScopes.CALENDAR and delete any stored
// credentials.

Event event = new Event()
    .setSummary("Google I/O 2015")
    .setLocation("800 Howard St., San Francisco, CA 94103")
    .setDescription("A chance to hear more about Google's developer products.");

DateTime startDateTime = new DateTime("2015-05-28T09:00:00-07:00");
EventDateTime start = new EventDateTime()
    .setDateTime(startDateTime)
    .setTimeZone("America/Los_Angeles");
event.setStart(start);

DateTime endDateTime = new DateTime("2015-05-28T17:00:00-07:00");
EventDateTime end = new EventDateTime()
    .setDateTime(endDateTime)
    .setTimeZone("America/Los_Angeles");
event.setEnd(end);

String[] recurrence = new String[] {"RRULE:FREQ=DAILY;COUNT=2"};
event.setRecurrence(Arrays.asList(recurrence));

EventAttendee[] attendees = new EventAttendee[] {
    new EventAttendee().setEmail("[e-mail]"),
    new EventAttendee().setEmail("[e-mail]"),
};
event.setAttendees(Arrays.asList(attendees));

EventReminder[] reminderOverrides = new EventReminder[] {
    new EventReminder().setMethod("email").setMinutes(24 * 60),
    new EventReminder().setMethod("popup").setMinutes(10),
};
Event.Reminders reminders = new Event.Reminders()
    .setUseDefault(false)
    .setOverrides(Arrays.asList(reminderOverrides));
event.setReminders(reminders);

String calendarId = "primary";
event = service.events().insert(calendarId, event).execute();
System.out.printf("Event created: %s\n", event.getHtmlLink());

JavaScript

// Refer to the JavaScript quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/js
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

const event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': '[e-mail]'},
    {'email': '[e-mail]'}
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10}
    ]
  }
};

const request = gapi.client.calendar.events.insert({
  'calendarId': 'primary',
  'resource': event
});

request.execute(function(event) {
  appendPre('Event created: ' + event.htmlLink);
});

Node.js

// Refer to the Node.js quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/node
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

const event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': '[e-mail]'},
    {'email': '[e-mail]'},
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
};

calendar.events.insert({
  auth: auth,
  calendarId: 'primary',
  resource: event,
}, function(err, event) {
  if (err) {
    console.log('There was an error contacting the Calendar service: ' + err);
    return;
  }
  console.log('Event created: %s', event.htmlLink);
});

PHP

$event = new Google_Service_Calendar_Event(array(
  'summary' => 'Google I/O 2015',
  'location' => '800 Howard St., San Francisco, CA 94103',
  'description' => 'A chance to hear more about Google\'s developer products.',
  'start' => array(
    'dateTime' => '2015-05-28T09:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'end' => array(
    'dateTime' => '2015-05-28T17:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'recurrence' => array(
    'RRULE:FREQ=DAILY;COUNT=2'
  ),
  'attendees' => array(
    array('email' => '[e-mail]'),
    array('email' => '[e-mail]'),
  ),
  'reminders' => array(
    'useDefault' => FALSE,
    'overrides' => array(
      array('method' => 'email', 'minutes' => 24 * 60),
      array('method' => 'popup', 'minutes' => 10),
    ),
  ),
));

$calendarId = 'primary';
$event = $service->events->insert($calendarId, $event);
printf('Event created: %s\n', $event->htmlLink);

Python

# Refer to the Python quickstart on how to setup the environment:
# https://developers.google.com/calendar/quickstart/python
# Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
# stored credentials.

event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': '[e-mail]'},
    {'email': '[e-mail]'},
  ],
  'reminders': {
    'useDefault': False,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
}

event = service.events().insert(calendarId='primary', body=event).execute()
print 'Event created: %s' % (event.get('htmlLink'))

Ruby

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Google I/O 2015',
  location: '800 Howard St., San Francisco, CA 94103',
  description: 'A chance to hear more about Google\'s developer products.',
  start: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T09:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  end: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T17:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  recurrence: [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  attendees: [
    Google::Apis::CalendarV3::EventAttendee.new(
      email: '[e-mail]'
    ),
    Google::Apis::CalendarV3::EventAttendee.new(
      email: '[e-mail]'
    )
  ],
  reminders: Google::Apis::CalendarV3::Event::Reminders.new(
    use_default: false,
    overrides: [
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'email',
        minutes: 24 * 60
      ),
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'popup',
        minutes: 10
      )
    ]
  )
)

result = client.insert_event('primary', event)
puts "Event created: #{result.html_link}"

为活动添加云端硬盘附件

您可以将 Google 云端硬盘文件（例如 Google 文档中的会议记录、Google 表格中的预算、Google 幻灯片中的演示文稿或任何其他相关的 Google 云端硬盘文件）附加到日历活动。您可以在使用 events.insert() 创建事件时添加连接，也可以在更新期间（例如使用 events.patch()）后添加连接。

将 Google 云端硬盘文件附加到活动的过程包含两个部分：

1. 从 Drive API 文件资源中获取文件 alternateLink 网址、title 和 mimeType，通常使用 files.get() 方法。
2. 若要创建或更新事件，请在请求正文中设置 attachments 字段，并将 supportsAttachments 参数设置为 true。

以下代码示例演示了如何更新现有事件以添加连接：

Java

public static void addAttachment(Calendar calendarService, Drive driveService, String calendarId,
    String eventId, String fileId) throws IOException {
  File file = driveService.files().get(fileId).execute();
  Event event = calendarService.events().get(calendarId, eventId).execute();

  List<EventAttachment> attachments = event.getAttachments();
  if (attachments == null) {
    attachments = new ArrayList<EventAttachment>();
  }
  attachments.add(new EventAttachment()
      .setFileUrl(file.getAlternateLink())
      .setMimeType(file.getMimeType())
      .setTitle(file.getTitle()));

  Event changes = new Event()
      .setAttachments(attachments);
  calendarService.events().patch(calendarId, eventId, changes)
      .setSupportsAttachments(true)
      .execute();
}

PHP

function addAttachment($calendarService, $driveService, $calendarId, $eventId, $fileId) {
  $file = $driveService->files->get($fileId);
  $event = $calendarService->events->get($calendarId, $eventId);
  $attachments = $event->attachments;

  $attachments[] = array(
    'fileUrl' => $file->alternateLink,
    'mimeType' => $file->mimeType,
    'title' => $file->title
  );
  $changes = new Google_Service_Calendar_Event(array(
    'attachments' => $attachments
  ));

  $calendarService->events->patch($calendarId, $eventId, $changes, array(
    'supportsAttachments' => TRUE
  ));
}

Python

def add_attachment(calendarService, driveService, calendarId, eventId, fileId):
    file = driveService.files().get(fileId=fileId).execute()
    event = calendarService.events().get(calendarId=calendarId,
                                         eventId=eventId).execute()

    attachments = event.get('attachments', [])
    attachments.append({
        'fileUrl': file['alternateLink'],
        'mimeType': file['mimeType'],
        'title': file['title']
    })

    changes = {
        'attachments': attachments
    }
    calendarService.events().patch(calendarId=calendarId, eventId=eventId,
                                   body=changes,
                                   supportsAttachments=True).execute()

重要提示： 向在本地存储事件的现有应用添加附件支持时，您必须先对所有事件执行完整同步，然后才能为事件修改启用 supportsAttachments 参数。如果您未先执行同步，则可能会无意中从用户活动中移除现有连接。

为活动添加视频和电话会议

您可以将活动与 Hangouts 和 Google Meet 会议关联，让您的用户通过电话或视频通话进行远程会议。

conferenceData 字段可用于读取、复制和清除现有会议详细信息，也可用于请求生成新会议。如需允许创建和修改会议详细信息，请将 conferenceDataVersion 请求参数设置为 1。

目前支持三种类型的 conferenceData（以 conferenceData.conferenceSolution.key.type 表示）：

1. 个人用户版 Hangouts (eventHangout)
2. 面向 Google Workspace 用户的传统版 Hangouts （已弃用；eventNamedHangout）
3. Google Meet (hangoutsMeet)

您可以查看 calendars 和 calendarList 集合中的 conferenceProperties.allowedConferenceSolutionTypes，了解用户的任何给定日历支持哪种会议类型。您还可以通过检查 settings 集合中的 autoAddHangouts 设置，了解用户是否希望为其所有新创建的活动创建 Hangouts。

除了 type 之外，conferenceSolution 还提供 name 和 iconUri 字段，可用于表示会议解决方案，如下所示：

JavaScript

const solution = event.conferenceData.conferenceSolution;

const content = document.getElementById("content");
const text = document.createTextNode("Join " + solution.name);
const icon = document.createElement("img");
icon.src = solution.iconUri;

content.appendChild(icon);
content.appendChild(text);

如需为活动创建新会议，您可以提供一个 createRequest，并提供新生成的 requestId（可以是随机 string）。会议是异步创建的，但您可以随时查看请求的状态，让用户了解最新动态。

例如，如需为现有活动请求生成会议，请使用以下代码：

JavaScript

const eventPatch = {
  conferenceData: {
    createRequest: {requestId: "7qxalsvy0e"}
  }
};

gapi.client.calendar.events.patch({
  calendarId: "primary",
  eventId: "7cbh8rpc10lrc0ckih9tafss99",
  resource: eventPatch,
  sendNotifications: true,
  conferenceDataVersion: 1
}).execute(function(event) {
  console.log("Conference created for event: %s", event.htmlLink);
});

对此调用的即时响应可能尚未包含完全填充的 conferenceData；这由 status 字段中的状态代码 pending 表示。填充会议信息后，状态代码将更改为 success。entryPoints 字段包含有关用户可以拨号加入的视频 URI 和电话 URI 的信息。

如果您想要使用相同的会议详细信息安排多个日历活动，则可以将整个 conferenceData 从一个活动复制到另一个活动中。

复制操作在某些情况下非常有用。例如，假设您正在开发一款为候选人和面试者设置不同活动的招聘应用，您不仅希望保护面试者的身份，还希望确保所有参与者都加入同一场电话会议。

重要提示 ：在向本地存储活动的现有应用添加会议支持时，您必须先对所有活动执行完全同步，然后才能启用会议数据支持（通过将 conferenceDataVersion 请求参数设置为 1 以进行活动修改）。如果不先执行同步，您可能会无意中从用户活动中移除现有会议。