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

office365/sharepoint/tenant/administration/copilot/adaptive_card_config.py

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

office365/sharepoint/tenant/administration/{internal/permission_grant.py → datagovernance/client_base.py}

@@ -1,7 +1,9 @@
 from office365.sharepoint.entity import Entity
 
 
-class SPO3rdPartyAADPermissionGrant(Entity):
+class SPDataGovernanceRestApiClientBase(Entity):
+    """"""
+
     @property
     def entity_type_name(self):
-        return "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPO3rdPartyAADPermissionGrant"
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPDataGovernanceRestApiClientBase"

office365/sharepoint/tenant/administration/datagovernance/insight_client.py

@@ -0,0 +1,82 @@
+from typing import TYPE_CHECKING
+
+from office365.runtime.client_result import ClientResult
+from office365.runtime.paths.service_operation import ServiceOperationPath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.tenant.administration.datagovernance.client_base import (
+    SPDataGovernanceRestApiClientBase,
+)
+from office365.sharepoint.tenant.administration.datagovernance.insight_metadata import (
+    SPDataGovernanceInsightMetadata,
+)
+
+if TYPE_CHECKING:
+    from office365.sharepoint.client_context import ClientContext
+
+
+class SPDataGovernanceInsightRestApiClient(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(SPDataGovernanceInsightRestApiClient, self).__init__(context, static_path)
+
+    def create_data_access_governance_report(
+        self,
+        report_entity,
+        workload,
+        report_type,
+        file_sensitivity_label_name,
+        file_sensitivity_label_guid,
+        name,
+        template,
+        privacy,
+        site_sensitivity_label_guid,
+        count_of_users_more_than,
+    ):
+        """ """
+        return_type = ClientResult(self.context, SPDataGovernanceInsightMetadata())
+        payload = {
+            "reportEntity": report_entity,
+            "workload": workload,
+            "reportType": report_type,
+            "fileSensitivityLabelName": file_sensitivity_label_name,
+            "fileSensitivityLabelGUID": file_sensitivity_label_guid,
+            "name": name,
+            "template": template,
+            "privacy": privacy,
+            "siteSensitivityLabelGUID": site_sensitivity_label_guid,
+            "countOfUsersMoreThan": count_of_users_more_than,
+        }
+        qry = ServiceOperationQuery(
+            self,
+            "CreateDataAccessGovernanceReport",
+            None,
+            payload,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    def export_spo_data_access_governance_insight(self, report_id):
+        return_type = ClientResult(self.context, str())
+        payload = {"reportId": report_id}
+        qry = ServiceOperationQuery(
+            self,
+            "ExportSPODataAccessGovernanceInsight",
+            None,
+            payload,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type

office365/sharepoint/tenant/administration/datagovernance/insight_metadata.py

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

office365/sharepoint/tenant/administration/default_time_zone_id.py

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

office365/sharepoint/tenant/administration/endpoints.py

@@ -1,15 +1,66 @@
-from typing import Optional
+from typing import TYPE_CHECKING, Optional
 
+from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.entity import Entity
 
+if TYPE_CHECKING:
+    from office365.sharepoint.client_context import ClientContext
+
 
 class TenantAdminEndpoints(Entity):
+
+    def __init__(self, context):
+        # type: (ClientContext) -> None
+        static_path = ResourcePath(
+            "Microsoft.Online.SharePoint.TenantAdministration.TenantAdminEndpoints"
+        )
+        super(TenantAdminEndpoints, self).__init__(context, static_path)
+
+    @property
+    def aad_admin_center_endpoint(self):
+        # type: () -> Optional[str]
+        """The URL for the Azure Active Directory Admin Center."""
+        return self.properties.get("AADAdminCenterEndpoint", None)
+
+    @property
+    def cdn_default_endpoint(self):
+        # type: () -> Optional[str]
+        """The base address of the default Content Delivery Network (CDN) used by SharePoint Online."""
+        return self.properties.get("CdnDefaultEndpoint", None)
+
     @property
     def o365_admin_center_endpoint(self):
         # type: () -> Optional[str]
-        """"""
+        """The endpoint (URL) to the Office 365 Admin Center."""
         return self.properties.get("O365AdminCenterEndpoint", None)
 
+    @property
+    def cfrms_graph_endpoint(self):
+        # type: () -> Optional[str]
+        """The URL of the Microsoft Graph API specifically for managing Conditional Access policies and Rights
+        Management Services (RMS) settings within a tenant."""
+        return self.properties.get("CFRMSGraphEndpoint", None)
+
+    @property
+    def migration_agent_url(self):
+        # type: () -> Optional[str]
+        """The endpoint where the migration agent software or services can be accessed"""
+        return self.properties.get("MigrationAgentUrl", None)
+
+    @property
+    def mini_maven_endpoint(self):
+        # type: () -> Optional[str]
+        """URL used internally by SharePoint or Microsoft 365 services. It may be part of Microsoft's orchestration
+        or lightweight service framework for tenant or feature management."""
+        return self.properties.get("MiniMavenEndpoint", None)
+
+    @property
+    def sp_migration_tool_url(self):
+        # type: () -> Optional[str]
+        """URL to access the SharePoint Migration Tool, enabling users to download the software
+        for performing migrations"""
+        return self.properties.get("SPMigrationToolUrl", None)
+
     @property
     def entity_type_name(self):
         return "Microsoft.Online.SharePoint.TenantAdministration.TenantAdminEndpoints"

office365/sharepoint/tenant/administration/insights/onedrive_site_sharing.py

@@ -3,3 +3,7 @@ from office365.runtime.client_value import ClientValue
 
 class OneDriveSiteSharingInsights(ClientValue):
     """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.OneDriveSiteSharingInsights"

office365/sharepoint/tenant/administration/insights/summary_response.py

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

office365/sharepoint/tenant/administration/internal/aad/permission_grant.py

@@ -0,0 +1,32 @@
+from typing_extensions import Self
+
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.entity_collection import EntityCollection
+
+
+class SPO3rdPartyAADPermissionGrant(Entity):
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPO3rdPartyAADPermissionGrant"
+
+
+class SPO3rdPartyAADPermissionGrantCollection(
+    EntityCollection[SPO3rdPartyAADPermissionGrant]
+):
+
+    def __init__(self, context, resource_path=None):
+        super(SPO3rdPartyAADPermissionGrantCollection, self).__init__(
+            context, SPO3rdPartyAADPermissionGrant, resource_path
+        )
+
+    def add(self, service_principal_id, resource, scope):
+        # type: (str, str, str) -> Self
+        payload = {
+            "servicePrincipalId": service_principal_id,
+            "resource": resource,
+            "scope": scope,
+        }
+        qry = ServiceOperationQuery(self, "Add", None, payload)
+        self.context.add_query(qry)
+        return self

office365/sharepoint/tenant/administration/internal/appservice/permission_grant.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.entity import Entity
+
+
+class SPOWebAppServicePrincipalPermissionGrant(Entity):
+    """"""

office365/sharepoint/tenant/administration/internal/appservice/permission_request.py

@@ -0,0 +1,13 @@
+from office365.sharepoint.entity import Entity
+
+
+class SPOWebAppServicePrincipalPermissionRequest(Entity):
+    """ """
+
+    @property
+    def client_component_item_unique_id(self):
+        return self.properties.get("ClientComponentItemUniqueId", False)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipalPermissionRequest"

office365/sharepoint/tenant/administration/internal/appservice/principal.py

@@ -0,0 +1,104 @@
+from typing import Optional
+
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.types.collections import StringCollection
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.entity_collection import EntityCollection
+from office365.sharepoint.tenant.administration.internal.aad.permission_grant import (
+    SPO3rdPartyAADPermissionGrantCollection,
+)
+from office365.sharepoint.tenant.administration.internal.appservice.permission_grant import (
+    SPOWebAppServicePrincipalPermissionGrant,
+)
+from office365.sharepoint.tenant.administration.internal.appservice.permission_request import (
+    SPOWebAppServicePrincipalPermissionRequest,
+)
+
+
+class SPOWebAppServicePrincipal(Entity):
+    def __init__(self, context):
+        stat_path = ResourcePath(
+            "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipal"
+        )
+        super(SPOWebAppServicePrincipal, self).__init__(context, stat_path)
+
+    def update_spfx_client_secret(self, secret_value):
+        """
+        :param str secret_value:
+        """
+        payload = {"secretValue": secret_value}
+        qry = ServiceOperationQuery(self, "UpdateSpfxClientSecret", None, payload)
+        self.context.add_query(qry)
+        return self
+
+    def update_spfx_third_party_app_id(self, app_id):
+        payload = {"appId": app_id}
+        qry = ServiceOperationQuery(self, "UpdateSpfxThirdPartyAppId", None, payload)
+        self.context.add_query(qry)
+        return self
+
+    @property
+    def account_enabled(self):
+        # type: () -> Optional[bool]
+        """ """
+        return self.properties.get("AccountEnabled", False)
+
+    @property
+    def app_id(self):
+        # type: () -> Optional[str]
+        """ """
+        return self.properties.get("AppId", False)
+
+    @property
+    def reply_urls(self):
+        # type: () -> StringCollection
+        """ """
+        return self.properties.get("ReplyUrls", StringCollection())
+
+    @property
+    def grant_manager(self):
+        return self.properties.get(
+            "GrantManager",
+            SPO3rdPartyAADPermissionGrantCollection(
+                self.context,
+                ResourcePath("GrantManager", self.resource_path),
+            ),
+        )
+
+    @property
+    def permission_grants(self):
+        return self.properties.get(
+            "PermissionGrants",
+            EntityCollection(
+                self.context,
+                SPOWebAppServicePrincipalPermissionGrant,
+                ResourcePath("PermissionGrants", self.resource_path),
+            ),
+        )
+
+    @property
+    def permission_requests(self):
+        return self.properties.get(
+            "PermissionRequests",
+            EntityCollection(
+                self.context,
+                SPOWebAppServicePrincipalPermissionRequest,
+                ResourcePath("PermissionRequests", self.resource_path),
+            ),
+        )
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipal"
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "GrantManager": self.grant_manager,
+                "PermissionRequests": self.permission_requests,
+                "PermissionGrants": self.permission_grants,
+                "ReplyUrls": self.reply_urls,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(SPOWebAppServicePrincipal, self).get_property(name, default_value)

office365/sharepoint/tenant/administration/malware/file.py

@@ -0,0 +1,18 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.files.file import File
+
+
+class SPOMalwareFile(Entity):
+    """ """
+
+    @property
+    def file(self):
+        return self.properties.get(
+            "File",
+            File(self.context, ResourcePath("File", self.resource_path)),
+        )
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOMalwareFile"

office365/sharepoint/tenant/administration/modified_property.py

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

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

@@ -0,0 +1,21 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPOAppBillingProperties(ClientValue):
+    """ """
+
+    def __init__(self, application_id=None, azure_region=None, is_activated=None):
+        """
+        :param str application_id: The application ID.
+        :param str azure_region: The Azure region.
+        :param bool is_activated:
+        """
+        self.ApplicationId = application_id
+        self.AzureRegion = azure_region
+        self.IsActivated = is_activated
+
+    @property
+    def entity_type_name(self):
+        return (
+            "Microsoft.Online.SharePoint.TenantAdministration.SPOAppBillingProperties"
+        )

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

@@ -0,0 +1,9 @@
+from office365.sharepoint.entity import Entity
+
+
+class SPOContentSecurityPolicyConfiguration(Entity):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOContentSecurityPolicyConfiguration"

office365/sharepoint/tenant/administration/recent_action.py

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

office365/sharepoint/tenant/administration/settings_service.py

@@ -3,15 +3,20 @@ from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.runtime.types.collections import StringCollection
 from office365.sharepoint.entity import Entity
+from office365.sharepoint.tenant.administration.default_time_zone_id import (
+    TenantDefaultTimeZoneId,
+)
 from office365.sharepoint.tenant.administration.smtp_server import SmtpServer
 from office365.sharepoint.tenant.administration.types import (
     AutoQuotaEnabled,
     DisableGroupify,
+    DisableSelfServiceSiteCreation,
+    EnableAutoNewsDigest,
 )
 
 
 class TenantAdminSettingsService(Entity):
-    """"""
+    """Manage various tenant-level settings related to SharePoint administration"""
 
     def __init__(self, context):
         static_path = ResourcePath(
@@ -20,7 +25,7 @@ class TenantAdminSettingsService(Entity):
         super(TenantAdminSettingsService, self).__init__(context, static_path)
 
     def get_tenant_sharing_status(self):
-        """"""
+        """Retrieves the current state of sharing settings for a tenant"""
         return_type = ClientResult(self.context, int())
         qry = ServiceOperationQuery(
             self, "GetTenantSharingStatus", None, None, None, return_type
@@ -30,26 +35,52 @@ class TenantAdminSettingsService(Entity):
 
     @property
     def auto_quota_enabled(self):
-        """"""
+        """Controls whether automatic quota management is enabled for SharePoint Online site collections.
+        When this feature is enabled, SharePoint Online automatically adjusts the storage quota for site collections
+        based on their usage, helping to ensure that site collections don't run out of space.
+        """
         return self.properties.get("AutoQuotaEnabled", AutoQuotaEnabled())
 
     @property
     def available_managed_paths_for_site_creation(self):
-        """"""
+        """
+        Specifies the managed paths that are available for the creation of new SharePoint sites within a tenant.
+        """
         return self.properties.get(
             "AvailableManagedPathsForSiteCreation", StringCollection()
         )
 
     @property
     def disable_groupify(self):
-        """"""
+        """
+        Controls whether SharePoint site owners in your tenant are allowed to convert classic SharePoint sites into
+        Microsoft 365 Groups (a process commonly known as "groupifying" a site)
+        """
         return self.properties.get("DisableGroupify", DisableGroupify())
 
+    @property
+    def disable_self_service_site_creation(self):
+        """ " """
+        return self.properties.get(
+            "DisableSelfServiceSiteCreation", DisableSelfServiceSiteCreation()
+        )
+
+    @property
+    def enable_auto_news_digest(self):
+        """ " """
+        return self.properties.get("EnableAutoNewsDigest", EnableAutoNewsDigest())
+
     @property
     def smtp_server(self):
-        """"""
+        """Specifies the server address or endpoint of the SMTP server that SharePoint Online or tenant-related
+        services use for sending emails"""
         return self.properties.get("SmtpServer", SmtpServer())
 
+    @property
+    def tenant_default_time_zone_id(self):
+        """Default time zone configured for a SharePoint Online tenant"""
+        return self.properties.get("TenantDefaultTimeZoneId", TenantDefaultTimeZoneId())
+
     @property
     def entity_type_name(self):
         return "Microsoft.Online.SharePoint.TenantAdministration.TenantAdminSettingsService"
@@ -58,7 +89,12 @@ class TenantAdminSettingsService(Entity):
         if default_value is None:
             property_mapping = {
                 "AvailableManagedPathsForSiteCreation": self.available_managed_paths_for_site_creation,
+                "AutoQuotaEnabled": self.auto_quota_enabled,
+                "DisableGroupify": self.disable_groupify,
+                "DisableSelfServiceSiteCreation": self.disable_self_service_site_creation,
+                "EnableAutoNewsDigest": self.enable_auto_news_digest,
                 "SmtpServer": self.smtp_server,
+                "TenantDefaultTimeZoneId": self.tenant_default_time_zone_id,
             }
             default_value = property_mapping.get(name, None)
         return super(TenantAdminSettingsService, self).get_property(name, default_value)

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

@@ -11,20 +11,20 @@ from office365.sharepoint.tenant.administration.sites.creation_data import (
 class SiteCreationSource(ClientValue):
     def __init__(
         self,
-        IsSyncThresholdLimitReached=None,
-        LastRefreshTimeStamp=None,
+        is_sync_threshold_limit_reached=None,
+        last_refresh_time_stamp=None,
         site_creation_data=None,
-        SyncThresholdLimit=None,
-        TotalSitesCount=None,
+        sync_threshold_limit=None,
+        total_sites_count=None,
     ):
         # type: (bool, datetime, List[SiteCreationData], int, int) -> None
-        self.IsSyncThresholdLimitReached = IsSyncThresholdLimitReached
-        self.LastRefreshTimeStamp = LastRefreshTimeStamp
+        self.IsSyncThresholdLimitReached = is_sync_threshold_limit_reached
+        self.LastRefreshTimeStamp = last_refresh_time_stamp
         self.SiteCreationData = ClientValueCollection(
             SiteCreationData, site_creation_data
         )
-        self.SyncThresholdLimit = SyncThresholdLimit
-        self.TotalSitesCount = TotalSitesCount
+        self.SyncThresholdLimit = sync_threshold_limit
+        self.TotalSitesCount = total_sites_count
 
     @property
     def entity_type_name(self):