connect_m365_account

Microsoft 365 · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Verbindet ein Microsoft-365-Konto (oder fügt ein weiteres hinzu oder meldet eines erneut an). Der erste Aufruf gibt eine Vorschau zurück und startet nichts; confirm: true liefert einen Anmeldecode. Rufen Sie erneut auf, nachdem Sie sich bei microsoft.com/devicelogin authentifiziert haben, um die Verbindung abzuschließen. Übergeben Sie include_channel_messages: true, um auch Teams-Kanalnachrichten zu lesen und zu durchsuchen – diese Berechtigung benötigt einen Administrator Ihrer Microsoft-365-Organisation; ohne diese Genehmigung wird die Anmeldung abgelehnt und das Konto behält seinen aktuellen Zugriff.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "account_type": {
      "description": "\"work\" (default): a work or school Microsoft 365 account — mail, calendar, contacts, Teams. \"personal\": an Outlook.com / Hotmail / Live account — mail, calendar and contacts only (Microsoft has no Teams chats or directory for personal accounts, and asking for them makes Microsoft refuse the sign-in as an 'expired code'). Ask the person which one it is when unsure.",
      "enum": [
        "work",
        "personal"
      ],
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to start the sign-in. Without it the call returns a preview and does nothing.",
      "type": "boolean"
    },
    "include_channel_messages": {
      "description": "Also request access to Teams channel messages and message search. Needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für connect_m365_account. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false
}

Windows

Zweck

Verbindet ein Microsoft-365-Konto (oder fügt ein weiteres hinzu oder meldet eines erneut an). Der erste Aufruf gibt eine Vorschau zurück und startet nichts; confirm=true liefert einen Anmeldecode, rufen Sie dann erneut auf, nachdem Sie sich bei microsoft.com/devicelogin authentifiziert haben, um abzuschließen. Übergeben Sie include_channel_messages: true, um auch Teams-Kanalnachrichten zu lesen und zu durchsuchen – diese Berechtigung benötigt einen Administrator Ihrer Microsoft-365-Organisation; ohne diese Genehmigung wird die Anmeldung abgelehnt und das Konto behält seinen aktuellen Zugriff.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to start the sign-in. Without it, returns a preview.",
      "type": "boolean"
    },
    "include_channel_messages": {
      "description": "Also request access to Teams channel messages and message search. That permission needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

{
  "confirm": false
}