カレンダー照会

    ログインしたユーザーアカウントの持つ特定のカレンダーを照会します。

    APIの種類

    サービスAPI

    Request URL

    https://apis.worksmobile.com/r/{API_ID}/calendar/v3/users/me/calendarList/{calendarId}

    HTTP Method

    GET

    Path Parameters

    パラメータ タイプ 必須 説明
    calendarId String Y カレンダーID

    Response

    プロパティ タイプ 必須 説明
    calendarUid String Y カレンダーID
    displayName String Y カレンダー名
    description String Y カレンダー説明
    ctag String Y カレンダー更新日時(UTC：yyyyMMddHHmmss)
    color String Y カレンダーの色
    dateAlarm String Y 終日予定の通知時間の既定値
    dateTimeAlarm String N 予定の通知時間の既定値
    defaultReminderMedia List Y 既定の通知方法
    enumのvalue: MAIL, POPUP
    showContent boolean Y ブラウザ版でこのカレンダーの予定を表示するかどうか
    showOnList boolean Y カレンダーリストに表示するかどうか
    isDefaultCalendar boolean Y 閲覧するユーザーの基本カレンダーかどうか
    isSharedCalendar boolean Y オーナーが共有したカレンダーかどうか
    calendarMembers List Y カレンダーを共有するメンバーリスト
         member Map Y メンバー
    Mapのkey: type, accountId
         roleId Integer Y 権限タイプ

    1: カレンダーマスター
    2: カレンダーおよび予定の管理
    3: 予定の管理
    4: 予定の詳細を閲覧
    8: 予定の時間枠のみ閲覧
         status String Y メンバーの状態（承諾、未定、辞退）
    • memberのタイプはカレンダーのメンバータイプです。
    • カレンダーのメンバータイプは、下記の通りです。
    type 説明
    INDIVIDUAL 個人
    MAILING_LIST グループ
    GROUP 組織
    DOMAIN ドメイン
    TENANT テナント

    Response Example

    {
    "calendarUid": "2f66dbb2-0db7-4f3a-9164-07b08b40362e",
    "displayName": "nameOf_99517579704",
    "description": "",
    "ctag": "20201103110516",
    "color": "#FF9C71",
    "dateAlarm": "-PT12H",
    "dateTimeAlarm": "-PT10M",
    "defaultReminderMedia": [
        "MAIL",
        "POPUP"
    ],
    "showContent": true,
    "showOnList": true,
    "isDefaultCalendar": true,
    "isSharedCalendar": false,
    "calendarMembers": [
        {
            "member": {
                "accountId": "99517579704@individual.com",
                "type": "INDIVIDUAL"
            },
            "roleId": 1,
            "status": "ACCEPT"
        }
    ]
}

    Error Code

    HTTPステータス エラーコード 説明
    400 BAD_REQUEST 不正なリクエスト
    403 FORBIDDEN 権限のないリソースへのアクセス
    404 NOT_FOUND 対象リソースがない
    500 INTERNAL_SERVER_ERROR 内部エラー