Method: userProfiles.checkUserCapability

Kullanıcının belirtilen Classroom özelliğini kullanıp kullanamayacağını döndürür. Örneğin, bu uç nokta, kullanıcının eklenti ekleri oluşturup oluşturamayacağını kontrol etmek için kullanılabilir.

İstek gönderen kullanıcı yalnızca kendi özelliklerini kontrol edebilir.

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

  • PERMISSION_DENIED İstekte bulunan kullanıcının, belirtilen kullanıcının uygunluğunu kontrol etmesine izin verilmiyorsa.
  • İstek yanlış biçimlendirilmişse INVALID_ARGUMENT.

HTTP isteği

GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability

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

Yol parametreleri

Parametreler
userId

string

Zorunlu. Kullanıcının tanımlayıcısı.

Bir isteğin parametresi olarak belirtildiğinde bu tanımlayıcı aşağıdakilerden biri olabilir:

  • Kullanıcının sayısal tanımlayıcısı
  • Kullanıcının e-posta adresi
  • İstekte bulunan kullanıcıyı belirten "me" dize değişmezi

Sorgu parametreleri

Parametreler
capability

enum (Capability)

Zorunlu. Bu kullanıcı için kontrol edilmesi gereken özellik. Örneğin, bir kullanıcının eklenti eki oluşturup oluşturamayacağını kontrol etmek için bu değeri CREATE_ADD_ON_ATTACHMENT olarak ayarlayın.
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kullanıcı özelliklerini kontrol etme işleminden alınan yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "capability": enum (Capability),
  "allowed": boolean
}
Alanlar
capability

enum (Capability)

Classroom özelliği.
allowed

boolean

Belirtilen özelliğin kullanıcıya izin verilip verilmediği.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

Kapasite

Özelliği temsil eden enum.

Sıralamalar
CAPABILITY_UNSPECIFIED Desteklenmiyor.
CREATE_ADD_ON_ATTACHMENT İsteği yapmak için kullanılan OAuth istemci kimliğinin Developer Console projesiyle ilişkili AddOnAttachment'ları oluşturma ve değiştirme özelliği.
CREATE_RUBRIC Derecelendirme ölçekleri oluşturma ve değiştirme özelliği.
UPDATE_GRADING_PERIOD_SETTINGS Notlandırma dönemi ayarlarını değiştirme özelliği.
CREATE_STUDENT_GROUP Öğrenci grupları ve üyelerini oluşturma ve değiştirme özelliği.