Microsoft Graph 実務入門 #4 メールとカレンダーの自動化 — 読み取り、送信、予定の作成

from datetime import datetime, timedelta, timezone
from msgraph.generated.users.item.messages.messages_request_builder import (
    MessagesRequestBuilder,
)

async def recent_reports(client, user_id: str):
    since = (datetime.now(timezone.utc) - timedelta(days=1)).strftime(
        "%Y-%m-%dT%H:%M:%SZ"
    )
    params = MessagesRequestBuilder.MessagesRequestBuilderGetQueryParameters(
        filter=f"receivedDateTime ge {since} and startsWith(subject, '[日報]')",
        select=["subject", "from", "receivedDateTime", "hasAttachments"],
        orderby=["receivedDateTime desc"],
        top=50,
    )
    config = MessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration(
        query_parameters=params,
    )
    result = await client.users.by_user_id(user_id).messages.get(
        request_configuration=config
    )
    return result.value or []

from msgraph.generated.models.message import Message
from msgraph.generated.models.item_body import ItemBody
from msgraph.generated.models.body_type import BodyType
from msgraph.generated.models.recipient import Recipient
from msgraph.generated.models.email_address import EmailAddress
from msgraph.generated.users.item.send_mail.send_mail_post_request_body import (
    SendMailPostRequestBody,
)

def to_recipient(addr: str) -> Recipient:
    return Recipient(email_address=EmailAddress(address=addr))

async def send_report(client, sender_id: str, to: list[str], html: str):
    body = SendMailPostRequestBody(
        message=Message(
            subject="[自動送信] 週次デプロイ状況",
            body=ItemBody(content_type=BodyType.Html, content=html),
            to_recipients=[to_recipient(a) for a in to],
        ),
        save_to_sent_items=True,
    )
    await client.users.by_user_id(sender_id).send_mail.post(body)

from msgraph.generated.models.event import Event
from msgraph.generated.models.date_time_time_zone import DateTimeTimeZone
from msgraph.generated.models.attendee import Attendee
from msgraph.generated.models.attendee_type import AttendeeType

async def create_meeting(client, organizer_id: str):
    event = Event(
        subject="デプロイのふりかえり",
        start=DateTimeTimeZone(
            date_time="2026-08-20T10:00:00", time_zone="Asia/Tokyo"
        ),
        end=DateTimeTimeZone(
            date_time="2026-08-20T11:00:00", time_zone="Asia/Tokyo"
        ),
        attendees=[
            Attendee(
                email_address=EmailAddress(address="dev-team@contoso.com"),
                type=AttendeeType.Required,
            ),
        ],
        is_online_meeting=True,        # Teams 会議リンクを自動生成
        online_meeting_provider="teamsForBusiness",
    )
    return await client.users.by_user_id(organizer_id).events.post(event)

from msgraph.generated.users.item.calendar.get_schedule.get_schedule_post_request_body import (
    GetSchedulePostRequestBody,
)

async def check_availability(client, user_id: str, emails: list[str]):
    body = GetSchedulePostRequestBody(
        schedules=emails,
        start_time=DateTimeTimeZone(
            date_time="2026-08-20T09:00:00", time_zone="Asia/Tokyo"
        ),
        end_time=DateTimeTimeZone(
            date_time="2026-08-20T18:00:00", time_zone="Asia/Tokyo"
        ),
        availability_view_interval=30,   # 30 分単位
    )
    result = await client.users.by_user_id(user_id).calendar.get_schedule.post(body)
    for sched in result.value:
        # availability_view: "0"=空き "1"=未定 "2"=多忙 "3"=不在 の文字列
        print(sched.schedule_id, sched.availability_view)