Teams API: new types, type hints improvements

Author: vgrem

examples/onedrive/README.md

@@ -0,0 +1 @@
+# Working with OneDrive and SharePoint API v2 APIs 

examples/outlook/README.md

@@ -0,0 +1,6 @@
+# Working with Outlook API
+
+The list of supported APIs:
+-   [Outlook Contacts REST API](https://msdn.microsoft.com/en-us/office/office365/api/contacts-rest-operations)
+-   [Outlook Calendar REST API](https://msdn.microsoft.com/en-us/office/office365/api/calendar-rest-operations)
+-   [Outlook Mail REST API](https://msdn.microsoft.com/en-us/office/office365/api/mail-rest-operations)

examples/sharepoint/README.md

@@ -3,20 +3,26 @@
 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)  
-
-
+###  Working with folders and files  
+   - **Download** a file: [`./files/download.py`](./files/download.py)  
+   - **Upload** a file: [`./files/upload.py`](./files/upload.py)  
+   - **Create** a folder: [`./folders/create.py`](./folders/create.py)
+   - **Upload** large file: [`./files/upload_large.py`](./files/upload_large.py) 
+   - **List** file version history: [`./versions/list.py`](./files/versions/list.py)
+
+###  Working with lists and list items  
+   - **Create** a list item: [`/lists/create_item.py`](./lists/create_item.py)   
+   - **Read** list items (paged): [`/lists/read_items.py`](./lists/read_items.py)
+   - **Update** items in batch: [`./listitems/update_batch.py`](./listitems/update_batch.py)  
+   - **Delete** an list item: [`./listitems/delete.py`](./listitems/delete.py)
+
+###   Working with fields and field values  
+   - **Create** lookup field: [`create_lookup.py`](./fields/create_lookup.py)  
+   
+###   Working with taxonomy  
+   - **Get** field value : [`get_field_value.py`](./taxonomy/get_field_value.py)  
+   
+###   Working with site  
 
 ---
 

generator/metadata/Graph.xml

@@ -41874,6 +41874,7 @@ within the time frame of their original request."/>
             <Member Name="microsoftDefenderThreatIntelligenceAnalytics" Value="1073741846"/>
             <Member Name="builtInMl" Value="1073741847"/>
             <Member Name="microsoftInsiderRiskManagement" Value="1073741848"/>
+            <Member Name="microsoftThreatIntelligence" Value="1073741849"/>
             <Member Name="microsoftSentinel" Value="268435456"/>
          </EnumType>
          <EnumType Name="detectionStatus">
@@ -42025,6 +42026,7 @@ within the time frame of their original request."/>
             <Member Name="microsoftDefenderForCloud" Value="256"/>
             <Member Name="microsoftSentinel" Value="512"/>
             <Member Name="microsoftInsiderRiskManagement" Value="1024"/>
+            <Member Name="microsoftThreatIntelligence" Value="2048"/>
          </EnumType>
          <EnumType Name="teamsDeliveryLocation">
             <Member Name="unknown" Value="0"/>

office365/directory/authentication/methods/sms.py

@@ -1,9 +1,26 @@
 from office365.directory.authentication.method_configuration import (
     AuthenticationMethodConfiguration,
 )
+from office365.directory.authentication.methods.sms_target import (
+    SmsAuthenticationMethodTarget,
+)
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class SmsAuthenticationMethodConfiguration(AuthenticationMethodConfiguration):
     """Represents a text message authentication methods policy. Authentication methods policies define
     configuration settings and users or groups that are enabled to use the authentication method.
     """
+
+    @property
+    def include_targets(self):
+        """Groups of users that are excluded from the policy."""
+        return self.properties.get(
+            "includeTargets",
+            EntityCollection(
+                self.context,
+                SmsAuthenticationMethodTarget,
+                ResourcePath("includeTargets", self.resource_path),
+            ),
+        )

office365/directory/authentication/methods/sms_target.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.entity import Entity
+
+
+class SmsAuthenticationMethodTarget(Entity):
+    """Represents the users or groups of users that are excluded from a policy."""

office365/directory/security/alerts/history_state.py

@@ -3,3 +3,9 @@
 
 class AlertHistoryState(ClientValue):
     """Stores changes made to alerts."""
+
+    def __init__(self, app_id=None, assigned_to=None, comments=None):
+        # type: (str, str, list[str]) -> None
+        self.appId = app_id
+        self.assignedTo = assigned_to
+        self.comments = comments

office365/directory/security/hunting_query_results.py

@@ -1,5 +1,10 @@
+from office365.directory.security.hunting_row_result import HuntingRowResult
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class HuntingQueryResults(ClientValue):
     """The results of running a query for advanced hunting."""
+
+    def __init__(self, results=None):
+        self.results = ClientValueCollection(HuntingRowResult, results)

office365/directory/security/hunting_row_result.py

@@ -0,0 +1,8 @@
+from office365.runtime.client_value import ClientValue
+
+
+class HuntingRowResult(ClientValue):
+    """Represents a row of the results from running an advanced hunting query.
+
+    The content of the results is depended on the submitted KQL query, see KQL quick reference.
+    """

office365/directory/security/security.py

@@ -6,6 +6,9 @@
 from office365.directory.security.incidents.incident import Incident
 from office365.directory.security.labels.root import LabelsRoot
 from office365.directory.security.scorecontrol.profile import SecureScoreControlProfile
+from office365.directory.security.subjectrightsrequests.request import (
+    SubjectRightsRequest,
+)
 from office365.directory.security.threatintelligence.threat_intelligence import (
     ThreatIntelligence,
 )
@@ -93,6 +96,19 @@ def labels(self):
             LabelsRoot(self.context, ResourcePath("labels", self.resource_path)),
         )
 
+    @property
+    def subject_rights_requests(self):
+        # type: () -> EntityCollection[SubjectRightsRequest]
+        """Get a list of the subjectRightsRequest objects and their properties."""
+        return self.properties.get(
+            "subjectRightsRequests",
+            EntityCollection(
+                self.context,
+                SubjectRightsRequest,
+                ResourcePath("subjectRightsRequests", self.resource_path),
+            ),
+        )
+
     @property
     def secure_score_control_profiles(self):
         """"""
@@ -128,6 +144,7 @@ def get_property(self, name, default_value=None):
             property_mapping = {
                 "alerts_v2": self.alerts_v2,
                 "attackSimulation": self.attack_simulation,
+                "subjectRightsRequests": self.subject_rights_requests,
                 "secureScoreControlProfiles": self.secure_score_control_profiles,
                 "threatIntelligence": self.threat_intelligence,
             }