Office365-REST-Python-Client 3.0.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

office365/onedrive/termstore/terms/collection.py

@@ -4,7 +4,6 @@ from office365.directory.permissions.require_permission import require_permissio
 from office365.entity_collection import EntityCollection
 from office365.onedrive.termstore.terms.label import LocalizedLabel
 from office365.onedrive.termstore.terms.term import Term
-from office365.runtime.client_request_exception import ClientRequestException, DuplicatedObjectException
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.v4.entity import EntityPath
 from office365.runtime.queries.create_entity import CreateEntityQuery
@@ -49,14 +48,8 @@ class TermCollection(EntityCollection[Term]):
 
         return return_type
 
-    def get_or_add(self, label: str) -> Term:
-        term = self.add(label)
+    def ensure(self, label: str) -> Term:
+        """Gets an existing term by label or creates it (idempotent)."""
+        from office365.runtime.queries.get_or_create import create_or_get
 
-        def _on_name_exists(error: ClientRequestException):
-            if not isinstance(error, DuplicatedObjectException):
-                raise error
-
-            self.get_by_label(label).after_execute(lambda existing: term.copy_from(existing), execute_first=True)
-
-        term.on_error(_on_name_exists)
-        return term
+        return create_or_get(create=lambda: self.add(label), find=lambda: self.get_by_label(label))

office365/onedrive/workbooks/charts/axes.py

@@ -1,11 +1,13 @@
 from office365.entity import Entity
 from office365.onedrive.workbooks.charts.axis import WorkbookChartAxis
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.types.odata_property import odata
 
 
 class WorkbookChartAxes(Entity):
     """Represents the chart axes."""
 
+    @odata(name="categoryAxis")
     @property
     def category_axis(self) -> WorkbookChartAxis:
         """Represents the category axis in a chart."""
@@ -14,6 +16,7 @@ class WorkbookChartAxes(Entity):
             WorkbookChartAxis(self.context, ResourcePath("categoryAxis", self.resource_path)),
         )
 
+    @odata(name="seriesAxis")
     @property
     def series_axis(self) -> WorkbookChartAxis:
         """Represents the series axis of a 3-dimensional chart."""
@@ -22,6 +25,7 @@ class WorkbookChartAxes(Entity):
             WorkbookChartAxis(self.context, ResourcePath("seriesAxis", self.resource_path)),
         )
 
+    @odata(name="valueAxis")
     @property
     def value_axis(self) -> WorkbookChartAxis:
         """Represents the value axis in an axis."""
@@ -29,13 +33,3 @@ class WorkbookChartAxes(Entity):
             "valueAxis",
             WorkbookChartAxis(self.context, ResourcePath("valueAxis", self.resource_path)),
         )
-
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "categoryAxis": self.category_axis,
-                "seriesAxis": self.series_axis,
-                "valueAxis": self.value_axis,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)

office365/onedrive/workbooks/filter_criteria.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass, field
 
+from office365.onedrive.workbooks.icon import WorkbookIcon
 from office365.runtime.client_value import ClientValue
 
 
@@ -13,3 +14,11 @@ class WorkbookFilterCriteria(ClientValue):
     dynamicCriteria: str | None = None
     operator: str | None = None
     values: list | None = field(default_factory=list)
+    criterion1: str | None = None
+    criterion2: str | None = None
+    filterOn: str | None = None
+    icon: WorkbookIcon = field(default_factory=WorkbookIcon)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookFilterCriteria"

office365/onedrive/workbooks/filter_datetime.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class WorkbookFilterDatetime(ClientValue):
+    date: str | None = None
+    specificity: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookFilterDatetime"

office365/onedrive/workbooks/icon.py

@@ -7,4 +7,10 @@ from office365.runtime.client_value import ClientValue
 
 @dataclass
 class WorkbookIcon(ClientValue):
-    """Represents a cell icon."""
+    index: int | None = None
+    set: str | None = None
+    "Represents a cell icon."
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookIcon"

office365/onedrive/workbooks/operations/error.py

@@ -12,3 +12,7 @@ class WorkbookOperationError(ClientValue):
     code: str | None = None
     innerError: str | None = None
     message: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookOperationError"

office365/onedrive/workbooks/ranges/reference.py

@@ -10,3 +10,7 @@ class WorkbookRangeReference(ClientValue):
     """"""
 
     address: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookRangeReference"

office365/onedrive/workbooks/session_info.py

@@ -11,3 +11,7 @@ class WorkbookSessionInfo(ClientValue):
 
     persistChanges: bool | None = None
     id: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookSessionInfo"

office365/onedrive/workbooks/sort_field.py

@@ -15,3 +15,8 @@ class WorkbookSortField(ClientValue):
     dataOption: str | None = None
     icon: WorkbookIcon | None = field(default_factory=WorkbookIcon)
     key: str | None = None
+    sortOn: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookSortField"

office365/onedrive/workbooks/workbook.py

@@ -17,11 +17,18 @@ from office365.onedrive.workbooks.worksheets.collection import (
 )
 from office365.runtime.client_result import ClientResult
 from office365.runtime.http.request_options import RequestOptions
+from office365.runtime.limits import Limit, LimitKind, limit
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
+_DOC = "https://learn.microsoft.com/en-us/graph/throttling-limits"
 
+
+@limit(
+    Limit("excel", 5_000, LimitKind.SUPPORTED, "requests", "app", doc=_DOC, window_seconds=10),
+    Limit("excel", 1_500, LimitKind.SUPPORTED, "requests", "app+tenant", doc=_DOC, window_seconds=10),
+)
 class Workbook(Entity):
     """The top-level object that contains related workbook objects such as worksheets, tables, and ranges."""
 

office365/onedrive/workbooks/worksheets/protection_options.py

@@ -20,3 +20,7 @@ class WorkbookWorksheetProtectionOptions(ClientValue):
     allowInsertRows: bool | None = None
     allowPivotTables: bool | None = None
     allowSort: bool | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkbookWorksheetProtectionOptions"

office365/onedrive/workbooks/worksheets/worksheet.py

@@ -14,6 +14,7 @@ from office365.onedrive.workbooks.worksheets.protection import (
     WorkbookWorksheetProtection,
 )
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.types.odata_property import odata
 
@@ -47,9 +48,10 @@ class WorkbookWorksheet(Entity):
     @require_permission(delegated=["Files.ReadWrite"], application=["Files.ReadWrite"])
     def range(self, address=None):
         """Gets the range object specified by the address or name."""
-        return_type = WorkbookRange(self.context, ResourcePath("range", self.resource_path))
-        params = {"address": address}
-        qry = FunctionQuery(self, "range", method_params=params, return_type=return_type)
+        return_type = WorkbookRange(
+            self.context, ServiceOperationPath("range", {"address": address}, self.resource_path)
+        )
+        qry = FunctionQuery(self, "range", method_params={"address": address}, return_type=return_type)
         self.context.add_query(qry)
         return return_type
 

office365/onenote/pages/collection.py

@@ -7,10 +7,10 @@ from office365.directory.permissions.require_permission import require_permissio
 from office365.entity_collection import EntityCollection
 from office365.onenote.pages.page import OnenotePage
 from office365.runtime.http.http_method import HttpMethod
+from office365.runtime.http.mime import get_mime_type
 from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.queries.batch import create_boundary
 from office365.runtime.queries.client_query import ClientQuery
-from office365.runtime.utilities import get_mime_type
 
 
 def _message_to_payload(message: Message) -> bytes:

office365/onenote/pages/page.py

@@ -9,6 +9,7 @@ from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.types.collections import StringCollection
+from office365.runtime.types.odata_property import odata
 
 
 class OnenotePage(OnenoteEntitySchemaObjectModel):
@@ -20,7 +21,7 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
     )
     def get_content(self) -> ClientResult[bytes]:
         """Download the page's HTML content."""
-        return_type = ClientResult(self.context)
+        return_type = ClientResult[bytes](self.context)
         qry = FunctionQuery(self, "content", None, return_type)
         self.context.add_query(qry)
         return return_type
@@ -43,6 +44,7 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
         """The title of the page."""
         return self.properties.get("title", None)
 
+    @odata(name="userTags")
     @property
     def user_tags(self) -> StringCollection:
         """Links for opening the page. The oneNoteClientURL link opens the page in the OneNote native client
@@ -51,6 +53,7 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
         """
         return self.properties.get("userTags", StringCollection())
 
+    @odata(name="parentNotebook")
     @property
     def parent_notebook(self) -> Notebook:
         """The notebook that contains the page. Read-only."""
@@ -59,6 +62,7 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
             Notebook(self.context, ResourcePath("parentNotebook", self.resource_path)),
         )
 
+    @odata(name="parentSection")
     @property
     def parent_section(self) -> OnenoteSection:
         """The section that contains the page."""
@@ -66,13 +70,3 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
             "parentSection",
             OnenoteSection(self.context, ResourcePath("parentSection", self.resource_path)),
         )
-
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "userTags": self.user_tags,
-                "parentSection": self.parent_section,
-                "parentNotebook": self.parent_notebook,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)

office365/outlook/calendar/attendees/attendee.py

@@ -13,3 +13,7 @@ class Attendee(AttendeeBase):
 
     proposedNewTime: TimeSlot | None = None
     status: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.Attendee"

office365/outlook/calendar/attendees/availability.py

@@ -18,3 +18,7 @@ class AttendeeAvailability(ClientValue):
 
     attendee: AttendeeBase = field(default_factory=AttendeeBase)
     availability: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.AttendeeAvailability"

office365/outlook/calendar/attendees/base.py

@@ -10,3 +10,7 @@ class AttendeeBase(Recipient):
     """The type of attendees."""
 
     type: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.AttendeeBase"

office365/outlook/calendar/collection.py

@@ -0,0 +1,7 @@
+from office365.entity_collection import EntityCollection
+from office365.outlook.calendar.calendar import Calendar
+
+
+class CalendarCollection(EntityCollection[Calendar]):
+    def __init__(self, context, resource_path=None):
+        super().__init__(context, Calendar, resource_path)

office365/outlook/calendar/events/event.py

@@ -34,6 +34,7 @@ from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.runtime.types.collections import StringCollection
+from office365.runtime.types.odata_property import odata
 
 
 class Event(OutlookItem):
@@ -255,6 +256,7 @@ class Event(OutlookItem):
         """
         self.set_property("end", DateTimeTimeZone.parse(value))
 
+    @odata(name="singleValueExtendedProperties")
     @property
     def single_value_extended_properties(self) -> EntityCollection[SingleValueLegacyExtendedProperty]:
         """The collection of single-value extended properties defined for the event."""
@@ -267,6 +269,7 @@ class Event(OutlookItem):
             ),
         )
 
+    @odata(name="multiValueExtendedProperties")
     @property
     def multi_value_extended_properties(self) -> EntityCollection[MultiValueLegacyExtendedProperty]:
         """The collection of multi-value extended properties defined for the event."""
@@ -304,6 +307,7 @@ class Event(OutlookItem):
         """Default is true, which represents the organizer would like an invitee to send a response to the event."""
         return self.properties.get("responseRequested", None)
 
+    @odata(name="responseStatus")
     @property
     def response_status(self) -> Optional[str]:
         """Indicates the type of response sent in response to an event message."""
@@ -396,21 +400,18 @@ class Event(OutlookItem):
             "instances", EventCollection(self.context, ResourcePath("instances", self.resource_path))
         )
 
+    @odata(name="cancelledOccurrences")
     @property
     def cancelled_occurrences(self) -> StringCollection:
         """Gets the cancelledOccurrences property"""
         return self.properties.get("cancelledOccurrences", StringCollection(None))
 
-    @property
-    def i_cal_u_id(self) -> Optional[str]:
-        """Gets the iCalUId property"""
-        return self.properties.get("iCalUId", None)
-
     @property
     def locations(self) -> ClientValueCollection[Location]:
         """Gets the locations property"""
         return self.properties.get("locations", ClientValueCollection[Location](Location))
 
+    @odata(name="onlineMeetingProvider")
     @property
     def online_meeting_provider(self) -> OnlineMeetingProviderType:
         """Gets the onlineMeetingProvider property"""
@@ -431,6 +432,7 @@ class Event(OutlookItem):
         """Gets the originalEndTimeZone property"""
         return self.properties.get("originalEndTimeZone", None)
 
+    @odata(name="originalStart")
     @property
     def original_start(self) -> datetime:
         """Gets the originalStart property"""
@@ -451,6 +453,7 @@ class Event(OutlookItem):
         """Gets the sensitivity property"""
         return self.properties.get("sensitivity", Sensitivity.normal)
 
+    @odata(name="showAs")
     @property
     def show_as(self) -> FreeBusyStatus:
         """Gets the showAs property"""
@@ -461,15 +464,6 @@ class Event(OutlookItem):
         """Gets the type property"""
         return self.properties.get("type", EventType.singleInstance)
 
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "multiValueExtendedProperties": self.multi_value_extended_properties,
-                "singleValueExtendedProperties": self.single_value_extended_properties,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)
-
     @property
     def entity_type_name(self) -> str:
         return "microsoft.graph.Event"

office365/outlook/calendar/events/reminder.py

@@ -34,3 +34,7 @@ class Reminder(ClientValue):
     eventSubject: str | None = None
     eventWebLink: str | None = None
     reminderFireTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.Reminder"

office365/outlook/calendar/location_constraint.py

@@ -14,3 +14,7 @@ class LocationConstraint(ClientValue):
     isRequired: bool | None = None
     locations: ClientValueCollection = field(default_factory=lambda: ClientValueCollection(LocationConstraintItem))
     suggestLocation: bool | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.LocationConstraint"

office365/outlook/calendar/meetingtimes/suggestion.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass, field
 
 from office365.outlook.calendar.attendees.availability import AttendeeAvailability
+from office365.outlook.calendar.meetingtimes.freebusystatus import FreeBusyStatus
 from office365.outlook.calendar.meetingtimes.time_slot import TimeSlot
 from office365.outlook.mail.location import Location
 from office365.runtime.client_value import ClientValue
@@ -22,6 +23,13 @@ class MeetingTimeSuggestion(ClientValue):
     confidence: float | None = None
     locations: ClientValueCollection = field(default_factory=lambda: ClientValueCollection(Location))
     meetingTimeSlot: TimeSlot = field(default_factory=TimeSlot)
+    order: int | None = None
+    organizerAvailability: FreeBusyStatus = FreeBusyStatus.unknown
+    suggestionReason: str | None = None
 
     def __repr__(self):
         return repr(self.meetingTimeSlot)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MeetingTimeSuggestion"

office365/outlook/calendar/meetingtimes/suggestions_result.py

@@ -17,3 +17,7 @@ class MeetingTimeSuggestionsResult(ClientValue):
         default_factory=lambda: ClientValueCollection(MeetingTimeSuggestion)
     )
     emptySuggestionsReason: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MeetingTimeSuggestionsResult"

office365/outlook/calendar/meetingtimes/time_constraint.py

@@ -14,3 +14,7 @@ class TimeConstraint(ClientValue):
 
     activityDomain: str | None = None
     timeSlots: ClientValueCollection = field(default_factory=lambda: ClientValueCollection(TimeSlot))
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.TimeConstraint"

office365/outlook/calendar/response_status.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
+from datetime import datetime
 
 from office365.runtime.client_value import ClientValue
 
@@ -14,3 +15,8 @@ class ResponseStatus(ClientValue):
     """
 
     response: str | None = None
+    time: datetime | None = field(default_factory=lambda: datetime.min)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ResponseStatus"

office365/outlook/calendar/schedule/free_busy_error.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class FreeBusyError(ClientValue):
+    message: str | None = None
+    responseCode: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.FreeBusyError"

office365/outlook/calendar/schedule/information.py

@@ -18,3 +18,7 @@ class ScheduleInformation(ClientValue):
     availabilityView: str | None = None
     error: str | None = None
     workingHours: WorkingHours = field(default_factory=WorkingHours)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ScheduleInformation"

office365/outlook/calendar/schedule/item.py

@@ -29,3 +29,7 @@ class ScheduleItem(ClientValue):
     start: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
     status: str | None = None
     subject: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ScheduleItem"

office365/outlook/calendar/sharing/message_action.py

@@ -2,9 +2,19 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 
+from office365.outlook.calendar.sharing.actionimportance import CalendarSharingActionImportance
+from office365.outlook.calendar.sharing.actiontype import CalendarSharingActionType
+from office365.outlook.calendar.sharing.types import CalendarSharingAction
 from office365.runtime.client_value import ClientValue
 
 
 @dataclass
 class CalendarSharingMessageAction(ClientValue):
-    """Represents a calendar sharing message action."""
+    action: CalendarSharingAction = CalendarSharingAction.accept
+    actionType: CalendarSharingActionType = CalendarSharingActionType.accept
+    importance: CalendarSharingActionImportance = CalendarSharingActionImportance.primary
+    "Represents a calendar sharing message action."
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.CalendarSharingMessageAction"

office365/outlook/calendar/timezones/base.py

@@ -13,3 +13,7 @@ class TimeZoneBase(ClientValue):
 
     def __repr__(self):
         return self.name or ""
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.TimeZoneBase"

office365/outlook/calendar/timezones/custom.py

@@ -1,8 +1,10 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 
 from office365.outlook.calendar.timezones.base import TimeZoneBase
+from office365.outlook.calendar.timezones.daylight_time_zone_offset import DaylightTimeZoneOffset
+from office365.outlook.timezones.standard_time_zone_offset import StandardTimeZoneOffset
 
 
 @dataclass
@@ -12,3 +14,9 @@ class CustomTimeZone(TimeZoneBase):
     """
 
     bias: int | None = None
+    daylightOffset: DaylightTimeZoneOffset = field(default_factory=DaylightTimeZoneOffset)
+    standardOffset: StandardTimeZoneOffset = field(default_factory=StandardTimeZoneOffset)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.CustomTimeZone"

office365/outlook/calendar/timezones/daylight_time_zone_offset.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class DaylightTimeZoneOffset(ClientValue):
+    daylightBias: int | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.DaylightTimeZoneOffset"

office365/outlook/calendar/working_hours.py

@@ -26,3 +26,7 @@ class WorkingHours(ClientValue):
     timeZone: TimeZoneBase = field(default_factory=TimeZoneBase)
     endTime: str | None = None
     startTime: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.WorkingHours"

office365/outlook/check_in_method.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class CheckInMethod(Enum):
+    unspecified = "0"
+    manual = "1"
+    inferred = "2"
+    verified = "3"
+    unknownFutureValue = "4"
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.CheckInMethod"

office365/outlook/contacts/folders/collection.py

@@ -1,6 +1,5 @@
 from office365.delta_collection import DeltaCollection
 from office365.outlook.contacts.folders.folder import ContactFolder
-from office365.runtime.client_request_exception import ClientRequestException, DuplicatedObjectException
 
 
 class ContactFolderCollection(DeltaCollection[ContactFolder]):
@@ -17,19 +16,11 @@ class ContactFolderCollection(DeltaCollection[ContactFolder]):
         kwargs["displayName"] = display_name
         return super().add(**kwargs)
 
-    def get_or_add(self, display_name: str) -> ContactFolder:
-        """Gets existing group by name or creates a new one (idempotent)."""
-        return_type = self.add(display_name)
+    def ensure(self, display_name: str) -> ContactFolder:
+        """Gets an existing folder by name or creates it (idempotent)."""
+        from office365.runtime.queries.get_or_create import create_or_get
 
-        def _on_name_exists(error: ClientRequestException):
-            if not isinstance(error, DuplicatedObjectException):
-                raise error
-            self.get_by_name(display_name).after_execute(
-                lambda existing: return_type.copy_from(existing), execute_first=True
-            )
-
-        return_type.on_error(_on_name_exists)
-        return return_type
+        return create_or_get(create=lambda: self.add(display_name), find=lambda: self.get_by_name(display_name))
 
     def get_by_name(self, display_name: str) -> ContactFolder:
         """Returns the group with the specified name."""

office365/outlook/convert_id_result.py

@@ -1,7 +1,8 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 
+from office365.directory.authentication.generic_error import GenericError
 from office365.runtime.client_value import ClientValue
 
 
@@ -16,3 +17,8 @@ class ConvertIdResult(ClientValue):
 
     sourceId: str | None = None
     targetId: str | None = None
+    errorDetails: GenericError = field(default_factory=GenericError)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ConvertIdResult"