เลือกขอบเขต 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 ที่เหมาะสมสำหรับป้ายกำกับนี้เท่านั้น

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