เลือกขอบเขต API ป้ายกำกับของ Google ไดรฟ์

เอกสารนี้มีการให้สิทธิ์และ การตรวจสอบสิทธิ์เฉพาะสำหรับ Drive ป้ายกำกับ API ก่อนอ่านเอกสารนี้ โปรดอ่านข้อมูลการตรวจสอบสิทธิ์และการให้สิทธิ์ทั่วไปของ Google Workspace ที่ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

กำหนดค่า OAuth 2.0 สำหรับการให้สิทธิ์

กำหนดค่าหน้าจอคำยินยอม OAuth และเลือกขอบเขตเพื่อกำหนดข้อมูลที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป ตลอดจนลงทะเบียนแอปเพื่อเผยแพร่แอปในภายหลัง

ขอบเขต API ป้ายกำกับของ Google ไดรฟ์

หากต้องการกำหนดระดับการเข้าถึงที่ให้แก่แอป คุณต้องระบุและประกาศขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง URI ของ OAuth 2.0 ที่มีชื่อแอป Google Workspace, ประเภทข้อมูลที่เข้าถึงได้ และระดับการเข้าถึง ขอบเขตคือคำขอในการทำงานร่วมกับข้อมูล Google Workspace ของแอป ซึ่งรวมถึงข้อมูลบัญชี Google ของผู้ใช้

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

เมื่อเป็นไปได้ เราขอแนะนำให้ใช้ขอบเขตที่ไม่มีความละเอียดอ่อนเนื่องจากจะกำหนดขอบเขตการเข้าถึงต่อไฟล์และจำกัดการเข้าถึงฟังก์ชันการทำงานเฉพาะที่แอปต้องการ

คุณใช้ขอบเขต OAuth 2.0 ต่อไปนี้เพื่ออ่าน ค้นหา และแก้ไขรายการในไดรฟ์ที่ใช้ข้อมูลเมตาป้ายกำกับได้

ขอบเขต ความหมาย
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
อ่าน ค้นหา และแก้ไขข้อมูลเมตาของป้ายกำกับที่ใช้กับรายการในไดรฟ์
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
อ่านและค้นหาข้อมูลเมตาของป้ายกำกับที่ใช้กับรายการในไดรฟ์ที่ได้รับสิทธิ์สำหรับแอปพลิเคชัน

ดูข้อมูลเพิ่มเติมได้ที่ขอบเขต OAuth 2.0 ของไดรฟ์และการให้สิทธิ์เฉพาะ Drive API

ขอบเขตสำหรับป้ายกำกับ

ขอบเขต OAuth ต่อไปนี้สามารถใช้เพื่อดูและจัดการป้ายกำกับได้

ขอบเขต ความหมาย
https://www.googleapis.com/auth/drive.labels ดู ใช้ และจัดการป้ายกำกับไดรฟ์
  • ขอบเขตนี้อนุญาตการเข้าถึงของผู้ใช้ และจำเป็นสำหรับการดำเนินการเขียนเมื่อไม่ได้ตั้งค่า use_admin_access
  • การดำเนินการเขียนที่มีขอบเขตนี้ใช้ได้กับป้ายกำกับที่มีประเภทป้ายกำกับ SHARED
https://www.googleapis.com/auth/drive.labels.readonly ดูและใช้ป้ายกำกับไดรฟ์
  • ขอบเขตนี้อนุญาตการเข้าถึงของผู้ใช้ และจำเป็นสำหรับการดำเนินการอ่านเมื่อไม่ได้ตั้งค่า use_admin_access
https://www.googleapis.com/auth/drive.admin.labels ดู แก้ไข สร้าง และลบป้ายกำกับไดรฟ์ทั้งหมดในองค์กร รวมถึงดูนโยบายการดูแลระบบเกี่ยวกับป้ายกำกับขององค์กร
  • ขอบเขตนี้ให้สิทธิ์เข้าถึงระดับผู้ดูแลระบบ และจำเป็นสำหรับการเขียนเมื่อตั้งค่า use_admin_access ขอบเขตนี้ให้สิทธิ์การอ่านด้วย
  • การดำเนินการเขียนที่มีขอบเขตนี้ใช้ได้กับป้ายกำกับที่มีประเภทป้ายกำกับ SHARED หรือ ADMIN
https://www.googleapis.com/auth/drive.admin.labels.readonly ดูป้ายกำกับของไดรฟ์และนโยบายการดูแลระบบเกี่ยวกับป้ายกำกับทั้งหมดในองค์กร
  • ขอบเขตนี้ให้สิทธิ์เข้าถึงระดับผู้ดูแลระบบ และจำเป็นสำหรับการดำเนินการอ่านเมื่อตั้งค่า use_admin_access

สิทธิ์เข้าถึงของผู้ดูแลระบบ

หากต้องการจัดการป้ายกำกับ ADMIN คุณต้องระบุสิ่งต่อไปนี้

  • useAdminAccess มีสถานะเป็น true เพื่อใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบของผู้ใช้
  • ผู้ดูแลบัญชีที่มีสิทธิ์จัดการป้ายกำกับ

useAdminAccess

ผู้ดูแลระบบต้องตั้งค่าพารามิเตอร์ useAdminAccess เพื่อให้สิทธิ์ของผู้ดูแลระบบ การตั้งค่า useAdminAccess ช่วยให้ดูและแก้ไขป้ายกำกับที่ลูกค้าเป็นเจ้าของได้ ซึ่งรวมทั้งป้ายกำกับ ADMIN และ SHARED

เมื่อไม่ได้ตั้งค่า useAdminAccess ระบบจะอนุญาตคำขอเขียนสำหรับป้ายกำกับที่มีทั้ง SHARED label type และผู้ใช้ที่มีบทบาท EDITOR ที่เหมาะสมสำหรับป้ายกำกับนี้

ดูข้อมูลเพิ่มเติมได้ที่สร้างข้อมูลเข้าสู่ระบบ