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

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

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

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

ขอบเขต Google Drive Labels API

หากต้องการกำหนดระดับการเข้าถึงที่อนุญาตแก่แอป คุณต้องระบุและประกาศขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง 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 และการให้สิทธิ์เฉพาะสำหรับ 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 ที่เหมาะสมสำหรับป้ายกำกับนี้เท่านั้น

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อสร้างข้อมูลเข้าสู่ระบบ