OneDrive new actions

Author: vgrem

examples/directory/applications/has_application_perms.py

@@ -22,7 +22,7 @@
 resource = client.service_principals.get_by_name("Microsoft Graph")
 app_role = "Place.Read.All"  # "Bookings.Read.All"
 result = resource.get_application_permissions(test_client_id).execute_query()
-#if app_role not in result.value:
+# if app_role not in result.value:
 if not any(role.value == app_role for role in result.value):
     print("Application permission '{0}' is not granted".format(app_role))
 else:

office365/directory/identitygovernance/entitlementmanagement/accesspackage/__init__.py

@@ -0,0 +1,10 @@
+from office365.entity import Entity
+
+
+class AccessPackageCatalog(Entity):
+    """In Microsoft Entra entitlement management, an access package catalog is a container for zero or more access
+    packages. Microsoft Entra entitlement management includes a built-in catalog named General.
+
+     An access package catalog might also have linked resources that are used in those access packages
+     to provide access. To view or change the membership of catalog-scoped roles, use the role assignments API
+     with the entitlement management RBAC provider."""

office365/directory/identitygovernance/entitlementmanagement/accesspackage/catalog.py

@@ -0,0 +1,8 @@
+from office365.entity import Entity
+
+
+class AccessPackageResourceRequest(Entity):
+    """In Microsoft Entra entitlement management, an access package resource request is a request
+    to add a resource to a catalog so that the roles of the resource can be used in one or more of the catalog's
+    access packages, update a resource in a catalog to have different attribute requirements, or to remove a resource
+    from a catalog that is no longer needed by the access packages."""

office365/directory/identitygovernance/entitlementmanagement/accesspackage/resource_request.py

@@ -1,7 +1,24 @@
+from office365.directory.identitygovernance.entitlementmanagement.accesspackage.resource_request import (
+    AccessPackageResourceRequest,
+)
 from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class EntitlementManagement(Entity):
     """The entitlement management singleton is the container for entitlement management resources,
     including accessPackageCatalog, connectedOrganization, and entitlementManagementSettings.
     """
+
+    @property
+    def resource_requests(self):
+        """Represents a request to add or remove a resource to or from a catalog respectively."""
+        return self.properties.get(
+            "resourceRequests",
+            EntityCollection(
+                self.context,
+                AccessPackageResourceRequest,
+                ResourcePath("resourceRequests", self.resource_path),
+            ),
+        )

office365/directory/identitygovernance/entitlementmanagement/entitlement_management.py

@@ -0,0 +1,13 @@
+from typing import Optional
+
+from office365.entity import Entity
+
+
+class CustomCalloutExtension(Entity):
+    """An abstract type that defines the configuration for apps that can extend the customer's identity flows."""
+
+    @property
+    def display_name(self):
+        # type: () -> Optional[str]
+        """Display name for the customCalloutExtension object."""
+        return self.properties.get("displayName", None)

office365/directory/identitygovernance/workflow/custom_callout_extension.py

@@ -233,6 +233,59 @@ def change_password(self, current_password, new_password):
         self.context.add_query(qry)
         return self
 
+    def follow_site(self, site):
+        # type: (str|Site) -> None
+        """follow a site"""
+
+        def _follow_site(site_id):
+            # type: (str) -> None
+            payload = {
+                "value": [
+                    {
+                        "id": site_id,
+                    }
+                ]
+            }
+            query = ServiceOperationQuery(self.followed_sites, "add", None, payload)
+            self.context.add_query(query)
+
+        if isinstance(site, Site):
+
+            def _user_loaded():
+                _follow_site(site.id)
+
+            site.ensure_property("id", _user_loaded)
+        else:
+            _follow_site(site)
+        return self
+
+    def unfollow_site(self, site):
+        # type: (str|Site) -> None
+        """Unfollow a user's site or multiple sites."""
+
+        def _unfollow_site(site_id):
+            # type: (str) -> None
+            payload = {
+                "value": [
+                    {
+                        "id": site_id,
+                    }
+                ]
+            }
+            query = ServiceOperationQuery(self.followed_sites, "remove", None, payload)
+            self.context.add_query(query)
+
+        if isinstance(site, Site):
+
+            def _user_loaded():
+                _unfollow_site(site.id)
+
+            site.ensure_property("id", _user_loaded)
+        else:
+            _unfollow_site(site)
+
+        return self
+
     def get_mail_tips(self, email_addresses, mail_tips_options=None):
         """Get the MailTips of one or more recipients as available to the signed-in user.
         :param list[str] email_addresses: A collection of SMTP addresses of recipients to get MailTips for.

office365/directory/users/user.py

@@ -527,3 +527,7 @@ def security(self):
     def schema_extensions(self):
         """Get a list of schemaExtension objects in your tenant"""
         return EntityCollection(self, SchemaExtension, ResourcePath("schemaExtensions"))
+
+    @property
+    def tenant_name(self):
+        return self._tenant

office365/graph_client.py

@@ -1,21 +1,17 @@
-from office365.runtime.compat import is_absolute_url, urlparse
+from office365.runtime.compat import urlparse
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.paths.v4.entity import EntityPath
 
 
 class SitePath(EntityPath):
     """Resource path for addressing Site resource"""
 
-    @property
-    def segment(self):
-        if is_absolute_url(self._key):
-            url_result = urlparse(self._key)
-            return ":".join([url_result.hostname, url_result.path])
-        else:
-            return super(SitePath, self).segment
+    def __init__(self, host_name, relative_path, parent=None):
+        super(SitePath, self).__init__(
+            ":".join([host_name, relative_path]), parent, ResourcePath("sites")
+        )
 
-    @property
-    def collection(self):
-        if self._collection is None:
-            self._collection = ResourcePath("sites")
-        return self._collection
+    @staticmethod
+    def from_url(url, parent=None):
+        url_result = urlparse(url)
+        return SitePath(url_result.hostname, url_result.path, parent)

office365/onedrive/internal/paths/site.py

@@ -21,12 +21,24 @@ def get_all_sites(self):
         self.context.add_query(qry)
         return return_type
 
+    def get_by_path(self, path):
+        """Address Site resource by server relative path
+
+        :param str path: Server relative path
+        """
+        tenant_part = self.context.tenant_name.split(".")[0]
+        host_name = "{0}.sharepoint.com".format(tenant_part)
+        return_type = Site(self.context, SitePath(host_name, path, self.resource_path))
+        qry = ReadEntityQuery(return_type)
+        self.context.add_query(qry)
+        return return_type
+
     def get_by_url(self, url):
         """Address Site resource by absolute url
 
         :param str url: Site absolute url
         """
-        return_type = Site(self.context, SitePath(url, self.resource_path))
+        return_type = Site(self.context, SitePath.from_url(url, self.resource_path))
         qry = ReadEntityQuery(return_type)
         self.context.add_query(qry)
         return return_type