Google классрум


Google Classroom - онлайн класс для эффективного обучения

Сейчас все чаще разные пользовательские активности «уходят» в глобальную паутину. Например, намного эффективнее хранить фотографии и документы онлайн в облачном хранилище, куда вы имеете доступ с любого компьютера и которыми можете делиться с другими пользователями. При работе или обучении люди также стараются использовать современные технологии, что помогает лучше справляться со своими задачами. Помнится, во время моего обучения, создавались групповые почтовые рассылки, куда преподаватели или одногруппники присылали важные документы. Сейчас, конечно, есть и более продвинутые инструменты, например Google Classroom он же Google Класс.

Недавно компания Google сообщила о полноценном запуске сервиса «Класс» для преподавателей по всему миру. Он был анонсирован где-то в мае этого года как пилотный проект. Для ознакомления с Классом зарегистрировалось около 100 тысяч учителей (из порядка 45 стран). Сейчас это полноценный сервис, который доступен для всех желающих. Он входит в число бесплатных сервисов Google Apps для образования. При этом интегрирован с другими сервисами: «Диск», YouTube, «Документы» и Gmail.

Фактически Google Класс позволяет преподавателям организовать стандартный учебный процесс через интернет:

  • Можно создавать классы обучения и добавлять в них учеников.
  • Можно отправлять задания ученикам, организовывать тематические обсуждения с учениками.
  • Ученик получает задание через сервис, выполняет его онлайн в Google Документах и прикрепляет свою работу к заданию.
  • Все документы сохраняется в структурированном виде в каталогах на Google Диске, вы можете не беспокоиться о том, что забыли работу дома и т.п.
  • Список выполненных работ в реальном времени обновляется в панели преподавателя – он может проверить работу, поставить соответствующую оценку и написать комментарий.
  • Есть функция для организации индивидуальных занятий.

Вот как это работает.

Сервис позволяет учителям не только давать задания, но рассылать объявления или создавать тематические обсуждения. У учеников есть возможность отвечать на вопросы преподавателей и обмениваться материалами с другими учащимися. Все это экономит уйму времени и ликвидирует бумажную волокиту.

Конечно, такой подход актуален для стран и школ, где современные технологии очень активно используются в учебном процессе. У нас, думаю, это организовать получится не скоро. На сайте сервиса есть еще одно интересное видео с отзывами учителей о Google Classroom.

Сервис постоянно улучшается и дорабатывается, в процессе тестирования было собрано немало отзывов и предложений от преподавателей. Например, изначально учителя не могли общаться с учащимися, пока они не сдадут задание – после этого была реализована возможность коммуникации уже в процессе выполнения работы. Учителя также просили создать особый раздел для публикации дополнительных материалов к курсам.

В настоящее время Google Класс доступен на 42 языках (русский также поддерживается). Интерфейс оптимизирован для корректной работы на мобильных устройствах, включая популярные электронные книги. Определенно за таким форматом обучения будущее.

www.web2me.ru

Authorizing Requests  |  Classroom API  |  Google Developers

Every request your application sends to the Classroom API must include an authorization token. The token also identifies your application to Google.

About authorization protocols

Your application must use OAuth 2.0 to authorize requests. No other authorization protocols are supported. If your application uses Google Sign-In, some aspects of authorization are handled for you.

Authorizing requests with OAuth 2.0

All requests to the Classroom API must be authorized by an authenticated user.

The details of the authorization process, or "flow," for OAuth 2.0 vary somewhat depending on what kind of application you're writing. The following general process applies to all application types:

  1. When you create your application, you register it using the Google API Console. Google then provides information you'll need later, such as a client ID and a client secret.
  2. Activate the Classroom API in the Google API Console. (If the API isn't listed in the API Console, then skip this step.)
  3. When your application needs access to user data, it asks Google for a particular scope of access.
  4. Google displays a consent screen to the user, asking them to authorize your application to request some of their data.
  5. If the user approves, then Google gives your application a short-lived access token.
  6. Your application requests user data, attaching the access token to the request.
  7. If Google determines that your request and the token are valid, it returns the requested data.

Some flows include additional steps, such as using refresh tokens to acquire new access tokens. For detailed information about flows for various types of applications, see Google's OAuth 2.0 documentation.

Here's the OAuth 2.0 scope information for the Classroom API:

Scope Meaning Additional Scopes - If needed, request these in addition to one or more of the scopes above
https://www.googleapis.com/auth/classroom.courses View, create, and delete Classroom courses
https://www.googleapis.com/auth/classroom.courses.readonly View Classroom courses
https://www.googleapis.com/auth/classroom.rosters View class rosters, add and invite people to classes, remove people from classes
https://www.googleapis.com/auth/classroom.rosters.readonly View class rosters
https://www.googleapis.com/auth/classroom.coursework.me View and modify assignments and questions and the work and grades for the current user.
https://www.googleapis.com/auth/classroom.coursework.me.readonly View assignments and questions and the work and grades for the current user.
https://www.googleapis.com/auth/classroom.coursework.students View and modify assignments and questions and the work and grades for the courses that the current user teaches and view the same for the courses the current user administers.
https://www.googleapis.com/auth/classroom.coursework.students.readonly View assignments and questions and the work and grades for the courses that the current user teaches or administers.
https://www.googleapis.com/auth/classroom.announcements View and modify announcements for the current user.
https://www.googleapis.com/auth/classroom.announcements.readonly View announcements for the current user.
https://www.googleapis.com/auth/classroom.guardianlinks.students View and manage guardians for students in your Google Classroom classes
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly View guardians for students in your Google Classroom classes
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly View your Google Classroom guardians
https://www.googleapis.com/auth/classroom.push-notifications Register for push notifications of Classroom activity.
https://www.googleapis.com/auth/classroom.profile.photos View user profile photos visible to the authenticated user
https://www.googleapis.com/auth/classroom.profile.emails View user email addresses visible to the authenticated user

To request access using OAuth 2.0, your application needs the scope information, as well as information that Google supplies when you register your application (such as the client ID and the client secret).

Tip: The Google APIs client libraries can handle some of the authorization process for you. They are available for a variety of programming languages; check the page with libraries and samples for more details.

developers.google.com

Google Classroom Branding Guidelines  |  Classroom API  |  Google Developers

This document outlines how to use the Google Classroom name, logo and icon. If you have any additional questions, please refer to the more general Google brand permissions.

Icon use guidelines

When you are integrating with Classroom, always use the Classroom icon (as opposed to the Google logo.) Make sure the Google Classroom icon is fully and clearly visible. You can use the icon with or without the accompanying text "Google Classroom". If you are using the Classroom icon along with other logos, make sure each has proper spacing for readability.

Sizes

The Classroom icon is available in a number of different sizes, from 32 to 96 pixels. You can scale the icon for different devices and screen sizes but must preserve the aspect ratio so the logo isn’t stretched.

Square Logo

Download square logos

Round Logo

Download round logos

Describing Classroom

When using the Classroom icon, you can include either the full name "Google Classroom" or the short version "Classroom".

Example buttons:

Example padding:

When talking about Classroom classes, use one of these phrases (note that "classes" is not capitalized):

  • Google Classroom classes (example: "Choose from your Google Classroom classes")
  • Classroom classes (example: "Choose from your Classroom classes")
  • Invite via Google Classroom
  • Share with Google Classroom
  • Share to Google Classroom

Do not use the following phrases:

  • Google Classrooms
  • Google classes
  • Google Classes
  • Google Class
  • Invite Google Classroom

Describing your own product or application

If your product is compatible with Google Classroom, make reference to Google Classroom by using the text "for", "for use with", or "compatible with", and be sure to include the ™ symbol with the Google trademark. Example: "for Google Classroom™"

If you are making reference to a Google trademark in combination with your logo, the referencing text should be smaller in size than your logo.

Note: Do not use Google trademarks or a modified version of a Google trademark as the logo for your application without written permission from Google.

Using screenshots

For illustrative or informative purposes, you may use standard, unaltered screenshots of Google services. For further details, check out the general Google Brand Permissions.

Giving proper attribution

Do give proper attribution to Google for any use of their marks in your application title or in your description. Example: Google Classroom is a trademark of Google Inc. Use of this trademark is subject to Google Brand Permissions.

Font

Use Roboto Bold, a TrueType font.

To install, download Roboto font and unzip the download bundle.

  • On Mac, double-click Roboto-Bold.ttf, then click "Install Font".
  • On Windows, drag the file to "My Computer" > "Windows" > "Fonts" folder.

Colors

  • Classic icon
    • The green color of the Google Classroom icon is #25A667
    • The yellow color of the Google Classroom icon is #F6BB18
    • The white color of the Google Classroom icon is #FFFFFF
    • The green secondary color of left and right person in Google Classroom icon is #57BB8A
  • Dark icon
    • The black color of the Google Classroom icon is #000000
    • The white color of the Google Classroom icon is #FFFFFF
    • The grey secondary color of left and right person in Google Classroom icon is #57BB8A
  • Light icon
    • The green color of the Google Classroom icon is #25A667
    • The yellow color of the Google Classroom icon is #F6BB18
    • The green secondary color of left and right person in Google Classroom icon is #57BB8A

Hover state

On hover the icon should be shaded with 20% black.

Incorrect logo design

  • Don’t use colors other than the two specified for the icon.
  • Don’t use a Google icon to represent Google Classroom.
  • Don’t create your own icon for the button.
  • Don’t use the term "Google" by itself in the button without a Google Classroom icon.
  • Examples of incorrect Google Classroom button designs:

Never use the colored Google logo in the button. Always include the Google Classroom icon on the left of the button. Do not change the font of the button.

developers.google.com

Google Classroom API  |  Classroom API  |  Google Developers

Manages classes, rosters, and invitations in Google Classroom.

Service: classroom.googleapis.com

All URIs below are relative to https://classroom.googleapis.com

This service provides the following discovery document:

Methods
create POST /v1/courses Creates a course.
delete DELETE /v1/courses/{id} Deletes a course.
get GET /v1/courses/{id} Returns a course.
list GET /v1/courses Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request.
patch PATCH /v1/courses/{id} Updates one or more fields in a course.
update PUT /v1/courses/{id} Updates a course.
Methods
create POST /v1/courses/{courseId}/aliases Creates an alias for a course.
delete DELETE /v1/courses/{courseId}/aliases/{alias} Deletes an alias of a course.
list GET /v1/courses/{courseId}/aliases Returns a list of aliases for a course.
Methods
create POST /v1/courses/{courseId}/announcements Creates an announcement.
delete DELETE /v1/courses/{courseId}/announcements/{id} Deletes an announcement.
get GET /v1/courses/{courseId}/announcements/{id} Returns an announcement.
list GET /v1/courses/{courseId}/announcements Returns a list of announcements that the requester is permitted to view.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees Modifies assignee mode and options of an announcement.
patch PATCH /v1/courses/{courseId}/announcements/{id} Updates one or more fields of an announcement.
Methods
create POST /v1/courses/{courseId}/courseWork Creates course work.
delete DELETE /v1/courses/{courseId}/courseWork/{id} Deletes a course work.
get GET /v1/courses/{courseId}/courseWork/{id} Returns course work.
list GET /v1/courses/{courseId}/courseWork Returns a list of course work that the requester is permitted to view.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees Modifies assignee mode and options of a coursework.
patch PATCH /v1/courses/{courseId}/courseWork/{id} Updates one or more fields of a course work.
Methods
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id} Returns a student submission.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions Returns a list of student submissions that the requester is permitted to view, factoring in the OAuth scopes of the request.
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments Modifies attachments of student submission.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id} Updates one or more fields of a student submission.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim Reclaims a student submission on behalf of the student that owns it.
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return Returns a student submission.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn Turns in a student submission.
Methods
create POST /v1/courses/{courseId}/students Adds a user as a student of a course.
delete DELETE /v1/courses/{courseId}/students/{userId} Deletes a student of a course.
get GET /v1/courses/{courseId}/students/{userId} Returns a student of a course.
list GET /v1/courses/{courseId}/students Returns a list of students of this course that the requester is permitted to view.
Methods
create POST /v1/courses/{courseId}/teachers Creates a teacher of a course.
delete DELETE /v1/courses/{courseId}/teachers/{userId} Deletes a teacher of a course.
get GET /v1/courses/{courseId}/teachers/{userId} Returns a teacher of a course.
list GET /v1/courses/{courseId}/teachers Returns a list of teachers of this course that the requester is permitted to view.
Methods
accept POST /v1/invitations/{id}:accept Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course.
create POST /v1/invitations Creates an invitation.
delete DELETE /v1/invitations/{id} Deletes an invitation.
get GET /v1/invitations/{id} Returns an invitation.
list GET /v1/invitations Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request.
Methods
create POST /v1/registrations Creates a Registration, causing Classroom to start sending notifications from the provided feed to the provided destination.
delete DELETE /v1/registrations/{registrationId} Deletes a Registration, causing Classroom to stop sending notifications for that Registration.
Methods
get GET /v1/userProfiles/{userId} Returns a user profile.
Methods
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations Creates a guardian invitation, and sends an email to the guardian asking them to confirm that they are the student's guardian.
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId} Returns a specific guardian invitation.
list GET /v1/userProfiles/{studentId}/guardianInvitations Returns a list of guardian invitations that the requesting user is permitted to view, filtered by the parameters provided.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId} Modifies a guardian invitation.
Methods
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId} Deletes a guardian.
get GET /v1/userProfiles/{studentId}/guardians/{guardianId} Returns a specific guardian.
list GET /v1/userProfiles/{studentId}/guardians Returns a list of guardians that the requesting user is permitted to view, restricted to those that match the request.

developers.google.com

Overview  |  Classroom API  |  Google Developers

The Classroom API provides a RESTful interface for you to manage courses and rosters in Google Classroom. Additionally, the Classroom share button allows developers and content owners to enable sharing their content to Classroom.

Who can use the API?

G Suite for Education domain administrators can use the API to programmatically provision courses on behalf of teachers, sync student information systems with Classroom, and get basic visibility into classes being taught in their domain.

Application developers can use the Classroom API to integrate their apps with Classroom. These apps need to use OAuth 2.0 to request permission to view classes and rosters from teachers. Admins can restrict whether teachers and students in their domain can authorize apps to access their Google Classroom data.

Website owners and content developers can use the Classroom share button to let students and teachers share content back to Classroom.

All API and Classroom share button integrations should follow the Classroom brand guidelines.

API overview

The Classroom API consists of several entity types that correspond to classes, teachers, and students in the Classroom interface. Some of these entities have additional properties specific to the API in addition to what exists in Classroom. The primary entity types are:

For detailed information on the API's resources and methods, refer to the Classroom API reference.

Course metadata and aliases

Courses represent a class, such as "M. Smith's 4th period math," and its assigned teachers, student roster, and metadata. Each course is identified by a unique ID assigned by the server. The Course resource specifically encapsulates all of the metadata about the course, such as the name, description, location, and time. Course rosters are managed through the Student, Teacher, and Invitation resources and their methods.

Aliases are alternate identifiers for a class that may be associated with a course and used in place of the unique ID. Each alias exists in a namespace that restricts who can create and view it. Two namespaces are supported:

  • Domain: The domain namespace is useful for creating aliases that all users need access to, but that are not specific to any one program. For example, alternate listings for a course, such as MATH 127 and COMSCI 127, should be created in the domain namespace. Aliases in the domain namespace may only be created by domain administrators but are visible to all users in a domain.
  • Developer project: The developer project namespace is useful for managing aliases specific to an application. For example, an application that uses alternate identifiers for courses can create aliases to map its identifier to Classroom courses. Aliases created in this namespace are tied to a specific Google API Console. Any user of an application can create and view aliases in the namespace for that application's developer project.

For more information about managing course metadata and aliases, see Manage Courses.

Course rosters and users

Students and Teachers are specific mappings between a user profile and a course, representing that user's role in the course. Designations of student and teacher are not global: a user can be assigned as a teacher for one course and a student in another. The designation "student" or "teacher" represents a set of permissions for a particular user in a particular course.

Students A Student resource represents a user who is enrolled as a student in a specific course. Students are permitted to view the course details and teachers for that course. Teachers A Teacher resource represents a user who teaches a specific course. Teachers are permitted to view and change the course details, view teachers and students, and manage additional teachers and students.

Invitations and their associated methods provide a convenient way of adding students and teachers to courses. Creating invitations allows users to choose whether or not to join a course, rather than you directly adding them through the teacher and student resources.

UserProfiles represent a mappping to a user's domain profile as identified by the unique ID or email address of the user returned by the Google Admin SDK. The current user may also refer to their own ID using the "me" shorthand.

For more information on managing rosters, see Manage Teachers and Students.

Coursework and student submissions

A CourseWork item represents a single task assigned to a group of students in a course. It contains details such as the description, due date, and materials as well as metadata such as creation time. Materials include a title, thumbnail, and URL, as well as an identifier that can be used with the appropriate APIs (i.e. Drive, YouTube).

CourseWork items describe one of the following types of tasks:

  • An assignment that students complete by submitting worksheets or other attachments.
  • A short answer question or multiple choice question.

Student work for a CourseWork item is represented by a StudentSubmission. It consists of a response and additional metadata such as a state and assigned grade.

The contents of a StudentSubmission depend on the type of the corresponding CourseWork item:

  • The worksheets and attachments submitted for an assignment, including their title, thumbnail, and URL, as well as identifiers that can be used with the appropriate APIs such as Drive or YouTube.
  • The response to a short answer question or multiple choice question.

For more information on managing coursework and student submissions, see Manage CourseWork.

Get started

To set up your environment and get started right away with the API, try one of the quickstarts:

You can also explore the API reference.

developers.google.com

Manage Coursework  |  Classroom API  |  Google Developers

You can manage coursework distributed to students using the CourseWork resource, and completed assignments using the StudentSubmission resource. The following sections describe these in more detail.

Manage assignments and questions

A Coursework resource describes an assignment or question that has been assigned to the students in a course, including any additional materials, and can optionally specify a due date and a max score.

Create assignments

You can create an assignment for a teacher in one of their courses, as shown in the following example:

Python

courseWork = { 'title': 'Ant colonies', 'description': 'Read the article about ant colonies and complete the quiz.', 'materials': [ {'link': { 'url': 'http://example.com/ant-colonies' }}, {'link': { 'url': 'http://example.com/ant-quiz' }} ], 'workType': 'ASSIGNMENT', 'state': 'PUBLISHED', } courseWork = service.courses().courseWork().create( courseId='<course ID or alias>', body=courseWork).execute() print('Assignment created with ID {0}'.format(courseWork.get('id')))

The result includes a server-assigned identifier that can be used to reference the assignment.

The title and workType fields are required. All other fields are optional. If state is unspecified, a draft assignment will be created.

To include linked materials in an assignment created via the Classroom API, use a Link resource, specifying the target URL. Classroom automatically fetches the title and thumbnail image. The Classroom API also natively supports Drive and YouTube materials, which can included with a DriveFile resource or YouTubeVideo resource in a similar way.

To specify a due date, set the dueDate and dueTime fields to the corresponding UTC time. The due date must be in the future.

Retrieve assignments and questions

You can retrieve assignments and questions for students and teachers of the corresponding course or by a domain administrator. To retrieve a specific assignment or question, use courses.courseWork.get. To retrieve all assignments or questions (optionally matching some criteria), use courses.courseWork.list.

If you're only interested in some fields, consider limiting your requests to those fields. This can significantly speed up your requests. See working with partial resources for more details.

The required scope depends on the role that the requesting user has in the course. If the user is a student, use one of the following scopes:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

If the user is a teacher or a domain administrator, use one of the following scopes:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

Having permission to retrieve an assignment or question does not imply permissions to access materials or material metadata. In practice, this means that an administrator may not see the title of an attached Drive file if they're not a member of the course. If you want to allow administrators access to user files, see the domain-wide delegation guide.

Manage student responses

A StudentSubmission resource represents the work done and grade of a student for an assignment or question. A StudentSubmission resource is implicitly created for each student when a new question or assignment is created.

Student submissions may only be modified by the Developer Console project that created the corresponding CourseWork resource. This is in addition to checking that the requesting user has the correct permissions. Modifications may be made by any OAuth3 client in that project; the associatedWithDeveloper field indicates if the current OAuth3 client can modify a given StudentSubmission.

The following sections explain common actions that manage student responses.

Retrieve student responses

Students can retrieve their own submissions, teachers can retrieve submissions for all students in their courses, and domain administrators can retrieve all submissions for all students in their domain. Each student submission is assigned an identifier; if you know the identifier, use courses.courseWork.studentSubmissions.get to retrieve it.

Use courses.courseWork.studentSubmissions.list to get StudentSubmission that match some criteria, as shown in the following sample:

Python

studentSubmissions = service.courses().courseWork().studentSubmissions().list( courseId=<course ID or alias>, courseWorkId=<assignment ID>).execute()

Retrieve student submissions that belong to a particular student by specifying the userId parameter, as shown in the following sample:

Python

service.courses().courseWork().studentSubmissions().list( courseId=<course ID or alias>, courseWorkId=<assignment ID>, userId=<user ID>).execute()

Students are identified by the unique ID or email address of the user, as returned by the Google Admin SDK. The current user may also refer to their own ID using the "me" shorthand.

It's also possible to get student submissions for all assignments within a course. To do so, use the literal "-" as the courseWorkId, as shown in the following sample:

Python

service.courses().courseWork().studentSubmissions().list( courseId=<course ID or alias>, courseWorkId='-', userId=<user ID>).execute() If you're only interested in some fields, consider limiting your requests to those fields. This can significantly speed up your requests. See Working with partial resources for more details.

The required scope depends on the role that the requesting user has in the course. Use the following scope if the user is a teacher or a domain administrator:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

Use the following scope if the user is a student:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

Having permission to retrieve a student submission does not imply permissions to access attachments or attachment metadata. In practice, this means that an administrator may not see the title of an attached Drive file if they're not a member of the course. If you want to allow administrators access to user files, see the domain-wide delegation guide.

Adding attachments to a student response

You can attach links to a student submission by attaching a Link, DriveFile, or YouTubeVideo resource. This is done with courses.courseWork.studentSubmissions.modifyAttachments, as shown in the following sample:

Python

request = { 'addAttachments': [ {'link': { 'url': 'http://example.com/quiz-results' }}, {'link': { 'url': 'http://example.com/quiz-reading' }} ] } service.courses().courseWork().studentSubmissions().modifyAttachments( courseId=<course ID or alias>, courseWorkId=<assignment ID>, id=<studentSubmission ID>, body=request).execute()

A Link attachment is defined by the target URL; Classroom will automatically fetch the title and thumbnail image. You can learn about the other materials at their respective reference pages.

Materials can be created by a course teacher or by the student that owns the corresponding student submission, but only for student submissions with a courseWorkType of "ASSIGNMENT".

The required scope depends on the role that the requesting user has in the course. Use the following scope if the user is a teacher:

  • https://www.googleapis.com/auth/classroom.coursework.students

Use the following scope if the user is a student:

  • https://www.googleapis.com/auth/classroom.coursework.me

Grade student responses

The StudentSubmission resource has two fields to store grades: assignedGrade, which is the grade reported to students, and draftGrade, which is a tentative grade visible only to teachers. These fields are updated using courses.courseWork.studentSubmissions.patch with a field mask containing the appropriate fields, as shown in the following sample.

Python

studentSubmission = { 'assignedGrade': 99, 'draftGrade': 80 } service.courses().courseWork().studentSubmissions().patch( courseId=<course ID or alias>, courseWorkId=<courseWork ID>, id=<studentSubmission ID>, updateMask='assignedGrade,draftGrade', body=studentSubmission).execute()

Students don't see the draftGrade value, but only the final assignedGrade. Setting assignedGrade is the most direct way to grade student work. However, it's better to use draftGrade when teachers are going to manually review and return student work from within Classroom; the draftGrade value will be copied to assignedGrade when the teacher manually returns the student submission.

Manage student response state

A student response may be unsubmitted, turned in, or returned. The state field in StudentSubmission indicates the current state. To change the state, call one of the following methods:

All of these methods take an empty body. Example:

Python

service.courses().courseWork().studentSubmission().turnIn( courseId=<course ID or alias>, courseWorkId=<courseWork ID>, id=<studentSubmission ID>, body={}).execute()

The student that owns a StudentSubmission may turn it in or reclaim it. Only a turned in submission may be reclaimed. Course teachers can return a StudentSubmission that is in the turned in state.

This does not change the value of assignedGrade or draftGrade. To display a grade to the student, see the Grade student work section.

developers.google.com

Новые возможности Google Classroom к 1 сентября

В Google Classroom появилась масса новых возможностей к началу учебного года.

Каждое лето, компания Google специально готовит пакет обновлений для Google Classroom, для того чтобы было удобнее начать их использовать с началом нового учебного года. Соответственно, администраторы доменов G Suite for Education и преподаватели, использующие Google Classroom в своей работе, получили хорошую традицию, посмотреть за пару недель до начала учебного года: "Что там нового в Google Classroom?" и успеть по экспериментировать и настроить новые возможности применительно к своему учебному процессу.

Краткий перечень новых возможностей в Google Classroom с лета 2017 года:

1. Персональная страница ученика

Теперь все задачи, работы и оценки, выполненные, невыполненные, оценённые или нет, которые были назначены ученику любыми преподавателями в рамках любых классов, можно увидеть на индивидуальной странице ученика. Такая страница генерируется и постоянно обновляется Google Classroom  автоматически, с тем чтобы на ней были самые последние сведения о прогрессе в учёбе данного ученика. 

Эта страница доступна, как самому ученику, а также преподавателям и родителям, что значительно упрощает процесс получения актуальной общей картины прогресса в обучении по конкретному ученику.

2. Индивидуальная настройка расположения классов

Если раньше после создания класса в общем списке его положение было изменить нельзя, то теперь преподаватель может расположить свои классы в любом порядке, как ему удобно, что по идее должно улучшить восприятие общей картины и облегчить ориентацию во множестве классов.

3. Дробные оценки

В большинстве случаев, в учебных заведениях применяется оценивание на основе целых баллов из 5, 10, 20, 40 и 100 баллов и Google Classroom позволял работать с любыми системами оценивания на основе целых баллов до сих пор.

Тем не менее, в некоторых странах, например в России, приняты образовательные стандарты, которые требуют нормирования итоговой оценки к определённому максимальному баллу, например к пяти баллам, что не позволяет применять оценивание в целых баллах, когда есть необходимость разделить близкие, но тем не менее качественно отличные результаты.

В таких случаях, например в некоторых учебных заведениях Москвы, применяются шкалы для оценивания с дробными баллами, например: 1, 2, 2.5, 3, 3.5, 4, 4.5, 5.

Теперь Google Classroom позволяет проставлять оценки с дробной частью, что позволит использовать практически любые стандарты оценивания (кроме относительных) в учебных заведениях. При этом, сводная статистика успеваемости, которую вы, при желании, можете вывести из Google Classroom, будет содержать уже правильно нормированные баллы.

4. Передача классов между преподавателями

Если ранее вы хотели передать класс от одного преподавателя другому, то вы могли только назначить несколько преподавателей на один класс, что неправильно, если владелец класса прекращал свою работу и его аккаунт в домене блокировался. Удаление и создание класса заново также не являлось выходом, так приводило к потере всех данных по прогрессу учеников в таком классе.

Теперь администратор или владелец класса могут просто передать класс другому преподавателю, с сохранением всей истории по данному классу.

5. Миграция классов с помощью Google School Directory Sync

Если вы ранее пользовались другими информационными системами для обучения (SIS), типа Moodle и т.п., но хотите перейти на Google Classroom без потери данных о классах и учениках, то теперь Google добавил в своё специальное средство миграции образовательных систем поддержку стандарта IMS OneRoster v1.0.

Стандарт IMS OneRoster позволяет передать из любой поддерживающей его SIS в другую (в данном случае в Google Classroom) всю информацию об образовательном учреждениии, включая список всех преподавателей, учеников, родителей, классов и их взаимосвязи друг с другом.

Для использования Google School Directory Sync не требуется наличие Active Directory или какой-либо обширной серверной инфраструктуры. Данное ПО для миграции можно установить на любой ПК и просто запустить из командной строки, любо с помощью "мастера для чайников".

Помимо изменений в самом Google Classrom, которые описаны выше, экосистема продуктов, совместимых с Google Classroom, пополнилась множеством первоклассных приложений и возможностей, что также может оказаться крайне полезным для учебного процесса в новом году:

1. Оценки из Google Forms теперь можно передавать в Google Classroom автоматически

Никто не любит нудную работу по переносу одних и тех же данных из одной системы в другую, особенно, когда эти данные с одной стороны важные, а с другой стороны повторяющиеся, и очень легко ошибиться.

С нового учебного года вы сможете делать тесты в Google Forms и собирать оценки прямо в Google Classroom без дополнительной ручной работы.

2. Задачки Quizizz получили интеграцию с Google Classroom

Если вам не хватает функционала Google Forms для проведения опросов и тестов, то с помощью Quizizz вы, возможно, сможете добиться большего. Сама система бесплатна, поэтому её использование определяется лишь удобством для преподавателей и учеников. С помощью интеграции с Google Classroom удобства, несомненно, станет больше.

3. Аннотация PDF совместно с Google Classroom

Много учебных материалов поставляется в виде файлов формата PDF, которые по техническим и/или лицензионным причинам не подразумевают возможность редактирования их содержимого. Тем не менее, возможность аннотирования с помощью свободных комментариев и рисунков поверх PDF признана многими преподавателями очень полезной функцией. Программа Kami (имеет бесплатные и платные тарифные планы), которая теперь интегрирована с Google Classroom, позволяет аннотировать любые PDF файлы на Google Drive, в том числе совместно с задачами Google Classroom, так что теперь этой функцией будет воспользоваться из Google Classroom намного проще.

4. Селфи в Google Classroom

Для тех учеников, кто пользуется Google Classroom с мобильных устройств, ввиду отсутствия обычных компьютеров, теперь появилась возможность менять своё фото профиля прямо из приложения на Android.

На случай появления возможных злоупотреблений со стороны учеников и фотографирования всяких непристойных вещей или просто лиц других одноклассников, вместо себя, считаю важным напомнить, что у администратора домена G Suite есть настройка для отключения возможности пользователям менять своё фото профиля. 

www.andreylavrov.com


Смотрите также