カレンダーメンバー閲覧

    カレンダー使用権限を有するメンバーのリストを閲覧します。

    APIの種類

    サービスAPI

    Request URL

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

    HTTP Method

    GET

    Path Parameters

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

    Response

    プロパティ タイプ 必須 説明
    role Map Y カレンダー権限
         roleName String Y 権限名
    ● master: マスター。予定を登録/修正/削除/閲覧し、カレンダーメンバーを管理したり、カレンダーを閉鎖/譲渡することができます。サービス画面上ではカレンダーマスターと表示されます。
    ● staff: 管理者。予定を登録/修正/削除/閲覧でき、カレンダーメンバーを管理できます。サービス画面上ではカレンダーおよび予定の管理と表示されます。
    ● member: 正会員。予定を登録/修正/削除/閲覧できます。サービス画面上では予定の管理と表示されます。
    ● half_member: 準会員。予定を閲覧できます。サービス画面上では予定の詳細を閲覧と表示されます。
    ● subscriber: 購読者。予定を閲覧できます。サービス画面上では表示されない権限です。
    ● timelookup_only_delegater: 時間枠に対する予定の有無のみ確認できます。サービス画面上では予定の時間枠のみ閲覧と表示されます。
         roleId Integer Y 権限タイプ
    ● 2: 管理者(staff)。サービス画面上ではカレンダーおよび予定の管理と表示されます。
    ● 3: 正会員(member)。サービス画面上では予定の管理と表示されます。
    ● 4: 会員(half_member)。サービス画面上では予定の詳細を閲覧と表示されます。
    ● 8: 時間閲覧委任(timelookup_only_delegater)。サービス画面上では予定の時間枠のみ閲覧と表示されます。
    userId String Y メンバーID
    userName String Y メンバー名
    userType String Y メンバータイプ
    email String Y メンバーのメールアドレス
    • カレンダーのメンバーとなれるタイプは、下記の通りです。
    type 説明
    INDIVIDUAL 個人
    MAILING_LIST グループ
    GROUP 組織
    DOMAIN ドメイン
    TENANT テナント

    Response Example

    [
        {
            "role": {
                "roleName": "master",
                "roleId": 1
            },
            "userType": "INDIVIDUAL",
            "userName": "nameOf_99141486929",
            "userId": "99141486929",
            "email": "99141486929@individual.com"
        },
        {
            "role": {
                "roleName": "half_member",
                "roleId": 4
            },
            "userType": "INDIVIDUAL",
            "userName": "nameOf_99140172775",
            "userId": "99140172775",
            "email": "99140172775@individual.com"
        },
        {
            "role": {
                "roleName": "half_member",
                "roleId": 4
            },
            "userType": "INDIVIDUAL",
            "userName": "nameOf_99147920087",
            "userId": "99147920087",
            "email": "99147920087@individual.com"
        },
        {
            "role": {
                "roleName": "half_member",
                "roleId": 4
            },
            "userType": "INDIVIDUAL",
            "userName": "nameOf_99147379949",
            "userId": "99147379949",
            "email": "99147379949@individual.com"
        }
    ]
    

    Error Code

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