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ı kullanması gerekiyorsa API isteklerini yaparken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Keşif Belgesi, REST API'leri açıklamak ve kullanmak için makine tarafından okunabilir bir spesifikasyondur. 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 dokümanı sağlayabilir. Bu hizmet, aşağıdaki keşif dokümanını sağlar:

Hizmet uç noktası

Hizmet uç noktası, bir API hizmetinin ağ adresini belirten temel bir URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmetin aşağıdaki hizmet uç noktası vardı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 kursu siler.
get GET /v1/courses/{id}
Bir kurs döndürür.
getGradingPeriodSettings GET /v1/courses/{courseId}/gradingPeriodSettings
Bir kurstaki 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 kursların listesini döndürür. Bu liste, istekle eşleşen kurslarla sınırlıdır.
patch PATCH /v1/courses/{id}
Bir kurstaki bir veya daha fazla alanı günceller.
update PUT /v1/courses/{id}
Kursu günceller.
updateGradingPeriodSettings PATCH /v1/courses/{courseId}/gradingPeriodSettings
Bir kursun notlandırma dönemi ayarlarını günceller.

REST Kaynağı: v1.courses.aliases

Yöntemler
create POST /v1/courses/{courseId}/aliases
Bir ders 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 kursun diğer 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}
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 eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/announcements
İsteği gönderenin görüntülemesine izin verilen duyuruların listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
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 gönderinin altına 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Eklenti tarafından gönderi altında 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}
Ödevleri siler.
get GET /v1/courses/{courseId}/courseWork/{id}
Kurs çalışmalarını geri verir.
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/courseWork
İsteği gönderen kullanıcının görüntülemesine izin verilen kurs çalışmalarının listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
Bir ödevin atananlar modunu ve seçeneklerini değiştirir.
patch PATCH /v1/courses/{courseId}/courseWork/{id}
Bir kurs çalışmasının bir veya daha fazla alanını günceller.

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

Yöntemler
create POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Bir gönderinin altına 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Eklenti tarafından gönderi altında 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 olarak gönderilen öğrenci gönderimini 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
İsteği gönderenin görüntülemesine izin verilen değerlendirme ölçütlerinin 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
İstekte bulunanın görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. Bu işlemde isteğin OAuth kapsamları dikkate alını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}
Bir öğrenci gönderiminin bir veya daha fazla alanını günceller.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
Sahibi olan öğrenci adına öğrenci gönderimini 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}
Ders materyalini siler.
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
Bir kurs çalışması materyali döndürür.
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
Belirli bir yayın bağlamında Classroom eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/courseWorkMaterials
İstekte bulunan kullanıcının görüntülemesine izin verilen kurs materyallerinin listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
Bir kurs materyalinin bir veya daha fazla alanını günceller.

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

Yöntemler
create POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Bir gönderinin altına 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Eklenti tarafından gönderi altında 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 eklentilerinin meta verilerini alır.

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

Yöntemler
create POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Bir gönderinin altına 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Eklenti tarafından gönderi altında 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 olarak gönderilen öğ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 kurs için öğrenci grubu oluşturur.
delete DELETE /v1/courses/{courseId}/studentGroups/{id}
Öğrenci grubunu siler.
list GET /v1/courses/{courseId}/studentGroups
Bir kurstaki grupların listesini döndürür.
patch PATCH /v1/courses/{courseId}/studentGroups/{id}
Bir öğ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
Bir gruptaki öğrencilerin listesini döndürür.

REST Kaynağı: v1.courses.students

Yöntemler
create POST /v1/courses/{courseId}/students
Bir kullanıcıyı kursun öğrencisi olarak ekler.
delete DELETE /v1/courses/{courseId}/students/{userId}
Bir dersin öğrencisini siler.
get GET /v1/courses/{courseId}/students/{userId}
Bir kursun öğrencisini döndürür.
list GET /v1/courses/{courseId}/students
İsteği gönderenin görüntülemesine izin verilen 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 kurstan kaldırır.
get GET /v1/courses/{courseId}/teachers/{userId}
Bir kursun öğretmenini döndürür.
list GET /v1/courses/{courseId}/teachers
İsteği gönderen kullanıcının görüntülemesine izin verilen bu dersin öğ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}
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
Daveti kabul eder, daveti kaldırır ve davet edilen kullanıcıyı belirtilen kursun öğ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
İstekte bulunan kullanıcının görüntülemesine izin verilen davetiyelerin listesini döndürür. Bu liste, liste isteğiyle eşleşen davetiyelerle sınırlıdır.

REST Kaynağı: v1.registrations

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

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ı profilini döndürür.

REST Kaynağı: v1.userProfiles.guardianInvitations

Yöntemler
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
Veli daveti 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
İstekte bulunan kullanıcının görüntülemesine izin verilen veli davetlerinin listesini, sağlanan parametrelere göre filtrelenmiş olarak döndürür.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Veli davetini değiştirir.

REST Kaynağı: v1.userProfiles.guardians

Yöntemler
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
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.