Method: courses.students.create

Kullanıcıyı bir dersin öğrencisi olarak ekler.

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

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

  • PERMISSION_DENIED ise istek gönderen kullanıcının bu kursta öğrenci oluşturmasına izin verilmez veya erişim hataları yaşanır.
  • İstenen kurs kimliği mevcut değilse NOT_FOUND.
  • FAILED_PRECONDITION istenen kullanıcının hesabı devre dışıysa aşağıdaki istek hataları için:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS kullanıcının derste zaten öğrenci veya öğretmen olması gerekir.

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ıdır. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
enrollmentCode

string

Öğrencinin oluşturulacağı kursun kayıt kodu. userId, istek gönderen kullanıcıya karşılık geliyorsa bu kod gereklidir. İstekte bulunan kullanıcının herhangi bir kullanıcı için öğrenci oluşturma konusunda yönetici izinleri varsa 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 metni, yeni oluşturulmuş bir Student örneği 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 bakın.