Office365-REST-Python-Client 2.6.0__py3-none-any.whl → 2.6.2__py3-none-any.whl

office365/admin/people_settings.py

@@ -1,5 +1,21 @@
 from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.outlook.people.profile_card_property import ProfileCardProperty
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class PeopleAdminSettings(Entity):
     """Represents a setting to control people-related admin settings in the tenant."""
+
+    @property
+    def profile_card_properties(self):
+        """Contains a collection of the properties an administrator has defined as visible on the
+        Microsoft 365 profile card."""
+        return self.properties.get(
+            "profileCardProperties",
+            EntityCollection(
+                self.context,
+                ProfileCardProperty,
+                ResourcePath("profileCardProperties", self.resource_path),
+            ),
+        )

office365/admin/sharepoint_settings.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import List, Optional
 
 from office365.entity import Entity
 from office365.onedrive.idle_session_signout import IdleSessionSignOut
@@ -39,6 +39,49 @@ class SharepointSettings(Entity):
         """Indicates whether comments are allowed on modern site pages in SharePoint."""
         return self.properties.get("isCommentingOnSitePagesEnabled", None)
 
+    @property
+    def sharing_allowed_domain_list(self):
+        # type: () -> StringCollection
+        """
+        Collection of email domains that are allowed for sharing outside the organization.
+        """
+        return self.properties.get("sharingAllowedDomainList", StringCollection())
+
+    @property
+    def sharing_blocked_domain_list(self):
+        # type: () -> StringCollection
+        """
+        Collection of email domains that are blocked for sharing outside the organization.
+        """
+        return self.properties.get("sharingBlockedDomainList", StringCollection())
+
+    @sharing_blocked_domain_list.setter
+    def sharing_blocked_domain_list(self, value):
+        # type: (List[str]) -> None
+        """Sets the collection of email domains that are blocked for sharing outside the organization."""
+        self.set_property("sharingBlockedDomainList", value)
+
+    @property
+    def sharing_capability(self):
+        # type: () -> Optional[str]
+        """
+        Sharing capability for the tenant.
+        Possible values are:
+            disabled,
+            externalUserSharingOnly,
+            externalUserAndGuestSharing,
+            existingExternalUserSharingOnly.
+        """
+        return self.properties.get("sharingCapability", None)
+
+    @property
+    def sharing_domain_restriction_mode(self):
+        # type: () -> Optional[str]
+        """
+        Specifies the external sharing mode for domains. Possible values are: none, allowList, blockList.
+        """
+        return self.properties.get("sharingDomainRestrictionMode", None)
+
     @property
     def site_creation_default_managed_path(self):
         # type: () -> Optional[str]
@@ -62,12 +105,18 @@ class SharepointSettings(Entity):
         """
         return self.properties.get("tenantDefaultTimezone", None)
 
+    @property
+    def entity_type_name(self):
+        return None
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "allowedDomainGuidsForSyncApp": self.allowed_domain_guids_for_sync_app,
                 "availableManagedPathsForSiteCreation": self.available_managed_paths_for_site_creation,
                 "excludedFileExtensionsForSyncApp": self.excluded_file_extensions_for_sync_app,
+                "sharingAllowedDomainList": self.sharing_allowed_domain_list,
+                "sharingBlockedDomainList": self.sharing_blocked_domain_list,
             }
             default_value = property_mapping.get(name, None)
         return super(SharepointSettings, self).get_property(name, default_value)

office365/admin/sharing_capabilities.py

@@ -0,0 +1,2 @@
+class SharingCapabilities:
+    """"""

office365/communications/calls/participant.py

@@ -4,6 +4,7 @@ from office365.communications.calls.invitation_participant_info import (
     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 @@ class Participant(Entity):
         # 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())

office365/communications/onlinemeetings/broadcast_settings.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class BroadcastMeetingSettings(ClientValue):
+    """Represents settings related to a live event in Microsoft Teams."""

office365/communications/onlinemeetings/collection.py

@@ -1,4 +1,5 @@
 from office365.communications.onlinemeetings.online_meeting import OnlineMeeting
+from office365.communications.onlinemeetings.recordings.call import CallRecording
 from office365.entity_collection import EntityCollection
 from office365.runtime.queries.create_entity import CreateEntityQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -65,3 +66,31 @@ class OnlineMeetingCollection(EntityCollection[OnlineMeeting]):
         )
         self.context.add_query(qry)
         return return_type
+
+    def get_all_recordings(
+        self, meeting_organizer_user_id, start_datetime=None, end_datetime=None
+    ):
+        """
+        Get all recordings from scheduled onlineMeeting instances for which the specified user is the organizer.
+        This API currently doesn't support getting call recordings from channel meetings.
+
+        :param str meeting_organizer_user_id: 	The user identifier of the meeting organizer to filter for artifacts
+            for meetings organized by the given user identifier.
+        :param datetime.datetime start_datetime: Optional parameter to filter for artifacts created after the given
+            start date. The timestamp type represents date and time information using ISO 8601 format and is always
+            in UTC
+        :param datetime.datetime end_datetime: Optional parameter to filter for artifacts created before the given
+            end date. The timestamp type represents date and time information using ISO 8601 format and is always
+            in UTC
+        """
+        return_type = EntityCollection(self.context, CallRecording)
+        payload = {
+            "meetingOrganizerUserId": meeting_organizer_user_id,
+            "startDateTime": start_datetime,
+            "endDateTime": end_datetime,
+        }
+        qry = ServiceOperationQuery(
+            self, "getAllRecordings", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type

office365/communications/onlinemeetings/online_meeting.py

@@ -124,7 +124,7 @@ class OnlineMeeting(Entity):
     @property
     def recordings(self):
         # type: () -> EntityCollection[CallRecording]
-        """he recordings of an online meeting"""
+        """The recordings of an online meeting"""
         return self.properties.get(
             "recordings",
             EntityCollection(

office365/communications/onlinemeetings/recordings/call.py

@@ -3,3 +3,8 @@ from office365.entity import Entity
 
 class CallRecording(Entity):
     """Represents a recording associated with an online meeting."""
+
+    @property
+    def call_id(self):
+        """The unique identifier for the call that is related to this recording. Read-only."""
+        return self.properties.get("callId", None)

office365/communications/onlinemeetings/restricted.py

@@ -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/directory/applications/collection.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/directory/audit/directory.py

@@ -2,7 +2,9 @@ import datetime
 from typing import Optional
 
 from office365.directory.audit.activity_initiator import AuditActivityInitiator
+from office365.directory.audit.target_resource import TargetResource
 from office365.entity import Entity
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class DirectoryAudit(Entity):
@@ -25,6 +27,14 @@ class DirectoryAudit(Entity):
         """
         return self.properties.get("activityDisplayName", None)
 
+    @property
+    def additional_details(self):
+        # type: () -> Optional[dict]
+        """
+        Indicates additional details on the activity.
+        """
+        return self.properties.get("additionalDetails", None)
+
     @property
     def category(self):
         # type: () -> Optional[str]
@@ -69,6 +79,14 @@ class DirectoryAudit(Entity):
         """
         return self.properties.get("loggedByService", None)
 
+    @property
+    def result(self):
+        # type: () -> Optional[str]
+        """
+        Indicates the result of the activity. Possible values are: success, failure, timeout, unknownFutureValue.
+        """
+        return self.properties.get("result", None)
+
     @property
     def result_reason(self):
         # type: () -> Optional[str]
@@ -77,11 +95,24 @@ class DirectoryAudit(Entity):
         """
         return self.properties.get("resultReason", None)
 
+    @property
+    def target_resources(self):
+        # type: () -> Optional[str]
+        """
+        Indicates information on which resource was changed due to the activity. Target Resource Type can be User,
+        Device, Directory, App, Role, Group, Policy or Other. Supports $filter (eq) for id and displayName;
+        and $filter (startswith) for displayName.
+        """
+        return self.properties.get(
+            "targetResources", ClientValueCollection(TargetResource)
+        )
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "activityDateTime": self.activity_datetime,
                 "initiatedBy": self.initiated_by,
+                "targetResources": self.target_resources,
             }
             default_value = property_mapping.get(name, None)
         return super(DirectoryAudit, self).get_property(name, default_value)

office365/directory/audit/signins/signin.py

@@ -3,8 +3,12 @@ from typing import Optional
 
 from office365.directory.audit.signins.location import SignInLocation
 from office365.directory.audit.signins.status import SignInStatus
+from office365.directory.policies.applied_conditional_access import (
+    AppliedConditionalAccessPolicy,
+)
 from office365.entity import Entity
 from office365.intune.devices.detail import DeviceDetail
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class SignIn(Entity):
@@ -24,6 +28,15 @@ class SignIn(Entity):
         """Unique GUID representing the app ID in the Azure Active Directory."""
         return self.properties.get("appId", None)
 
+    @property
+    def applied_conditional_access_policies(self):
+        # type: () -> Optional[str]
+        """Provides a list of conditional access policies that the corresponding sign-in activity triggers."""
+        return self.properties.get(
+            "appliedConditionalAccessPolicies",
+            ClientValueCollection(AppliedConditionalAccessPolicy),
+        )
+
     @property
     def client_app_used(self):
         # type: () -> Optional[str]
@@ -122,6 +135,7 @@ class SignIn(Entity):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "appliedConditionalAccessPolicies": self.applied_conditional_access_policies,
                 "createdDateTime": self.created_datetime,
                 "deviceDetail": self.device_detail,
             }

office365/directory/audit/target_resource.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TargetResource(ClientValue):
+    """Represents target resource types associated with audit activity."""

office365/directory/authentication/conditions/conditions.py

@@ -5,7 +5,11 @@ from office365.runtime.client_value import ClientValue
 
 
 class AuthenticationConditions(ClientValue):
-    """"""
+    """The conditions on which an authenticationEventListener should trigger."""
 
     def __init__(self, applications=AuthenticationConditionsApplications()):
+        """
+        :parm AuthenticationConditionsApplications applications: Applications which trigger a custom authentication
+        extension.
+        """
         self.applications = applications

office365/directory/datapolicy/operation.py

@@ -1,3 +1,6 @@
+from datetime import datetime
+from typing import Optional
+
 from office365.entity import Entity
 
 
@@ -7,3 +10,39 @@ class DataPolicyOperation(Entity):
     an operation. For example, a company administrator can submit a data policy operation request to export an
     employee's company data, and then later track that request.
     """
+
+    @property
+    def completed_datetime(self):
+        # type: () -> datetime
+        """Represents when the request for this data policy operation was completed"""
+        return self.properties.get("completedDateTime", datetime.min)
+
+    @property
+    def progress(self):
+        # type: () -> Optional[float]
+        """Specifies the progress of an operation."""
+        return self.properties.get("progress", None)
+
+    @property
+    def status(self):
+        # type: () -> Optional[str]
+        """Possible values are: notStarted, running, complete, failed, unknownFutureValue."""
+        return self.properties.get("status", None)
+
+    @property
+    def storage_location(self):
+        # type: () -> Optional[str]
+        """The URL location to where data is being exported for export requests."""
+        return self.properties.get("storageLocation", None)
+
+    @property
+    def submitted_datetime(self):
+        # type: () -> datetime
+        """Represents when the request for this data operation was submitted"""
+        return self.properties.get("submittedDateTime", datetime.min)
+
+    @property
+    def user_id(self):
+        # type: () -> Optional[str]
+        """The id for the user on whom the operation is performed."""
+        return self.properties.get("userId", None)

office365/directory/directory.py

@@ -4,6 +4,7 @@ from office365.directory.custom_security_attribute_definition import (
 )
 from office365.directory.device_local_credential_info import DeviceLocalCredentialInfo
 from office365.directory.object_collection import DirectoryObjectCollection
+from office365.directory.subscriptions.company import CompanySubscription
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.runtime.paths.resource_path import ResourcePath
@@ -50,6 +51,18 @@ class Directory(Entity):
             ),
         )
 
+    @property
+    def subscriptions(self):
+        """List of commercial subscriptions that an organization acquired."""
+        return self.properties.get(
+            "subscriptions",
+            EntityCollection(
+                self.context,
+                CompanySubscription,
+                ResourcePath("subscriptions", self.resource_path),
+            ),
+        )
+
     def deleted_items(self, entity_type=None):
         """Recently deleted items. Read-only. Nullable."""
         if entity_type:

office365/directory/identitygovernance/accessreview/instance.py

@@ -0,0 +1,29 @@
+from office365.directory.identitygovernance.accessreview.stages import (
+    AccessReviewStageCollection,
+)
+from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class AccessReviewInstance(Entity):
+    """
+    Represents a Microsoft Entra access review recurrence. If the parent accessReviewScheduleDefinition is a
+    recurring access review, instances represent each recurrence. A review that does not recur will have exactly
+    one instance. Instances also represent each unique group being reviewed in the schedule definition.
+    If a schedule definition reviews multiple groups, each group will have a unique instance for each recurrence.
+
+    Every accessReviewInstance contains a list of decisions that reviewers can take action on.
+    There is one decision per identity being reviewed.
+    """
+
+    @property
+    def stages(self):
+        # type: () -> AccessReviewStageCollection
+        """If the instance has multiple stages, this returns the collection of stages.
+        A new stage will only be created when the previous stage ends"""
+        return self.properties.get(
+            "stages",
+            AccessReviewStageCollection(
+                self.context, ResourcePath("stages", self.resource_path)
+            ),
+        )

office365/directory/identitygovernance/accessreview/stage.py

@@ -0,0 +1,13 @@
+from office365.entity import Entity
+
+
+class AccessReviewStage(Entity):
+    """
+    Represents a stage of a Microsoft Entra access review. If the parent accessReviewScheduleDefinition has defined
+    the stageSettings property, the accessReviewInstance is comprised of up to three subsequent stages.
+    Each stage may have a different set of reviewers who can act on the stage decisions, and settings determining
+    which decisions pass from stage to stage.
+
+    Every accessReviewStage contains a list of decision items for reviewers.
+    There's only one decision per identity being reviewed.
+    """

office365/directory/identitygovernance/accessreview/stages.py

@@ -0,0 +1,11 @@
+from office365.directory.identitygovernance.accessreview.stage import AccessReviewStage
+from office365.entity_collection import EntityCollection
+
+
+class AccessReviewStageCollection(EntityCollection[AccessReviewStage]):
+    """AccessReviewStage collection"""
+
+    def __init__(self, context, resource_path=None):
+        super(AccessReviewStageCollection, self).__init__(
+            context, AccessReviewStage, resource_path
+        )

office365/directory/identitygovernance/appconsent/request.py

@@ -56,3 +56,12 @@ class AppConsentRequest(Entity):
                 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/identitygovernance/privilegedaccess/group.py

@@ -1,5 +1,5 @@
 from office365.directory.identitygovernance.privilegedaccess.approval import Approval
-from office365.directory.identitygovernance.privilegedaccess.group_assignment_schedule_instance import (
+from office365.directory.identitygovernance.privilegedaccess.schedule.group_assignment_instance import (
     PrivilegedAccessGroupAssignmentScheduleInstance,
 )
 from office365.entity import Entity

office365/directory/identitygovernance/privilegedaccess/{group_assignment_schedule_instance.py → schedule/group_assignment_instance.py}

@@ -1,4 +1,4 @@
-from office365.directory.identitygovernance.privilegedaccess.schedule_instance import (
+from office365.directory.identitygovernance.privilegedaccess.schedule.instance import (
     PrivilegedAccessScheduleInstance,
 )
 

office365/directory/identitygovernance/privilegedaccess/schedule/schedule.py

@@ -0,0 +1,6 @@
+from office365.entity import Entity
+
+
+class PrivilegedAccessSchedule(Entity):
+    """An abstract type that exposes properties relating to the schedule of assigned and eligible membership and
+    ownership to groups that are governed by PIM."""

office365/directory/insights/trending.py

@@ -1,3 +1,7 @@
+from datetime import datetime
+from typing import Optional
+
+from office365.directory.insights.resource_reference import ResourceReference
 from office365.entity import Entity
 from office365.runtime.paths.resource_path import ResourcePath
 
@@ -8,6 +12,18 @@ class Trending(Entity):
     OneDrive files, and files stored on SharePoint team sites can trend around the user.
     """
 
+    @property
+    def last_modified_datetime(self):
+        # type: () -> Optional[datetime]
+        """Gets date and time the item was last modified."""
+        return self.properties.get("lastModifiedDateTime", datetime.min)
+
+    @property
+    def resource_reference(self):
+        # type: () -> ResourceReference
+        """Reference properties of the trending document, such as the url and type of the document."""
+        return self.properties.get("resourceReference", ResourceReference())
+
     @property
     def resource(self):
         """Used for navigating to the trending document."""
@@ -15,3 +31,12 @@ class Trending(Entity):
             "resource",
             Entity(self.context, ResourcePath("resource", self.resource_path)),
         )
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "lastModifiedDateTime": self.last_modified_datetime,
+                "resourceReference": self.resource_reference,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(Trending, self).get_property(name, default_value)

office365/directory/licenses/assignment_state.py

@@ -18,8 +18,8 @@ class LicenseAssignmentState(ClientValue):
         assigned_by_group=None,
         disabled_plans=None,
         error=None,
-        lastUpdatedDateTime=None,
-        skuId=None,
+        last_updated_datetime=None,
+        sku_id=None,
         state=None,
     ):
         """
@@ -31,13 +31,13 @@ class LicenseAssignmentState(ClientValue):
              The possible values are CountViolation, MutuallyExclusiveViolation, DependencyViolation,
              ProhibitedInUsageLocationViolation, UniquenessViolation, and Other.
              For more information on how to identify and resolve license assignment errors, see here.
-        :param str skuId: The unique identifier for the SKU. Read-Only.
+        :param str sku_id: The unique identifier for the SKU. Read-Only.
         :param str state: Indicate the current state of this assignment. Read-Only.
              The possible values are Active, ActiveWithError, Disabled, and Error.
         """
         self.assignedByGroup = assigned_by_group
         self.disabledPlans = StringCollection(disabled_plans)
         self.error = error
-        self.lastUpdatedDateTime = lastUpdatedDateTime
-        self.skuId = skuId
+        self.lastUpdatedDateTime = last_updated_datetime
+        self.skuId = sku_id
         self.state = state

office365/directory/licenses/details.py

@@ -34,3 +34,9 @@ class LicenseDetails(Entity):
         for example: "AAD_Premium". Read-only
         """
         return self.properties.get("skuPartNumber", None)
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {"servicePlans": self.service_plans}
+            default_value = property_mapping.get(name, None)
+        return super(LicenseDetails, self).get_property(name, default_value)

office365/directory/permissions/scoped_role_membership.py

@@ -0,0 +1,8 @@
+from office365.entity import Entity
+
+
+class ScopedRoleMembership(Entity):
+    """A scoped-role membership describes a user's membership of a directory role that is further
+    scoped to an Administrative Unit. Scoped-role membership provides a mechanism to allow a tenant-wide company
+    administrator to delegate administrative privileges to a user, to manage users and groups in a subset
+    of the organization."""

office365/directory/policies/applied_conditional_access.py

@@ -0,0 +1,31 @@
+from office365.runtime.client_value import ClientValue
+from office365.runtime.types.collections import StringCollection
+
+
+class AppliedConditionalAccessPolicy(ClientValue):
+    """Indicates the attributes related to applied conditional access policy or policies that are triggered
+    by a sign-in activity.
+
+    The data in this object is returned only for callers with privileges to read conditional access data.
+    For more information, see Permissions for viewing applied conditional access (CA) policies in sign-ins.
+    """
+
+    def __init__(
+        self,
+        display_name=None,
+        enforced_grant_controls=None,
+        enforced_session_controls=None,
+        id_=None,
+        result=None,
+    ):
+        """
+        :param str display_name: Refers to the name of the conditional access policy
+        :param list[str] enforced_grant_controls: Refers to the grant controls enforced by the conditional access policy
+        :param list[str] enforced_session_controls: Refers to the session controls enforced by the conditional
+            access policy
+        """
+        self.displayName = display_name
+        self.enforcedGrantControls = StringCollection(enforced_grant_controls)
+        self.enforcedSessionControls = StringCollection(enforced_session_controls)
+        self.id = id_
+        self.result = result

office365/directory/policies/feature_rollout.py

@@ -1,4 +1,6 @@
+from office365.directory.object_collection import DirectoryObjectCollection
 from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class FeatureRolloutPolicy(Entity):
@@ -14,3 +16,25 @@ class FeatureRolloutPolicy(Entity):
      - The appliesTo field only supports groups.
      - Dynamic groups and nested groups are not supported.
     """
+
+    @property
+    def applies_to(self):
+        # type: () -> DirectoryObjectCollection
+        """
+        Specifies a list of directoryObject resources that feature is enabled for.
+        """
+        return self.properties.get(
+            "appliesTo",
+            DirectoryObjectCollection(
+                self.context,
+                ResourcePath("appliesTo", self.resource_path),
+            ),
+        )
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "appliesTo": self.applies_to,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(FeatureRolloutPolicy, self).get_property(name, default_value)