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 yetkilerini kontrol edebilir.

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

  • PERMISSION_DENIED ise istek gönderen kullanıcının, belirtilen kullanıcının uygunluğunu kontrol etmesine izin verilmez.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.

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 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 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 bir enum.

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.
CREATE_RUBRIC Ölçütler oluşturma ve değiştirme yetkisi.
UPDATE_GRADING_PERIOD_SETTINGS Notlandırma dönemi ayarlarını değiştirme yetkisi.