Method: courses.students.create

Bir kullanıcıyı dersin öğrencisi olarak ekler.

Alan yöneticilerinin kendi alanlarındaki kullanıcıları kendi alanlarındaki derslere öğrenci olarak doğrudan eklemesine izin verilir. Öğrencilerin kayıt kodu kullanarak kendilerini derse eklemelerine izin verilir.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • İstekte bulunan kullanıcının bu derste öğrenci oluşturmasına izin verilmiyorsa veya erişim hataları varsa PERMISSION_DENIED.
  • İstenen ders kimliği mevcut değilse NOT_FOUND.
  • İstenen kullanıcının hesabı devre dışı bırakılırsa aşağıdaki istek hatalarından dolayı FAILED_PRECONDITION:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • Kullanıcı derste zaten öğrenci veya öğretmense ALREADY_EXISTS.

HTTP isteği

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
courseId

string

Öğrencinin oluşturulacağı dersin tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
enrollmentCode

string

Öğrencinin oluşturulacağı derse ait kayıt kodu. userId, istekte bulunan kullanıcıya karşılık geliyorsa bu kod gereklidir. İstekte bulunan kullanıcının, herhangi bir kullanıcı için öğrenci oluşturmak üzere yönetim izinlerine sahip olması durumunda bu kod atlanabilir.

İstek içeriği

İstek metni, Student öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulan Student örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.