Method: userProfiles.checkUserCapability

แสดงผลว่าผู้ใช้ใช้ความสามารถของ Classroom ที่ระบุได้หรือไม่ เช่น คุณสามารถใช้ปลายทางนี้เพื่อตรวจสอบว่าผู้ใช้สร้างไฟล์แนบของส่วนเสริมได้หรือไม่

ผู้ใช้ที่ขอจะตรวจสอบความสามารถของตนเองได้เท่านั้น

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้ตรวจสอบสิทธิ์ของผู้ใช้ที่ระบุ
  • INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
userId

string

ต้องระบุ ตัวระบุของผู้ใช้

เมื่อระบุเป็นพารามิเตอร์ของคำขอ ตัวระบุนี้อาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • ตัวระบุตัวเลขสำหรับผู้ใช้
  • อีเมลของผู้ใช้
  • สตริงตามตัวอักษร "me" ซึ่งระบุผู้ใช้ที่ขอ

พารามิเตอร์การค้นหา

พารามิเตอร์
capability

enum (Capability)

ต้องระบุ ความสามารถที่ควรตรวจสอบสำหรับผู้ใช้รายนี้ เช่น หากต้องการตรวจสอบว่าผู้ใช้สร้างไฟล์แนบส่วนเสริมได้หรือไม่ ให้ตั้งค่านี้เป็น CREATE_ADD_ON_ATTACHMENT
previewVersion

enum (PreviewVersion)

ไม่บังคับ API เวอร์ชันตัวอย่าง

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับจากการตรวจสอบความสามารถของผู้ใช้

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "capability": enum (Capability),
  "allowed": boolean
}
ช่อง
capability

enum (Capability)

ความสามารถของ Classroom
allowed

boolean

อนุญาตให้ผู้ใช้ใช้ความสามารถที่ระบุหรือไม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์

ความสามารถ

Enum ที่แสดงถึงความสามารถ

Enum
CAPABILITY_UNSPECIFIED ไม่รองรับ
CREATE_ADD_ON_ATTACHMENT ความสามารถในการสร้างและแก้ไข AddOnAttachments ที่เชื่อมโยงกับโปรเจ็กต์ Developer Console ของรหัสไคลเอ็นต์ OAuth ที่ใช้ในการส่งคำขอ
CREATE_RUBRIC ความสามารถในการสร้างและแก้ไขรูบริก
UPDATE_GRADING_PERIOD_SETTINGS ความสามารถในการแก้ไขการตั้งค่าระยะเวลาการให้คะแนน
CREATE_STUDENT_GROUP ความสามารถในการสร้างและแก้ไขกลุ่มนักเรียนและสมาชิกในกลุ่ม