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

office365/sharepoint/sharing/information.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.entity import Entity
 from office365.sharepoint.sharing.abilities import SharingAbilities

office365/sharepoint/sharing/links/partial_success_response.py

@@ -3,3 +3,7 @@ from office365.sharepoint.sharing.links.share_response import ShareLinkResponse
 
 class ShareLinkPartialSuccessResponse(ShareLinkResponse):
     """"""
+
+    @property
+    def entity_type_name(self):
+        return "SP.Sharing.ShareLinkPartialSuccessResponse"

office365/sharepoint/sites/azure_container_Info.py

@@ -2,4 +2,7 @@ from office365.runtime.client_value import ClientValue
 
 
 class ProvisionedTemporaryAzureContainerInfo(ClientValue):
-    pass
+
+    def __init__(self, encryption_key=None, uri=None):
+        self.EncryptionKey = encryption_key
+        self.Uri = uri

office365/sharepoint/sites/brand_center_configuration.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class BrandCenterConfiguration(ClientValue):
+    """ """

office365/sharepoint/sites/manager/service.py

@@ -0,0 +1,34 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.sites.manager.types import TopSiteFilesResult
+
+
+class SiteManagerService(Entity):
+    """ """
+
+    def __init__(self, context):
+        static_path = ResourcePath(
+            "Microsoft.SharePoint.SiteManager.SiteManagerService"
+        )
+        super(SiteManagerService, self).__init__(context, static_path)
+
+    def top_files(self, max_count=None):
+        """ """
+        return_type = ClientResult(self.context, TopSiteFilesResult())
+        payload = {"maxCount": max_count}
+        qry = ServiceOperationQuery(
+            self,
+            "TopFiles",
+            None,
+            payload,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.SiteManager.SiteManagerService"

office365/sharepoint/sites/manager/types.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TopSiteFilesResult(ClientValue):
+    """ """

office365/sharepoint/sites/site.py

@@ -57,6 +57,50 @@ class Site(Entity):
     def __init__(self, context, resource_path=None):
         super(Site, self).__init__(context, ResourcePath("Site", resource_path))
 
+    def create_migration_ingestion_job(
+        self,
+        g_web_id,
+        azure_container_source_uri,
+        azure_container_manifest_uri,
+        azure_queue_report_uri,
+        ingestion_task_key,
+    ):
+        """ """
+        return_type = ClientResult(self.context, str())
+        payload = {
+            "gWebId": g_web_id,
+            "azureContainerSourceUri": azure_container_source_uri,
+            "azureContainerManifestUri": azure_container_manifest_uri,
+            "azureQueueReportUri": azure_queue_report_uri,
+            "ingestionTaskKey": ingestion_task_key,
+        }
+        qry = ServiceOperationQuery(
+            self, "CreateMigrationIngestionJob", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def create_migration_job(
+        self,
+        g_web_id=None,
+        azure_container_source_uri=None,
+        azure_container_manifest_uri=None,
+        azure_queue_report_uri=None,
+    ):
+        """ """
+        return_type = ClientResult(self.context, str())
+        payload = {
+            "gWebId": g_web_id,
+            "azureContainerSourceUri": azure_container_source_uri,
+            "azureContainerManifestUri": azure_container_manifest_uri,
+            "azureQueueReportUri": azure_queue_report_uri,
+        }
+        qry = ServiceOperationQuery(
+            self, "CreateMigrationJob", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def create_preview_site(self, upgrade=None, sendemail=None):
         """
         Schedules the creation of an evaluation copy of the site collection for the purposes of evaluating an upgrade
@@ -411,6 +455,16 @@ class Site(Entity):
         context.add_query(qry)
         return return_type
 
+    def is_deletable(self):
+        """"""
+        return_type = ClientResult(self.context, bool())
+
+        def _is_site_deletable():
+            SPPolicyStoreProxy.is_site_deletable(self.context, self.url, return_type)
+
+        self.ensure_property("Url", _is_site_deletable)
+        return return_type
+
     def get_catalog(self, type_catalog):
         """
         Specifies the list template gallery, site template gallery, Web Part gallery, master page gallery,

office365/sharepoint/sites/themes.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SiteThemes(ClientValue):
+    """ """

office365/sharepoint/storagemetrics/storage_metrics.py

@@ -7,6 +7,12 @@ from office365.sharepoint.entity import Entity
 class StorageMetrics(Entity):
     """Specifies the storage-related metrics for list folders in the site"""
 
+    @property
+    def additional_file_stream_size(self):
+        # type: () -> Optional[int]
+        """ """
+        return self.properties.get("AdditionalFileStreamSize", None)
+
     @property
     def last_modified(self):
         # type: () -> Optional[datetime.datetime]
@@ -41,3 +47,15 @@ class StorageMetrics(Entity):
         Total size for a file/folder includes stream, version, and metadata sizes.
         """
         return self.properties.get("TotalSize", None)
+
+    @property
+    def version_count(self):
+        # type: () -> Optional[int]
+        """ """
+        return self.properties.get("VersionCount", None)
+
+    @property
+    def version_size(self):
+        # type: () -> Optional[int]
+        """ """
+        return self.properties.get("VersionSize", None)

office365/sharepoint/tenant/administration/copilot/agentinsights/client.py

@@ -0,0 +1,42 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.runtime.paths.service_operation import ServiceOperationPath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.tenant.administration.copilot.agentinsights.report_metadata import (
+    SPOCopilotAgentInsightsReportMetadata,
+)
+from office365.sharepoint.tenant.administration.datagovernance.client_base import (
+    SPDataGovernanceRestApiClientBase,
+)
+
+
+class SPOCopilotAgentInsightsRestApiClient(SPDataGovernanceRestApiClientBase):
+    """"""
+
+    def __init__(self, context, authorization_header, url, user_agent):
+        # type: (ClientContext, str, str, str) -> None
+        static_path = ServiceOperationPath(
+            "Microsoft.Online.SharePoint.TenantAdministration.SPDataGovernanceInsightRestApiClient",
+            {
+                "authorizationHeader": authorization_header,
+                "url": url,
+                "userAgent": user_agent,
+            },
+        )
+        super(SPOCopilotAgentInsightsRestApiClient, self).__init__(context, static_path)
+
+    def get_all_copilot_agent_insights_reports_metadata(self):
+        return_type = ClientResult(
+            self.context, ClientValueCollection(SPOCopilotAgentInsightsReportMetadata)
+        )
+        qry = ServiceOperationQuery(
+            self,
+            "GetAllCopilotAgentInsightsReportsMetadata",
+            None,
+            None,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type

office365/sharepoint/tenant/administration/copilot/agentinsights/report_metadata.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPOCopilotAgentInsightsReportMetadata(ClientValue):
+    """"""

office365/sharepoint/tenant/administration/group.py

@@ -1,7 +1,18 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.client_value import ClientValue
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
+class GroupInfo(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.GroupInfo"
+
+
 class SPOGroup(Entity):
     """ """
 
@@ -12,6 +23,29 @@ class SPOGroup(Entity):
             )
         super(SPOGroup, self).__init__(context, resource_path)
 
+    def add_as_group_owner_and_member(self, group_id, user_id, user_principal_name):
+        """ """
+        payload = {
+            "groupId": group_id,
+            "userId": user_id,
+            "userPrincipalName": user_principal_name,
+        }
+        qry = ServiceOperationQuery(
+            self, "AddAsGroupOwnerAndMember", None, payload, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    def get_group_info(self, group_id):
+        """"""
+        return_type = ClientResult(self.context, GroupInfo())
+        payload = {"groupId": group_id}
+        qry = ServiceOperationQuery(
+            self, "GetGroupInfo", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def entity_type_name(self):
         return "Microsoft.Online.SharePoint.TenantAdministration.SPOGroup"

office365/sharepoint/tenant/administration/policies/file_version_types.py

@@ -0,0 +1,17 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPOFileVersionPolicySettings(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOFileVersionPolicySettings"
+
+
+class SPOFileVersionBatchDeleteJobProgress(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOFileVersionBatchDeleteJobProgress"

office365/sharepoint/tenant/administration/policies/list_parameters.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPOListParameters(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOListParameters"

office365/sharepoint/tenant/administration/policies/resource_storage.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class PolicyResourceStorage(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Administration.TenantAdmin.PolicyResourceStorage"

office365/sharepoint/tenant/administration/sites/properties_enumerable_filter.py

@@ -10,6 +10,9 @@ class SitePropertiesEnumerableFilter(ClientValue):
         include_personal_site=None,
         group_id_defined=None,
         template=None,
+        archived_by=None,
+        archived_time=None,
+        archive_status=None,
     ):
         """
         :param str _filter:
@@ -20,12 +23,15 @@ class SitePropertiesEnumerableFilter(ClientValue):
         :param str template:
         """
         super(SitePropertiesEnumerableFilter, self).__init__()
+        self.ArchivedBy = archived_by
         self.Filter = _filter
         self.GroupIdDefined = group_id_defined
         self.IncludeDetail = include_detail
         self.IncludePersonalSite = include_personal_site
         self.StartIndex = start_index
         self.Template = template
+        self.ArchivedTime = archived_time
+        self.ArchiveStatus = archive_status
 
     @property
     def entity_type_name(self):

office365/sharepoint/tenant/administration/tenant.py

@@ -37,9 +37,16 @@ from office365.sharepoint.tenant.administration.insights.top_files_sharing impor
 from office365.sharepoint.tenant.administration.policies.app_billing_properties import (
     SPOAppBillingProperties,
 )
+from office365.sharepoint.tenant.administration.policies.content_security_configuration import (
+    SPOContentSecurityPolicyConfiguration,
+)
 from office365.sharepoint.tenant.administration.policies.definition import (
     TenantAdminPolicyDefinition,
 )
+from office365.sharepoint.tenant.administration.policies.file_version_types import (
+    SPOFileVersionBatchDeleteJobProgress,
+    SPOFileVersionPolicySettings,
+)
 from office365.sharepoint.tenant.administration.powerapps.environment import (
     PowerAppsEnvironment,
 )
@@ -221,6 +228,15 @@ class Tenant(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def get_content_security_policy(self):
+        """"""
+        return_type = SPOContentSecurityPolicyConfiguration(self.context)
+        qry = ServiceOperationQuery(
+            self, "GetContentSecurityPolicy", None, None, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def get_spo_app_billing_policies(self):
         """ """
         return_type = ClientResult(
@@ -310,6 +326,32 @@ class Tenant(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def is_request_content_management_assessment_eligible(self):
+        return_type = ClientResult(self.context, bool())
+        qry = ServiceOperationQuery(
+            self,
+            "IsRequestContentManagementAssessmentEligible",
+            None,
+            None,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def is_syntex_repository_terms_of_service_accepted(self):
+        return_type = ClientResult(self.context, bool())
+        qry = ServiceOperationQuery(
+            self,
+            "IsSyntexRepositoryTermsOfServiceAccepted",
+            None,
+            None,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def export_to_csv(
         self, view_xml=None, time_zone_id=None, columns_info=None, list_name=None
     ):
@@ -398,6 +440,20 @@ class Tenant(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def get_root_site_url(self):
+        """ """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self,
+            "GetRootSiteUrl",
+            None,
+            None,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def get_site_authorization_code_for_migration(self, endpoint_url):
         return_type = ClientResult(self.context, str())
         payload = {"endpointUrl": endpoint_url}
@@ -714,9 +770,53 @@ class Tenant(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def restore_deleted_site_by_id(self, site_id):
+        """Restores deleted site with the specified URL
+        :param str site_id: A string representing the site identifier.
+        """
+        return_type = SpoOperation(self.context)
+        qry = ServiceOperationQuery(
+            self, "RestoreDeletedSiteById", [site_id], None, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def get_file_version_policy_for_library(self, site_url, list_params=None):
+        """ """
+        return_type = ClientResult(self.context, SPOFileVersionPolicySettings())
+        payload = {"siteUrl": site_url, "listParams": list_params}
+        qry = ServiceOperationQuery(
+            self,
+            "GetFileVersionPolicyForLibrary",
+            None,
+            payload,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def get_file_version_batch_delete_job_progress_for_library(
+        self, site_url, list_params
+    ):
+        """Gets the progress of the file version batch delete job for the specified site and list parameters."""
+        return_type = ClientResult(self.context, SPOFileVersionBatchDeleteJobProgress())
+        payload = {"siteUrl": site_url, "listParams": list_params}
+        qry = ServiceOperationQuery(
+            self,
+            "GetFileVersionBatchDeleteJobProgressForLibrary",
+            None,
+            payload,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def get_site_properties_by_site_id(self, site_id, include_detail=False):
         # type: (str, bool) -> SiteProperties
-        """
+        """Gets the site properties for the specified site ID.
+
         :param str site_id: A string that represents the site identifier.
         :param bool include_detail: A Boolean value that indicates whether to include all of the SPSite properties.
         """
@@ -733,6 +833,8 @@ class Tenant(Entity):
     def get_site_properties_by_url(self, url, include_detail=False):
         # type: (str, bool) -> SiteProperties
         """
+         Gets the site properties for the specified URL.
+
         :param str url: A string that represents the site URL.
         :param bool include_detail: A Boolean value that indicates whether to include all of the SPSite properties.
         """
@@ -798,15 +900,84 @@ class Tenant(Entity):
         self.context.add_query(qry)
         return self
 
-    def send_email(self, site_url):
-        # type: (str) -> ClientResult[bool]
-        """ """
+    def export_unlicensed_one_drive_for_business_list_to_csv(self):
+        """Exports a list of OneDrive for Business sites that are associated with unlicensed users into a CSV file"""
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self, "ExportUnlicensedOneDriveForBusinessListToCSV"
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def send_email(self, site_url, activity_event_json):
+        # type: (str, str) -> ClientResult[bool]
+        """Send Email"""
         return_type = ClientResult(self.context, bool())
-        payload = {"siteUrl": site_url}
+        payload = {"siteUrl": site_url, "activityEventJson": activity_event_json}
         qry = ServiceOperationQuery(self, "SendEmail", None, payload, None, return_type)
         self.context.add_query(qry)
         return return_type
 
+    def set_copilot_promo_optin_status(self, copilot_promo_optin_enabled):
+        # type: (bool) -> ClientResult[bool]
+        """ """
+        payload = {"copilotPromoOptInEnabled": copilot_promo_optin_enabled}
+        qry = ServiceOperationQuery(self, "SetCopilotPromoOptInStatus", None, payload)
+        self.context.add_query(qry)
+        return self
+
+    def set_default_view(self, view_id, list_name):
+        # type: (str, str) -> Self
+        """ """
+        payload = {"viewId": view_id, "listName": list_name}
+        qry = ServiceOperationQuery(self, "SetDefaultView", None, payload)
+        self.context.add_query(qry)
+        return self
+
+    def get_file_version_policy(self):
+        return_type = ClientResult(self.context, str())
+
+        def _get_file_version_policy():
+            return_type.set_property("__value", self.file_version_policy_xml)
+
+        self.ensure_property("FileVersionPolicyXml", _get_file_version_policy)
+        return return_type
+
+    def set_file_version_policy(
+        self, is_auto_trim_enabled, major_version_limit, expire_versions_after_days
+    ):
+        """
+        Automatically delete older versions of documents after a specified number of days.
+        Specify the maximum number of major versions to retain and the number of major versions
+        for which all minor versions will be kept.
+
+        :param bool is_auto_trim_enabled: If true, versions are trimmed automatically.
+        :param int major_version_limit: Retains only many major versions.
+        :param int expire_versions_after_days: Deletes versions older than this many days.
+        """
+        payload = {
+            "isAutoTrimEnabled": is_auto_trim_enabled,
+            "majorVersionLimit": major_version_limit,
+            "expireVersionsAfterDays": expire_versions_after_days,
+        }
+        qry = ServiceOperationQuery(self, "SetFileVersionPolicy", None, payload)
+        self.context.add_query(qry)
+        return self
+
+    def clear_file_version_policy(self):
+        self.set_property("FileVersionPolicyXml", "")
+        self.update()
+        return self
+
+    @property
+    def app_service_principal(self):
+        """ """
+        from office365.sharepoint.tenant.administration.internal.appservice.principal import (
+            SPOWebAppServicePrincipal,
+        )
+
+        return SPOWebAppServicePrincipal(self.context)
+
     @property
     def admin_settings(self):
         """Manage various tenant-level settings related to SharePoint administration"""
@@ -897,6 +1068,12 @@ class Tenant(Entity):
         """"""
         return self.properties.get("DefaultContentCenterSite", SiteInfoForSitePicker())
 
+    @property
+    def file_version_policy_xml(self):
+        # type: () -> Optional[str]
+        """ """
+        return self.properties.get("FileVersionPolicyXml", None)
+
     @property
     def information_barriers_suspension(self):
         # type: () -> Optional[bool]

office365/sharepoint/userprofiles/people_manager.py

@@ -148,14 +148,16 @@ class PeopleManager(Entity):
         return self
 
     def get_user_profile_properties(self, user_or_name):
+        # type: (str|User) -> ClientResult[dict]
         """
         Gets the specified user profile properties for the specified user.
 
         :param str or User user_or_name: User or Login name of the specified user.
         """
-        return_type = ClientResult(self.context)
+        return_type = ClientResult(self.context, {})
 
         def _user_resolved(account_name):
+            # type: (str) -> None
             params = {"accountName": account_name}
             qry = ServiceOperationQuery(
                 self, "GetUserProfileProperties", params, None, None, return_type

office365/sharepoint/utilities/utility.py

@@ -144,6 +144,22 @@ class Utility(Entity):
         context.add_query(qry)
         return utility
 
+    @staticmethod
+    def unmark_discussion_as_featured(context, list_id, topic_ids):
+        """
+        This method is a static method.
+        :type context: office365.sharepoint.client_context.ClientContext
+        :type list_id: str
+        :type topic_ids: str
+        """
+        utility = Utility(context)
+        payload = {"listID": list_id, "topicIDs": topic_ids}
+        qry = ServiceOperationQuery(
+            utility, "UnmarkDiscussionAsFeatured", None, payload, None, None, True
+        )
+        context.add_query(qry)
+        return utility
+
     @staticmethod
     def expand_groups_to_principals(context, inputs, max_count=None, return_type=None):
         """