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 tarafından sağlanan istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerinde bulunurken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Keşif Belgesi, REST API'lerini açıklamak ve tüketmek için makine tarafından okunabilen bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'leriyle etkileşimde bulunan 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 URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmet, aşağıdaki hizmet uç noktasına sahiptir ve aşağıdaki URI'lerin tümü bu hizmet uç noktasına bağlıdır:

  • https://classroom.googleapis.com

REST Kaynağı: v1.courses

Yöntemler
checkAddOnCreationEligibility GET /v1/courses/{courseId}:checkAddOnCreationEligibility
Kullanıcının belirli bir derste eklenti ekleri oluşturmaya uygun olup olmadığını döndürür.
checkGradingPeriodsSetupEligibility GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
Kullanıcının belirli bir derste GradingPeriodSettings güncellemeye uygun olup olmadığını döndürür.
create POST /v1/courses
Kurs oluşturur.
delete DELETE /v1/courses/{id}
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, istekle eşleşen kurslarla sınırlı kursların listesini döndürü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
Dersin notlandırma dönemi ayarlarını günceller.

REST Kaynağı: v1.courses.aliases

Yöntemler
create POST /v1/courses/{courseId}/aliases
Ders için takma ad oluşturur.
delete DELETE /v1/courses/{courseId}/aliases/{alias}
Dersin takma adını siler.
list GET /v1/courses/{courseId}/aliases
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}
Duyuruyu siler.
get GET /v1/courses/{courseId}/announcements/{id}
Duyuru döndürür.
getAddOnContext GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext
Belirli bir yayının bağlamında Classroom eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/announcements
İstekte bulunanın görüntülemesine izin verilen duyuruların listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
Atanan modu ve duyurunun seçeneklerini değiştirir.
patch PATCH /v1/courses/{courseId}/announcements/{id}
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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Gönderinin altında bulunan 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ışmaları oluşturur.
delete DELETE /v1/courses/{courseId}/courseWork/{id}
Sınıf çalışmasını siler.
get GET /v1/courses/{courseId}/courseWork/{id}
Sınıf çalışmasını döndürür.
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
Belirli bir yayının bağlamında Classroom eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/courseWork
İstekte bulunan kişinin görüntülemesine izin verilen kurs çalışmalarının listesini döndürür.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
Atananlar modunu ve sınıf çalışmasının seçeneklerini değiştirir.
patch PATCH /v1/courses/{courseId}/courseWork/{id}
Bir sınıf ç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 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Gönderinin altında bulunan 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}
Öğrenci tarafından eklenti eki için gönderim 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}
Bir puan anahtarını siler.
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Bir puan anahtarı döndürür.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
İstekte bulunan kişinin görüntülemesine izin verilen puan anahtarlarının listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Bir puan anahtarını günceller.

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

Yöntemler
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Öğrencinin gönderimini döndürür.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
İsteğin OAuth kapsamları da hesaba katılarak, istekte bulunan kişinin 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önderimlerinin eklerini değiştirir.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Öğrencinin gönderdiği bir veya daha fazla alanı günceller.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
Sahibi olan öğrenci adına öğrenci gönderimi için yeniden hak talebinde bulunur.
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Öğrencinin gönderimini döndürür.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
Öğrencinin gönderdiği dosyayı 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}
Ders çalışma materyalini döndürür.
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
Belirli bir yayının bağlamında Classroom eklentilerinin meta verilerini alır.
list GET /v1/courses/{courseId}/courseWorkMaterials
Talepte bulunan kişinin görüntülemesine izin verilen kurs çalışması materyalinin listesini döndürür.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
Sınıf çalışması materyalindeki bir veya daha fazla alanı 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Gönderinin altında bulunan 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ı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 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}
Eklenti eki döndürür.
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Gönderinin altında bulunan 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}
Öğrenci tarafından eklenti eki için gönderim 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.students

Yöntemler
create POST /v1/courses/{courseId}/students
Bir kullanıcıyı dersin öğrencisi olarak ekler.
delete DELETE /v1/courses/{courseId}/students/{userId}
Bir dersin öğrencisini siler.
get GET /v1/courses/{courseId}/students/{userId}
Bir dersin öğrencisini döndürür.
list GET /v1/courses/{courseId}/students
Bu dersteki, istekte bulunan kişinin görüntülemesine izin verilen öğrencilerin listesini döndürür.

REST Kaynağı: v1.courses.teachers

Yöntemler
create POST /v1/courses/{courseId}/teachers
Bir dersin öğ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
Bu kursun, istekte bulunan kişinin görüntülemesine izin verilen öğ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ı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
Davetiye kabul edildiğinde, davetiye kaldırılır ve davet edilen kullanıcı belirtilen dersin öğretmenlerine veya öğrencilerine (uygun şekilde) eklenir.
create POST /v1/invitations
Davetiye oluşturur.
delete DELETE /v1/invitations/{id}
Bir 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, liste isteğiyle eşleşen davetiyelerin listesini döndürür.

REST Kaynağı: v1.registrations

Yöntemler
create POST /v1/registrations
Bir Registration oluşturarak Classroom'un sağlanan feed kaynağından cloudPubSubTopic içinde sağlanan hedefe bildirim göndermeye başlamasını sağlar.
delete DELETE /v1/registrations/{registrationId}
Bir Registration öğesini siler ve Classroom, söz konusu Registration için bildirim göndermeyi durdurur.

REST Kaynağı: v1.userProfiles

Yöntemler
get GET /v1/userProfiles/{userId}
Bir 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
İstekte bulunan kullanıcının görüntülemesine izin verilen veli davetiyelerinin, sağlanan parametrelere göre filtrelenen listesini döndürür.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Veli davetiyesinde değişiklik yapar.

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 velilerle eşleşen velilerin listesini döndürür.