Freebusy: query

返回一组日历的有空/忙碌信息。 立即试用。

请求

HTTP 请求

POST https://www.googleapis.com/calendar/v3/freeBusy

授权

此请求允许获得以下至少一个范围的授权：

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

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

请求正文

在请求正文中，请按以下结构提供数据：

{
  "timeMin": datetime,
  "timeMax": datetime,
  "timeZone": string,
  "groupExpansionMax": integer,
  "calendarExpansionMax": integer,
  "items": [
    {
      "id": string
    }
  ]
}
属性名称 值 说明 备注
timeMin datetime 查询的间隔开始时间，采用 RFC3339 格式。
timeMax datetime 查询的间隔结束时间，采用 RFC3339 格式。
timeZone string 响应中使用的时区。可选。默认值为 UTC。
groupExpansionMax integer 为单个群组提供的日历标识符的数量上限。可选。如果群组的成员数超过此值，系统会返回错误。最大值为 100。
calendarExpansionMax integer 要提供空闲/忙碌信息的日历的数量上限。可选。最大值为 50。
items[] list 要查询的日历和/或群组的列表。
items[].id string 日历或群组的标识符。

响应

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

{
  "kind": "calendar#freeBusy",
  "timeMin": datetime,
  "timeMax": datetime,
  "groups": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "calendars": [
        string
      ]
    }
  },
  "calendars": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "busy": [
        {
          "start": datetime,
          "end": datetime
        }
      ]
    }
  }
}
属性名称 值 说明 备注
kind string 资源的类型（“calendar#freeBusy”）。
timeMin datetime 时间段的开始时间。
timeMax datetime 间隔时段的结束时间。
groups object 群组扩展。
groups.(key) nested object 此群组的成员日历列表。
groups.(key).errors[] list 可选错误（如果组的计算失败）。
groups.(key).errors[].domain string 错误的领域或大致类别。
groups.(key).errors[].reason string 错误的具体原因。可能的值包括：
  • “groupTooBig”- 请求的用户群组太大，无法通过单个查询完成。
  • “tooManyCalendarsRequested”- 请求的日历数量过多，超出了单个查询的限制。
  • “notFound”- 找不到所请求的资源。
  • “internalError”- API 服务遇到了内部错误。
未来可能会添加其他错误类型，因此客户端应妥善处理此列表中未包含的其他错误状态。
groups.(key).calendars[] list 群组中日历的标识符列表。
calendars object 日历的有空/忙碌信息列表。
calendars.(key) nested object 单个日历的有空/忙碌状态展开。
calendars.(key).errors[] list 可选错误（如果日历计算失败）。
calendars.(key).errors[].domain string 错误的领域或大致类别。
calendars.(key).errors[].reason string 错误的具体原因。可能的值包括：
  • “groupTooBig”- 请求的用户群组太大，无法通过单个查询完成。
  • “tooManyCalendarsRequested”- 请求的日历数量过多，超出了单个查询的限制。
  • “notFound”- 找不到所请求的资源。
  • “internalError”- API 服务遇到了内部错误。
未来可能会添加其他错误类型，因此客户端应妥善处理此列表中未包含的其他错误状态。
calendars.(key).busy[] list 应将此日历视为繁忙的时段列表。
calendars.(key).busy[].start datetime 时间段的开始时间（含）。
calendars.(key).busy[].end datetime 时间段的结束时间（不含此时间）。

试试看！

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