Calendar a Planner endpointy, admin consent URL, C# ukazka (1.1.0)

Podle zadani "MS365 prava konektoru":
- Calendar: calendarView, getSchedule, get/patch/delete udalosti
- Planner: plany skupiny, buckety, tasky, create/patch/delete s ETag
- GET /admin-consent/url pro onboarding klientskeho tenantu
- examples/csharp/ListUsersTop10: ukazka volani GET /users?top=10
  vcetne sifrovani hlavicek X-MS365-*
- README: multitenant napojeni, endpointy, opravneni, zaznam zmen

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

app/schemas.py

@@ -69,6 +69,125 @@ class CalendarEventRequest(BaseModel):
     online_meeting_provider: str | None = Field(None, pattern="^(teamsForBusiness|skypeForBusiness|skypeForConsumer)$")
 
 
+class CalendarEventUpdateRequest(BaseModel):
+    """Partial update; only fields that are set are sent to Microsoft Graph."""
+
+    subject: str | None = None
+    body: str | None = None
+    body_content_type: str = Field("HTML", pattern="^(HTML|Text)$")
+    start: DateTimeTimeZone | None = None
+    end: DateTimeTimeZone | None = None
+    location: str | None = None
+    attendees: list[CalendarAttendee] | None = None
+    is_online_meeting: bool | None = None
+    online_meeting_provider: str | None = Field(None, pattern="^(teamsForBusiness|skypeForBusiness|skypeForConsumer)$")
+
+    def as_graph_patch(self) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        if self.subject is not None:
+            payload["subject"] = self.subject
+        if self.body is not None:
+            payload["body"] = {"contentType": self.body_content_type, "content": self.body}
+        if self.start is not None:
+            payload["start"] = self.start.model_dump(by_alias=True)
+        if self.end is not None:
+            payload["end"] = self.end.model_dump(by_alias=True)
+        if self.location is not None:
+            payload["location"] = {"displayName": self.location}
+        if self.attendees is not None:
+            payload["attendees"] = [attendee.as_graph_attendee() for attendee in self.attendees]
+        if self.is_online_meeting is not None:
+            payload["isOnlineMeeting"] = self.is_online_meeting
+        if self.online_meeting_provider is not None:
+            payload["onlineMeetingProvider"] = self.online_meeting_provider
+        return payload
+
+
+class ScheduleRequest(BaseModel):
+    """Free/busy lookup (Graph getSchedule) for one or more mailboxes."""
+
+    schedules: list[EmailStr] = Field(..., min_length=1, description="Mailboxes whose availability is requested.")
+    start: DateTimeTimeZone
+    end: DateTimeTimeZone
+    availability_view_interval: int = Field(30, ge=5, le=1440, description="Slot length in minutes.")
+
+    def as_graph_payload(self) -> dict[str, Any]:
+        return {
+            "schedules": [str(address) for address in self.schedules],
+            "startTime": self.start.model_dump(by_alias=True),
+            "endTime": self.end.model_dump(by_alias=True),
+            "availabilityViewInterval": self.availability_view_interval,
+        }
+
+
+def _planner_assignments(assign_user_ids: list[str], unassign_user_ids: list[str]) -> dict[str, Any]:
+    assignments: dict[str, Any] = {
+        user_id: {"@odata.type": "#microsoft.graph.plannerAssignment", "orderHint": " !"}
+        for user_id in assign_user_ids
+    }
+    for user_id in unassign_user_ids:
+        assignments[user_id] = None
+    return assignments
+
+
+class PlannerTaskCreateRequest(BaseModel):
+    plan_id: str
+    bucket_id: str | None = None
+    title: str
+    start_date_time: str | None = Field(None, description="ISO 8601 with offset, e.g. 2026-09-08T08:00:00Z.")
+    due_date_time: str | None = Field(None, description="ISO 8601 with offset, e.g. 2026-09-10T16:00:00Z.")
+    percent_complete: int | None = Field(None, ge=0, le=100)
+    priority: int | None = Field(None, ge=0, le=10, description="Graph priority: 1 urgent, 3 important, 5 medium, 9 low.")
+    assign_user_ids: list[str] = Field(default_factory=list, description="Microsoft Graph user ids to assign.")
+
+    def as_graph_payload(self) -> dict[str, Any]:
+        payload: dict[str, Any] = {"planId": self.plan_id, "title": self.title}
+        if self.bucket_id:
+            payload["bucketId"] = self.bucket_id
+        if self.start_date_time:
+            payload["startDateTime"] = self.start_date_time
+        if self.due_date_time:
+            payload["dueDateTime"] = self.due_date_time
+        if self.percent_complete is not None:
+            payload["percentComplete"] = self.percent_complete
+        if self.priority is not None:
+            payload["priority"] = self.priority
+        if self.assign_user_ids:
+            payload["assignments"] = _planner_assignments(self.assign_user_ids, [])
+        return payload
+
+
+class PlannerTaskUpdateRequest(BaseModel):
+    """Partial update; only fields that are set are sent to Microsoft Graph."""
+
+    title: str | None = None
+    bucket_id: str | None = None
+    start_date_time: str | None = None
+    due_date_time: str | None = None
+    percent_complete: int | None = Field(None, ge=0, le=100)
+    priority: int | None = Field(None, ge=0, le=10)
+    assign_user_ids: list[str] = Field(default_factory=list)
+    unassign_user_ids: list[str] = Field(default_factory=list)
+
+    def as_graph_patch(self) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        if self.title is not None:
+            payload["title"] = self.title
+        if self.bucket_id is not None:
+            payload["bucketId"] = self.bucket_id
+        if self.start_date_time is not None:
+            payload["startDateTime"] = self.start_date_time
+        if self.due_date_time is not None:
+            payload["dueDateTime"] = self.due_date_time
+        if self.percent_complete is not None:
+            payload["percentComplete"] = self.percent_complete
+        if self.priority is not None:
+            payload["priority"] = self.priority
+        if self.assign_user_ids or self.unassign_user_ids:
+            payload["assignments"] = _planner_assignments(self.assign_user_ids, self.unassign_user_ids)
+        return payload
+
+
 class DriveUploadRequest(BaseModel):
     content_base64: str
     content_type: str = "application/octet-stream"