call-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.
Die Anrufressource wird erstellt, wenn ein eingehender Anruf für die Anwendung erfolgt, oder die Anwendung erstellt einen neuen ausgehenden Anruf über einen POST für app/calls.
Anrufe können als Peer-to-Peer-Anruf oder als Gruppenanruf eingerichtet werden. Geben Sie zum Erstellen oder Beitreten eines Gruppenanrufs chatInfo und meetingInfo an. Wenn diese nicht angegeben werden, wird automatisch ein neuer Gruppenaufruf erstellt. Zeichnen Sie diese Werte für einen eingehenden Anruf in einem hoch verfügbaren Speicher auf, damit die Anwendung dem Anruf erneut beitreten kann, falls sie abstürzt.
Obwohl dieselbe Identität nicht mehrmals eingeladen werden kann, ist es möglich, dass eine Anwendung mehrmals an derselben Besprechung teilnimmt. Jedes Mal, wenn die Anwendung eine Verbindung herstellen will, muss eine eigene Identität bereitgestellt werden, damit die Clients sie als unterschiedliche Teilnehmer anzeigen können.
Hinweis: In einer mit Microsoft Teams geplanten Besprechung können Sie die Teilnahme-URL erhalten. Extrahieren Sie die Daten aus der URL wie dargestellt, um
chatInfoundmeetingInfoaufzufüllen.
https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%224b444206-207c-42f8-92a6-e332b41c88a2%22%7d
Wird zu:
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"}
Hinweis
Die folgenden bekannten Probleme sind mit dieser Ressource verbunden:
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | call | Mit "Anruf erstellen" kann Ihr Bot einen neuen ausgehenden Peer-to-Peer- oder Gruppenanruf erstellen oder an einer vorhandenen Besprechung teilnehmen. |
| Get | call | Lesen der Eigenschaften des call-Objekts. |
| Löschen/Auflegen | Keine | Löschen oder Auflegen eines aktiven Anrufs. |
| Am Leben bleiben | Keine | Sicherstellen, dass der Anruf aktiv bleibt. |
| Anrufverarbeitung | ||
| Answer | Keine | Beantworten eines eingehenden Anrufs. |
| Reject | Keine | Ablehnen eines eingehenden Anrufs. |
| Redirect | Keine | Umleiten eines eingehenden Anrufs. |
| Transfer | Keine | Anruf weiterleiten |
| Gruppenanrufe | ||
| List | participant-Auflistung | Abrufen einer Auflistung von Teilnehmerobjekten. |
| Einladen von Teilnehmern | commsOperation | Einladen von Teilnehmern zum aktiven Anruf. |
| Alle Teilnehmer stummschalten | commsOperation | Stummschalten aller Teilnehmer in dem Anruf. |
| Teilnehmer stummschalten | muteParticipantOperation | Stummschalten eines Teilnehmers im Gruppenanruf. |
| Create | audioRoutingGroup | Erstellen Sie eine neue audioRoutingGroup, indem Sie sie an die audioRoutingGroups-Sammlung senden. |
| Auflisten von Audioroutinggruppen | audioRoutingGroup-Auflistung | Rufen Sie eine audioRoutingGroup-Objektsammlung ab. |
| Fügen Sie eine große Galerieansicht hinzu | addLargeGalleryViewOperation | Fügen Sie einem Anruf die große Galerieansicht hinzu. |
| Interactive-Voice-Response | ||
| Aufforderung wiedergeben | playPromptOperation | Wiedergabeaufforderung in dem Anruf. |
| Datensatzantwort | recordOperation | Zeichnet eine kurze Audioantwort vom Anrufer auf. |
| Medienverarbeitung abbrechen | commsOperation | Abbrechen der Medienverarbeitung. |
| Ton abonnieren | commsOperation | Abonnieren von DTMF-Tönen. |
| DTMF-Ton senden | commsOperation | Senden von DTMF-Tönen in einem Anruf. |
| Self Participant Operations | ||
| Anwendung stummschalten | muteParticipantOperation | Sich selbst stummschalten in dem Anruf. |
| Stummschaltung der Anwendung aufheben | unmuteParticipantOperation | Stummschaltung für sich selbst in dem Anruf aufheben. |
| Rolle „Bildschirmfreigabe“ ändern | Keine | Starten und Beenden der Bildschirmübertragung in dem Anruf. |
| Aufzeichnungsvorgänge | ||
| Aufzeichnungsstatus aktualisieren | updateRecordingStatusOperation | Aktualisiert den Aufzeichnungsstatus. |
| Protokollierungsvorgänge | ||
| Protokollieren von Daten zur Qualität des Telekonferenzgeräts | teleconferenceDeviceQuality | Zeichnet Qualitätsdaten von Videokonferenzgeräten auf. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| activeModalities | „modality“-Auflistung | Die Liste der aktiven Modalitäten. Mögliche Werte: unknown, audio, video, videoBasedScreenSharing, data. Schreibgeschützt. |
| answeredBy | participantInfo | Der Teilnehmer, der den Anruf angenommen hat. Schreibgeschützt. |
| callRoutes | callRoute-Auflistung | Die Routinginformationen, wie der Anruf umgeleitet wurde. Schreibgeschützt. |
| callbackUri | Zeichenfolge | Die Rückruf-URL, zu der Rückrufe zugestellt werden. Muss https sein. |
| callChainId | Zeichenfolge | Ein eindeutiger Bezeichner für alle Teilnehmer in einer Konferenz oder ein eindeutiger Bezeichner für zwei Teilnehmer in einem P2P-Anruf. Dieser muss aus Microsoft.Graph.Call.CallChainId kopiert werden. |
| callOptions | outgoingCallOptions | Enthält die optionalen Features für den Anruf. |
| chatInfo | chatInfo | Die Chatinformationen. Erforderliche Informationen für Besprechungs-Szenarien. |
| direction | callDirection | Die Richtung des Anrufs. Die möglichen Werte sind incoming oder outgoing. Schreibgeschützt. |
| id | Zeichenfolge | Die Anruf-ID. Schreibgeschützt. |
| incomingContext | incomingContext | Der Kontext, der einem eingehenden Anruf zugeordnet ist. Schreibgeschützt. Vom Server generiert. |
| mediaConfig | appHostedMediaConfig oder serviceHostedMediaConfig | Die Medienkonfiguration. Erforderliche Informationen für das Erstellen von Peer-to-Peer-Anrufen oder zum Beitreten zu Besprechungen. |
| mediaState | callMediaState | Schreibgeschützt. Der Aufruf des Medienstatus. |
| meetingCapability | meetingCapability | Enthält die Funktionen einer Besprechung. Schreibgeschützt. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo oder joinMeetingIdMeetingInfo | Die Besprechungsinformationen. Erforderliche Informationen für Besprechungs-Szenarien. |
| Transkription | callTranscriptionInfo | Die Transkriptionsinformationen für den Anruf. Schreibgeschützt. |
| myParticipantId | Zeichenfolge | Schreibgeschützt. |
| requestedModalities | „modality“-Auflistung | Die Liste der angeforderten Modalitäten. Mögliche Werte: unknown, audio, video, videoBasedScreenSharing, data. |
| resultInfo | resultInfo | Die Ergebnisinformationen. Das Ergebnis kann z. B. den Beendigungsgrund enthalten. Schreibgeschützt. |
| ringingTimeoutInSeconds | Int32 | Timeout in Sekunden für Rufzeichen für ausgehende Peer-to-Peer-Anrufe. Der maximale Wert für dieses Attribut ist 115 Sekunden. |
| routingPolicies | routingPolicy-Sammlung | Diese Eigenschaft gilt nur für Peer-to-Peer-Anrufe. Mögliche Werte sind: none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness und unknownFutureValue. |
| source | participantInfo | Ursprung des Anrufs. |
| state | callState | Der Anrufstatus. Mögliche Werte: incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating, terminated. Schreibgeschützt. |
| subject | Zeichenfolge | Der Betreff der Unterhaltung. |
| targets | Sammlung invitationParticipantInfo | Die Ziele des Anrufs. Erforderliche Informationen für das Erstellen von Peer-to-Peer-Anrufen. |
| tenantId | Zeichenfolge | Schreibgeschützt.
tenantIdin Microsoft Entra ID. |
| terminationReason | Zeichenfolge | Schreibgeschützt. |
| toneInfo | toneInfo | Schreibgeschützt. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| audioRoutingGroups | audioRoutingGroup-Auflistung | Schreibgeschützt. Lässt Nullwerte zu. |
| operations | commsOperation-Auflistung | Schreibgeschützt. Lässt Nullwerte zu. |
| participants | participant-Auflistung | Schreibgeschützt. Nullwerte zulassend. |
| contentSharingSessions | contentSharingSession-Sammlung | Schreibgeschützt. Nullwerte zulassend. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"activeModalities": ["String"],
"answeredBy": {"@odata.type": "#microsoft.graph.participantInfo"},
"callRoutes": [{"@odata.type": "#microsoft.graph.callRoute"}],
"callbackUri": "String",
"callChainId": "String",
"callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
"chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
"contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
"direction": "String",
"id": "String (identifier)",
"incomingContext": {"@odata.type": "#microsoft.graph.incomingContext"},
"mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
"mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
"meetingCapability": {"@odata.type": "#microsoft.graph.meetingCapability"},
"meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
"transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
"myParticipantId": "String",
"requestedModalities": ["String"],
"resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
"ringingTimeoutInSeconds": 99,
"routingPolicies": ["String"],
"source": {"@odata.type": "#microsoft.graph.participantInfo"},
"state": "String",
"subject": "String",
"targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
"tenantId": "String",
"terminationReason": "String",
"toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}