Créer virtualEventTownhall
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Créez un objet virtualEventTownhall en mode brouillon.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
Type d’autorisation | Autorisation avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | VirtualEvent.ReadWrite | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Non prise en charge. | Non prise en charge. |
Requête HTTP
POST /solutions/virtualEvents/townhalls
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON des types dérivés pris en charge de l’objet virtualEventTownhall .
Vous pouvez spécifier les propriétés suivantes lorsque vous créez un virtualEventTownhall.
Propriété | Type | Description |
---|---|---|
audience | meetingAudience | Le public auquel la mairie est visible. |
coorganiseurs | collection communicationsUserIdentity | Les informations d’identité des coorganisateurs de la mairie. |
description | itemBody | Description de la mairie. |
displayName | Chaîne | Nom d’affichage de la mairie. |
endDateTime | dateTimeTimeZone | Date et heure de la fin de la mairie. |
invitedAttendees | collection d’identités | Identités des participants invités à la mairie. Les identités prises en charge sont les suivantes : communicationsGuestIdentity et communicationsUserIdentity. |
isInviteOnly | Valeur booléenne | Indique si l’assemblée publique est ouverte uniquement aux personnes et groupes invités au sein de votre organisation. La propriété isInviteOnly ne peut être true que si la valeur de la propriété audience est définie sur organization . |
paramètres | virtualEventSettings | Les paramètres de l’hôtel de ville. |
startDateTime | dateTimeTimeZone | Date et heure de début de la mairie. |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created
code de réponse et un objet virtualEventTownhall dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls
Content-Type: application/json
{
"displayName": "The Impact of Tech on Our Lives",
"description": {
"contentType": "text",
"content": "Discusses how technology has changed the way we communicate."
},
"startDateTime": {
"dateTime": "2023-03-30T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2023-03-30T17:00:00",
"timeZone": "Pacific Standard Time"
},
"audience": "organization",
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"settings": {
"isAttendeeEmailNotificationEnabled": false
}
}
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba",
"status": "draft",
"displayName": "The Impact of Tech on Our Lives",
"description": {
"contentType": "text",
"content": "Discusses how technology has changed the way we communicate."
},
"startDateTime": {
"dateTime": "2023-03-30T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2023-03-30T17:00:00",
"timeZone": "Pacific Standard Time"
},
"audience": "organization",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
"displayName": "Diane Demoss",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
},
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"displayName": "Kenneth Brown",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"invitedAttendees": [],
"settings": {
"isAttendeeEmailNotificationEnabled": false
},
"isInviteOnly": false
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour