Merge pull request #25765 from microsoftgraph/repo_sync_working_branch

Lauragra · web-flow · commit 6a16ce50f559 · 2024-11-22T17:59:04.000-08:00
Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftgraph/microsoft-graph-docs-contrib (branch main)
diff --git a/api-reference/beta/resources/aiinteractionhistory.md b/api-reference/beta/resources/aiinteractionhistory.md
@@ -21,7 +21,7 @@ Represents a list of messages exchanged involving AI.
 
 |  Method       |  Return Type  | Description| 
 |:---------------|:--------|:----------|
-|[List all enterprise interactions](../api/aiinteractionhistory-getallenterpriseinteractions.md) | [aiinteraction](aiinteraction.md) collection | Get all Microsoft 365 Copilot interactions data, including user prompts to Copilot and the Copilot responses. |
+|[List all enterprise interactions](../api/aiinteractionhistory-getallenterpriseinteractions.md) | [aiInteraction](aiinteraction.md) collection | Get all Microsoft 365 Copilot interactions data, including user prompts to Copilot and the Copilot responses. |
 
 ## Properties
 None.
diff --git a/api-reference/v1.0/api/virtualeventtownhall-cancel.md b/api-reference/v1.0/api/virtualeventtownhall-cancel.md
@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall: cancel
 Namespace: microsoft.graph
 
 Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md). A canceled town hall has its **status** set to `canceled` permanently. You can still get a canceled town hall by using the [Get virtualEventTownhall](../api/virtualeventtownhall-get.md) API.
 
+Only the **Organizer** can cancel a townhall event.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,7 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/bce9a3ca
 
 ---
 
----
 
 ### Response
 
diff --git a/api-reference/v1.0/api/virtualeventtownhall-get.md b/api-reference/v1.0/api/virtualeventtownhall-get.md
@@ -5,7 +5,7 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/08/2024
+ms.date: 11/22/2024
 ---
 
 # Get virtualEventTownhall
@@ -14,6 +14,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object.
 
+All roles can get the details of a townhall event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
diff --git a/api-reference/v1.0/api/virtualeventtownhall-publish.md b/api-reference/v1.0/api/virtualeventtownhall-publish.md
@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall: publish
 Namespace: microsoft.graph
 
 Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md) to make it visible to its audience.
 
+Only the **Organizer** can publish a townhall event.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,7 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/bce9a3ca
 
 ---
 
----
 
 ### Response
 
diff --git a/api-reference/v1.0/api/virtualeventtownhall-update.md b/api-reference/v1.0/api/virtualeventtownhall-update.md
@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/08/2024
+ms.date:11/22/2024
 ---
 
 # Update virtualEventTownhall
 Namespace: microsoft.graph
 
 Update the properties of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object.
 
+Only the **Organizer** and **Co-organizer** can make changes to a townhall event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
diff --git a/api-reference/v1.0/api/virtualeventwebinar-cancel.md b/api-reference/v1.0/api/virtualeventwebinar-cancel.md
@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar: cancel
 Namespace: microsoft.graph
 
 Cancel a [virtualEventWebinar](../resources/virtualeventwebinar.md). A canceled webinar has its **status** set to `canceled` permanently. You can still get a canceled webinar by using the [Get virtualEventWebinar](../api/virtualeventwebinar-get.md) API.
 
+Only the **Organizer** can cancel a webinar.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,8 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/a57082a9
 
 ---
 
----
-
 ### Response
 
 The following example shows the response.
diff --git a/api-reference/v1.0/api/virtualeventwebinar-get.md b/api-reference/v1.0/api/virtualeventwebinar-get.md
@@ -5,13 +5,16 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # Get virtualEventWebinar
 Namespace: microsoft.graph
 
 Read the properties and relationships of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object.
 
+All roles can get the details of a webinar event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
diff --git a/api-reference/v1.0/api/virtualeventwebinar-publish.md b/api-reference/v1.0/api/virtualeventwebinar-publish.md
@@ -5,13 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar: publish
 Namespace: microsoft.graph
 
 Publish a [virtualEventWebinar](../resources/virtualeventwebinar.md) to make it visible to its audience.
 
+Only the **Organizer** can publish a webinar.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -70,8 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/a57082a9-
 
 ---
 
----
-
 ### Response
 
 The following example shows the response.
diff --git a/api-reference/v1.0/api/virtualeventwebinar-update.md b/api-reference/v1.0/api/virtualeventwebinar-update.md
@@ -5,13 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # Update virtualEventWebinar
 Namespace: microsoft.graph
 
 Update the properties of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object.
 
+Only the **Organizer** and **Co-organizer** can make changes to a webinar event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
diff --git a/api-reference/v1.0/resources/virtualeventtownhall.md b/api-reference/v1.0/resources/virtualeventtownhall.md
@@ -5,6 +5,7 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: resourcePageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall resource type
@@ -25,6 +26,18 @@ Inherits from [virtualEvent](../resources/virtualevent.md).
 | [Publish](../api/virtualeventtownhall-publish.md) | None | Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md).|
 | [Cancel](../api/virtualeventtownhall-cancel.md) | None | Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md).|
 
+### Roles required to act on virtualEventTownhall objects
+
+The following table shows the roles that can perform various actions on virtual event town halls.
+
+|Role          | Create	    | Get	       | Update	    | Publish 	 | Cancel 	  |
+| ------           | ----------- | ---------- | ---------- | ---------- | ---------- |
+|Organizer         |	✅|	✅|	✅|	✅|	✅|
+|Co-organizer      |	❌|	✅|	✅|	❌|	❌|
+|Presenter         | 	❌|	✅|	❌|	❌|	❌|
+|Attendee          |	❌|	✅|	❌|	❌|	❌|
+|Custom application|	❌|	✅|	❌|	❌|	❌|
+
 ## Properties
 
 |Property|Type|Description|
diff --git a/api-reference/v1.0/resources/virtualeventwebinar.md b/api-reference/v1.0/resources/virtualeventwebinar.md
@@ -5,6 +5,7 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: resourcePageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar resource type
@@ -28,6 +29,19 @@ Inherits from [virtualEvent](../resources/virtualevent.md).
 | [List by user role](../api/virtualeventwebinar-getbyuserrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the signed-in user is either the organizer or a coorganizer. |
 | [List by user ID and role](../api/virtualeventwebinar-getbyuseridandrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the specified user is either the organizer or a coorganizer. |
 
+### Roles required to act on virtualEventWebinar objects
+
+The following table shows the roles that can perform various actions on webinars.
+
+|Role          | Create	    | Get	       | Update	    | Publish 	 | Cancel 	  | List in org	| List by user role	| List by user ID & role |
+| ------           | ----------- | ---------- | ---------- | ---------- | ---------- | ----------  | ----------------- | ---------------------- |
+|Organizer         |	✅|	✅|	✅|	✅|	✅|	❌|	✅|	❌|
+|Co-organizer      |	❌|	✅|	✅|	❌|	❌|	❌|	✅|	❌|
+|Presenter         | 	❌|	✅|	❌|	❌|	❌|	❌|	✅|	❌|
+|Attendee          |	❌|	✅|	❌|	❌|	❌|	❌|	✅|	❌|
+|Custom application|	❌|	✅|	❌|	❌|	❌|	✅|	❌|	✅|
+
+
 ## Properties
 
 | Property | Type | Description |
diff --git a/concepts/cloud-communications-online-meeting-artifacts.md b/concepts/cloud-communications-online-meeting-artifacts.md
@@ -4,42 +4,26 @@ description: "Learn about online meeting artifacts, such as attendance reports a
 author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
-ms.date: "09/20/2021"
+ms.date: "11/22/2024"
 ---
 
 # Online meeting artifacts and permissions
 
-Online meeting artifacts are content produced during an online meeting or [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). You can use the [Get onlineMeeting](/graph/api/onlinemeeting-get) operation to get the following meeting artifacts:
-
-- Attendance report of an online meeting, in the form of a JSON response. Attendance reports have the following characteristics:
-  - Available for meetings other than Teams live events
-  - Only available when the meeting ends
-  - Only the meeting organizer can access
-  - Includes guest and federated users that were part of the online meeting
-- Recordings of a Teams live event, in the form of a download link that expires in 60 seconds. Recordings have the following characteristics:
-  - Only available for Teams live events
-  - Only available when the Teams live event ends
-  - Only the organizer of the Teams live event can access
-- Attendee report of a Teams live event, in the form of a download link that expires in 60 seconds. Attendee reports have the following characteristics:
-  - Only available for Teams live events
-  - Only available when the Teams live event ends
-  - Only the organizer of the Teams live event can access
+Online meeting artifacts are content produced during online meetings and virtual events like webinars. You can use the [Get meetingAttendanceReport](/graph/api/meetingattendancereport-get) method to get the attendance report of an online meeting, in the form of a JSON response. Attendance reports have the following characteristics:
+
+  - They're only available when the meeting ends.
+  - Only the meeting organizer can access them.
+  - They include guest and federated users that were part of the online meeting.
 
 ## Permissions
 
 The following permissions are available to manage meeting artifacts:
 
 - Delegated (work or school account) - OnlineMeetingArtifact.Read.All
+- Delegated (personal Microsoft account) - Not supported
 - Application - OnlineMeetingArtifact.Read.All
 
-Only the _OnlineMeetingArtifact.Read.All_ permissions are required to fetch online meeting artifacts. Until **January 15, 2022**, you can use the following permissions to get meeting artifacts in beta:
-
-- _OnlineMeeting.Read_
-- _OnlineMeeting.ReadWrite_
-- _OnlineMeeting.Read.All_
-- _OnlineMeeting.ReadWrite.All_
-
-After that date, the _OnlineMeetingArtifact.Read.All_ permissions will be required to fetch meeting artifacts; requests that don't have those permissions will be rejected.
+For more information about the permissions for this API, see [Get meetingAttendanceReport](/graph/api/meetingattendancereport-get?view=graph-rest-1.0&tabs=http#permissions).
 
 ## Related content
 
diff --git a/concepts/microsoft-graph-activity-logs-overview.md b/concepts/microsoft-graph-activity-logs-overview.md
@@ -37,9 +37,7 @@ To access the Microsoft Graph activity logs, you need the following privileges.
 
 ## What data is available in the Microsoft Graph activity logs?
 
-The following data relating to API requests is available for Microsoft Graph activity logs on the Logs Analytics interface.
-
-[!INCLUDE [microsoftgraphactivitylogs-include](~/../azure-reference-other/azure-monitor-ref/tables/includes/microsoftgraphactivitylogs-include.md)]
+For information about the available data relating to API requests for Microsoft Graph activity logs on the Logs Analytics interface, see [Azure Monitor Logs reference](/azure/azure-monitor/reference/tables/microsoftgraphactivitylogs).
 
 ## Common use cases for Microsoft Graph activity logs
 
