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 eki oluşturup oluşturamayacağını kontrol etmek için kullanılabilir.

İstekte bulunan kullanıcı yalnızca kendi yeteneklerini kontrol edebilir.

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

  • İstekte bulunan kullanıcının, belirtilen kullanıcı için uygunluğu kontrol etmesine izin verilmiyorsa PERMISSION_DENIED.
  • İstek bozuksa 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ıdır.

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ıdır.
  • kullanıcının e-posta adresi
  • İstekte bulunan kullanıcıyı belirten "me" değişmez dizesi

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 ayarı CREATE_ADD_ON_ATTACHMENT olarak belirleyin.

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 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

Kullanıcının belirtilen yeteneğe erişmesine 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ılavuzuna bakın.

Kapasite

Özelliği temsil eden sıralama.

Sıralamalar
CAPABILITY_UNSPECIFIED Desteklenmiyor.
CREATE_ADD_ON_ATTACHMENT İsteği göndermek için kullanılan OAuth istemci kimliğinin Developer Console projesiyle ilişkili AddOnAttachments oluşturma ve değiştirme yetkisi.
UPDATE_GRADING_PERIOD_SETTINGS Notlandırma dönemi ayarlarını değiştirme yetkisi.