次の方法で共有

呼び出しを削除する

  • [アーティクル]

名前空間: microsoft.graph

重要

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

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

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

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

アクセス許可

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

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) サポートされていません。 サポートされていません。
委任 (個人用 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

応答

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

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 の間のメディア接続を確認します。