Create virtualEventTownhall

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Create ein neues virtualEventTownhall-Objekt im Entwurfsmodus.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigung mit den geringsten Rechten	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	VirtualEvent.ReadWrite	Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Nicht unterstützt	Nicht unterstützt

HTTP-Anforderung

POST /solutions/virtualEvents/townhalls

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der unterstützten abgeleiteten Typen des virtualEventTownhall-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine virtualEventTownhall erstellen.

Eigenschaft	Typ	Beschreibung
Publikum	meetingAudience	Das Publikum, für das das Rathaus sichtbar ist.
coOrganizers	communicationsUserIdentity-Sammlung	Die Identitätsinformationen der Mitorganisierer des Rathauses.
description	itemBody	Eine Beschreibung des Rathauses.
displayName	Zeichenfolge	Anzeigename des Rathauses.
endDateTime	dateTimeTimeZone	Datum und Uhrzeit des Endes des Rathauses.
invitedAttendees	Identitätssammlung	Die Identitäten der Ins Rathaus eingeladenen Teilnehmer. Die unterstützten Identitäten sind communicationsGuestIdentity und communicationsUserIdentity.
isInviteOnly	Boolesch	Gibt an, ob das Rathaus nur für eingeladene Personen und Gruppen innerhalb Ihres organization geöffnet ist. Die isInviteOnly-Eigenschaft kann nur sein true , wenn der Wert der Audience-Eigenschaft auf organizationfestgelegt ist.
startDateTime	dateTimeTimeZone	Das Datum und die Uhrzeit des Beginns des Rathauses.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein virtualEventTownhall-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls
Content-Type: application/json

{     
    "displayName": "The Impact of Tech on Our Lives",
    "description": "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" 
      }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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": "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": [],
    "isInviteOnly": false
}