요청한 사용자가 볼 수 있고 요청과 일치하는 과정으로 제한된 과정의 목록을 반환합니다. 반환된 강의는 만든 시간순으로 정렬되며 가장 최근에 생성된 강의가 먼저 표시됩니다.
이 메서드는 다음 오류 코드를 반환합니다.
- 액세스 오류:
PERMISSION_DENIED
- 쿼리 인수 형식이 잘못된 경우
INVALID_ARGUMENT
입니다. - 쿼리 인수에 지정된 사용자가 없는 경우
NOT_FOUND
입니다.
HTTP 요청
GET https://classroom.googleapis.com/v1/courses
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
studentId |
반환된 과정을 지정된 식별자가 있는 학생이 있는 강의로 제한합니다. 식별자는 다음 중 하나일 수 있습니다.
|
teacherId |
반환된 과정을 지정된 식별자가 있는 교사가 있는 강의로 제한합니다. 식별자는 다음 중 하나일 수 있습니다.
|
courseStates[] |
반환된 과정을 지정된 상태 중 하나로 제한합니다. 기본값은 ACTIVE, ARCHIVED, PROVISIONED, DECLINED입니다. |
pageSize |
반환할 최대 항목 수입니다. 0 또는 지정되지 않은 값은 서버가 최댓값을 할당할 수 있음을 나타냅니다. 서버는 지정된 수보다 적은 수의 결과를 반환할 수도 있습니다. |
pageToken |
이전 그 외의 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
강의를 나열할 때의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"courses": [
{
object ( |
필드 | |
---|---|
courses[] |
목록 요청과 일치하는 강의입니다. |
nextPageToken |
반환할 다음 결과 페이지를 식별하는 토큰입니다. 비어 있으면 추가 결과가 없습니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
자세한 내용은 승인 가이드를 참조하세요.