실시간 채팅의 운영자를 나열합니다. 요청은 실시간 채팅 채널의 소유자가 승인해야 합니다.
일반적인 사용 사례
요청
HTTP 요청
GET https://www.googleapis.com/youtube/v3/liveChat/moderators
매개변수
다음 표에는 이 쿼리에서 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.
| 매개변수 | ||
|---|---|---|
| 필수 매개변수 | ||
liveChatId |
stringliveChatId 매개변수는 API가 운영자를 반환해야 하는 YouTube 실시간 채팅을 지정합니다. 브로드캐스트와 연결된 실시간 채팅 ID는 liveBroadcast 리소스의 snippet.liveChatId 속성으로 반환됩니다. |
|
part |
stringpart 매개변수는 API 응답에 포함될 liveChatModerator 리소스 부분을 지정합니다. 지원되는 값은 id 및 snippet입니다. |
|
| 선택적 매개변수 | ||
maxResults |
unsigned integermaxResults 매개변수는 결과 집합에서 반환되어야 하는 최대 항목 수를 지정합니다. 허용되는 값은 0~50(포함)입니다. 기본값은 5입니다. |
|
pageToken |
stringpageToken 매개변수는 반환되어야 하는 결과 집합의 특정 페이지를 식별합니다. API 응답에서 nextPageToken 및 prevPageToken 속성은 검색할 수 있는 다른 페이지를 식별합니다. |
|
요청 본문
이 메소드를 호출할 때 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{
"kind": "youtube#liveChatModeratorListResponse",
"etag": etag,
"prevPageToken": string,
"nextPageToken": string,
"pageInfo": {
"totalResults": integer,
"resultsPerPage": integer
},
"items": [
liveChatModerator Resource
]
}속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
| 속성 | |
|---|---|
kind |
stringAPI 리소스의 유형을 식별합니다. 값은 youtube#liveChatModeratorListResponse입니다. |
etag |
etag이 리소스의 ETag입니다. |
prevPageToken |
string결과 집합의 이전 페이지를 검색하기 위해 pageToken 매개변수의 값으로 사용할 수 있는 토큰입니다. |
nextPageToken |
string결과 집합의 다음 페이지를 검색하기 위해 pageToken 매개변수의 값으로 사용할 수 있는 토큰입니다. |
pageInfo |
objectpageInfo 객체는 결과 집합의 페이징 정보를 캡슐화합니다. |
pageInfo.totalResults |
integer결과 집합의 총 결과 수입니다. |
pageInfo.resultsPerPage |
integerAPI 응답에 포함된 결과 수입니다. |
items[] |
list요청 기준과 일치하는 운영자 목록입니다. |
오류
API는 이 API 메서드에 고유한 오류 메시지를 정의하지 않습니다. 하지만 이 메서드는 오류 메시지 문서에 나열된 일반 API 오류를 반환할 수 있습니다.
기능을 사용해 보세요.
APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인하세요.