Просмотр, создание и изменение учебных материалов в режиме онлайн-обучения.
Что я могу создать с помощью конечных точек CourseWork в Classroom API?
Эти конечные точки позволяют разработчикам просматривать и управлять работой в классе. В частности, вы можете делать все следующее:
- Просмотр заданий и вопросов (в совокупности именуемых
CourseWork») для пользователя. - Создавайте, изменяйте и удаляйте записи в
CourseWork. - Прикрепите материалы (файлы с Google Диска, видео с YouTube, ссылки) к
CourseWork. - Изменить статус работы студента (например, сдана, возвращена, запрошена).
- Выставьте оценку за сданное задание.
- Прикрепляйте к работам студентов дополнительные материалы (файлы на Google Диске, видеоролики на YouTube, ссылки).
Несколько примеров использования CourseWork :
- Журналы оценок, информационные системы для учащихся или системы отчетности могут синхронизировать задания и оценки из Classroom со своими приложениями, исключая ручной перенос данных.
- Учебные приложения могут создавать новые задания, которые отображаются в ленте класса. По мере выполнения заданий студентами приложения могут отправлять работы, выставлять оценки, прикреплять работы студентов и сохранять их в соответствующих папках Google Диска.
- Преподаватели могут создавать задания с дополнительными вложениями с вашего веб-сайта или приложения.
- Студенты могут сдавать задания, к которым прикреплены ваши дополнительные файлы.
Какие права доступа необходимы моему приложению для создания или изменения заданий?
Как правило, приложение может изменять только созданную им работу. Другими словами, любые запросы API для изменения CourseWork должны использовать тот же идентификатор проекта Google Cloud, который использовался при создании CourseWork .
Надстройки Google Classroom имеют исключение из этого правила. Облачный проект может получить доступ к любому объявлению, заданию или материалу, к которому прикреплено одно или несколько таких надстроек, или изменить их. Облачный проект также может сдать, запросить или вернуть задание, к которому прикреплено одно или несколько таких надстроек.
Для запросов к API также требуются соответствующие права доступа пользователей. Преподаватели могут просматривать задания, создавать задания, прикреплять ссылки к отправленным работам и устанавливать оценки за выполненные работы. Студенты могут просматривать задания, прикреплять ссылки к своим записям о заданиях, а также отправлять и запрашивать свои работы. Администраторы домена могут просматривать CourseWork , но не имеют прав на запись.
Какие виды материалов может приложить моя заявка к заданию или к представленным работам?
API поддерживает прикрепление файлов Google Диска, видео с YouTube и ссылок. Прикрепление стандартных форм Google Forms пока не поддерживается.
Знают ли конечные пользователи, что задание в Classroom было создано моим приложением?
Да. Пользовательский интерфейс Classroom идентифицирует задания, созданные извне, используя название продукта проекта Google Cloud, в котором была создана работа. Пользователи могут сообщать о таких работах как о нежелательных, а также отключать приложение, создавшее работу, путем отзыва учетных данных, выданных приложению пользователем.
Кнопка «Поделиться в классе» и другие интеграции.
Я уже интегрировал функцию «Поделиться» с Classroom. Могу ли я изменить задание, созданное с помощью этой кнопки?
Пока нет. Для изменения задания запрос должен использовать тот же проект Google Cloud, в котором было создано это задание.
Могу ли я отвечать на вопросы через API?
Пока нет. Вы можете создавать и изменять вопросы.
Дополнительные модули для учебных классов
Конфигурация проекта
Могу ли я преобразовать частный проект Google Cloud, который я использовал во время разработки, в публичный проект, который я смогу использовать в продакшене?
Нет, вы не можете преобразовать частный проект Google Cloud в публичный. Вам понадобятся два отдельных проекта: один для разработки, а другой для продакшена.
Может ли один проект Google Cloud иметь два объявления в Google Workspace Marketplace?
Нет. Вы не можете создать два объявления в Google Workspace Marketplace для одного проекта Google Cloud.
Однако, можно объединять дополнения в пакеты . Это позволяет одному объявлению в Google Workspace Marketplace представлять несколько дополнений. Установка из такого объявления установит все дополнения из пакета одновременно. Пользователям потребуется дать согласие на все необходимые права доступа для объединенных дополнений при авторизации.
Можно ли повторно использовать OAuth-клиент из другого проекта Google Cloud в проекте Google Cloud для дополнений Classroom?
Нет, клиент OAuth из проекта Google Cloud, отличного от проекта надстройки Classroom, работать не будет. Токены доступа, сгенерированные другим проектом Google Cloud, отклоняются API Classroom. Необходимо создать отдельный клиент OAuth для проекта надстройки.
пользовательский опыт
Наш логотип плохо помещается в маленьком квадрате. Какие размеры логотипов доступны в заголовке iframe-панели дополнений для класса?
Заголовок iframe был разработан для поддержки только квадратного логотипа размером 32x32 пикселя. Это решение было принято в соответствии с формой значка favicon, который компании используют на своих веб-сайтах, и мы рекомендуем использовать тот же логотип в этом пространстве для обеспечения единообразия бренда.
Домены
Все ли преподаватели и ученики в одном домене имеют доступ к установленному дополнению?
Администраторы домена могут контролировать, каким учителям будет доступен установленный надстройкой. Надстройки для учебных классов доступны только пользователям с лицензиями Teaching & Learning или Education Plus.
Как администраторы домена взаимодействуют с дополнениями?
Администраторы домена контролируют, кто может использовать ваше дополнение. Они могут установить дополнение для всего домена, используя опцию установки для администратора. Если ваше дополнение можно установить индивидуально, обратите внимание, что большинство администраторов ведут список разрешенных дополнений; преподаватели, включенные в этот список, могут устанавливать дополнения самостоятельно. Администратор также может установить ваше дополнение индивидуально для целей тестирования.
Администраторы также могут быть заинтересованы в статистике использования вашего дополнения. Если это поддерживается вашим продуктом, рассмотрите возможность предоставления статистики использования дополнения в административном интерфейсе на вашем собственном сайте.
API
Как можно надёжно определить, загружается ли контент дополнения внутри iframe или в новой вкладке?
В настоящее время не существует способа различить эти два явления.
Для каких заданий, которые можно назначить, предусмотрен iframe для обзора студенческой работы?
iframe «Обзор студенческих работ» предоставляется только для вложений типа «Действия». Вызовите метод courses.courseWork.getAddOnContext , чтобы узнать, поддерживает ли данный тип записи студенческие работы. Поле supportsStudentWork может иметь значение true только для типа записи, являющегося действием.
Может ли дополнительный модуль получить доступ к элементу потока, к которому он прикреплен?
Да. Вы можете get или patch любое Announcement , CourseWork или CourseWorkMaterial , содержащие хотя бы один из ваших дополнительных файлов. Вы можете reclaim , return или turnIn CourseWork StudentSubmission .
Единый вход
Могут ли учащиеся, использующие значки Clever или Classlink для входа в свои Chromebook, использовать вход через Google?
Да, они по-прежнему могут использовать вход через Google.
Есть ли у каждого студента правильно оформленный адрес электронной почты, даже если у него нет доступа к Gmail?
Каждый пользователь Google Workspace for Education имеет свою учетную запись Google, независимо от того, имеет ли он доступ к Gmail. Учетная запись и доступ к любой конкретной службе Google (включая Gmail) являются отдельными. Даже если Gmail отключен, учащиеся могут войти в Classroom, используя свой адрес электронной почты. Учетные записи представлены идентификатором пользователя и адресом электронной почты. Пользователь Google Workspace for Education может изменить свой адрес электронной почты, поэтому рекомендуется использовать идентификаторы пользователей в качестве первичных ключей при хранении информации о пользователях.
Нужно ли школьному администратору предварительно одобрять приложение, чтобы разрешить ученикам входить в систему?
Администраторы домена должны добавить надстройку в список разрешенных пользователей, прежде чем она сможет быть установлена. При желании администраторы домена могут установить надстройку для всех пользователей в домене или организационном подразделении.
Отзывы и общие вопросы
Как я могу отправлять запросы на добавление новых функций или запросы на исправление ошибок?
Вы можете отправлять, просматривать и голосовать за запросы на добавление новых функций в нашем общедоступном трекере проблем .
Как узнать о появлении новых функций в Classroom API?
Обновления API публикуются в рассылке для разработчиков и в общедоступной системе отслеживания ошибок .
Я использую Classroom API. Как я могу задать технические вопросы?
Задавайте свои вопросы на Stack Overflow, используя тег google-classroom .