Просмотр, создание и изменение CourseWork в Classroom
Что я могу создать с помощью конечных точек CourseWork в Classroom API?
Конечные точки позволяют разработчикам просматривать и управлять работой в классе. В частности, вы можете выполнять следующие действия:
- Просмотр заданий и вопросов (совместно именуемых
CourseWork) для пользователя. - Создание, изменение и удаление
CourseWork. - Прикрепите материалы (файлы Диска, видео YouTube, ссылки) к
CourseWork. - Изменить статус отправленной студенту работы (например, «сдана», «возвращена», «забрана»).
- Установите оценку за сданное задание.
- Прикрепляйте материалы (файлы с Диска, видео на YouTube, ссылки) к работам учащихся.
Некоторые примеры использования CourseWork :
- Журналы успеваемости, SIS или системы отчетности могут синхронизировать задания и оценки из Classroom со своими приложениями, устраняя необходимость в ручном переносе данных.
- Учебные приложения могут создавать новые задания, которые отображаются в ленте курса. По мере завершения работы учащимися приложения могут сдавать её, выставлять оценки, прикреплять работы учащихся и сохранять их в соответствующих папках на Диске.
- Преподаватели могут создавать задания с дополнительными вложениями с вашего веб-сайта или приложения.
- Пользователи-студенты могут сдавать свои задания, содержащие ваши дополнительные вложения.
Какие разрешения необходимы моему приложению для создания или изменения заданий?
Как правило, приложение может изменять только созданную им работу. Другими словами, любые запросы API на изменение CourseWork должны использовать тот же идентификатор проекта Google Cloud, который был использован для создания CourseWork .
Для дополнений Google Класса есть исключение из этого правила. Проект Cloud может получать доступ к любому объявлению, заданию или материалу, к которым прикреплены хотя бы несколько дополнений, или изменять их. Проект Cloud также может сдать, отозвать или вернуть задание, к которому прикреплены хотя бы несколько дополнений.
Для запросов API также требуются корректные права доступа. Преподаватели могут просматривать задания, создавать задания, прикреплять ссылки к сданным работам и выставлять оценки. Студенты могут просматривать задания, прикреплять ссылки к записям о своих работах, а также сдавать и отзывать свои работы. Администраторы домена могут просматривать CourseWork , но не имеют прав на запись.
Какие типы материалов я могу прикрепить к заданию или материалам?
API поддерживает прикрепление файлов с Диска, видео YouTube и ссылок. Прикрепление собственных форм Google пока не поддерживается.
Знают ли конечные пользователи, что задания в 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, отличного от проекта надстройки Google Classroom, работать не может. Токены доступа, сгенерированные другим проектом Google Cloud, отклоняются API Classroom. Необходимо создать отдельный OAuth-клиент для проекта надстройки.
Пользовательский опыт
Наш логотип плохо помещается в небольшой квадрат. Какие варианты размера логотипов есть в заголовке iframe надстроек Classroom?
Заголовок iframe был разработан для поддержки только квадратного логотипа размером 32x32. Этот выбор был сделан в соответствии с формой фавикона, который компании используют на своих сайтах, и мы рекомендуем использовать тот же логотип в этом пространстве для обеспечения единообразия бренда.
Домены
Имеют ли все преподаватели и студенты в одном домене доступ к установленному дополнению?
Администраторы домена могут контролировать, какие преподаватели могут видеть установленное дополнение. Надстройки для класса доступны только пользователям с лицензией 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 отключен, учащиеся могут входить в Класс, используя свой адрес электронной почты. Идентификаторы представлены идентификатором пользователя и адресом электронной почты. Пользователь Google Workspace for Education может изменить свой адрес электронной почты, поэтому рекомендуется использовать идентификаторы пользователей в качестве первичных ключей при хранении информации о пользователях.
Должен ли администратор школы предварительно одобрить приложение, чтобы разрешить учащимся войти в него?
Администраторы домена должны добавить дополнение в список разрешенных , прежде чем его можно будет установить. При желании администраторы домена могут установить дополнение для всех пользователей домена или организационного подразделения.
Обратная связь и общие вопросы
Как я могу отправить запрос на добавление функций или сообщить о проблемах?
Вы можете отправлять, просматривать и голосовать за запросы функций в нашей публичной системе отслеживания ошибок .
Как узнать о появлении новых функций в Classroom API?
Обновления API публикуются в информационном бюллетене для разработчиков и в общедоступной системе отслеживания ошибок .
Я использую Classroom API. Как мне задать технические вопросы?
Задавайте свои вопросы на Stack Overflow с тегом google-classroom .