呼び出しを削除する

[アーティクル]
10/30/2023

名前空間: microsoft.graph

アクティブな通話を削除またはハングアップします。グループ呼び出しの場合は、通話区間のみが削除され、基になるグループ呼び出しは引き続き続行されます。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、アクセス許可のリファレンスを参照してください。

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	サポートされていません。	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	Calls.Initiate.All	Calls.AccessMedia.All

HTTP 要求

DELETE /communications/calls/{id}

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と承認の詳細については、こちらをご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文では何も返されません。

例

要求

次の例は要求を示しています。

DELETE https://graph.microsoft.com/v1.0/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Communications.Calls["{call-id}"].DeleteAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc communications calls delete --call-id {call-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.Communications().Calls().ByCallId("call-id").Delete(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.communications().calls().byCallId("{call-id}").delete();


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896')
	.delete();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->communications()->calls()->byCallId('call-id')->delete()->wait();


Import-Module Microsoft.Graph.CloudCommunications

Remove-MgCommunicationCall -CallId $callId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


await graph_client.communications.calls.by_call_id('call-id').delete()

応答

HTTP/1.1 204 No Content

通知 - 終了

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "updated",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminating"
      }
    }
  ]
}

通知 - 終了しました

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "deleted",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminated",
        "resultInfo": {
          "@odata.type": "#microsoft.graph.resultInfo",
          "code": "200",
          "subcode": "5001",
          "message": "The conversation has ended."
        }
      }
    }
  ]
}

通話終了理由コード

これらは、呼び出しが終了したときに通知によって受信される一般的なエラーコードの一部です。

コード	サブコード	終了の理由
200	4097	通話の他の参加者によって終了された呼び出し。
200	4521	ピアツーピア呼び出しで他の参加者によって終了された呼び出し。
200	5000	別の参加者による会話から削除されました。
200	5001	会話は終了しました。
200	5002	他のすべての参加者が通話を終了すると、会話は終了しました。
200	5003	会話は終了しました。
200	5007	グループ呼び出しのイニシエーターが会話を終了すると、会話は終了しました。
200	5010	会話は、1 人の参加者だけが会話に残ったので終了しました。
200	5012	着信名簿に参加者がいないため、会話は終了しました。
200	5013	他のユーザーがグループ呼び出しに参加していないので、会話は終了しました。
200	5014	グループ呼び出しの潜在的なホストを特定できなかったため、会話は終了しました。
200	5020	着信名簿に非表示でない参加者がいないため、会話は終了しました。
200	5030	ブレークアウトルームの期間が経過すると、会話は終了しました。
200	5300	別の参加者によって会話から参加者が削除されました。
200	5855	ロビーで待機している参加者は、ロビーの非アクティブタイムアウト後に会話から削除されました。
200	7000	会話はボットによって終了しました。
200	7015	転送が正常に完了すると、通話は終了しました。
200	10550	会話はボットによって終了しました。
200	18503	ピアツーピア呼び出しのもう 1 人の参加者は、会話を終了しました。
200	540000/560000	PSTN ユーザーが通話を終了しました。
408	8537	キープアライブタイムアウト。非アクティブな呼び出しをクリーンアップしました。
408	1106	割り当てられた時間内に、通話の受け入れに対する受信確認が受信されませんでした。
408	10057	呼び出し先エンドポイントからのシグナリングがないため、通話がタイムアウトしました。
410	301005	メディア接続エラー。
480	10037	呼び出し先エンドポイントが見つかりませんでした。
480	10076	呼び出し先に到達できませんでした。
480	10134	呼び出しをルーティングできないため、呼び出しが拒否されました。
480	10199	プライベート呼び出しがユーザーに対して無効になっているので、拒否された呼び出し。
500	1005	Bot のメディアでサーバーで接続エラーが発生しました。 Bot と Microsoft の間のメディア接続を確認します。