Chat Thread - List Chat Participants
스레드의 참가자를 가져옵니다.
GET {endpoint}/chat/threads/{chatThreadId}/participants?api-version=2024-03-15-preview
GET {endpoint}/chat/threads/{chatThreadId}/participants?maxPageSize={maxPageSize}&skip={skip}&api-version=2024-03-15-preview
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
chat
|
path | True |
string |
참가자를 가져올 스레드 ID입니다. |
endpoint
|
path | True |
string |
Azure Communication 리소스의 엔드포인트입니다. |
api-version
|
query | True |
string |
호출할 API의 버전입니다. |
max
|
query |
integer int32 |
페이지당 반환할 최대 참가자 수입니다. |
|
skip
|
query |
integer int32 |
응답에서 지정된 위치까지 참가자를 건너뜁니다. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
Authorization | True |
string |
ACS(Azure Communication Services) 사용자 액세스 토큰입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
요청이 성공했습니다. 작업은 스레드의 참가자를 반환합니다. |
|
401 Unauthorized |
Communication |
권한이 없습니다. |
403 Forbidden |
Communication |
사용할 수 없습니다. |
429 Too Many Requests |
Communication |
요청이 너무 많습니다. |
Other Status Codes |
Communication |
서비스를 사용할 수 없습니다. |
보안
Authorization
ACS(Azure Communication Services) 사용자 액세스 토큰입니다.
Type:
apiKey
In:
header
예제
Get participants with pagination (max page size)
Sample Request
GET https://contoso.westus.communications.azure.com/chat/threads/19:f2167429acf6482880c6b7790a9086c1@thread.v2/participants?maxPageSize=2&api-version=2024-03-15-preview
Sample Response
{
"value": [
{
"communicationIdentifier": {
"rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_c94ff260-162d-46d6-94fd-e79f4d213715",
"communicationUser": {
"id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_c94ff260-162d-46d6-94fd-e79f4d213715"
}
},
"displayName": "Jane",
"shareHistoryTime": "2020-06-06T05:55:41Z"
},
{
"communicationIdentifier": {
"rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
"communicationUser": {
"id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
}
},
"displayName": "Alex",
"shareHistoryTime": "2020-06-06T05:55:41Z"
}
],
"nextLink": "https://contoso.westus.communications.azure.com/chat/threads/19:453dafb77b26481ea2e73bcada0324af@thread.v2/participants?skip=2&maxPageSize=2&api-version=2024-03-15-preview"
}
{
"error": {
"code": "Unauthorized",
"message": "Request is not authorized."
}
}
{
"error": {
"code": "Forbidden",
"message": "User is not allowed to perform specified action."
}
}
{
"error": {
"code": "TooManyRequests",
"message": "Rate limit exceeded."
}
}
{
"error": {
"code": "ServiceUnavailable",
"message": "The server is currently unable to handle the request."
}
}
정의
Name | Description |
---|---|
Chat |
채팅 스레드의 참가자입니다. |
Chat |
참가자의 컬렉션은 특정 스레드에 속합니다. |
ChatParticipant
채팅 스레드의 참가자입니다.
Name | 형식 | Description |
---|---|---|
communicationIdentifier |
Communication |
|
displayName |
string |
채팅 참가자의 표시 이름입니다. |
metadata |
object |
채팅 참가자에 대한 컨텍스트 메타데이터입니다. 메타데이터는 이름/값 쌍으로 구성됩니다. 모든 메타데이터 쌍의 총 크기는 최대 1KB일 수 있습니다. |
shareHistoryTime |
string |
채팅 기록이 참가자와 공유되는 시간입니다. 타임스탬프는 RFC3339 형식 |
ChatParticipantsCollection
참가자의 컬렉션은 특정 스레드에 속합니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
검색할 수 있는 채팅 참가자가 더 많은 경우 다음 링크가 채워집니다. |
value |
채팅 참가자. |