Call Connection - Get Participants

서비스:

Communication

API 버전:

2024-09-15

통화에서 참가자를 가져옵니다. 기록 및 전사 봇은 이 목록에서 생략됩니다.

GET {endpoint}/calling/callConnections/{callConnectionId}/participants?api-version=2024-09-15

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
callConnectionId	path	True	string	통화 연결 ID
endpoint	path	True	string url	Azure Communication 리소스의 엔드포인트입니다.
api-version	query	True	string	호출할 API의 버전입니다.

요청 헤더

Name	필수	형식	Description
Authorization	True	string	Azure Communication Services 사용자 액세스 토큰입니다.

응답

Name	형식	Description
200 OK	GetParticipantsResponse	참가자 가져오기 응답을 반환합니다.
Other Status Codes	CommunicationErrorResponse	오류

보안

Authorization

Azure Communication Services 사용자 액세스 토큰입니다.

형식: apiKey
In(다음 안에): header

예제

CallConnection_GetParticipants

샘플 요청

HTTP

GET https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c/participants?api-version=2024-09-15

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "identifier": {
        "kind": "communicationUser",
        "communicationUser": {
          "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
        }
      },
      "isMuted": true
    }
  ],
  "nextLink": "string"
}

정의

Name	Description
CallParticipant	통화 참가자입니다.
GetParticipantsResponse	통화 참가자를 가져오기 위한 응답 페이로드입니다.

CallParticipant

통화 참가자입니다.

Name	형식	Description
identifier	CommunicationIdentifierModel
isMuted	boolean	참가자 음소거됨
isOnHold	boolean	대기 중인 참가자입니다.

GetParticipantsResponse

통화 참가자를 가져오기 위한 응답 페이로드입니다.

Name	형식	Description
nextLink	string	참가자 목록 계속
value	CallParticipant[]	통화의 현재 참가자 목록입니다.