Feedback Bearbeiten

meetingRegistrant erstellen

  • Artikel
  • 8 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Registrieren Sie einen Besprechungstermin in einer Onlinebesprechung, für die die Besprechungsregistrierung im Auftrag des Unternehmens aktiviert ist. Dieser Vorgang hat zwei Szenarien:

  • Wenn der Wert der allowedRegistrant-Eigenschaft des meetingRegistration-Objekts organization lautet, müssen sich die Teilnehmer anmelden, bevor sie sich für die Besprechung registrieren. "firstName", "lastName" und "email" müssen mit den in Azure Active Directory (Azure AD) gespeicherten Informationen übereinstimmen.
  • Wenn der Wert der allowedRegistrant-Eigenschaft des meetingRegistration-Objekts everyone lautet, müssen sich die Teilnehmer nicht anmelden und werden als anonym betrachtet.

In beiden Szenarien erhält der Antragsteller eine E-Mail-Benachrichtigung, die die Registrierungsinformationen enthält.

Berechtigungen

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

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetings.ReadWrite
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung OnlineMeetings.Read.All

Tipp

  • Wenn der Wert der allowedRegistrant-Eigenschaft des meetingRegistration-Objekts organization lautet, verwenden Sie die delegierte Berechtigung der Delegation für die Registrierung.
  • Wenn der Wert der allowedRegistrant-Eigenschaft des meetingRegistration-Objekts everyone lautet, verwenden Sie die delegierte Berechtigung der Delegation für die Registrierung.

HTTP-Anforderung

POST /users/{userId}/onlineMeetings/{id}/registration/registrants

Hinweis: userId ist die objectID des Besprechungsorganisators.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der bearbeitbaren Eigenschaften eines meetingRegistrant-Objekts an.

Wichtig

Sie müssen die @odata.type-Eigenschaft angeben, um den Typen des Objekts anzugeben. Weitere Informationen finden Sie im folgenden Beispiel.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein partielles meetingRegistrant-Objekt im Antworttext zurück.

Tipp

Der Antworttext enthält abhängig vom Wert von allowedRegistrant unterschiedliche Informationen.

  • Wenn der Wert der allowedRegistrant-Eigenschaft organization lautet, werden nur id und joinWebUrl im meetingRegistrant-Objekt zurückgegeben. Teilnehmer können die ID verwenden, um ihre Registrierung abzubrechen oder anWebUrl teilzunehmen, um an der Besprechung teilzunehmen.
  • Wenn der Wert der allowedRegistrant-Eigenschaft everyone lautet, wird ein leeres meetingRegistrant-Objekt zurückgegeben. Die Teilnehmer müssen die Links in der E-Mail verwenden, die sie erhalten, um die Registrierung abzubrechen oder an der Besprechung teilzunehmen.

Beispiele

Beispiel 1: Registrieren eines angemeldeten Teilnehmers

Das folgende Beispiel zeigt, wie Sie einen angemeldeten Teilnehmer mit der delegierten Berechtigung des Teilnehmers registrieren, wenn die Besprechung die Berechtigung "Registrant" auf " festgelegt organization hat.

Anforderung

POST https://graph.microsoft.com/beta/users/16664f75-11dc-4870-bec6-38c1aaa81431/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Frederick",
  "lastName": "Cormier",
  "email": "frederick.cormier@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "id": "gWWckDBR6UOI8_yzWCzeNw,6pAAiSU1bkGqzLnbHG_muA,bzLh6uR-5EGYsCvtvIvs6Q,E4jbleVFdE6BDf6ei3YBOA,KvXQzK4zfU-5LQj_ZLWgow,A7_SArco00S-Qr707l0vBA,UFakyZrk1K9vBacExW1muA",
  "registrationDateTime": null,
  "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MmE4Mzg1OTItYjg2Ni00ZmNmLWI5NjMtODNkZDJiMWNlNTVi%40thread.v2/0?context=%7b%22Tid%22%3a%22909c6581-5131-43e9-88f3-fcb3582cde37%22%2c%22Oid%22%3a%22dc17674c-81d9-4adb-bfb2-8f6a442e4622%22%2c%22prid%22%3a%22gWWckDBR6UOI8_yzWCzeNw%2c6pAAiSa1bkGqzLnbHG_muA%2cbzLh6uR-5EGdsCvtvIvs6Q%2cE4jbleVFdE6BDf6ei3YBOA%2cKvXQzK4zfU-5LQj_ZLWgow%2cA7_SArco00S-Qr707l0vBA%2cUFaiyZrk1K9vBacExW1muA%22%2c%22isPublic%22%3afalse%7d",
  "firstName": null,
  "lastName": null,
  "email": null,
  "status": null,
  "customQuestionAnswers": []
}

Beispiel 2: Registrieren eines anonymen Teilnehmers

Das folgende Beispiel zeigt, wie sie einen anonymen Kasten mit Anwendungsberechtigung registrieren, wenn die Besprechung die Berechtigung "Registrant" auf " festgelegt everyone hat.

Anforderung

POST https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Lisa",
  "lastName": "Adkins",
  "email": "lisa.adkins@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
    "@odata.type": "#microsoft.graph.meetingRegistrant",
    "id": "",
    "registrationDateTime": null,
    "joinWebUrl": "",
    "firstName": null,
    "lastName": null,
    "email": null,
    "status": null,
    "customQuestionAnswers": []
}