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