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

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

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

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

ขอบเขต Labels API ของ Google Drive

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

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อ Drive API OAuth 2.0 ขอบเขต และเฉพาะ 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 ที่เหมาะสมสำหรับป้ายกำกับนี้

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