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

office365/sharepoint/marketplace/tenant/appcatalog/accessor.py

@@ -1,3 +1,5 @@
+import os
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.paths.service_operation import ServiceOperationPath
@@ -8,9 +10,18 @@ from office365.sharepoint.marketplace.app_metadata import CorporateCatalogAppMet
 from office365.sharepoint.marketplace.app_metadata_collection import (
     CorporateCatalogAppMetadataCollection,
 )
+from office365.sharepoint.marketplace.corporatecuratedgallery.app_request_information import (
+    SPStoreAppRequestInformation,
+)
+from office365.sharepoint.marketplace.corporatecuratedgallery.app_response_information import (
+    SPStoreAppResponseInformation,
+)
 from office365.sharepoint.marketplace.corporatecuratedgallery.app_upgrade_availability import (
     AppUpgradeAvailability,
 )
+from office365.sharepoint.marketplace.corporatecuratedgallery.card_designs import (
+    CardDesigns,
+)
 from office365.sharepoint.marketplace.corporatecuratedgallery.teams_package_download import (
     TeamsPackageDownload,
 )
@@ -22,7 +33,7 @@ from office365.sharepoint.marketplace.sitecollection.appcatalog.allowed_items im
 class TenantCorporateCatalogAccessor(Entity):
     """Accessor for the tenant corporate catalog."""
 
-    def add(self, content, overwrite, url):
+    def add(self, content, overwrite, url=None):
         """
         Adds a file to the corporate catalog.
 
@@ -32,13 +43,34 @@ class TenantCorporateCatalogAccessor(Entity):
         :param str url: Specifies the URL of the file to be added.
         """
         return_type = File(self.context)
-        payload = {"Content": content, "Overwrite": overwrite, "Url": url}
-        qry = ServiceOperationQuery(self, "Add", None, payload, None, return_type)
+        params = {"Overwrite": overwrite, "Url": url}
+        qry = ServiceOperationQuery(self, "Add", params, content, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def app_from_path(self, path, overwrite):
+        # type: (str, bool) -> File
+        """
+        Adds a file to the corporate catalog.
+        """
+        with open(path, "rb") as f:
+            content = f.read()
+        url = os.path.basename(path)
+        return self.add(content=content, overwrite=overwrite, url=url)
+
+    def app_requests(self):
+        """"""
+        return_type = ClientResult(self.context, SPStoreAppResponseInformation())
+        payload = {"AppRequestInfo": SPStoreAppRequestInformation()}
+        qry = ServiceOperationQuery(
+            self, "AppRequests", None, payload, None, return_type
+        )
         self.context.add_query(qry)
         return return_type
 
     def download_teams_solution(self, _id):
         """
+        Downloads a Microsoft Teams solution package associated with an app from the SharePoint App Catalog
         :param int _id:
         """
         return_type = TeamsPackageDownload(self.context)
@@ -60,6 +92,7 @@ class TenantCorporateCatalogAccessor(Entity):
 
     def is_app_upgrade_available(self, _id):
         """
+        Determines if an upgrade is available for an app in the SharePoint app catalog
         :param int _id:
         """
         return_type = ClientResult(self.context, AppUpgradeAvailability())
@@ -70,8 +103,21 @@ class TenantCorporateCatalogAccessor(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def upload(self, content, overwrite, url, xor_hash=None):
+        """"""
+        payload = {
+            "Content": content,
+            "Overwrite": overwrite,
+            "Url": url,
+            "XorHash": xor_hash,
+        }
+        qry = ServiceOperationQuery(self, "Upload", None, payload)
+        self.context.add_query(qry)
+        return self
+
     def send_app_request_status_notification_email(self, request_guid):
         """
+        Sends email notifications about the status of an app request in the corporate app catalog
         :param str request_guid:
         """
         qry = ServiceOperationQuery(
@@ -90,6 +136,14 @@ class TenantCorporateCatalogAccessor(Entity):
             ),
         )
 
+    @property
+    def card_designs(self):
+        """Returns the card designs available in this corporate catalog."""
+        return self.properties.get(
+            "CardDesigns",
+            CardDesigns(self.context, ResourcePath("CardDesigns", self.resource_path)),
+        )
+
     @property
     def site_collection_app_catalogs_sites(self):
         """Returns an accessor to the allow list of site collections allowed to have site collection corporate
@@ -102,10 +156,15 @@ class TenantCorporateCatalogAccessor(Entity):
             ),
         )
 
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.TenantCorporateCatalogAccessor"
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "AvailableApps": self.available_apps,
+                "CardDesigns": self.card_designs,
                 "SiteCollectionAppCatalogsSites": self.site_collection_app_catalogs_sites,
             }
             default_value = property_mapping.get(name, None)

office365/sharepoint/multigeo/services.py

@@ -2,6 +2,7 @@ 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.entity_collection import EntityCollection
+from office365.sharepoint.multigeo.storage_quota import StorageQuota
 from office365.sharepoint.multigeo.unified_group import UnifiedGroup
 from office365.sharepoint.multigeo.user_personal_site_location import (
     UserPersonalSiteLocation,
@@ -39,6 +40,19 @@ class MultiGeoServices(Entity):
         self.context.add_query(qry)
         return return_type
 
+    @property
+    def storage_quotas(self):
+        # type: () -> EntityCollection[UnifiedGroup]
+        """ """
+        return self.properties.get(
+            "StorageQuotas",
+            EntityCollection(
+                self.context,
+                StorageQuota,
+                ResourcePath("StorageQuotas", self.resource_path),
+            ),
+        )
+
     @property
     def unified_groups(self):
         # type: () -> EntityCollection[UnifiedGroup]

office365/sharepoint/multigeo/storage_quota.py

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

office365/sharepoint/policy/license_utilities.py

@@ -0,0 +1,27 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.entity import Entity
+
+
+class PolicyLicenseUtilities(Entity):
+    """"""
+
+    @staticmethod
+    def check_tenant_m365_copilot_business_chat_license(context, return_type=None):
+        """"""
+        if return_type is None:
+            return_type = ClientResult(context, bool())
+        qry = ServiceOperationQuery(
+            PolicyLicenseUtilities(context),
+            "CheckTenantM365CopilotBusinessChatLicense",
+            None,
+            None,
+            None,
+            return_type,
+        )
+        context.add_query(qry)
+        return return_type
+
+    @property
+    def entity_type_name(self):
+        return "SP.Utilities.PolicyLicenseUtilities"

office365/sharepoint/principal/principal.py

@@ -1,7 +1,9 @@
 from typing import Optional
 
+from office365.runtime.odata.type import ODataType
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.sharepoint.entity import Entity
+from office365.sharepoint.principal.type import PrincipalType
 
 
 class Principal(Entity):
@@ -60,6 +62,10 @@ class Principal(Entity):
         """Gets the type of the principal."""
         return self.properties.get("PrincipalType", None)
 
+    @property
+    def principal_type_name(self):
+        return ODataType.resolve_enum_key(PrincipalType, self.principal_type)
+
     @property
     def property_ref_name(self):
         return "Id"

office365/sharepoint/request.py

@@ -1,10 +1,11 @@
-from typing import Optional
+from typing import Callable, List, Optional
 
 from requests import Response
 from typing_extensions import Self
 
 from office365.runtime.auth.authentication_context import AuthenticationContext
 from office365.runtime.auth.client_credential import ClientCredential
+from office365.runtime.auth.token_response import TokenResponse
 from office365.runtime.auth.user_credential import UserCredential
 from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.odata.request import ODataRequest
@@ -12,31 +13,115 @@ from office365.runtime.odata.v3.json_light_format import JsonLightFormat
 
 
 class SharePointRequest(ODataRequest):
-    def __init__(self, base_url):
+    def __init__(
+        self, base_url, environment="commercial", allow_ntlm=False, browser_mode=False
+    ):
         """
         :param str base_url: Absolute Web or Site Url
+        :param str environment: The Office 365 Cloud Environment endpoint used for authentication
+            defaults to 'commercial'.
+        :param bool allow_ntlm: Flag indicates whether NTLM scheme is enabled. Disabled by default
+        :param bool browser_mode: Allow browser authentication
         """
         super().__init__(JsonLightFormat())
-        self._auth_context = AuthenticationContext(url=base_url)
+        self._auth_context = AuthenticationContext(
+            url=base_url,
+            environment=environment,
+            allow_ntlm=allow_ntlm,
+            browser_mode=browser_mode,
+        )
         self.beforeExecute += self._authenticate_request
 
     def execute_request(self, path):
         # type: (str) -> Response
-        request_url = "{0}/_api/{1}".format(self._auth_context.url, path)
+        request_url = "{0}/{1}".format(self.service_root_url, path)
         return self.execute_request_direct(RequestOptions(request_url))
 
-    def with_credentials(self, credentials, environment="commercial"):
-        # type: (UserCredential|ClientCredential, Optional[str]) -> Self
+    def with_credentials(self, credentials):
+        # type: (UserCredential|ClientCredential) -> Self
         """
         Initializes a client to acquire a token via user or client credentials
-        :type credentials: UserCredential or ClientCredential
-        :param str environment: The Office 365 Cloud Environment endpoint used for authentication
-            defaults to 'commercial'.
         """
-        self._auth_context.with_credentials(credentials, environment=environment)
+        self._auth_context.with_credentials(credentials)
+        return self
+
+    def with_client_certificate(
+        self,
+        tenant,
+        client_id,
+        thumbprint,
+        cert_path=None,
+        private_key=None,
+        scopes=None,
+        passphrase=None,
+    ):
+        # type: (str, str, str, Optional[str], Optional[str], Optional[List[str]], Optional[str]) -> Self
+        """
+        Creates authenticated SharePoint context via certificate credentials
+
+        :param str tenant: Tenant name
+        :param str or None cert_path: Path to A PEM encoded certificate private key.
+        :param str or None private_key: A PEM encoded certificate private key.
+        :param str thumbprint: Hex encoded thumbprint of the certificate.
+        :param str client_id: The OAuth client id of the calling application.
+        :param list[str] or None scopes:  Scopes requested to access a protected API (a resource)
+        :param str passphrase: Passphrase if the private_key is encrypted
+        """
+        self._auth_context.with_client_certificate(
+            tenant, client_id, thumbprint, cert_path, private_key, scopes, passphrase
+        )
+        return self
+
+    def with_device_flow(self, tenant, client_id, scopes=None):
+        # type: (str, str, Optional[List[str]]) -> Self
+        """
+        Initializes a client to acquire a token via device flow auth.
+
+        :param str tenant: Tenant name, for example: contoso.onmicrosoft.com
+        :param str client_id: The OAuth client id of the calling application.
+        :param list[str] or None scopes:  Scopes requested to access a protected API (a resource)
+        """
+        self._auth_context.with_device_flow(tenant, client_id, scopes)
+        return self
+
+    def with_interactive(self, tenant, client_id, scopes=None):
+        # type: (str, str, Optional[List[str]]) -> Self
+        """
+        Initializes a client to acquire a token interactively i.e. via a local browser.
+
+        Prerequisite: In Azure Portal, configure the Redirect URI of your
+        "Mobile and Desktop application" as ``http://localhost``.
+
+        :param str tenant: Tenant name, for example: contoso.onmicrosoft.com
+        :param str client_id: The OAuth client id of the calling application.
+        :param list[str] or None scopes:  Scopes requested to access a protected API (a resource)
+        """
+        self._auth_context.with_interactive(tenant, client_id, scopes)
+        return self
+
+    def with_access_token(self, token_func):
+        # type: (Callable[[], TokenResponse]) -> Self
+        """
+        Initializes a client to acquire a token from a callback
+        :param () -> TokenResponse token_func: A token callback
+        """
+        self._auth_context.with_access_token(token_func)
         return self
 
     def _authenticate_request(self, request):
         # type: (RequestOptions) -> None
         """Authenticate request"""
         self._auth_context.authenticate_request(request)
+
+    @property
+    def authentication_context(self):
+        return self._auth_context
+
+    @property
+    def base_url(self):
+        """Represents Base Url"""
+        return self._auth_context.url
+
+    @property
+    def service_root_url(self):
+        return "{0}/_api".format(self._auth_context.url)

office365/sharepoint/search/administration/document_crawl_log.py

@@ -15,15 +15,29 @@ class DocumentCrawlLog(Entity):
         )
         super(DocumentCrawlLog, self).__init__(context, static_path)
 
-    def get_crawled_urls(self, get_count_only=False):
+    def get_crawled_urls(
+        self,
+        get_count_only=False,
+        max_rows=None,
+        query_string=None,
+        content_source_id=None,
+    ):
         """
         Retrieves information about all the contents that were crawled.
 
         :param bool get_count_only: f true, only the count of the contents crawled MUST be returned.
              If false, all the information about the crawled contents MUST be returned.
+        :param int max_rows:
+        :param str query_string:
+        :param int content_source_id:
         """
         return_type = ClientResult(self.context, SimpleDataTable())
-        payload = {"getCountOnly": get_count_only}
+        payload = {
+            "getCountOnly": get_count_only,
+            "maxRows": max_rows,
+            "queryString": query_string,
+            "contentSourceID": content_source_id,
+        }
         qry = ServiceOperationQuery(
             self, "GetCrawledUrls", None, payload, None, return_type
         )

office365/sharepoint/search/administration/tenant_crawl_versions_info_provider.py

@@ -4,7 +4,7 @@ from office365.sharepoint.entity import Entity
 
 
 class TenantCrawlVersionsInfoProvider(Entity):
-    """ """
+    """Retrieves information about crawl versions for a tenant in SharePoint"""
 
     def disable_crawl_versions(self, site_id):
         """

office365/sharepoint/search/reports/abandoned_queries.py

@@ -1,3 +1,7 @@
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.search.reports.abandonedqueries.item import (
+    ReportAbandonedQueriesItem,
+)
 from office365.sharepoint.search.reports.base import ReportBase
 
 
@@ -6,4 +10,10 @@ class ReportAbandonedQueries(ReportBase):
     queries that might create user dissatisfaction and to improve the discoverability of content.
     """
 
-    pass
+    def __init__(self, reports=None):
+        super(ReportAbandonedQueries, self).__init__()
+        self.Reports = ClientValueCollection(ReportAbandonedQueriesItem, reports)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Office.Server.Search.REST.ReportAbandonedQueries"

office365/sharepoint/search/reports/abandonedqueries/item.py

@@ -2,4 +2,10 @@ from office365.runtime.client_value import ClientValue
 
 
 class ReportAbandonedQueriesItem(ClientValue):
-    pass
+
+    def __init__(self, date=None):
+        self.Date = date
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Office.Server.Search.REST.ReportAbandonedQueriesItem"

office365/sharepoint/sharing/domain_restriction_settings.py

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

office365/sharepoint/sharing/information.py

@@ -2,6 +2,9 @@ from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.entity import Entity
 from office365.sharepoint.sharing.abilities import SharingAbilities
 from office365.sharepoint.sharing.access_request_settings import AccessRequestSettings
+from office365.sharepoint.sharing.domain_restriction_settings import (
+    DomainRestrictionSettings,
+)
 from office365.sharepoint.sharing.links.default_templates_collection import (
     SharingLinkDefaultTemplatesCollection,
 )
@@ -24,9 +27,17 @@ class SharingInformation(Entity):
 
     @property
     def anonymous_link_expiration_restriction_days(self):
+        # type: () -> Optional[int]
         """Tenant's anonymous link expiration restriction in days."""
         return self.properties.get("anonymousLinkExpirationRestrictionDays", None)
 
+    @property
+    def domain_restriction_settings(self):
+        """Whether DomainRestrictionSettings is used to limit the external Users set by Admin."""
+        return self.properties.get(
+            "anonymousLinkExpirationRestrictionDays", DomainRestrictionSettings()
+        )
+
     @property
     def permissions_information(self):
         """
@@ -62,6 +73,7 @@ class SharingInformation(Entity):
         if default_value is None:
             property_mapping = {
                 "accessRequestSettings": self.access_request_settings,
+                "domain_restriction_settings": self.domain_restriction_settings,
                 "permissionsInformation": self.permissions_information,
                 "pickerSettings": self.picker_settings,
                 "sharingAbilities": self.sharing_abilities,

office365/sharepoint/sitehealth/result.py

@@ -2,13 +2,13 @@ from office365.runtime.client_value import ClientValue
 
 
 class SiteHealthResult(ClientValue):
-    """Specifies the result of running a site collection health rule."""
+    """Specifies the result of running a site collection sitehealth rule."""
 
     def __init__(self, message_as_text=None, rule_help_link=None, rule_id=None):
         """
-        :param str message_as_text: Specifies a summary of the results of running a site collection health rule.
-        :param str rule_help_link: Specifies a hyperlink to help information about the site collection health rule.
-        :param str rule_id: Specifies the unique identifier of the site collection health rule.
+        :param str message_as_text: Specifies a summary of the results of running a site collection sitehealth rule.
+        :param str rule_help_link: Specifies a hyperlink to help information about the site collection sitehealth rule.
+        :param str rule_id: Specifies the unique identifier of the site collection sitehealth rule.
         """
         self.MessageAsText = message_as_text
         self.RuleHelpLink = rule_help_link

office365/sharepoint/sitehealth/summary.py

@@ -6,29 +6,29 @@ from office365.sharepoint.sitehealth.result import SiteHealthResult
 
 
 class SiteHealthSummary(Entity):
-    """Specifies a summary of the results of running a set of site collection health rules."""
+    """Specifies a summary of the results of running a set of site collection sitehealth rules."""
 
     @property
     def failed_error_count(self):
         # type: () -> Optional[int]
-        """Specifies the number of site collection health rules that failed with an error."""
+        """Specifies the number of site collection sitehealth rules that failed with an error."""
         return self.properties.get("FailedErrorCount", None)
 
     @property
     def failed_warning_count(self):
         # type: () -> Optional[int]
-        """Specifies the number of site collection health rules that failed with a warning."""
+        """Specifies the number of site collection sitehealth rules that failed with a warning."""
         return self.properties.get("FailedWarningCount", None)
 
     @property
     def passed_count(self):
         # type: () -> Optional[int]
-        """Specifies the number of site collection health rules that passed."""
+        """Specifies the number of site collection sitehealth rules that passed."""
         return self.properties.get("PassedCount", None)
 
     @property
     def results(self):
-        """Specifies a list of site collection health rule results, one for each site collection health rule that
+        """Specifies a list of site collection sitehealth rule results, one for each site collection sitehealth rule that
         was run."""
         return self.properties.get("Results", ClientValueCollection(SiteHealthResult))
 

office365/sharepoint/sites/copy_job_progress.py

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

office365/sharepoint/sites/copy_migration_iInfo.py

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

office365/sharepoint/sites/{sph_site.py → home/site.py}

@@ -2,7 +2,7 @@ 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.home_site_reference import SPHSiteReference
+from office365.sharepoint.sites.home.reference import SPHSiteReference
 
 
 class SPHSite(Entity):

office365/sharepoint/sites/site.py

@@ -27,10 +27,11 @@ from office365.sharepoint.sitehealth.summary import SiteHealthSummary
 from office365.sharepoint.sites.azure_container_Info import (
     ProvisionedTemporaryAzureContainerInfo,
 )
+from office365.sharepoint.sites.copy_job_progress import CopyJobProgress
+from office365.sharepoint.sites.home.site import SPHSite
 from office365.sharepoint.sites.html_field_security_setting import (
     HTMLFieldSecuritySetting,
 )
-from office365.sharepoint.sites.sph_site import SPHSite
 from office365.sharepoint.sites.upgrade_info import UpgradeInfo
 from office365.sharepoint.sites.usage_info import UsageInfo
 from office365.sharepoint.sites.version_policy_manager import SiteVersionPolicyManager
@@ -153,6 +154,18 @@ class Site(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def get_copy_job_progress(self, copy_job_info=None):
+        """
+        :param copy_job_info: Optional copyJobInfo object.
+        """
+        payload = {"copyJobInfo": copy_job_info}
+        return_type = ClientResult(self.context, CopyJobProgress())
+        qry = ServiceOperationQuery(
+            self, "GetCopyJobProgress", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def get_site_logo(self):
         """Downloads a site logo"""
         return_type = ClientResult(self.context)
@@ -265,6 +278,18 @@ class Site(Entity):
         self.ensure_property("Id", _site_loaded)
         return return_type
 
+    def get_web_path(self, site_id, web_id):
+        """
+        :param int site_id: The site identifier
+        :param int web_id: The web identifier
+        """
+        params = {"siteId": site_id, "webId": web_id}
+        return_type = ClientResult(self.context, SPResPath())
+
+        qry = ServiceOperationQuery(self, "GetWebPath", params, None, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
     def get_web_templates(self, lcid=1033, override_compat_level=0):
         """
         Returns the collection of site definitions that are available for creating

office365/sharepoint/tenant/administration/app_service_principal_public.py

@@ -0,0 +1,17 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.entity import Entity
+
+
+class SPOWebAppServicePrincipalPublic(Entity):
+    """ """
+
+    def __init__(self, context):
+        """ """
+        static_path = ResourcePath(
+            "Microsoft.Online.SharePoint.TenantAdministration.SPOWebAppServicePrincipalPublic"
+        )
+        super(SPOWebAppServicePrincipalPublic, self).__init__(context, static_path)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOWebAppServicePrincipalPublic"

office365/sharepoint/tenant/administration/audit/data.py

@@ -1,7 +1,19 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.tenant.administration.modified_property import (
+    ModifiedProperty,
+)
 
 
 class AuditData(ClientValue):
+
+    def __init__(self, client_ip=None, correlation_id=None, modified_properties=None):
+        self.ClientIP = client_ip
+        self.CorrelationId = correlation_id
+        self.ModifiedProperties = ClientValueCollection(
+            ModifiedProperty, modified_properties
+        )
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Administration.TenantAdmin.AuditData"