Type de ressource Call
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
La ressource d’appel est créée lorsqu’il y a un appel entrant pour l’application ou que l’application crée un nouvel appel sortant via un POST sur app/calls.
Les appels peuvent être configurés en tant qu'appel de réseau pair à pair ou en tant qu'appel de groupe. Pour créer ou rejoindre un appel de groupe, fournissez le chatInfo et meetingInfo. Si elles ne sont pas fournies, un nouvel appel de groupe est créé automatiquement. Pour un appel entrant, enregistrez ces valeurs dans une mémoire facilement accessible, de sorte que votre application puisse reprendre l'appel en cas de panne de votre application.
Bien que la même identité ne puisse pas être invitée plusieurs fois, il est possible pour une application de rejoindre la même réunion plusieurs fois. Chaque fois que l’application souhaite participer, une identité distincte doit être fournie pour que les clients l’affiche en tant qu’autre participant.
Remarque : vous pouvez obtenir l’URL de participation d’un appel de réunion planifiée avec Microsoft Teams. Extraire les données de l’URL comme indiqué pour compléter
chatInfoetmeetingInfo.
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
Devient :
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"}
Remarque
Les problèmes connus suivants sont associés à cette ressource :
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Créer | Appel | Créer un appel permet à votre bot de créer un nouvel appel d’égal à égal ou de groupe sortant, ou de rejoindre une réunion existante. |
| Obtenir | call | Lire les propriétés de l’objet call. |
| Supprimer/raccrocher | Aucun | Supprimer ou raccrocher un appel en cours. |
| Garder en vie | Aucun | Veillez à ce que l’appel reste actif. |
| Call Handling | ||
| Answer | Aucun | Répondre à un appel entrant. |
| Reject | Aucun | Rejeter un appel entrant. |
| Redirect | Aucun | Rediriger un appel entrant. |
| Transfer | Aucun | Transférer un appel |
| Appels de groupe | ||
| List | Liste de participants | Récupérer une collection d’objets participant. |
| Inviter les participants | commsOperation | Inviter des participants à l’appel en cours. |
| Désactiver le son pour tous les participants | commsOperation | Désactivez le son de tous les participants dans l’appel. |
| Désactiver le son des Participants | muteParticipantOperation | Désactiver le son d’un participant lors de l’appel de groupe. |
| Create | audioRoutingGroup | Créer un nouveau groupe audioRoutingGroup en postant dans la collection audioRoutingGroups. |
| Répertorier les groupes de routage audio | CollectionaudioRoutingGroup | Récupérer une collection d’objet audioRoutingGroup. |
| Ajouter une vue de galerie volumineuse | addLargeGalleryViewOperation | Ajoutez la vue de la grande galerie à un appel. |
| Interactive-Voice-Response | ||
| Lire une invitation | playPromptOperation | Lire l’invite dans l’appel. |
| Enregistrer la réponse | recordOperation | Enregistre une courte réponse audio de l’appelant. |
| Annuler le traitement multimédia | commsOperation | Annuler le traitement du média. |
| S’abonner à la tonalité | commsOperation | Abonnement aux tonalités DTMF. |
| Envoyer la tonalité DTMF | commsOperation | Envoyer des tonalités DTMF dans un appel. |
| Self Participant Operations | ||
| Désactiver le son de l’application | muteParticipantOperation | Désactivez le son pour soi-même dans l’appel. |
| Activer l’application | unmuteParticipantOperation | Réactivez le son pour soi-même dans l’appel. |
| Changer de rôle partage écran | Aucun | Démarrer et arrêter le partage d’écran dans l’appel. |
| Opérations d’enregistrement | ||
| Mettre à jour les status d’enregistrement | updateRecordingStatusOperation | Met à jour le statut de l’enregistrement. |
| Opérations de journalisation | ||
| Journaliser les données de qualité des appareils de téléconférence | teleconferenceDeviceQuality | Enregistrez les données de qualité d’un appareil de téléconférence vidéo. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| activeModalities | collection de modalités | Liste des modalités actives. Les valeurs possibles sont les suivantes : unknown, audio, video, videoBasedScreenSharing, data. En lecture seule. |
| answeredBy | participantInfo | Le participant qui répond à l’appel. En lecture seule. |
| callRoutes | callRoute collection de sites | Les informations de routage sur la manière dont l’appel a été reciblé. En lecture seule. |
| callbackUri | String | L’URL de rappel vers laquelle les rappels seront remis. Doit être https. |
| callChainId | Chaîne | Identificateur unique de tous les appels de participants dans une conférence ou un identificateur unique pour deux appels de participants dans un appel P2P. Il doit être copié depuis Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Contient les fonctionnalités facultatives de l’appel. |
| chatInfo | chatInfo | Informations de chat. Informations requises pour les scénarios de réunion. |
| direction | callDirection | Direction de l’appel. Les valeurs possibles sont incoming ou outgoing. En lecture seule. |
| id | String | ID de l’appel. En lecture seule. |
| incomingContext | incomingContext | Le contexte associé à un appel entrant. Lecture seule. Généré par le server. |
| mediaConfig | appHostedMediaConfig ou serviceHostedMediaConfig | Configuration du média. Informations requises pour la création d’appels d’égal à égal ou pour la participation à des réunions. |
| mediaState | callMediaState | En lecture seule. État du support d’appel. |
| meetingCapability | meetingCapability | Contient les fonctionnalités d’une réunion. En lecture seule. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo, ou joinMeetingIdMeetingInfo | Informations de réunion. Informations requises pour les scénarios de réunion. |
| transcription | callTranscriptionInfo | Informations de la transcription pour l’appel. En lecture seule. |
| myParticipantId | Chaîne | En lecture seule. |
| requestedModalities | collection de modalités | Liste des modalités demandées. Les valeurs possibles sont les suivantes : unknown, audio, video, videoBasedScreenSharing, data. |
| resultInfo | resultInfo | Informations résultat. Par exemple, le résultat peut contenir la raison de l’arrêt. En lecture seule. |
| ringingTimeoutInSeconds | Int32 | Délai d’expiration en attente en secondes pour les appels d’égal à égal sortants. La valeur maximale pour cet attribut est de 115 secondes. |
| routingPolicies | collection routingPolicy | Cette propriété est applicable pour les appels d’égal à égal uniquement. Les valeurs possibles sont : none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness, unknownFutureValue. |
| source | participantInfo | L’émetteur de l’appel. |
| état | callState | État de l'appel. Les valeurs possibles sont les suivantes : incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating et terminated. En lecture seule. |
| subject | Chaîne | Objet de la conversation. |
| cibles | Collection invitationParticipantInfo | Cibles de l’appel. Informations requises pour la création d’appels d’égal à égal. |
| tenantId | Chaîne | En lecture seule.
tenantIddans Microsoft Entra ID. |
| terminationReason | Chaîne | En lecture seule. |
| toneInfo | toneInfo | En lecture seule. |
Relations
| Relation | Type | Description |
|---|---|---|
| audioRoutingGroups | CollectionaudioRoutingGroup | En lecture seule. Peut avoir la valeur Null. |
| operations | Collecte commsOperation | En lecture seule. Pouvant accepter la valeur Null. |
| participants | Liste de participants | En lecture seule. Pouvant accepter la valeur Null. |
| contentSharingSessions | collection contentSharingSession | En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"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"}
}