LINE WORKS API ユーザーの基本カレンダーの取得

LINE WORKS API を使ってユーザーの基本カレンダー情報を取得する

この記事では、LINE WORKS API を利用してユーザーの基本カレンダー情報を取得する方法について説明します。
Python のサンプルコードを提供し、Google Colab 上で実際に動作させる方法も解説します。

特徴

• APIの利用方法: カレンダー情報を取得するためのリクエストの作成。
• Pythonサンプルコード: リクエストとレスポンスの処理を実装。
• Google Colabで試す: 提供される Colab ノートブックで即座に試せます。

必要な準備

1. LINE WORKS API アクセストークンを取得してください。
   • アクセストークンは API リクエストの認証に必要です。
2. Google Colab を利用して実行環境を整えてください。
   • 共有リンクを使って簡単に試せます。

Google Colab ノートブック

Google Colab ノートブックを使用すると、この記事のコードを直接試すことができます。
以下のリンクからノートブックにアクセスしてください:

Google Colab ノートブックを開く

サンプルコード

以下の Python コードは、LINE WORKS API を使用してカレンダー情報を取得するサンプルです。

# 必要なライブラリをインストール
!pip install requests

import requests

# 必要な変数を Google Colab のパラメータ形式で入力
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" # @param {type:"string"}
USER_ID = "me" # @param {type:"string"}

BASE_URL = "https://www.worksapis.com/v1.0/users/{userId}/calendar"

# カレンダー情報を取得する関数
def get_user_calendar(user_id, access_token):
    url = BASE_URL.format(userId=user_id)
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json"
    }

    try:
        # API リクエストを送信
        response = requests.get(url, headers=headers)
        if response.status_code == 200:
            data = response.json()
            print("カレンダー情報を取得しました:")
            print(f"カレンダー名: {data['calendarName']}")
            print(f"説明: {data['description']}")
            print(f"カレンダーID: {data['calendarId']}")
            print(f"公開設定: {data['isPublic']}")
            print(f"共有メンバー:")
            for member in data["members"]:
                print(f"  - ID: {member['id']}, タイプ: {member['type']}, 権限: {member['role']}")
        elif response.status_code == 403:
            print("エラー: 権限がありません (403 Forbidden)")
        elif response.status_code == 404:
            print("エラー: カレンダーが見つかりません (404 Not Found)")
        else:
            print(f"エラー: ステータスコード {response.status_code}")
            print(response.text)
    except Exception as e:
        print(f"エラーが発生しました: {e}")

# カレンダー情報を取得
get_user_calendar(USER_ID, ACCESS_TOKEN)

実行手順

1. Colab ノートブックを開きます。
2. 必要なパラメータ（ACCESS_TOKEN など）を設定します。
3. コードを実行して、カレンダー情報を取得します。

参考情報

• LINE WORKS API ドキュメント
• Google Colab

この記事のコードは、LINE WORKS API を活用したシンプルな実装例です。API の活用方法を学ぶ一助となれば幸いです。