fix: add entity_type_name override to Device — matches User, Group, ServicePrincipal pattern

Author: vgrem

examples/communications/presence/teams_presence_monitor.py

@@ -11,47 +11,53 @@
 from time import sleep
 from typing import Optional
 
+from office365.communications.presences.presence import Presence
 from office365.graph_client import GraphClient
+from tests import test_admin_principal_name, test_client_id, test_tenant
 
 POLL_INTERVAL = 30
 BUSY_ACTIVITIES = {"InACall", "InAConferenceCall", "InAMeeting", "Presenting"}
 
 
-def is_available(presence) -> bool:
-    availability = presence.get_property("availability")
-    activity = presence.get_property("activity")
-    if not availability or not activity:
+def is_available(presence: Presence) -> bool:
+    if not presence.availability or not presence.activity:
         return False
-    if availability in ("DoNotDisturb", "Offline", "PresenceUnknown"):
+    if presence.availability in ("DoNotDisturb", "Offline", "PresenceUnknown"):
         return False
-    if activity in BUSY_ACTIVITIES | {"OffWork", "OutOfOffice"}:
+    if presence.activity in BUSY_ACTIVITIES | {"OffWork", "OutOfOffice"}:
         return False
     return True
 
 
-def agent_status_summary(presence) -> str:
-    a = presence.get_property("availability") or "Unknown"
-    b = presence.get_property("activity") or "Unknown"
+def agent_status_summary(presence: Presence) -> str:
+    a = presence.availability or "Unknown"
+    b = presence.activity or "Unknown"
     return f"availability={a}, activity={b}"
 
 
 def take_agent_offline(client: GraphClient, user_id: str):
     expires = datetime.now(timezone.utc) + timedelta(hours=9)
     client.communications.presences[user_id].set_user_preferred_presence(
-        availability="DoNotDisturb", activity="OffWork", expiration_duration="PT9H",
+        availability="DoNotDisturb",
+        activity="OffWork",
+        expiration_duration="PT9H",
     ).execute_query()
     client.communications.presences[user_id].set_status_message(
-        message="Shift ended", expiry=expires,
+        message="Shift ended",
+        expiry=expires,
     ).execute_query()
 
 
 def start_shift(client: GraphClient, user_id: str):
     expires = datetime.now(timezone.utc) + timedelta(hours=9)
     client.communications.presences[user_id].set_user_preferred_presence(
-        availability="Available", activity="Available", expiration_duration="PT9H",
+        availability="Available",
+        activity="Available",
+        expiration_duration="PT9H",
     ).execute_query()
     client.communications.presences[user_id].set_status_message(
-        message="Online and ready", expiry=expires,
+        message="Online and ready",
+        expiry=expires,
     ).execute_query()
 
 
@@ -81,7 +87,7 @@ def monitor_presence(client: GraphClient, agents: list[str], cycles: int = 3):
 
 
 def main():
-    client = GraphClient().with_device_flow(client_id="your_client_id")
+    client = GraphClient(tenant=test_tenant).with_token_interactive(test_client_id, test_admin_principal_name)
     agents = ["alice@company.com", "bob@company.com", "carol@company.com"]
 
     presences = client.communications.get_presences_by_user_id(agents).execute_query()

generator/.checkpoints/SharePoint.xml.json

@@ -1 +1 @@
-["SP.TranslationStatus", "SP.RenderListDataParameters", "SP.FontOption", "SP.AlertCreationInformation", "SP.MediaServiceUpdateParameters", "SP.PivotItem", "SP.PublishModernTemplatePayload", "SP.PortalAndOrgNewsSiteReference", "SP.WebCreationInformation", "SP.VisualizationAppInfo", "SP.TemporaryFolderFileInfo", "SP.InsertFieldResponse", "SP.SubwebQuery", "SP.CustomizedFormsPageCollection", "SP.CopyMigrationOptions", "SP.RestrictAccessControlUpdate", "SP.CreatableItemInfo", "SP.ChangeQuery", "SP.AppLicenseCollection", "SP.BrandCenterConfiguration", "SP.CustomerKeyInfo", "SP.FieldCreationInformation", "SP.CustomerKeyVaultInfo", "SP.UpgradeInfo", "SP.CAFieldValue", "SP.SPAgreementsSite", "SP.MobileSettings", "SP.SPHSiteReference", "SP.WebInfoCreationInformation", "SP.UsageInfo", "SP.AgreementDocumentsInfo", "SP.ListCreationInformation", "SP.SPFocalPoint", "SP.Audience", "SP.FolderColoringInformation", "SP.HTMLFieldSecuritySetting", "SP.SimpleDataTable", "SP.SuggestedSitesParams", "SP.AsyncReadJobInfo", "SP.Padding", "SP.DashboardItem", "SP.AgreementsSolutionFileContext", "SP.ApprovalsProperties", "SP.CopyMigrationInfo", "SP.AdaptiveCard", "SP.InputText", "SP.FolderDeleteParameters", "SP.Hashtag", "SP.VersionPolicySelectionParameters", "SP.TimeZoneInformation", "SP.UpdateTemplateInfo", "SP.AgreementLocationData", "SP.PlaceholderV2", "SP.ListItemCreationInformation", "SP.GetListItemVersionsParameters", "SP.FileCollectionAddParameters", "SP.ListCollectionPosition", "SP.CurrencyInformationCollection", "SP.SemanticSearchCrawlerEnqueueItem", "SP.ListItemFormUpdateValue", "SP.RoleDefinitionCreationInformation", "SP.AdaptiveCardAction", "SP.ListItemVersionCollectionPosition", "SP.FieldLookupValue", "SP.FieldValuesWithUrl", "SP.DocumentLibraryInformation", "SP.BaseRequestParams", "SP.SharingLinkData", "SP.AgreementSummaryData", "SP.MainLinkDetails", "SP.AppSettingsInTeams", "SP.ColumnTypeInfo", "SP.AgreementDataPair", "SP.EngageDistributionInfo", "SP.Snippet", "SP.InputChoice", "SP.VivaConnectionsLicense", "SP.SensitivityLabelInfo", "SP.ProvisionedMigrationQueueInfo", "SP.AdaptiveCardColumn", "SP.ListItemCreationInformationUsingPath", "SP.ProvisionedMigrationContainersInfo", "SP.TargetedSiteDetails", "SP.MigrationJobProgress", "SP.EventReceiverDefinitionCreationInformation", "SP.FavoritedItemsParams", "SP.VivaConnectionsUrlConfiguration", "SP.ContentTypeEntityData", "SP.SPListItemVersionChange", "SP.VivaHomeTitleRegion", "SP.FileDeleteParameters", "SP.ListForm", "SP.SystemSiteLockExpirationResult", "SP.CoAuthConfiguration", "SP.SiteTemplate", "SP.SPTeamChannelCapabilities", "SP.VisualizationStyleSet", "SP.HomeSiteNavConfiguration", "SP.ContentTypeId", "SP.CustomActionElement", "SP.DocumentGenerationInfo", "SP.FieldUrlValue", "SP.PowerPlatformEnvironment", "SP.UserIdInfo", "SP.ContentAssemblyFileInfo", "SP.SharedWithUser", "SP.TabItem", "SP.RequestedTranslation", "SP.NgspRequestParams", "SP.HubSiteCreationInformation", "SP.UserCreationInformation", "SP.KnowledgeHubSiteReference", "SP.TranslationNotificationRecipient", "SP.LabelAccessControlData", "SP.ListItemDeleteParameters", "SP.ContentControlInfo", "SP.RecipientLimitsInfo", "SP.AgreementLocation", "SP.ContentAssemblyFormAnswer", "SP.CopyJobProgress", "SP.FolderCollectionAddParameters", "SP.ListItemCollectionPosition", "SP.ItemOrderUpdateValue", "SP.SyntexCustomModelDeploymentProperties", "SP.MachineLearningSampleMeta", "SP.LockFileData", "SP.UpdateTemplateInfoV2", "SP.GetNextAgreementWorkFlowRequest", "SP.SimpleDataRow", "SP.ListItemUpdateParameters", "SP.XmlSchemaFieldCreationInformation", "SP.AppSiteContext", "SP.SharePointIds", "SP.AgreementWorkFlowResponse", "SP.ChangeLogItemQuery", "SP.CreateTemplateResponse", "SP.ColumnSet", "SP.ListDataValidationExceptionValue", "SP.SPInvitationCreationResult", "SP.VisualizationField", "SP.ContextWebInformation", "SP.RelatedItem", "SP.ActionShowCard", "SP.AdaptiveCardImage", "SP.ContentTypeCreationInformation", "SP.TemplatizationMetaData", "SP.RecycleBinQueryInformation", "SP.ListDataValidationFailure", "SP.SharingLinkInfo", "SP.ActionToggleVisibility", "SP.SmartTemplateContentType", "SP.SPRuleAction", "SP.ScriptSafeDomainEntityData", "SP.LibraryDetails", "SP.IngestionTaskKey", "SP.CustomActionElementCollection", "SP.MoveCopyOptions", "SP.FontPackageCreationParameters", "SP.Language", "SP.UpdateAgreementESignConfigPayload", "SP.SPImageItem", "SP.SPResourceEntry", "SP.RestrictContentOrgWidePolicyUpdate", "SP.SPListRule", "SP.EncryptionOption", "SP.SiteAISettingsRequest", "SP.GridInitInfoType", "SP.Container", "SP.InputChoiceSet", "SP.FollowedSitesParams", "SP.SyntexCustomModelSetting", "SP.ProvisionedTemporaryAzureContainerInfo", "SP.AgreementCountryResponse", "SP.ActionOpenUrl", "SP.AgreementPermissionsData", "SP.UpdateAgreementMetaDataPayload", "SP.AttachmentCreationInformation", "SP.TranslationNotificationRecipientCollection", "SP.ClassificationResult", "SP.CreatableItemInfoCollection", "SP.CurrencyInformation", "SP.AccessRequestResponse", "SP.RenderListDataOverrideParameters", "SP.RecentSitesParams", "SP.PublishTemplateV2Payload", "SP.HomeSiteReference", "SP.AdditionalAccessStatusResponse", "SP.ContentAssemblyModernTemplateColumnsMappingInfo", "SP.ManageChannelCapabilitiesRequest", "SP.FileCreationInformation", "SP.ApprovalsCreateRequestParameters", "SP.SharedWithUserCollection", "SP.AutoLabellingWorkInformation", "SP.CountByDate", "SP.ListItemComplianceInfo", "SP.ConfigurationData", "SP.AgreementImportData", "SP.CAAESnippetElement", "SP.OwnedByMeParams", "SP.FieldGeolocationValue", "SP.SiteAISettings", "SP.TemplateMetaData", "SP.ResourceVisualization", "SP.ActionSet", "SP.MultiGeoCopyParameters", "SP.SPMoveAndShareFileInfo", "SP.AppLicense", "SP.FieldRatingScaleQuestionAnswer", "SP.DestinationLibraryInfo", "SP.CreateAgreementFolderInfo", "SP.ChangeToken", "SP.TranslationStatusSetRequest", "SP.SPAgreementResults", "SP.ActionSubmit", "SP.FieldUserValue", "SP.AgreementDocument", "SP.ListDataSource", "SP.CustomerKeyStatusInfo", "SP.GetListsParameters", "SP.AgreementReportBaseData", "SP.TranslationStatusCreationRequest", "SP.CAAEFieldElement", "SP.TenantAppInformation", "SP.DashboardItemInfo", "SP.AppViewCreationInfo", "SP.SiteSuggestionItem", "SP.DesktopSettings", "SP.ListItemUpdateResults", "SP.HomeSitesDetails", "SP.FieldCalculatedErrorValue", "SP.CustomizedFormsPage", "SP.ExceptionDetails", "SP.CamlQuery", "SP.RenderListContextMenuDataParameters", "SP.TextBlock", "SP.ThreadEngagementData", "SP.AgreementReportFilter", "SP.CardElement", "SP.PublishSnippetPayload", "SP.RecentFilesParams", "SP.GroupCreationInformation", "SP.ViewCreationInformation", "SP.OrganizationNewsSiteReference", "SP.AppProperties", "SP.DocumentLocation", "SP.AsyncReadOptions", "SP.AgreementSearchParameters", "SP.AgreementMetaData", "SP.EnqueueJobInformation", "SP.FileVersionBatchDeleteParameters", "SP.UpdateAgreementStatePayload", "SP.RenderListFilterDataParameters", "SP.CreateHVCSItemApprovalRequestParameters", "SP.Visualization", "SP.EffectiveBasePermissions", "SP.AgreementsSolutionEnabledSitesResponse", "SP.Placeholder", "SP.SPRuleUserInfo", "SP.SyntexCustomModelDeploymentModelInfo", "SP.TranslationNotificationRecipientSetRequest", "SP.BasePermissions", "SP.ChannelCapabilities", "SP.SiteSuggestionResponse", "SP.ActionHttp"]
+["SP.TabItem", "SP.CreatableItemInfoCollection", "SP.ListItemVersionCollectionPosition", "SP.ListItemComplianceInfo", "SP.FieldCalculatedErrorValue", "SP.RecipientLimitsInfo", "SP.CustomerKeyInfo", "SP.SharedWithUserCollection", "SP.RequestedTranslation", "SP.ContentTypeCreationInformation", "SP.SharingLinkData", "SP.VivaHomeTitleRegion", "SP.ActionOpenUrl", "SP.SuggestedSitesParams", "SP.SharingLinkInfo", "SP.MobileSettings", "SP.DocumentLibraryInformation", "SP.FileVersionBatchDeleteParameters", "SP.EnqueueJobInformation", "SP.RulesDefinitionGroup", "SP.SPInvitationCreationResult", "SP.HubSiteCreationInformation", "SP.ApprovalsProperties", "SP.EncryptionOption", "SP.BrandCenterConfiguration", "SP.FieldCreationInformation", "SP.VivaConnectionsLicense", "SP.VisualizationField", "SP.RelatedItem", "SP.AgreementDocument", "SP.FileDeleteParameters", "SP.ContentTypeId", "SP.LabelAccessControlData", "SP.ItemOrderUpdateValue", "SP.UpdateAgreementMetaDataPayload", "SP.RenderListDataParameters", "SP.LockFileData", "SP.BaseRequestParams", "SP.SPResourceEntry", "SP.NavigationNodeCreationInformation", "SP.ListItemUpdateParameters", "SP.TranslationNotificationRecipient", "SP.RenderListFilterDataParameters", "SP.SyntexCustomModelDeploymentModelInfo", "SP.MenuState", "SP.SPFocalPoint", "SP.ListItemFormUpdateValue", "SP.EventReceiverDefinitionCreationInformation", "SP.SPListItemVersionChange", "SP.CountByDate", "SP.DashboardItem", "SP.AdaptiveCardAction", "SP.Directory.GroupNameValidationResultErrorParams", "SP.ListDataValidationExceptionValue", "SP.SPImageItem", "SP.ActionSet", "SP.ContentAssemblyFormAnswer", "SP.Padding", "SP.CustomizedFormsPageCollection", "SP.SyntexCustomModelSetting", "SP.RestrictContentOrgWidePolicyUpdate", "SP.UpdateAgreementStatePayload", "SP.SiteSuggestionResponse", "SP.TenantAppInformation", "SP.VisualizationAppInfo", "SP.ListItemCreationInformation", "SP.SharePointIds", "SP.LibraryDetails", "SP.AppSettingsInTeams", "SP.SmartTemplateContentType", "SP.ApprovalsCreateRequestParameters", "SP.MachineLearningSampleMeta", "SP.SemanticSearchCrawlerEnqueueItem", "SP.CustomActionElement", "SP.AppSiteContext", "SP.ActionToggleVisibility", "SP.SensitivityLabelInfo", "SP.FolderColoringInformation", "SP.CAFieldValue", "SP.AgreementLocation", "SP.ReviewerInfo", "SP.ActionSubmit", "SP.InsertFieldResponse", "SP.NgspRequestParams", "SP.CurrencyInformation", "SP.AsyncReadOptions", "SP.PublishModernTemplatePayload", "SP.ChangeLogItemQuery", "SP.SiteAISettingsRequest", "SP.DashboardItemInfo", "SP.ListForm", "SP.UpdateTemplateInfo", "SP.AdaptiveCardImage", "SP.ExceptionDetails", "SP.DocumentLocation", "SP.FileCreationInformation", "SP.GetListsParameters", "SP.CreatableItemInfo", "SP.PowerPlatformEnvironment", "SP.AgreementDataPair", "SP.CustomerKeyVaultInfo", "SP.RecentSitesParams", "SP.RecentFilesParams", "SP.TranslationNotificationRecipientCollection", "SP.AgreementSearchParameters", "SP.TemplatizationMetaData", "SP.AgreementsSolutionFileContext", "SP.ClassificationResult", "SP.SiteSuggestionItem", "SP.AdditionalAccessStatusResponse", "SP.AdaptiveCardColumn", "SP.UserIdInfo", "SP.AppLicense", "SP.MediaServiceUpdateParameters", "SP.HomeSiteNavConfiguration", "SP.ProvisionedTemporaryAzureContainerInfo", "SP.CurrencyInformationCollection", "SP.ThreadEngagementData", "SP.Visualization", "SP.SPMoveAndShareFileInfo", "SP.HomeSiteReference", "SP.ListDataSource", "SP.RoleDefinitionCreationInformation", "SP.FollowedSitesParams", "SP.ContextWebInformation", "SP.CreateAgreementFolderInfo", "SP.AutoLabellingWorkInformation", "SP.ContentTypeEntityData", "SP.ContentControlInfo", "SP.PlaceholderV2", "SP.ResourceVisualization", "SP.PivotItem", "SP.Audience", "SP.AppViewCreationInfo", "SP.MainLinkDetails", "SP.CreateTemplateResponse", "SP.AdaptiveCard", "SP.FieldLookupValue", "SP.HomeSitesDetails", "SP.RulesProperties", "SP.ViewCreationInformation", "SP.ThemeData", "SP.Snippet", "SP.ChannelCapabilities", "SP.FieldValuesWithUrl", "SP.TranslationStatus", "SP.SPRuleUserInfo", "SP.ListCollectionPosition", "SP.MigrationJobProgress", "SP.RulesDefinition", "SP.UsageInfo", "SP.AlertCreationInformation", "SP.SPTeamChannelCapabilities", "SP.WebCreationInformation", "SP.FolderCollectionAddParameters", "SP.AgreementReportFilter", "SP.OwnedByMeParams", "SP.EffectiveBasePermissions", "SP.EngageDistributionInfo", "SP.KnowledgeHubSiteReference", "SP.SPAgreementsSite", "SP.MoveCopyOptions", "SP.AgreementsSolutionEnabledSitesResponse", "SP.IngestionTaskKey", "SP.ActionHttp", "SP.SimpleDataRow", "SP.SiteThemes", "SP.ConfiguredUserInfo", "SP.AgreementMetaData", "SP.DeviationAnalysisRule", "SP.ProvisionedMigrationContainersInfo", "SP.SubwebQuery", "SP.ChangeQuery", "SP.CoAuthConfiguration", "SP.ConfigurationData", "SP.AgreementReportBaseData", "SP.CopyMigrationInfo", "SP.TextBlock", "SP.XmlSchemaFieldCreationInformation", "SP.Placeholder", "SP.CopyMigrationOptions", "SP.CopyJobProgress", "SP.ActionShowCard", "SP.RenderListDataOverrideParameters", "SP.AppLicenseCollection", "SP.VisualizationStyleSet", "SP.FieldUrlValue", "SP.SiteTemplate", "SP.CustomerKeyStatusInfo", "SP.TargetedSiteDetails", "SP.FontPackageCreationParameters", "SP.GetListItemVersionsParameters", "SP.HTMLFieldSecuritySetting", "SP.SimpleDataTable", "SP.SPHSiteReference", "SP.CustomizedFormsPage", "SP.AppProperties", "SP.Container", "SP.PublishTemplateV2Payload", "SP.InputChoiceSet", "SP.InputText", "SP.VivaConnectionsUrlConfiguration", "SP.SystemSiteLockExpirationResult", "SP.FieldGeolocationValue", "SP.TemplateMetaData", "SP.CreateHVCSItemApprovalRequestParameters", "SP.TranslationNotificationRecipientSetRequest", "SP.CamlQuery", "SP.FolderDeleteParameters", "SP.RecycleBinQueryInformation", "SP.Hashtag", "SP.AgreementWorkFlowResponse", "SP.RulesValidationEntryResponse", "SP.AgreementSummaryData", "SP.ListItemCreationInformationUsingPath", "SP.CustomActionElementCollection", "SP.UpgradeInfo", "SP.AgreementPermissionsData", "SP.TranslationStatusSetRequest", "SP.AgreementImportData", "SP.TemporaryFolderFileInfo", "SP.GetNextAgreementWorkFlowRequest", "SP.UpdateAgreementESignConfigPayload", "SP.RenderListContextMenuDataParameters", "SP.CardElement", "SP.ContentAssemblyFileInfo", "SP.AgreementDocumentsInfo", "SP.Language", "SP.ListItemCollectionPosition", "SP.DestinationLibraryInfo", "SP.ContentAssemblyModernTemplateColumnsMappingInfo", "SP.TranslationStatusCreationRequest", "SP.RestrictAccessControlUpdate", "SP.CAAEFieldElement", "SP.GroupCreationInformation", "SP.OrganizationNewsSiteReference", "SP.FavoritedItemsParams", "SP.BasePermissions", "SP.MultiGeoCopyParameters", "SP.MenuNode", "SP.WorkflowConfigurationResponse", "SP.PublishSnippetPayload", "SP.ColumnSet", "SP.AsyncReadJobInfo", "SP.TimeZoneInformation", "SP.ListDataValidationFailure", "SP.ListCreationInformation", "SP.UpdateUploadedAgreementMetadataPayload", "SP.UpdateTemplateInfoV2", "SP.CAAESnippetElement", "SP.ColumnTypeInfo", "SP.ProvisionedMigrationQueueInfo", "SP.FieldRatingScaleQuestionAnswer", "SP.ListItemDeleteParameters", "SP.AgreementLocationData", "SP.FieldUserValue", "SP.UploadDocumentInfo", "SP.SharedWithUser", "SP.AccessRequestResponse", "SP.ScriptSafeDomainEntityData", "SP.ManageChannelCapabilitiesRequest", "SP.SyntexCustomModelDeploymentProperties", "SP.WebInfoCreationInformation", "SP.SPRuleAction", "SP.SiteAISettings", "SP.SPListRule", "SP.ChangeToken", "SP.SPAgreementResults", "SP.DocumentGenerationInfo", "SP.VersionPolicySelectionParameters", "SP.InputChoice", "SP.DesktopSettings", "SP.Directory.GroupNameValidationResult", "SP.FontOption", "SP.PortalAndOrgNewsSiteReference", "SP.AgreementCountryResponse", "SP.GridInitInfoType", "SP.UserCreationInformation", "SP.AttachmentCreationInformation", "SP.ListItemUpdateResults", "SP.FileCollectionAddParameters", "SP.TenantThemes"]

office365/intune/devices/device.py

@@ -19,6 +19,10 @@ class Device(DirectoryObject):
     def __repr__(self):
         return self.device_id or self.entity_type_name
 
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.Device"
+
     @property
     def account_enabled(self) -> Optional[bool]:
         """true if the account is enabled; otherwise, false. Required. Default is true.

office365/onenote/sectiongroups/section_group.py

@@ -7,6 +7,7 @@
 from office365.onenote.notebooks.notebook import Notebook
 from office365.onenote.sections.section import OnenoteSection
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.types.odata_property import odata
 
 
 class SectionGroup(OnenoteEntityHierarchyModel):
@@ -24,6 +25,7 @@ def sections_url(self) -> Optional[str]:
         """The URL for the sections navigation property, which returns all the sections in the section group."""
         return self.properties.get("sectionsUrl", None)
 
+    @odata(name="parentNotebook")
     @property
     def parent_notebook(self) -> Notebook:
         """The notebook that contains the section group. Read-only."""
@@ -44,6 +46,7 @@ def sections(self) -> EntityCollection[OnenoteSection]:
             ),
         )
 
+    @odata(name="sectionGroups")
     @property
     def section_groups(self) -> EntityCollection[SectionGroup]:
         """Retrieve a list of onenoteSection objects from the specified notebook."""
@@ -55,12 +58,3 @@ def section_groups(self) -> EntityCollection[SectionGroup]:
                 ResourcePath("sectionGroups", self.resource_path),
             ),
         )
-
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "parentNotebook": self.parent_notebook,
-                "sectionGroups": self.section_groups,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)