Merge pull request #24773 from microsoftgraph/add-virtual-event-settings-property

Lauragra · web-flow · commit b1c5ef7b883a · 2024-08-06T20:35:26.000-07:00
Add virtual event settings property
diff --git a/api-reference/v1.0/api/virtualeventsroot-list-webinars.md b/api-reference/v1.0/api/virtualeventsroot-list-webinars.md
@@ -61,50 +61,15 @@ If successful, this method returns a `200 OK` response code and a collection of
 
 The following example shows a request.
 
-# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "list_virtualeventwebinars"
 }
 -->
 ``` http
-GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars
+GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars
 ```
 
-# [C#](#tab/csharp)
-[!INCLUDE [sample-code](../includes/snippets/csharp/list-virtualeventwebinars-csharp-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [CLI](#tab/cli)
-[!INCLUDE [sample-code](../includes/snippets/cli/list-virtualeventwebinars-cli-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Go](#tab/go)
-[!INCLUDE [sample-code](../includes/snippets/go/list-virtualeventwebinars-go-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Java](#tab/java)
-[!INCLUDE [sample-code](../includes/snippets/java/list-virtualeventwebinars-java-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [JavaScript](#tab/javascript)
-[!INCLUDE [sample-code](../includes/snippets/javascript/list-virtualeventwebinars-javascript-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PHP](#tab/php)
-[!INCLUDE [sample-code](../includes/snippets/php/list-virtualeventwebinars-php-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PowerShell](#tab/powershell)
-[!INCLUDE [sample-code](../includes/snippets/powershell/list-virtualeventwebinars-powershell-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Python](#tab/python)
-[!INCLUDE [sample-code](../includes/snippets/python/list-virtualeventwebinars-python-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
----
-
 ### Response
 
 The following example shows the response.
@@ -152,7 +117,10 @@ Content-Type: application/json
           "displayName": "Kenneth Brown",
           "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
         }
-      ]
+      ],
+      "settings": {
+        "isAttendeeEmailNotificationEnabled": false
+      }
     }
   ]
 }
diff --git a/api-reference/v1.0/api/virtualeventwebinar-get.md b/api-reference/v1.0/api/virtualeventwebinar-get.md
@@ -144,7 +144,10 @@ Content-Type: application/json
         "displayName": "Kenneth Brown",
         "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
       }
-    ]
+    ],
+    "settings": {
+      "isAttendeeEmailNotificationEnabled": false
+    }
   }
 }
 ```
diff --git a/api-reference/v1.0/api/virtualeventwebinar-getbyuseridandrole.md b/api-reference/v1.0/api/virtualeventwebinar-getbyuseridandrole.md
@@ -150,7 +150,10 @@ Content-Type: application/json
           "displayName": "Kenneth Brown",
           "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
         }
-      ]
+      ],
+      "settings": {
+        "isAttendeeEmailNotificationEnabled": false
+      }
     }
   ]
 }
diff --git a/api-reference/v1.0/api/virtualeventwebinar-getbyuserrole.md b/api-reference/v1.0/api/virtualeventwebinar-getbyuserrole.md
@@ -146,7 +146,10 @@ Content-Type: application/json
           "displayName": "Kenneth Brown",
           "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
         }
-      ]
+      ],
+      "settings": {
+        "isAttendeeEmailNotificationEnabled": false
+      }
     }
   ]
 }
diff --git a/api-reference/v1.0/resources/virtualevent.md b/api-reference/v1.0/resources/virtualevent.md
@@ -27,6 +27,7 @@ Inherits from [entity](../resources/entity.md).
 |displayName|String|The display name of the virtual event. |
 |endDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|The end time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).|
 |id|String|The unique identifier of the virtual event. Inherited from [entity](../resources/entity.md).|
+|settings|[virtualEventSettings](../resources/virtualeventsettings.md)| The virtual event settings. |
 |startDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|Start time of the virtual event. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones).|
 |status|virtualEventStatus|The status of the virtual event. The possible values are: `draft`, `published`, `canceled`, and `unknownFutureValue`.|
 
@@ -63,6 +64,9 @@ The following JSON representation shows the resource type.
     "@odata.type": "microsoft.graph.dateTimeTimeZone"
   },
   "id": "String (identifier)",
+  "settings": {
+    "@odata.type": "microsoft.graph.virtualEventSettings"
+  },
   "startDateTime": {
     "@odata.type": "microsoft.graph.dateTimeTimeZone"
   },
diff --git a/api-reference/v1.0/resources/virtualeventsettings.md b/api-reference/v1.0/resources/virtualeventsettings.md
@@ -0,0 +1,47 @@
+---
+title: "virtualEventSettings resource type"
+description: "Represents the settings for a virtual event."
+author: "halleclottey-msft"
+ms.localizationpriority: medium
+ms.subservice: "cloud-communications"
+doc_type: resourcePageType
+---
+
+# virtualEventSettings resource type
+
+Namespace: microsoft.graph
+
+Represents the settings for a [virtual event](../resources/virtualevent.md).
+
+## Properties
+
+|Property|Type|Description|
+|:---|:---|:---|
+|isAttendeeEmailNotificationEnabled|Boolean| Indicates whether virtual event attendees receive email notifications.|
+
+## Relationships
+
+|Relationship|Type|Description|
+|:---|:---|:---|
+|virtualEvents|[virtualEvent](../resources/virtualevent.md)| Provides configuration settings for a [virtual event](../resources/virtualevent.md).|
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+
+<!-- {
+  "blockType": "resource",
+  "@odata.type": "microsoft.graph.virtualEventSettings"
+}
+-->
+``` json
+{
+  "@odata.type": "#microsoft.graph.virtualEventSettings",
+  "isAttendeeEmailNotificationEnabled": "Boolean"
+}
+```
+
+## Related content
+
+- [Virtual event](../resources/virtualevent.md)
+- [Virtual event webinars](../resources/virtualeventwebinar.md)
diff --git a/api-reference/v1.0/resources/virtualeventwebinar.md b/api-reference/v1.0/resources/virtualeventwebinar.md
@@ -40,6 +40,7 @@ Inherits from [virtualEvent](../resources/virtualevent.md).
 | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | End time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). |
 | startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Start time of the webinar. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). |
 | id | String | Unique identifier of the webinar. Inherited from [entity](../resources/entity.md).|
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The webinar settings. Inherited from [virtualEvent](../resources/virtualevent.md). |
 | status | virtualEventStatus | Status of the webinar. Possible values are: `draft`, `published`, `canceled`, and `unknownFutureValue`. Inherited from [virtualEvent](../resources/virtualevent.md). |
 
 ## Relationships
@@ -72,11 +73,12 @@ The following JSON representation shows the resource type.
   "displayName": "String",
   "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
   "id": "String (identifier)",
+  "settings": {"@odata.type": "microsoft.graph.virtualEventSettings"},
   "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
   "status": "String"
 }
 ```
 
 ## Related content
 
-[List meetingAttendanceReports](../api/meetingattendancereport-list.md)
+[List meetingAttendanceReports](../api/meetingattendancereport-list.md)
diff --git a/changelog/Microsoft.Skype.Calling.json b/changelog/Microsoft.Skype.Calling.json
@@ -1,5 +1,31 @@
 {
   "changelog": [
+    {
+      "ChangeList": [
+        {
+          "Id": "ec5ee95e-0c0f-4fe5-a404-bdc4d3faea41",
+          "ApiChange": "Resource",
+          "ChangedApiName": "virtualEventSettings",
+          "ChangeType": "Addition",
+          "Description": "Added the [virtualEventSettings](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSettings?view=graph-rest-1.0) resource type.",
+          "Target": "virtualEventSettings"
+        },
+        {
+          "Id": "ec5ee95e-0c0f-4fe5-a404-bdc4d3faea41",
+          "ApiChange": "Property",
+          "ChangedApiName": "settings",
+          "ChangeType": "Addition",
+          "Description": "Added the **settings** property to the [virtualEvent](https://learn.microsoft.com/en-us/graph/api/resources/virtualEvent?view=graph-rest-1.0) resource.",
+          "Target": "virtualEvent"
+        }
+      ],
+      "Id": "ec5ee95e-0c0f-4fe5-a404-bdc4d3faea41",
+      "Cloud": "Prod",
+      "Version": "v1.0",
+      "CreatedDateTime": "2024-08-06T00:00:00Z",
+      "WorkloadArea": "Teamwork and communications",
+      "SubArea": "Calls and online meetings"
+    },
     {
       "ChangeList": [
         {
@@ -215,7 +241,7 @@
           "ApiChange": "Method",
           "ChangedApiName": "GET",
           "ChangeType": "Change",
-          "Description": "Renamed the [List](https://learn.microsoft.com/en-us/graph/api/virtualeventwebinar-list-registrations?view=graph-rest-1.0) method to (https://learn.microsoft.com/en-us/graph/api/virtualeventregistration-list?view=graph-rest-1.0).",
+          "Description": "Renamed the file for the List operation of the [virtualEventRegistration](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventRegistration?view=graph-rest-1.0) resource to [virtualeventregistration-list](https://learn.microsoft.com/en-us/graph/api/virtualeventregistration-list?view=graph-rest-1.0).",
           "Target": "virtualEventRegistration"
         }
       ],
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -65,6 +65,7 @@ Use the **summary** property to get details about what happened, impacted assets
 
 ### Teamwork and communications | Calls and online meetings
 
+- Use the **settings** property on [virtualEventWebinar](/graph/api/resources/virtualeventwebinar) to identify whether attendees receive email notifications.
 - Use the **callId** on [callRecording](/graph/api/resources/callrecording) or [callTranscript](/graph/api/resources/calltranscript) to identify the [call](/graph/api/resources/call) that is related to a recording or transcript.
 - Use the **contentCorrelationId** on [callRecording](/graph/api/resources/callrecording) or [callTranscript](/graph/api/resources/calltranscript) to correlate a transcript with its corresponding recording.
 - Use the **endDateTime** on [callRecording](/graph/api/resources/callrecording) or [callTranscript](/graph/api/resources/calltranscript) to identify when a recording or transcript ends.

Original file line number	Diff line number	Diff line change
`@@ -144,7 +144,10 @@ Content-Type: application/json`
`144`	`144`	`"displayName": "Kenneth Brown",`
`145`	`145`	`"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"`
`146`	`146`	`}`
`147`		`- ]`
	`147`	`+ ],`
	`148`	`+ "settings": {`
	`149`	`+ "isAttendeeEmailNotificationEnabled": false`
	`150`	`+ }`
`148`	`151`	`}`
`149`	`152`	`}`
`150`	`153`	```
Original file line number	Diff line number	Diff line change
`@@ -150,7 +150,10 @@ Content-Type: application/json`
`150`	`150`	`"displayName": "Kenneth Brown",`
`151`	`151`	`"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"`
`152`	`152`	`}`
`153`		`- ]`
	`153`	`+ ],`
	`154`	`+ "settings": {`
	`155`	`+ "isAttendeeEmailNotificationEnabled": false`
	`156`	`+ }`
`154`	`157`	`}`
`155`	`158`	`]`
`156`	`159`	`}`
Original file line number	Diff line number	Diff line change
`@@ -146,7 +146,10 @@ Content-Type: application/json`
`146`	`146`	`"displayName": "Kenneth Brown",`
`147`	`147`	`"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"`
`148`	`148`	`}`
`149`		`- ]`
	`149`	`+ ],`
	`150`	`+ "settings": {`
	`151`	`+ "isAttendeeEmailNotificationEnabled": false`
	`152`	`+ }`
`150`	`153`	`}`
`151`	`154`	`]`
`152`	`155`	`}`