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 ความสามารถในการแก้ไขการตั้งค่าระยะเวลาการให้คะแนน