通話の削除

[アーティクル]
04/06/2022

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

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

アクセス許可

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

注: 呼び出しが作成されると、アクセス許可がチェックされます。この API を呼び出す際に、追加のアクセス許可のチェックは行なないます。 Calls.AccessMedia.All は、アプリホスト型メディアを使用する呼び出しでのみ必要です。

HTTP 要求

DELETE /app/calls/{id}
DELETE /communications/calls/{id}

注: /app パスは廃止されます。今後は、/communications パスを使用してください。

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。

要求本文

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

応答

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

例

要求

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

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


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Communications.Calls["{call-id}"]
    .Request()
    .DeleteAsync();

重要

Microsoft Graph SDK では、既定で v1.0 バージョンの API が使用され、ベータ版で使用できるすべての種類、プロパティ、API はサポートされていません。 SDK を使用してベータ API にアクセスする方法の詳細については、「Microsoft Graph SDK とベータ API を使用する」を参照してください。

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


const options = {
    authProvider,
};

const client = Client.init(options);

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

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896"]]];
[urlRequest setHTTPMethod:@"DELETE"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.communications().calls("57dab8b1-894c-409a-b240-bd8beae78896")
    .buildRequest()
    .delete();

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

callId := "call-id"
graphClient.Communications().CallsById(&callId).Delete()

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


Import-Module Microsoft.Graph.CloudCommunications

Remove-MgCommunicationCall -CallId $callId

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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	ピアツーピア呼び出しの他の参加者は、会話を離しました。
200	540000/560000	PSTN ユーザーが通話を終了しました。
408	8537	キープアライブタイムアウト、非アクティブな呼び出しをクリーンアップします。
408	1106	割り当てられた時間に通話の受け入れについて確認応答が受信されません。
408	10057	呼び出し先エンドポイントからのシグナリングが発生しなかから、通話がタイムアウトしました。
410	301005	メディア接続の失敗。
480	10037	呼び出し先エンドポイントが見つかりませんでした。
480	10076	呼び出し先に到達できません。
480	10134	呼び出しをルーティングしきれなかのため、呼び出しは拒否されました。
480	10199	プライベート通話がユーザーに対して無効になっている場合、通話は拒否されます。
500	1005	ボットのメディアに接続エラーが発生しました。ボットと Microsoft の間のメディア接続を確認してください。

通話の削除

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

通知 - 終了

通知 - 終了

通話終了理由コード

フィードバック