Öğrenciler ve öğretmenler, kullanıcı profili ile ders arasında yapılan belirli eşlemelerdir ve bu eşleştirmeler, ilgili kullanıcının kurstaki rolünü temsil eder. Öğrenci ve öğretmen atamaları genel değildir: Bir kullanıcı bir derste öğretmen, başka bir derste ise öğrenci olarak atanabilir. "Öğrenci" veya "öğretmen" ataması belirli bir kurstaki belirli bir kullanıcıya verilen izin grubunu temsil eder.
- Öğrenciler
- Öğrenci kaynağı, belirli bir kursa öğrenci olarak kaydolmuş kullanıcıları temsil eder. Öğrencilerin söz konusu kursla ilgili kurs ayrıntılarını ve öğretmenleri görüntülemesine izin verilir.
- Öğretmenler
- Öğretmen kaynağı, belirli bir dersi veren kullanıcıyı temsil eder. Öğretmenlerin kurs ayrıntılarını görüntülemesine ve değiştirmesine, öğretmen ve öğrencileri görüntülemesine, ek öğretmen ve öğrencileri yönetmesine izin verilir.
Öğrenciler ve öğretmenler, Directory API'nin döndürdüğü benzersiz kimliği veya e-posta adresiyle tanımlanır.
Geçerli kullanıcı, "me"
kısaltmasını kullanarak kendi kimliğine de başvurabilir.
Doğrudan ekleme
Alan yöneticilerinin davet akışını atlamasına ve alanlarındaki kullanıcıları, alanlarındaki derslere doğrudan öğretmen veya öğrenci olarak eklemesine izin verilir. Bir kurs, sahibi yöneticinin alanındaysa yöneticinin alanı dahilinde olduğu kabul edilir. Kimliği doğrulanmış bir alan yöneticisinin alanı dışındaki kullanıcılar veya kurslar için uygulamalar, invitations.create()
yöntemiyle bir davetiye göndererek kullanıcının iznini almalıdır.
Öğretmen ekleme veya kaldırma
Alan yöneticileri, aşağıdaki örnekte gösterildiği gibi, alanlarındaki öğretmenleri teachers.create()
ile doğrudan derslere ekleyebilir:
.NET
Java
PHP
Python
Kimliği doğrulanmış bir öğretmen adına başka öğretmenler ekliyorsanız invitations.create()
yöntemini kullanmanız gerekir.
Bir dersten ek öğretmenleri çıkarmak için teachers.delete()
yöntemini kullanabilirsiniz. Bu işlem yalnızca belirtilen öğretmeni dersten kaldırır ve öğrencinin diğer derslere atamasını veya kullanıcı profilini etkilemez.
Öğrencileri kaydettirme veya kaldırma
Alan yöneticileri, aşağıdaki örnekte gösterildiği gibi students.create()
yöntemini kullanarak alanları kendi içindeki öğrencileri doğrudan ekleyebilir:
.NET
Java
PHP
Python
Kimliği doğrulanmış bir öğretmen adına öğrenci ekliyorsanız invitations.create()
yöntemini kullanmanız gerekir.
Öğrencileri derslerden çıkarmak için students.delete()
yöntemini kullanabilirsiniz. Bu işlem yalnızca belirtilen öğrenciyi dersten kaldırır ve öğrencinin diğer kurslara kaydını ya da kullanıcı profilini etkilemez.
Bir kullanıcının kurslarını alma
Bir öğrenci veya öğretmen için ders listesi almak istiyorsanız courses.list()
numaralı telefonu arayın ve ilgili kullanıcının studentId
veya teacherId
değerlerini sağlayın.
Kullanıcı profilini alma
Bir kullanıcının kimliği ve adı dahil olmak üzere kısaltılmış profili almak için userProfiles.get()
numarasını kullanıcının kimliği, e-posta adresi veya istekte bulunan kullanıcının "ben" numarasıyla birlikte arayın.
emailAddress
alanını almak için classroom.profile.emails
kapsamını eklemeniz gerekir.
Döndürülen kimlik, eşleşen studentId
veya teacherId
öğesini içeren Directory API Kullanıcıları kaynağına karşılık gelir.
Ders sahiplerini yönetme
Alan yöneticileri, derslerin sahipliğini öğretmenler arasında aktarabilir. Önemli ayrıntılar için lütfen Ders sahipliğini aktarma bölümüne bakın.