Docs updates

Author: vgrem

README.md

@@ -158,20 +158,10 @@ json = json.loads(response.content)
 web_title = json['d']['Title']
 print("Web title: {0}".format(web_title))
 ```
-
-The list of examples:
-
-- Working with files
-  - [download a file](examples/sharepoint/files/download.py) 
-  - [upload a file](examples/sharepoint/files/upload.py)
-
-- Working with lists and list items
-  -  [create a list item](examples/sharepoint/lists/data_generator.py)
-  -  [read a list item](examples/sharepoint/lists/read_paged.py)   
-  -  [update a list item](examples/sharepoint/listitems/update_batch.py)
-  -  [delete a list item](examples/sharepoint/listitems/delete.py) 
 
-Refer [examples section](examples/sharepoint) for another scenarios
+For SharePoint-specific examples, see:  
+📌 **[SharePoint examples guide](examples/sharepoint/README.md)**  
+
 
 ### Support for Azure environments
 

examples/README.md

@@ -0,0 +1,3 @@
+# Examples
+
+This directory contains practical examples demonstrating how to use the library.

examples/auth/README.md

@@ -0,0 +1,10 @@
+# Authentication
+For the following examples, relevant credentials can be found in the Azure Portal.
+
+Steps to access:
+1. Login to the home page of the Azure Portal
+2. Navigate to "Azure Active Directory" using the three bars in the top right corner of the portal
+3. Select "App registrations" in the navigation panel on the left
+4. Search for and select your relevant application
+5. In the application's "Overview" page, the client id can be found under "Application (client) id"
+6. In the application's "Certificates & Secrets" page, the client secret can be found under the "Value" of the "Client Secrets." If there is no client secret yet, create one here.

examples/communications/create_call.py

@@ -0,0 +1,22 @@
+# SharePoint Examples
+
+This directory contains examples for SharePoint REST API v1
+ 
+
+###  [Working with folders and files](./files/)  
+   - **Download** a file: [`download.py`](./files/download.py)  
+   - **Upload** a file: [`upload.py`](./files/upload.py)  
+   - **Create** a folder: [`create.py`](./folders/create.py)
+
+###  [Working with lists](./lists/)  
+   - **Create** a list item: [`create_item.py`](./lists/create_item.py)   
+   - **Read** list items (paged): [`read_items.py`](./lists/read_items.py)  
+
+###   [Working with list items](./listitems/)  
+   - **Update** items in batch: [`update_batch.py`](./listitems/update_batch.py)  
+   - **Delete** an item: [`delete.py`](./listitems/delete.py)  
+
+
+
+---
+

examples/informationprotection/create_mail_assessment.py

@@ -4,9 +4,27 @@
 class CustomActionElement(ClientValue):
     """A class specifies a custom action element."""
 
-    def __init__(self, clientside_component_id=None):
+    def __init__(
+        self,
+        clientside_component_id=None,
+        client_side_component_properties=None,
+        command_ui_extension=None,
+        enabled_script=None,
+        host_properties=None,
+        image_url=None,
+    ):
         """
         :param str clientside_component_id: The unique identifier of the client-side component associated
             with the custom action.
+        :param str client_side_component_properties: This property is only used when a ClientSideComponentId is
+            specified. It is optional. If non-empty, the string MUST contain a JSON object with custom
+            initialization properties whose format and meaning are defined by the client-side component.
+        :param str command_ui_extension: This property is only used when a ClientSideComponentId is specified.
+        :param str enabled_script: The client side script to enabled or disable the custom action.
         """
         self.ClientSideComponentId = clientside_component_id
+        self.ClientSideComponentProperties = client_side_component_properties
+        self.CommandUIExtension = command_ui_extension
+        self.EnabledScript = enabled_script
+        self.HostProperties = host_properties
+        self.ImageUrl = image_url

examples/sharepoint/README.md

@@ -0,0 +1,11 @@
+class CheckinType:
+    """Specifies the type of check in for a file."""
+
+    MinorCheckIn = 0
+    """Incremented as a minor version. Value=0."""
+
+    MajorCheckIn = 1
+    """Incremented as a major version. Value=1."""
+
+    OverwriteCheckIn = 2
+    """Overwrite the existing file. Value=2."""

office365/sharepoint/customactions/element.py

@@ -1,7 +1,12 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.lists.data_validation_failure import ListDataValidationFailure
 
 
 class ListDataValidationExceptionValue(ClientValue):
     """Specifies failure information for a failed field or list item data validation."""
 
-    pass
+    def __init__(self, field_failures=None):
+        self.FieldFailures = ClientValueCollection(
+            ListDataValidationFailure, field_failures
+        )

office365/sharepoint/files/checkin_type.py

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