此页面由 Cloud Translation API 翻译。

Events: instances

返回指定周期性活动的实例。立即试用或查看示例。

请求

HTTP 请求

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

参数

参数名称	值	说明
路径参数
`calendarId`	`string`	日历标识符。要检索日历 ID，请调用 calendarList.list 方法。如果您想访问当前登录用户的主日历，请使用“`primary`”关键字。
`eventId`	`string`	周期性活动标识符。
可选的查询参数
`alwaysIncludeEmail`	`boolean`	已弃用并忽略。系统将始终在 `email` 字段中为组织者、创建者和参加者返回一个值，即使没有可用的真实电子邮件地址（即将提供生成的无效值）也是如此。
`maxAttendees`	`integer`	响应中可包含的参加者数量上限。如果参加者人数超过指定值，则仅返回参与者。可选。
`maxResults`	`integer`	一个结果页上返回的事件数上限。默认情况下，此值为 250 个事件。页面大小永远不会超过 2500 个事件。可选。
`originalStart`	`string`	结果中实例的原始开始时间。可选。
`pageToken`	`string`	用于指定要返回的结果页面的令牌。可选。
`showDeleted`	`boolean`	是否在结果中包含已删除的事件（`status` 等于“`cancelled`”）。如果 `singleEvents` 为 False，则已取消的周期性活动实例仍将包含在内。可选。默认值为 False。
`timeMax`	`datetime`	活动开始时间的过滤条件上限（不含此上限）。可选。默认情况下，不按开始时间进行过滤。必须是带有强制性时区偏移量的 RFC3339 时间戳。
`timeMin`	`datetime`	活动结束时间的下限（含此下限），用作过滤条件。可选。默认设置是不按结束时间进行过滤。必须是带有强制性时区偏移量的 RFC3339 时间戳。
`timeZone`	`string`	响应中使用的时区。可选。默认时区为日历的时区。

授权

此请求至少允许授权以下任一范围：

范围
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.events.readonly`
`https://www.googleapis.com/auth/calendar.events`

如需了解详情，请参阅身份验证和授权页面。

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "calendar#events",
  "etag": etag,
  "summary": string,
  "description": string,
  "updated": datetime,
  "timeZone": string,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    events Resource
  ]
}

属性名称	值	说明	备注
`kind`	`string`	集合的类型（“`calendar#events`”）。
`etag`	`etag`	集合的 ETag。
`summary`	`string`	日历标题。只读。
`description`	`string`	日历说明。只读。
`updated`	`datetime`	日历的上次修改时间（以 RFC3339 时间戳表示）。只读。
`timeZone`	`string`	日历的时区。只读。
`accessRole`	`string`	用户对此日历的访问角色。只读。可能的值包括： “`none`”- 用户没有访问权限。 “`freeBusyReader`”- 用户拥有对空闲/忙碌信息的读取权限。 “`reader`”- 用户拥有对日历的读取权限。拥有读者访问权限的用户将会看到不公开活动，但活动详细信息处于隐藏状态。 “`writer`”- 用户拥有对日历的读写权限。拥有写入者权限的用户会看到不公开的活动，并且活动详细信息也会显示。 “`owner`”- 用户拥有日历的所有权。此角色拥有 writer 角色的所有权限，还拥有查看和操作 ACL 的额外权限。
`defaultReminders[]`	`list`	日历上针对经过身份验证的用户的默认提醒。这些提醒会应用于此日历上所有不会明确覆盖它们的活动（即没有将 `reminders.useDefault` 设置为 True）。
`defaultReminders[].method`	`string`	此提醒使用的方法。可能的值包括： “`email`”- 提醒通过电子邮件发送。 “`popup`”- 提醒通过 UI 弹出窗口发送。添加提醒时必填。	可写入
`defaultReminders[].minutes`	`integer`	在事件开始前多少分钟应触发提醒。有效值介于 0 到 40320 之间（4 周的分钟数）。添加提醒时必填。	可写入
`nextPageToken`	`string`	用于访问此结果的下一页的令牌。如果没有其他结果，则省略，在这种情况下提供了 `nextSyncToken`。
`items[]`	`list`	日历上的活动列表。
`nextSyncToken`	`string`	稍后用于检索自此结果返回后更改的条目的令牌。如果有其他结果，则省略，在这种情况下提供了 `nextPageToken`。

示例

注意：此方法的代码示例并未列出所有受支持的编程语言（请参阅客户端库页面，查看受支持的语言列表）。

Java

使用 Java 客户端库。

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;
import com.google.api.services.calendar.model.Events;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Iterate over the instances of a specific recurring event
String pageToken = null;
do {
  Events events =
      service.events().instances('primary', 'eventId').setPageToken(pageToken).execute();
  List<Event> items = events.getItems();
  for (Event event : items) {
    System.out.println(event.getSummary());
  }
  pageToken = events.getNextPageToken();
} while (pageToken != null);

Python

使用 Python 客户端库。

page_token = None
while True:
  events = service.events().instances(calendarId='primary', eventId='eventId',
                                      pageToken=page_token).execute()
  for event in events['items']:
    print event['summary']
  page_token = events.get('nextPageToken')
  if not page_token:
    break

PHP

使用 PHP 客户端库。

$events = $service->events->instances('primary', "eventId");

while(true) {
  foreach ($events->getItems() as $event) {
    echo $event->getSummary();
  }
  $pageToken = $events->getNextPageToken();
  if ($pageToken) {
    $optParams = array('pageToken' => $pageToken);
    $events = $service->events->instances('primary', "eventId",
        $optParams);
  } else {
    break;
  }
}

Ruby

使用 Ruby 客户端库。

page_token = nil
begin
  result = client.list_event_instances('primary', 'eventId')
  result.items.each do |e|
    print e.summary + "\n"
  end
  if result.next_page_token != page_token
    page_token = result.next_page_token
  else
    page_token = nil
  end
end while !page_token.nil?

试试看！

使用下面的 API Explorer 对实际数据调用此方法，然后查看响应。