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.

İ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.
  • 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
  • istekte bulunan kullanıcıyı belirten dize değişmez değeri ("me")

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

Belirtilen özelliğe kullanıcı için 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ılavuzunu inceleyin.

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.
UPDATE_GRADING_PERIOD_SETTINGS Notlandırma dönemi ayarlarını değiştirme yetkisi.