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