virtualEvent-Ressourcentyp

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.

Stellt einen abstrakten Basistyp für ein virtuelles Ereignis dar. Basistyp von virtualEventTownhall und virtualEventWebinar.

Erbt von entity.

Tipp

Dies ist ein abstrakter Typ, der nicht direkt verwendet werden kann. Verwenden Sie stattdessen die abgeleiteten Typen virtualEventTownhall oder virtualEventWebinar .

Methoden

Methode Rückgabetyp Beschreibung
Festlegen externer Ereignisinformationen Keine Verknüpfen Sie externe Ereignisinformationen mit einem virtualEventTownhall oder virtualEventWebinar , indem Sie eine externalEventId festlegen. ]

Eigenschaften

Eigenschaft Typ Beschreibung
Kapazität Integer Stellt die erwartete Anzahl von Teilnehmern für Rathäuser dar.
createdBy communicationsIdentitySet Die Identitätsinformationen für den Ersteller des virtuellen Ereignisses. Geerbt von virtualEvent.
description itemBody Eine Beschreibung des virtuellen Ereignisses.
displayName Zeichenfolge Der Anzeigename des virtuellen Ereignisses.
endDateTime dateTimeTimeZone Die Endzeit des virtuellen Ereignisses. Die timeZone-Eigenschaftkann auf jede der Zeitzonen festgelegt werden, die derzeit von Windows unterstützt werden. Ausführliche Informationen zum Abrufen aller verfügbaren Zeitzonen mithilfe von PowerShell finden Sie unter Get-TimeZone.
externalEventInformation virtualEventExternalInformation-Auflistung Die externen Informationen eines virtuellen Ereignisses. Wird nur für Eventorganisatoren oder Co-Organisatoren zurückgegeben; nullandernfalls .
id Zeichenfolge Der eindeutige Bezeichner des virtuellen Ereignisses. Geerbt von entity.
isRegistrationRequired Boolean Gibt an, ob die Teilnehmerregistrierung für das virtuelle Ereignis aktiviert ist.
settings virtualEventSettings Die Einstellungen für virtuelle Ereignisse.
startDateTime dateTimeTimeZone Startzeit des virtuellen Ereignisses. Die timeZone-Eigenschaftkann auf jede der Zeitzonen festgelegt werden, die derzeit von Windows unterstützt werden. Ausführliche Informationen zum Abrufen aller verfügbaren Zeitzonen mithilfe von PowerShell finden Sie unter Get-TimeZone.
status virtualEventStatus Die status des virtuellen Ereignisses. Mögliche Werte sind: draft, published, canceled, unknownFutureValue.

Hinweis

Hinweis: Die isRegistrationRequired -Eigenschaft steuert, ob das virtuelle Ereignis den Registrierungsworkflow verwendet. Wenn isRegistrationRequired auf false festgelegt ist, können registrierungsbezogene APIs weiterhin aufgerufen werden. Diese Aufrufe lösen jedoch nicht die vollständige Registrierung aus. Stattdessen verhalten sie sich wie eine Add-to-Calendar-Aktion, sodass Teilnehmer das Ereignis ihrem Kalender hinzufügen können, ohne einen Registrierungsprozess abzuschließen. Für Webinare ist die Registrierung standardmäßig aktiviert (isRegistrationRequired = true). Für Rathäuser ist die Registrierung standardmäßig nicht aktiviert. Wenn eine Registrierung für ein Rathaus erforderlich ist, muss der Organisator beim Konfigurieren des virtuellen Ereignisses explizit auf TRUE festlegen isRegistrationRequired .

Dadurch wird sichergestellt, dass registrierungsbezogene APIs den vollständigen Registrierungsworkflow und die Teilnehmerregistrierung aufrufen.

virtualEventStatus-Werte

Wert Beschreibung
Entwurf Das virtuelle Ereignis befindet sich im Entwurf und ist nur für den Organisator sichtbar.
Veröffentlicht Der Organisator hat das virtuelle Ereignis veröffentlicht und ist für die Zielgruppe sichtbar.
Abgebrochen Der Organisator hat das virtuelle Ereignis abgesagt.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Beziehung Typ Beschreibung
Moderatoren virtualEventPresenter-Sammlung Die Referenten für virtuelle Ereignisse.
Sitzungen virtualEventSession-Sammlung Die Sitzungen für das virtuelle Ereignis.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.virtualEvent",
  "capacity": "Integer",
  "createdBy": {"@odata.type": "microsoft.graph.communicationsIdentitySet"},
  "description": {"@odata.type": "microsoft.graph.itemBody"},
  "displayName": "String",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "externalEventInformation" : [{"@odata.type": "microsoft.graph.virtualEventExternalInformation"}],
  "id": "String (identifier)",
  "isRegistrationRequired": "Boolean",
  "settings": {"@odata.type": "microsoft.graph.virtualEventSettings"},
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "String"
}
  • Last updated on