名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
 
呼び出しの文字起こしを停止します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 
米国政府機関 L4 | 
米国政府機関 L5 (DOD) | 
21Vianet が運営する中国 | 
| ✅ | 
✅ | 
✅ | 
❌ | 
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 
              アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 
最小特権アクセス許可 | 
より高い特権のアクセス許可 | 
| 委任 (職場または学校のアカウント) | 
サポートされていません。 | 
サポートされていません。 | 
| 委任 (個人用 Microsoft アカウント) | 
サポートされていません。 | 
サポートされていません。 | 
| アプリケーション | 
Calls.JoinGroupCall.All | 
注意事項なし。 | 
HTTP 要求
POST /communications/calls/{id}/microsoft.graph.StopTranscription
| 名前 | 
説明 | 
| Authorization | 
ベアラー {token}。 必須です。 
              認証と認可についての詳細をご覧ください。 | 
| Content-type | 
application/json. 必須です。 | 
要求本文
要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。
| パラメーター | 
型 | 
説明 | 
| language | 
文字列 | 
文字起こしの言語。 現在サポート中: en-us。 | 
応答
このメソッドは、 202 Accepted 応答コードと、この要求用に作成された stopTranscriptionOperation オブジェクトを返します。
例
次の例は、この API を呼び出す方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StopTranscription
Content-Type: application/json
Content-Length: 56
{
  "language": "en-us"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Communications.Calls.Item.StopTranscription;
var requestBody = new StopTranscriptionPostRequestBody
{
	Language = "en-us",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Communications.Calls["{call-id}"].StopTranscription.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphcommunications "github.com/microsoftgraph/msgraph-beta-sdk-go/communications"
	  //other-imports
)
requestBody := graphcommunications.NewStopTranscriptionPostRequestBody()
language := "en-us"
requestBody.SetLanguage(&language) 
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
stopTranscription, err := graphClient.Communications().Calls().ByCallId("call-id").StopTranscription().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.communications.calls.item.stoptranscription.StopTranscriptionPostRequestBody stopTranscriptionPostRequestBody = new com.microsoft.graph.beta.communications.calls.item.stoptranscription.StopTranscriptionPostRequestBody();
stopTranscriptionPostRequestBody.setLanguage("en-us");
var result = graphClient.communications().calls().byCallId("{call-id}").stopTranscription().post(stopTranscriptionPostRequestBody);
const options = {
	authProvider,
};
const client = Client.init(options);
const stopTranscriptionOperation = {
  language: 'en-us'
};
await client.api('/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StopTranscription')
	.version('beta')
	.post(stopTranscriptionOperation);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Communications\Calls\Item\StopTranscription\StopTranscriptionPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new StopTranscriptionPostRequestBody();
$requestBody->setLanguage('en-us');
$result = $graphServiceClient->communications()->calls()->byCallId('call-id')->stopTranscription()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.communications.calls.item.stop_transcription.stop_transcription_post_request_body import StopTranscriptionPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = StopTranscriptionPostRequestBody(
	language = "en-us",
)
result = await graph_client.communications.calls.by_call_id('call-id').stop_transcription.post(request_body)
 
応答
次の例は応答を示しています。
              注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/operations/2d7ab59c-f8bd-4911-8302-6d58ab60e338
{
  "@odata.type": "#microsoft.graph.stopTranscriptionOperation",
  "clientContext": "clientContext-value",
  "status": "completed"
}