Bu sayfada, eklenti web uygulamanız ile Google Classroom eklentileri API'si arasındaki temel etkileşimlere kısa bir genel bakış sunulmaktadır.
Ek Bulma iframe'i
Ek Discovery iframe'i, eklentinizdeki öğretmenlere yönelik açılış sayfasıdır. Bu görünümle ilgili olarak aşağıdaki işlemleri yapmanızı öneririz:
İçerik keşfetme veya oluşturma kullanıcı arayüzünüzü gösterin.
İsteğe bağlı olarak, öğretmenin etkinlik türü ekleri eklemesini önlemek isteyebilirsiniz. Böylece, akış öğesinin öğrenci yanıtlarını kabul edip etmeyeceğini belirleyebilirsiniz. Eklenti iframe'li açıldığında iletilen
itemType
sorgu parametresinin değerini kontrol edin. Öğrenci yanıtlarını yalnızcacourseWork
türü kabul eder.Öğretmen seçimlerine bağlı olarak, ödeve ek eklemek için bir veya daha fazla eklenti
create
isteğinde bulunun.
Diğer iframe'ler
Öğrenci Görünümü iframe'i, Öğrenci Çalışması İnceleme iframe'i ve Öğretmen Görünümü iframe'i, bir Classroom ödevini değiştirmek yerine kullanıcıya içerik sunmayı amaçlar. Bu görünümlerle ilgili olarak aşağıdaki işlemleri yapmanızı öneririz:
- Bir iFrame açıldığında kullanıcının OAuth iznini alıp rolünü ve ek kimliğini doğrulayın.
- Bir iFrame açıldığında, kullanıcı rolünü doğrulamak için
itemType
temelinde bircourseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
veyaannouncements.GetAddOnContextRequest
oluşturun. - Geçerli kullanıcı öğrenciyse yanıttaki
submissionId
öğesini öğrenci çalışmasıyla ilişkilendirin. Bu, not verme aracında notları geri vermek ve öğrenci çalışmalarını öğretmenlere göstermek için gereklidir.submissionIds
, görünümlerde eşleşir. attachmentId
, eklenti tarafından zaten biliniyorsa uygun ek kullanıcı arayüzünü gösterin.- Aksi takdirde, bu ekin üst gönderisinin başka bir yayından veya dersten kopyalanmış olması gerekir. Eklentinin bildiği en yeni kopyayı belirlemek için
copyHistory
kullanın ve eklenti tarafında ekin karşılık gelen yeni bir modelini oluşturmak için ayarları kopyalayın. Ardından, uygun ek kullanıcı arayüzünü gösterin.