Ressourcentyp Einladung

Namespace: microsoft.graph

Stellt eine Einladung dar, die verwendet wird, um einer Organisation externe Benutzer hinzuzufügen.

Der Einladungsprozess verwendet den folgenden Ablauf:

• Eine Einladung wird erstellt.
• Eine Einladung (mit einem Einladungs-Link) wird an den eingeladenen Benutzer gesendet.
• Der eingeladene Benutzer klickt auf den Einladungs-Link, meldet sich an und löst die Einladung und die Erstellung der Benutzerentität ein, die den eingeladenen Benutzer darstellt.
• Der Benutzer wird nach Abschluss der Einlösung zu einer bestimmten Seite umgeleitet.

Durch Erstellen einer Einladung wird eine URL für die Einlösung in der Antwort zurückgegeben (InviteRedeemUrl). Die API zum Erstellen der Einladung kann automatisch eine E-Mail mit der Einlösungs-URL an den eingeladenen Benutzer senden, indem sendInvitationMessage auf „true“ festgelegt wird. Sie können die Nachricht, die an den eingeladenen Benutzer gesendet wird, auch anpassen. Wenn Sie die Einlösungs-URL anderweitig versenden möchten, können Sie die sendInvitationMessage auf „false“ festlegen und die Einlösungs-URL aus der Antwort verwenden, um Ihre eigene Mitteilung zu erstellen. Derzeit gibt es keine API, die den Einlösungsprozess durchführt. Der eingeladene Benutzer muss auf den Link inviteRedeemUrl klicken, der in der Mitteilung im Schritt oben versendet wurde, und den interaktiven Einlösungsprozess in einem Browser durchführen. Nach Abschluss wird der eingeladene Benutzer ein externer Benutzer in der Organisation.

Methoden

Methode	Rückgabetyp	Beschreibung
Einladung erstellen	invitation	Dient zum Schreiben der Eigenschaften und der Beziehungen des Einladungsobjekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
invitedUserDisplayName	String	Der Anzeigename des eingeladenen Benutzers.
invitedUserEmailAddress	Zeichenfolge	Die E-Mail-Adresse des eingeladenen Benutzers. Erforderlich. Die folgenden Sonderzeichen sind in der E-Mail-Adresse nicht zulässig: Tilde (~) Ausrufezeichen (!) Nummernzeichen (#) Dollarzeichen ($) Prozentzeichen (%) Zirkumflex (^) Kaufmännisches Und-Zeichen (&) Sternchen (*) Runde Klammern (( )) Pluszeichen (+) Gleichheitszeichen (=) Klammern ([ ]) Geschweifte Klammern ({ }) Umgekehrter Schrägstrich (\) Schrägstrich (/) Pipe (\|) Semikolon (;) Doppelpunkt (:) Anführungszeichen (") Spitze Klammer (< >) Fragezeichen (?) Komma (,) Es gelten aber folgende Ausnahmen: Ein Punkt (.) oder ein Bindestrich (-) ist überall im Benutzernamen zulässig, außer am Anfang oder Ende des Namens. Ein Unterstrich (_) ist überall im Benutzernamen zulässig. Das gilt auch für den Anfang oder das Ende des Namens.
invitedUserMessageInfo	invitedUserMessageInfo	Zusätzliche Konfiguration für die an den eingeladenen Benutzer gesendete Nachricht, einschließlich des Anpassens des Nachrichtentexts, der Sprache und der Empfängerliste in CC.
sendInvitationMessage	Boolean	Gibt an, ob eine E-Mail an den eingeladenen Benutzer gesendet werden soll. Der Standardwert lautet false.
inviteRedirectUrl	Zeichenfolge	Die URL, zu der Benutzende weitergeleitet werden, nachdem die Einladung eingelöst wurde. Erforderlich.
inviteRedeemUrl	Zeichenfolge	Die URL, die Benutzer zur Einlösung einer Einladung verwenden können. Schreibgeschützt.
invitedUserType	Zeichenfolge	Der userType des eingeladenen Benutzers. Der Standardwert ist Guest. Wenn Sie der Unternehmensadministrator sind, können Sie jemanden als Member einladen.
status	String	Der Status der Einladung. Mögliche Werte sind: PendingAcceptance, Completed, InProgress, und Error.

Beziehungen

Beziehung	Typ	Beschreibung
invitedUser	Benutzer	Der Benutzer, der im Rahmen der Einladungserstellung erstellt wurde. Schreibgeschützt

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "invitedUserDisplayName": "string",
  "invitedUserEmailAddress": "string",
  "invitedUserMessageInfo": {"@odata.type": "microsoft.graph.invitedUserMessageInfo"},
  "sendInvitationMessage": false,
  "inviteRedirectUrl": "string",
  "inviteRedeemUrl": "string",
  "status": "string",
  "invitedUser": {"@odata.type": "microsoft.graph.user"},
  "invitedUserType": "string"
}