directory & teams new types and methods

Author: vgrem

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/Graph.xml",
+    default="./metadata/SharePoint.xml",
     help="Import metadata endpoint",
 )
 

generator/metadata/Graph.xml

@@ -4,6 +4,7 @@
     InvitationParticipantInfo,
 )
 from office365.communications.calls.participant_info import ParticipantInfo
+from office365.communications.onlinemeetings.restricted import OnlineMeetingRestricted
 from office365.communications.operations.invite_participants import (
     InviteParticipantsOperation,
 )
@@ -73,3 +74,8 @@ def metadata(self):
         # type: () -> Optional[str]
         """A blob of data provided by the participant in the roster."""
         return self.properties.get("metadata", None)
+
+    @property
+    def restricted_experience(self):
+        """Information about the reason or reasons media content from a participant is restricted."""
+        return self.properties.get("restrictedExperience", OnlineMeetingRestricted())

generator/metadata/SharePoint.xml

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class OnlineMeetingRestricted(ClientValue):
+    """Indicates the reason or reasons media content from a participant is restricted."""

office365/communications/calls/participant.py

@@ -9,6 +9,17 @@ class ApplicationCollection(DeltaCollection[Application]):
     def __init__(self, context, resource_path=None):
         super(ApplicationCollection, self).__init__(context, Application, resource_path)
 
+    def add(self, display_name, **kwargs):
+        """
+        Create a new application object.
+        :param str display_name: Display name of the application.
+        """
+        props = {
+            "displayName": display_name,
+            **kwargs,
+        }
+        return super(ApplicationCollection, self).add(**props)
+
     def get_by_app_id(self, app_id):
         # type: (str) -> Application
         """Retrieves application by Application client identifier

office365/communications/onlinemeetings/restricted.py

@@ -56,3 +56,12 @@ def user_consent_requests(self):
                 self.context, ResourcePath("userConsentRequests", self.resource_path)
             ),
         )
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "pendingScopes": self.pending_scopes,
+                "userConsentRequests": self.user_consent_requests,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(AppConsentRequest, self).get_property(name, default_value)

office365/directory/applications/collection.py

@@ -1,4 +1,4 @@
-from office365.directory.protection.threatassessment.request import (
+from office365.directory.protection.threatassessment.requests.request import (
     ThreatAssessmentRequest,
 )
 from office365.entity import Entity
@@ -11,6 +11,23 @@
 class InformationProtection(Entity):
     """Exposes methods that you can use to get Microsoft Purview Information Protection labels and label policies."""
 
+    def create_url_assessment(self, url, expected_assessment, category):
+        """Create a new threat assessment request."""
+        from office365.directory.protection.threatassessment.requests.url import (
+            UrlAssessmentRequest,
+        )
+
+        return_type = UrlAssessmentRequest(self.context)
+        return_type.set_property("url", url)
+        return_type.set_property("expectedAssessment", expected_assessment)
+        return_type.set_property("category", category)
+        self.threat_assessment_requests.add_child(return_type)
+        qry = CreateEntityQuery(
+            self.threat_assessment_requests, return_type, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def create_mail_assessment(
         self, message, recipient=None, expected_assessment="block", category="spam"
     ):
@@ -22,7 +39,7 @@ def create_mail_assessment(
         :param str category:
         """
 
-        from office365.directory.protection.threatassessment.mail_request import (
+        from office365.directory.protection.threatassessment.requests.mail import (
             MailAssessmentRequest,
         )
 

office365/directory/identitygovernance/appconsent/request.py

@@ -1,6 +1,6 @@
 from typing import Optional
 
-from office365.directory.protection.threatassessment.request import (
+from office365.directory.protection.threatassessment.requests.request import (
     ThreatAssessmentRequest,
 )
 
@@ -18,3 +18,11 @@ def content_data(self):
         Base64 encoded .eml email file content. The file content can't fetch back because it isn't stored.
         """
         return self.properties.get("contentData", None)
+
+    @property
+    def file_name(self):
+        # type: () -> Optional[str]
+        """
+        Base64 encoded .eml email file content. The file content can't fetch back because it isn't stored.
+        """
+        return self.properties.get("fileName", None)

office365/directory/protection/information.py

@@ -1,4 +1,4 @@
-from office365.directory.protection.threatassessment.request import (
+from office365.directory.protection.threatassessment.requests.request import (
     ThreatAssessmentRequest,
 )
 

office365/directory/protection/threatassessment/requests/__init__.py

@@ -0,0 +1,9 @@
+from office365.directory.protection.threatassessment.requests.request import (
+    ThreatAssessmentRequest,
+)
+
+
+class UrlAssessmentRequest(ThreatAssessmentRequest):
+    """
+    Used to create and retrieve a URL threat assessment, derived from threatAssessmentRequest.
+    """

office365/directory/protection/threatassessment/email_file_request.py renamed to office365/directory/protection/threatassessment/requests/email_file.py

@@ -0,0 +1,14 @@
+from office365.entity import Entity
+
+
+class AppScope(Entity):
+    """
+    The scope of a role assignment determines the set of resources for which the principal has been granted access.
+    An app scope is a scope defined and understood by a specific application, unlike directory scopes that are
+    shared scopes stored in the directory and understood by multiple applications.
+
+    This may be in both the following principal and scope scenarios:
+
+    A single principal and a single scope
+    Multiple principals and multiple scopes.
+    """

office365/directory/protection/threatassessment/mail_request.py renamed to office365/directory/protection/threatassessment/requests/mail.py

@@ -1,10 +1,10 @@
 from office365.directory.identitygovernance.privilegedaccess.unified_role_assignment_schedule_request import (
     UnifiedRoleAssignmentScheduleRequest,
 )
-from office365.directory.rolemanagement.unified_role_assignment import (
+from office365.directory.rolemanagement.unifiedrole.assignment import (
     UnifiedRoleAssignment,
 )
-from office365.directory.rolemanagement.unified_role_definition import (
+from office365.directory.rolemanagement.unifiedrole.definition import (
     UnifiedRoleDefinition,
 )
 from office365.entity import Entity
@@ -31,6 +31,7 @@ def role_assignments(self):
             ),
         )
 
+    @property
     def role_definitions(self):
         # type: () -> EntityCollection[UnifiedRoleDefinition]
         """Resource representing the roles allowed by RBAC providers and the permissions assigned to the roles."""

office365/directory/protection/threatassessment/request.py renamed to office365/directory/protection/threatassessment/requests/request.py

@@ -1,6 +1,7 @@
 from typing import Optional
 
-from office365.directory.rolemanagement.unified_role_definition import (
+from office365.directory.rolemanagement.app_scope import AppScope
+from office365.directory.rolemanagement.unifiedrole.definition import (
     UnifiedRoleDefinition,
 )
 from office365.entity import Entity
@@ -30,6 +31,29 @@ def condition(self):
         """ """
         return self.properties.get("condition", None)
 
+    @property
+    def principal_id(self):
+        # type: () -> Optional[str]
+        """Identifier of the principal to which the assignment is granted. Supported principals are users,
+        role-assignable groups, and service principals. Supports $filter (eq, in)."""
+        return self.properties.get("principalId", None)
+
+    @property
+    def role_definition_id(self):
+        # type: () -> Optional[str]
+        """Identifier of the unifiedRoleDefinition the assignment is for. Read-only. Supports $filter (eq, in)."""
+        return self.properties.get("roleDefinitionId", None)
+
+    @property
+    def directory_scope_id(self):
+        # type: () -> Optional[str]
+        """Identifier of the directory object representing the scope of the assignment.
+        The scope of an assignment determines the set of resources for which the principal has been granted access.
+        Directory scopes are shared scopes stored in the directory that are understood by multiple applications,
+        unlike app scopes that are defined and understood by a resource application only. Supports $filter (eq, in).
+        """
+        return self.properties.get("directoryScopeId", None)
+
     @property
     def role_definition(self):
         """
@@ -42,9 +66,21 @@ def role_definition(self):
             ),
         )
 
+    @property
+    def app_scope(self):
+        """
+        Read-only property with details of the app specific scope when the assignment scope is app specific.
+        Containment entity. Supports $expand for the entitlement provider only.
+        """
+        return self.properties.get(
+            "appScope",
+            AppScope(self.context, ResourcePath("appScope", self.resource_path)),
+        )
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "appScope": self.app_scope,
                 "roleDefinition": self.role_definition,
             }
             default_value = property_mapping.get(name, None)

office365/directory/protection/threatassessment/requests/url.py

@@ -1,6 +1,6 @@
 from typing import Optional
 
-from office365.directory.rolemanagement.unified_role_permission import (
+from office365.directory.rolemanagement.unifiedrole.permission import (
     UnifiedRolePermission,
 )
 from office365.entity import Entity
@@ -13,6 +13,9 @@ class UnifiedRoleDefinition(Entity):
     """A role definition is a collection of permissions in Azure Active Directory (Azure AD) listing the operations
     that can be performed and the resources against which they can performed."""
 
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
     @property
     def display_name(self):
         # type: () -> Optional[str]
@@ -29,6 +32,7 @@ def is_built_in(self):
 
     @property
     def role_permissions(self):
+        # type: () -> ClientValueCollection[UnifiedRolePermission]
         """
         List of permissions included in the role. Read-only when isBuiltIn is true. Required.
         """
@@ -56,6 +60,7 @@ def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "inheritsPermissionsFrom": self.inherits_permissions_from,
+                "rolePermissions": self.role_permissions,
             }
             default_value = property_mapping.get(name, None)
         return super(UnifiedRoleDefinition, self).get_property(name, default_value)

office365/directory/rolemanagement/app_scope.py

@@ -57,6 +57,11 @@ def created_datetime(self):
         """Set by the server. DateTime in UTC when the object was created on the server."""
         return self.properties.get("createdDateTime", datetime.min)
 
+    @property
+    def expiration_datetime(self):
+        """Set by the server. DateTime in UTC when the object was created on the server."""
+        return self.properties.get("expirationDateTime", datetime.min)
+
     @property
     def history_items(self):
         """NavigationProperty/Containment; navigation property to the associated activity."""
@@ -75,6 +80,10 @@ def history_items(self):
 
     def get_property(self, name, default_value=None):
         if default_value is None:
-            property_mapping = {"historyItems": self.history_items}
+            property_mapping = {
+                "createdDateTime": self.created_datetime,
+                "expirationDateTime": self.expiration_datetime,
+                "historyItems": self.history_items,
+            }
             default_value = property_mapping.get(name, None)
         return super(UserActivity, self).get_property(name, default_value)

office365/directory/rolemanagement/application.py

@@ -14,6 +14,9 @@
 from office365.directory.authentication.authentication import Authentication
 from office365.directory.extensions.extension import Extension
 from office365.directory.identities.object_identity import ObjectIdentity
+from office365.directory.identitygovernance.termsofuse.agreement_acceptance import (
+    AgreementAcceptance,
+)
 from office365.directory.insights.office_graph import OfficeGraphInsights
 from office365.directory.licenses.assigned_license import AssignedLicense
 from office365.directory.licenses.assigned_plan import AssignedPlan
@@ -55,6 +58,7 @@
 from office365.outlook.mail.messages.message import Message
 from office365.outlook.mail.recipient import Recipient
 from office365.outlook.mail.tips.tips import MailTips
+from office365.outlook.person import Person
 from office365.outlook.user import OutlookUser
 from office365.planner.user import PlannerUser
 from office365.runtime.client_result import ClientResult
@@ -69,6 +73,7 @@
 from office365.runtime.types.collections import StringCollection
 from office365.teams.chats.collection import ChatCollection
 from office365.teams.collection import TeamCollection
+from office365.teams.teamwork.shiftmanagement.user_solution_root import UserSolutionRoot
 from office365.teams.teamwork.user import UserTeamwork
 from office365.teams.viva.employee_experience_user import EmployeeExperienceUser
 from office365.todo.todo import Todo
@@ -1025,6 +1030,17 @@ def outlook(self):
             OutlookUser(self.context, ResourcePath("outlook", self.resource_path)),
         )
 
+    @property
+    def people(self):
+        # type: () -> EntityCollection[Person]
+        """People that are relevant to the user. Read-only. Nullable."""
+        return self.properties.get(
+            "people",
+            EntityCollection(
+                self.context, Person, ResourcePath("people", self.resource_path)
+            ),
+        )
+
     @property
     def onenote(self):
         # type: () -> Onenote
@@ -1050,6 +1066,20 @@ def planner(self):
             PlannerUser(self.context, ResourcePath("planner", self.resource_path)),
         )
 
+    @property
+    def agreement_acceptances(self):
+        """
+        The user's terms of use acceptance statuses
+        """
+        return self.properties.get(
+            "agreementAcceptances",
+            EntityCollection(
+                self.context,
+                AgreementAcceptance,
+                ResourcePath("agreementAcceptances", self.resource_path),
+            ),
+        )
+
     @property
     def extensions(self):
         # type: () -> EntityCollection[Extension]
@@ -1140,6 +1170,17 @@ def teamwork(self):
             UserTeamwork(self.context, ResourcePath("teamwork", self.resource_path)),
         )
 
+    @property
+    def solutions(self):
+        # type: () -> UserSolutionRoot
+        """The identifier that relates the user to the working time schedule triggers. Read-Only. Nullable."""
+        return self.properties.get(
+            "solutions",
+            UserSolutionRoot(
+                self.context, ResourcePath("solutions", self.resource_path)
+            ),
+        )
+
     @property
     def todo(self):
         # type: () -> Todo

office365/directory/rolemanagement/unifiedrole/__init__.py

@@ -73,7 +73,7 @@ def create_typed_object(self, initial_properties=None, resource_path=None):
 
     def set_property(self, key, value, persist_changes=False):
         # type: (str | int, dict, bool) -> Self
-        if key == "__deltaLinkUrl":
+        if key == self.context.pending_request().json_format.collection_delta:
             self._delta_request_url = value
         else:
             super(EntityCollection, self).set_property(key, value, persist_changes)