时间戳

首页 > 解决方案 > 了解 Microsoft graph /getSchedule Api 功能

java - 了解 Microsoft graph /getSchedule Api 功能

问题描述

我正在尝试使用 graph /getSchedule api 来检查会议冲突。但是，我不太了解请求输入字段“availabilityViewInterval”的功能和用法。

我的基本要求是传递开始和结束日期时间并查看资源是否可用（空闲/忙碌）。虽然我能够在 /getSchedule Api 中得到它，但不确定请求和响应中的某些字段。

  1. “availabilityViewInterval”：这是一个请求字段，在文档中声明为可选，但在使用图形客户端时，我需要为此传递值。它接受从 5 到 1440 的 int 值，但不确定它的作用以及我应该传递的值是多少？

  2. “availabilityView”：这是一个响应字段并返回一个字符串值。但我无法理解。这个值是什么以及它是如何计算的？它有什么意义以及如何利用它？

要求：

ICalendarGetScheduleCollectionPage response = graphClient.users("usrEmailAddress").calendars(calendar.id)
                .getSchedule(schedulesList,endTime,startTime,availabilityViewInterval)
                .buildRequest()
                .post();

下面是我的示例响应（请求中的availabilityViewInterval 值均为5，但响应availabilityView 不同）：

**"availabilityView": "22"**,
      "scheduleItems": [
        {
          "isPrivate": false,
          "status": "busy",
          "subject": "Test Meeting again",
          "location": "",
          "start": {
            "dateTime": "2020-06-12T10:58:45.0000000",
            "timeZone": "UTC"
          },
          "end": {
            "dateTime": "2020-06-12T11:08:45.0000000",
            "timeZone": "UTC"
          }
        }
      ],
      "workingHours": {
        "daysOfWeek": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "startTime": "08:00:00.0000000",
        "endTime": "17:00:00.0000000",
        "timeZone": {
          "name": "India Standard Time"
        }

回应 2：

**"availabilityView": "00"**,
      "scheduleItems": [],
      "workingHours": {
        "daysOfWeek": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "startTime": "08:00:00.0000000",
        "endTime": "17:00:00.0000000",
        "timeZone": {
          "name": "India Standard Time"
        }

回应 3：

**"availabilityView": "220000000000"**,
      "scheduleItems": [
        {
          "isPrivate": false,
          "status": "busy",
          "subject": "Test Meeting again",
          "location": "",
          "start": {
            "dateTime": "2020-06-12T10:58:45.0000000",
            "timeZone": "UTC"
          },
          "end": {
            "dateTime": "2020-06-12T11:08:45.0000000",
            "timeZone": "UTC"
          }
        }
      ],
      "workingHours": {
        "daysOfWeek": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "startTime": "08:00:00.0000000",
        "endTime": "17:00:00.0000000",
        "timeZone": {
          "name": "India Standard Time"
        }

注意：所有请求的开始时间和结束时间都不同，但在所有情况下，availabilityViewInterval 字段都是 5。

我指的是下面的微软文档：

https://docs.microsoft.com/en-us/graph/api/calendar-getschedule?view=graph-rest-1.0&tabs=java

请帮助我了解请求中“availabilityViewInterval”和响应中“availabilityView”的意义和用法。此外，状态值是否只是“空闲/忙碌”或它也可以具有任何其他值？提前致谢

标签： javamicrosoft-graph-apimicrosoft-graph-sdksmicrosoft-graph-teamsmicrosoft-graph-calendar

解决方案

文档说：

表示响应中可用性视图中时隙的持续时间。默认为 30 分钟，最小值为 5，最大值为 1440。可选。

这意味着availabilityView. 看一个例子可能会有所帮助。

这是来自文档的示例请求：

{        
    "schedules": ["adelev@contoso.onmicrosoft.com", "meganb@contoso.onmicrosoft.com"],
    "startTime": {
        "dateTime": "2019-03-15T09:00:00",
        "timeZone": "Pacific Standard Time"
    },
    "endTime": {
        "dateTime": "2019-03-15T18:00:00",
        "timeZone": "Pacific Standard Time"
    },
    "availabilityViewInterval": 60
}

设置为 60，这availabilityViewInterval意味着返回的每个数字availabilityView代表 60 分钟的时间块。示例响应显示了200220010Megan 的值。0 = 空闲，1 = 暂定，2 = 忙碌，我们可以将其解码为：

  • 上午 9 点 - 上午 10 点忙
  • 上午 10 点 - 上午 11 点免费
  • 上午 11 点至下午 12 点免费
  • 12PM - 1PM 忙
  • 下午 1 点 - 下午 2 点忙
  • 下午 2 点 - 下午 3 点免费
  • 下午 3 点 - 下午 4 点免费
  • 下午 4 点 - 下午 5 点暂定
  • 下午 5 点 - 下午 6 点免费

如果您在availabilityViewInterval设置为 30 的情况下执行相同的请求，您将返回 的availabilityView值220000222200001100，每个数字代表 30 分钟的时间块。

推荐阅读