建立事件

假設有一個應用程式可協助使用者找到最佳健行路線，將 比起將健行行程 當做日曆活動，使用者無論如何都很方便 自動整理。Google 日曆有助他們分享計畫 可以提醒他們注意壓力，讓他們在毫無壓力的情況下做好準備。此外，感謝 Google 即時資訊完美整合各項 Google 產品，即時掌握最新資訊 就會準時離開，Google 地圖就會引導他們準時前往會議地點。

本文將說明如何建立日曆活動並新增至使用者的 日曆。

新增活動

如要建立事件，請呼叫 events.insert() 方法提供以下功能： 至少以下參數：

• calendarId 是日曆 ID，可以是電子郵件地址 要建立活動或特殊關鍵字的日曆 'primary'，系統會使用已登入使用者的主要日曆。如果 你不知道要使用的日曆電子郵件地址，你 可以在 Google 日曆網頁版的日曆設定中查看 (位於「日曆網址」部分)，或者查詢 結果 calendarList.list() 呼叫。
• event 是要建立的事件，包含 start 等所有必要詳細資料 和結尾只有兩個必填欄位是 start 和 end 次。詳情請參閱 完整事件的 event 參考資料 只要使用來自這些領域的 小型資料集訓練即可
  使用 start.dateTime 指定定時事件 和 end.dateTime 欄位如果是全天活動，請使用 請改為使用 start.date 和 end.date。

如要成功建立事件，您必須：

• 將 OAuth 範圍設為 https://www.googleapis.com/auth/calendar，即可 您有使用者日曆的編輯權限。
• 使用 您提供的 calendarId (例如： calendarList.get() 適用於 calendarId 並檢查 accessRole)。

新增事件中繼資料

建立日曆活動時，您可以選擇新增活動中繼資料。如果發生以下情況： 建立時選擇不新增中繼資料，您可以使用 events.update()；但針對部分欄位 例如事件 ID，只能在 events.insert() 作業。

位置

在地點欄位新增地址後，您就能啟用下列功能：

「出發提醒」或是顯示含有路線的地圖

事件 ID

建立活動時，你可以選擇自行產生活動 ID

必須符合我們的格式規定這讓您可以保留 本機資料庫內的資料，與 Google 日曆中的活動保持同步。此外， 如果作業在之後的某個時間點失敗，則避免建立重複的事件 但會在日曆後端成功執行如果答案為「否」 事件 ID 則由伺服器產生。查看事件 ID 參考資料。

參與者

您建立的活動會顯示在以下位置的所有主要 Google 日曆中

包含相同活動 ID 的與會者。如果您為 並傳送插入要求給true sendNotifications，與會者將 也會收到活動的電子郵件通知。請查看含有 多位與會者指南 瞭解詳情

下列範例說明如何建立活動及設定活動中繼資料：

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'))

小茹

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. 從 取得檔案 alternateLink 網址、title 和 mimeType Drive API 檔案資源，一般 呼叫 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. 傳統版 Hangouts Google Workspace 使用者 (已淘汰；eventNamedHangout)
3. Google Meet (hangoutsMeet)

您可以在 使用者conferenceProperties.allowedConferenceSolutionTypes calendars和 calendarList 集合。你也可以 瞭解使用者是否要為所有新使用者建立 Hangouts 方法是查看autoAddHangouts settings 集合。

除了 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；表示該區的狀態碼為 pending 狀態 ] 欄位。會議資訊結束後，狀態碼會變更為 success 。entryPoints 欄位包含影片的相關資訊和 可以使用電話號碼 URI，讓使用者撥入會議。

如果想排定多個 你可以將單一活動的完整conferenceData複製到 另一個例子。

在某些情況下，複製功能很實用。舉例來說，假設您想開發 為求職者設定個別事件， - 你想保護面試官的形象 想確保所有參與者都加入同一個會議通話。

重要事項： 務必執行完整同步處理 啟用會議資料支援功能之前的所有活動 (方法是將 事件修改用的 conferenceDataVersion 要求參數至 1) 為儲存在本機事件的現有應用程式新增會議支援功能。如果 您沒有先執行同步處理，可能會在無意間將現有檔案 使用者的會議事件。