Google Classroom API

Google Classroom'daki sınıfları, öğrenci listelerini ve davetiyeleri yönetir.

Hizmet: classroom.googleapis.com

Bu hizmeti çağırmak için Google'ın sağladığı istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerini yaparken aşağıdaki bilgileri kullanın.

Keşif belgesi

Keşif Belgesi, REST API'leri açıklamak ve kullanmak için makine tarafından okunabilir bir tanımlamadır. Google API'leriyle etkileşimde bulunan istemci kitaplıkları, IDE eklentileri ve diğer araçları oluşturmak için kullanılır. Bir hizmet birden fazla keşif belgesi sağlayabilir. Bu hizmet, aşağıdaki keşif belgesini sağlar:

Hizmet uç noktası

Hizmet uç noktası, bir API hizmetinin ağ adresini belirten ana URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmet aşağıdaki hizmet uç noktasını kullanır ve aşağıdaki tüm URI'ler bu hizmet uç noktasıyla ilgilidir:

  • https://classroom.googleapis.com

REST Kaynağı: v1.courses

Yöntemler
checkAddOnCreationEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkAddOnCreationEligibility
Kullanıcının belirli bir kursta eklenti ekleri oluşturmaya uygun olup olmadığını döndürür.
checkGradingPeriodsSetupEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
Kullanıcının belirli bir kursta GradingPeriodSettings'i güncellemeye uygun olup olmadığını döndürür.
create POST /v1/courses
Kurs oluşturur.
delete DELETE /v1/courses/{id}
Bir dersi siler.
get GET /v1/courses/{id}
Bir kurs döndürür.
getGradingPeriodSettings GET /v1/courses/{courseId}/gradingPeriodSettings
Bir dersteki notlandırma dönemi ayarlarını döndürür.
list GET /v1/courses
İstekte bulunan kullanıcının görüntülemesine izin verilen ve istekle eşleşen derslerin listesini döndürür.
patch PATCH /v1/courses/{id}
Bir dersteki bir veya daha fazla alanı günceller.
update PUT /v1/courses/{id}
Bir dersi günceller.
updateGradingPeriodSettings PATCH /v1/courses/{courseId}/gradingPeriodSettings
Bir dersin notlandırma dönemi ayarlarını günceller.

REST Kaynağı: v1.courses.aliases

Yöntemler
create POST /v1/courses/{courseId}/aliases
Bir kurs için takma ad oluşturur.
delete DELETE /v1/courses/{courseId}/aliases/{alias}
Bir dersin takma adını siler.
list GET /v1/courses/{courseId}/aliases
Bir dersin takma adlarının listesini döndürür.

REST Kaynağı: v1.courses.announcements

Yöntemler
create POST /v1/courses/{courseId}/announcements
Duyuru oluşturur.
delete DELETE /v1/courses/{courseId}/announcements/{id}
Bir duyuruyu siler.
get GET /v1/courses/{courseId}/announcements/{id}
Bir duyuru döndürür.
getAddOnContext GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.
list GET /v1/courses/{courseId}/announcements
İstekte bulunan kullanıcının görüntülemesine izin verilen duyuruların listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
Bir duyurunun atanan modunu ve seçeneklerini değiştirir.
patch PATCH /v1/courses/{courseId}/announcements/{id}
Bir duyurunun bir veya daha fazla alanını günceller.

REST Kaynağı: v1.courses.announcements.addOnAttachments

Yöntemler
create POST /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Bir yayının altında eklenti eki oluşturur.
delete DELETE /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini siler.
get GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Bir eklenti eki döndürür.
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Yayın altındaki bir eklenti tarafından oluşturulan tüm ekleri döndürür.
patch PATCH /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini günceller.

REST Kaynağı: v1.courses.courseWork

Yöntemler
create POST /v1/courses/{courseId}/courseWork
Sınıf çalışması oluşturur.
delete DELETE /v1/courses/{courseId}/courseWork/{id}
Bir sınıf çalışmasını siler.
get GET /v1/courses/{courseId}/courseWork/{id}
Sınıf çalışmasını geri verir.
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.
list GET /v1/courses/{courseId}/courseWork
İstekte bulunan kullanıcının görüntülemesine izin verilen ödevlerin listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
Bir çalışma materyalinin atanan modunu ve seçeneklerini değiştirir.
patch PATCH /v1/courses/{courseId}/courseWork/{id}
Bir veya daha fazla ödev alanını günceller.

REST Kaynağı: v1.courses.courseWork.addOnAttachments

Yöntemler
create POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Bir yayının altında eklenti eki oluşturur.
delete DELETE /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini siler.
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Bir eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Yayın altındaki bir eklenti tarafından oluşturulan tüm ekleri döndürür.
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini günceller.

REST Kaynağı: v1.courses.courseWork.addOnAttachments.studentSubmissions

Yöntemler
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Eklenti eki için öğrenci gönderimini döndürür.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions
İstekte bulunan kullanıcının görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Eklenti eki gönderimiyle ilişkili verileri günceller.

REST Kaynağı: v1.courses.courseWork.rubrics

Yöntemler
create POST /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
Puan anahtarı oluşturur.
delete DELETE /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Puan anahtarını siler.
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Puan anahtarı döndürür.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
İstekte bulunan kullanıcının görüntülemesine izin verilen puan anahtarlarının listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Puan anahtarını günceller.

REST Kaynağı: v1.courses.courseWork.studentSubmissions

Yöntemler
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Öğrenci gönderimini geri verir.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
İsteğin OAuth kapsamlarını hesaba katarak, istekte bulunan kullanıcının görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür.
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
Öğrenci gönderiminin eklerini değiştirir.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Öğrenci gönderiminin bir veya daha fazla alanını günceller.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
Öğrenci gönderimini, sahibi olan öğrenci adına geri alır.
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Öğrenci gönderimini geri verir.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
Öğrenci gönderimini teslim eder.

REST Kaynağı: v1.courses.courseWorkMaterials

Yöntemler
create POST /v1/courses/{courseId}/courseWorkMaterials
Sınıf çalışması materyali oluşturur.
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
Sınıf çalışması materyalini siler.
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
Bir ders çalışması materyalini döndürür.
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.
list GET /v1/courses/{courseId}/courseWorkMaterials
İstekte bulunan kullanıcının görüntülemesine izin verilen sınıf çalışması materyallerinin listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
Bir veya daha fazla ders materyali alanını günceller.

REST Kaynağı: v1.courses.courseWorkMaterials.addOnAttachments

Yöntemler
create POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Bir yayının altında eklenti eki oluşturur.
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini siler.
get GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Bir eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Yayın altındaki bir eklenti tarafından oluşturulan tüm ekleri döndürür.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Eklenti ekini günceller.

REST Kaynağı: v1.courses.posts

Yöntemler
getAddOnContext GET /v1/courses/{courseId}/posts/{postId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.

REST Kaynağı: v1.courses.posts.addOnAttachments

Yöntemler
create POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Bir yayının altında eklenti eki oluşturur.
delete DELETE /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Eklenti ekini siler.
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Bir eklenti eki döndürür.
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Yayın altındaki bir eklenti tarafından oluşturulan tüm ekleri döndürür.
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Eklenti ekini günceller.

REST Kaynağı: v1.courses.posts.addOnAttachments.studentSubmissions

Yöntemler
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Eklenti eki için öğrenci gönderimini döndürür.
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Eklenti eki gönderimiyle ilişkili verileri günceller.

REST Kaynağı: v1.courses.studentGroups

Yöntemler
create POST /v1/courses/{courseId}/studentGroups
Bir ders için öğrenci grubu oluşturur.
delete DELETE /v1/courses/{courseId}/studentGroups/{id}
Öğrenci grubunu siler.
list GET /v1/courses/{courseId}/studentGroups
Bir dersteki grupların listesini döndürür.
patch PATCH /v1/courses/{courseId}/studentGroups/{id}
Öğrenci grubundaki bir veya daha fazla alanı günceller.

REST Kaynağı: v1.courses.studentGroups.studentGroupMembers

Yöntemler
create POST /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
Öğrenci grubu için öğrenci grubu üyesi oluşturur.
delete DELETE /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}
Öğrenci grubu üyesini siler.
list GET /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
Gruptaki öğrencilerin listesini döndürür.

REST Kaynağı: v1.courses.students

Yöntemler
create POST /v1/courses/{courseId}/students
Kullanıcıyı bir dersin öğrencisi olarak ekler.
delete DELETE /v1/courses/{courseId}/students/{userId}
Bir dersteki öğrenciyi siler.
get GET /v1/courses/{courseId}/students/{userId}
Bir dersin öğrencisini döndürür.
list GET /v1/courses/{courseId}/students
İstek sahibinin görüntüleme izni olan bu kursun öğrencilerinin listesini döndürür.

REST Kaynağı: v1.courses.teachers

Yöntemler
create POST /v1/courses/{courseId}/teachers
Bir kursun öğretmenini oluşturur.
delete DELETE /v1/courses/{courseId}/teachers/{userId}
Belirtilen öğretmeni belirtilen dersten kaldırır.
get GET /v1/courses/{courseId}/teachers/{userId}
Bir dersin öğretmenini döndürür.
list GET /v1/courses/{courseId}/teachers
İstekte bulunan kullanıcının görüntülemesine izin verilen, bu kursun öğretmenlerinin listesini döndürür.

REST Kaynağı: v1.courses.topics

Yöntemler
create POST /v1/courses/{courseId}/topics
Konu oluşturur.
delete DELETE /v1/courses/{courseId}/topics/{id}
Bir konuyu siler.
get GET /v1/courses/{courseId}/topics/{id}
Bir konu döndürür.
list GET /v1/courses/{courseId}/topics
İstekte bulunan kullanıcının görüntülemesine izin verilen konuların listesini döndürür.
patch PATCH /v1/courses/{courseId}/topics/{id}
Bir konunun bir veya daha fazla alanını günceller.

REST Kaynağı: v1.invitations

Yöntemler
accept POST /v1/invitations/{id}:accept
Davetiyeyi kabul eder, kaldırır ve davet edilen kullanıcıyı belirtilen dersin öğretmenlerine veya öğrencilerine (uygun şekilde) ekler.
create POST /v1/invitations
Davetiye oluşturur.
delete DELETE /v1/invitations/{id}
Davetiyeyi siler.
get GET /v1/invitations/{id}
Davetiye döndürür.
list GET /v1/invitations
İstek gönderen kullanıcının görüntüleme iznine sahip olduğu davetlerin listesini döndürür. Bu liste, liste isteğiyle eşleşen davetlerle sınırlıdır.

REST Kaynağı: v1.registrations

Yöntemler
create POST /v1/registrations
Bir Registration oluşturur. Bu işlem, Classroom'un sağlanan feed kaynağından cloudPubSubTopic içinde sağlanan hedefe bildirim göndermeye başlamasına neden olur.
delete DELETE /v1/registrations/{registrationId}
Bir Registration siler ve Classroom'un bu Registration için bildirim göndermeyi durdurmasına neden olur.

REST Kaynağı: v1.userProfiles

Yöntemler
checkUserCapability GET /v1/userProfiles/{userId}:checkUserCapability
Kullanıcının belirtilen Classroom özelliğini kullanıp kullanamayacağını döndürür.
get GET /v1/userProfiles/{userId}
Kullanıcı profili döndürür.

REST Kaynağı: v1.userProfiles.guardianInvitations

Yöntemler
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
Veli davetiyesi oluşturur ve veliye, öğrencinin velisi olduğunu onaylamasını isteyen bir e-posta gönderir.
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Belirli bir veli davetiyesini döndürür.
list GET /v1/userProfiles/{studentId}/guardianInvitations
İstek gönderen kullanıcının görüntülemesine izin verilen veli davetiyelerinin listesini, sağlanan parametrelere göre filtrelenmiş olarak döndürür.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Veli davetiyesini değiştirir.

REST Kaynağı: v1.userProfiles.guardians

Yöntemler
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
Bir veliyi siler.
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
Belirli bir veliyi döndürür.
list GET /v1/userProfiles/{studentId}/guardians
İstekte bulunan kullanıcının görüntülemesine izin verilen velilerin listesini döndürür. Bu liste, istekle eşleşen velilerle sınırlıdır.