Introduced support for M365 Backup Storage service

Author: vgrem

examples/directory/applications/get_delegated_permissions.py renamed to examples/directory/applications/get_delegated_perms.py

@@ -5,7 +5,12 @@
 """
 
 from office365.graph_client import GraphClient
-from tests import test_client_id, test_password, test_tenant, test_username
+from tests import (
+    test_client_id,
+    test_password,
+    test_tenant,
+    test_username,
+)
 
 client = GraphClient.with_username_and_password(
     test_tenant, test_client_id, test_username, test_password

examples/directory/applications/grant_delegated_perms.py

@@ -21,16 +21,7 @@
 
 
 resource = client.service_principals.get_by_name("Microsoft Graph")
-app_role = "User.Read.All"
+# app_role = "User.Read.All"
+app_role = "BackupRestore-Control.Read.All"
 user = client.users.get_by_principal_name(test_user_principal_name)
 resource.grant_delegated(test_client_id, user, app_role).execute_query()
-
-
-# Confirm and print permission grants
-result = (
-    client.oauth2_permission_grants.filter("clientId eq '{0}'".format(test_client_id))
-    .get()
-    .execute_query()
-)
-for grant in result:
-    print(grant)

examples/directory/applications/has_delegated_perms.py

@@ -0,0 +1,34 @@
+"""
+Determines whether the delegated permissions is defined by the Microsoft Graph service principal in the tenant.
+
+https://learn.microsoft.com/en-us/graph/permissions-grant-via-msgraph?tabs=http&pivots=grant-delegated-permissions
+"""
+
+from office365.graph_client import GraphClient
+from tests import (
+    test_admin_principal_name,
+    test_client_id,
+    test_password,
+    test_tenant,
+    test_user_principal_name,
+    test_username,
+)
+
+# client = GraphClient.with_username_and_password(
+#    test_tenant, test_client_id, test_username, test_password
+# )
+client = GraphClient.with_token_interactive(
+    test_tenant, test_client_id, test_admin_principal_name
+)
+
+resource = client.service_principals.get_by_name("Microsoft Graph")
+# app_role = "User.Read.All"
+app_role = "BackupRestore-Control.Read.All"
+user = client.users.get_by_principal_name(test_admin_principal_name)
+client_app = client.applications.get_by_app_id(test_client_id)
+# result = resource.get_delegated(client_app, user, app_role).execute_query()
+result = resource.get_delegated(test_client_id, user, app_role).execute_query()
+if len(result) == 0:
+    print("Delegated permission '{0}' is not set".format(app_role))
+else:
+    print(result.value)

examples/directory/applications/list_delegated_perms.py

@@ -0,0 +1,28 @@
+"""
+How to grant and revoke delegated permissions for an app using Microsoft Graph.
+Delegated permissions, also called scopes or OAuth2 permissions, allow an app to call an API
+on behalf of a signed-in user.
+
+
+https://learn.microsoft.com/en-us/graph/permissions-grant-via-msgraph?tabs=http&pivots=grant-delegated-permissions
+"""
+
+from office365.graph_client import GraphClient
+from tests import (
+    test_admin_principal_name,
+    test_client_id,
+    test_tenant,
+    test_user_principal_name,
+)
+
+client = GraphClient.with_token_interactive(
+    test_tenant, test_client_id, test_admin_principal_name
+)
+
+
+resource = client.service_principals.get_by_name("Microsoft Graph")
+user = client.users.get_by_principal_name(test_user_principal_name)
+result = resource.get_delegated(test_client_id, user).execute_query()
+
+for grant in result:
+    print(grant)

examples/onedrive/lists/list_in_site.py

@@ -10,4 +10,4 @@
 client = GraphClient.with_client_secret(test_tenant, test_client_id, test_client_secret)
 lists = client.sites.root.lists.get().execute_query()
 for lst in lists:
-    print(lst.display_name)
+    print(lst)

generator/import_metadata.py

@@ -26,13 +26,13 @@ def export_to_file(path, content):
     "--endpoint",
     dest="endpoint",
     help="Import metadata endpoint",
-    default="graph",
+    default="sharepoint",
 )
 parser.add_argument(
     "-p",
     "--path",
     dest="path",
-    default="./metadata/MicrosoftGraph.xml",
+    default="./metadata/SharePoint.xml",
     help="Import metadata endpoint",
 )
 

generator/metadata/MicrosoftGraph.xml

@@ -16894,6 +16894,12 @@
          <Annotations Target="microsoft.graph.disconnect(microsoft.graph.remoteAssistancePartner)">
             <Annotation Term="Org.OData.Core.V1.Description" String="A request to remove the active TeamViewer connector"/>
          </Annotations>
+         <Annotations Target="microsoft.graph.endWorkingTime(microsoft.graph.workingTimeSchedule)">
+            <Annotation Term="Org.OData.Core.V1.Description" String="Triggers the policies associated with the end of working hours for user."/>
+         </Annotations>
+         <Annotations Target="microsoft.graph.startWorkingTime(microsoft.graph.workingTimeSchedule)">
+            <Annotation Term="Org.OData.Core.V1.Description" String="Triggers the policies associated with the start of working hours for user."/>
+         </Annotations>
       </Schema>
       <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="microsoft.graph" Alias="graph">
          <EnumType Name="appliedConditionalAccessPolicyResult">
@@ -23017,6 +23023,7 @@
             <NavigationProperty Name="joinedTeams" Type="Collection(graph.team)" ContainsTarget="true"/>
             <NavigationProperty Name="permissionGrants" Type="Collection(graph.resourceSpecificPermissionGrant)" ContainsTarget="true"/>
             <NavigationProperty Name="teamwork" Type="graph.userTeamwork" ContainsTarget="true"/>
+            <NavigationProperty Name="solutions" Type="graph.userSolutionRoot" ContainsTarget="true"/>
             <NavigationProperty Name="todo" Type="graph.todo" ContainsTarget="true"/>
             <NavigationProperty Name="employeeExperience" Type="graph.employeeExperienceUser" ContainsTarget="true"/>
          </EntityType>
@@ -23446,6 +23453,9 @@
             <NavigationProperty Name="associatedTeams" Type="Collection(graph.associatedTeamInfo)" ContainsTarget="true"/>
             <NavigationProperty Name="installedApps" Type="Collection(graph.userScopeTeamsAppInstallation)" ContainsTarget="true"/>
          </EntityType>
+         <EntityType Name="userSolutionRoot" BaseType="graph.entity">
+            <NavigationProperty Name="workingTimeSchedule" Type="graph.workingTimeSchedule" ContainsTarget="true"/>
+         </EntityType>
          <EntityType Name="todo" BaseType="graph.entity">
             <NavigationProperty Name="lists" Type="Collection(graph.todoTaskList)" ContainsTarget="true"/>
          </EntityType>
@@ -34560,6 +34570,7 @@
             <Property Name="sharedTimeOff" Type="graph.timeOffItem"/>
             <Property Name="userId" Type="Edm.String"/>
          </EntityType>
+         <EntityType Name="workingTimeSchedule" BaseType="graph.entity"/>
          <EntityType Name="emailFileAssessmentRequest" BaseType="graph.threatAssessmentRequest">
             <Property Name="contentData" Type="Edm.String" Nullable="false"/>
             <Property Name="destinationRoutingReason" Type="graph.mailDestinationRoutingReason"/>
@@ -40310,6 +40321,12 @@
             <Parameter Name="startDateTime" Type="Edm.DateTimeOffset"/>
             <Parameter Name="endDateTime" Type="Edm.DateTimeOffset"/>
          </Action>
+         <Action Name="endWorkingTime" IsBound="true">
+            <Parameter Name="bindparameter" Type="graph.workingTimeSchedule" Nullable="false"/>
+         </Action>
+         <Action Name="startWorkingTime" IsBound="true">
+            <Parameter Name="bindparameter" Type="graph.workingTimeSchedule" Nullable="false"/>
+         </Action>
          <EntityContainer Name="GraphService">
             <EntitySet Name="directoryObjects" EntityType="microsoft.graph.directoryObject"/>
             <EntitySet Name="invitations" EntityType="microsoft.graph.invitation">