เอกสารนี้มีข้อมูลการให้สิทธิ์และการตรวจสอบสิทธิ์เฉพาะสำหรับ Google Docs API โปรดอ่านข้อมูลการตรวจสอบสิทธิ์และการให้สิทธิ์ทั่วไปของ Google Workspace ที่ หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ก่อนอ่านเอกสารนี้
กำหนดค่า OAuth 2.0 สำหรับการให้สิทธิ์
กำหนดค่าหน้าจอขอความยินยอม OAuth และเลือกขอบเขต เพื่อกำหนดข้อมูลที่จะแสดงต่อผู้ใช้และผู้ตรวจสอบแอป รวมถึงลงทะเบียน แอปเพื่อให้คุณเผยแพร่แอปได้ในภายหลัง
ขอบเขต Docs API
หากต้องการกำหนดระดับการเข้าถึงที่มอบให้แอป คุณต้องระบุและประกาศ ขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง URI ของ OAuth 2.0 ที่มีชื่อแอป Google Workspace, ประเภทข้อมูลที่เข้าถึง และระดับการเข้าถึง ขอบเขตคือคำขอของแอปในการทำงานกับข้อมูล Google Workspace ซึ่งรวมถึงข้อมูลในบัญชี Google ของผู้ใช้
เมื่อติดตั้งแอป ระบบจะขอให้ผู้ใช้ตรวจสอบขอบเขตที่แอปใช้ โดยทั่วไป คุณควรเลือกขอบเขตที่แคบที่สุดเท่าที่จะเป็นไปได้ และหลีกเลี่ยงการขอขอบเขตที่แอปไม่จำเป็นต้องใช้ ผู้ใช้จะให้สิทธิ์เข้าถึงขอบเขตที่จำกัดและอธิบายไว้อย่างชัดเจนได้ง่ายกว่า
เราขอแนะนำให้ใช้ขอบเขตที่ไม่ละเอียดอ่อนหากเป็นไปได้ เนื่องจากขอบเขตดังกล่าวให้สิทธิ์เข้าถึงระดับไฟล์และจำกัดการเข้าถึงฟีเจอร์เฉพาะที่แอปต้องการ
Docs API รองรับขอบเขตต่อไปนี้
| รหัสขอบเขต | คำอธิบาย | การใช้งาน |
|---|---|---|
https://www.googleapis.com/auth/documents |
ดู แก้ไข สร้าง และลบเอกสารทั้งหมดใน Google เอกสาร | ละเอียดอ่อน |
https://www.googleapis.com/auth/documents.readonly |
ดูเอกสารทั้งหมดใน Google เอกสาร | ละเอียดอ่อน |
https://www.googleapis.com/auth/drive.file |
ดู แก้ไข สร้าง และลบเฉพาะไฟล์ Google ไดรฟ์ที่คุณ ใช้กับแอปนี้ | แนะนำ ไม่ละเอียดอ่อน |
https://www.googleapis.com/auth/drive |
ดู แก้ไข สร้าง และลบไฟล์ทั้งหมดใน Google ไดรฟ์ | จำกัด |
https://www.googleapis.com/auth/drive.readonly |
ดูและดาวน์โหลดไฟล์ทั้งหมดใน Google ไดรฟ์ | จำกัด |
คอลัมน์การใช้งานในตารางจะระบุความละเอียดอ่อนของแต่ละขอบเขตตามคำจำกัดความต่อไปนี้
ไม่ละเอียดอ่อน: ขอบเขตเหล่านี้ให้สิทธิ์เข้าถึงที่เล็กที่สุด และต้องมีการตรวจสอบแอปพื้นฐานเท่านั้น ดูข้อมูลเกี่ยวกับข้อกำหนดนี้ได้ที่การส่งแอปเพื่อรับการยืนยัน
ละเอียดอ่อน: ขอบเขตเหล่านี้ให้สิทธิ์เข้าถึงข้อมูลผู้ใช้ Google ที่เฉพาะเจาะจง ซึ่งผู้ใช้ให้สิทธิ์แก่แอป และคุณต้องผ่าน การตรวจสอบแอปเพิ่มเติม ดูข้อมูลเกี่ยวกับข้อกำหนดนี้ได้ที่ ข้อกำหนดของขอบเขตที่ละเอียดอ่อนและขอบเขตที่จำกัด
จำกัด: ขอบเขตเหล่านี้ให้สิทธิ์เข้าถึงข้อมูลผู้ใช้ Google ในวงกว้าง และ คุณต้องผ่านกระบวนการยืนยันขอบเขตที่จำกัด ดูข้อมูลเกี่ยวกับข้อกำหนดนี้ได้ที่นโยบายข้อมูลผู้ใช้ของบริการ Google API และข้อกำหนดเพิ่มเติมสำหรับขอบเขต API เฉพาะ หากคุณจัดเก็บ (หรือส่ง) ข้อมูลขอบเขตที่จำกัดไว้ในเซิร์ฟเวอร์ คุณต้องผ่านการประเมินความปลอดภัย
หากแอปต้องมีสิทธิ์เข้าถึง Google API อื่นๆ คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต Google API ได้ที่ การใช้ OAuth 2.0 เพื่อ เข้าถึง Google API
ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 ที่เฉพาะเจาะจงได้ที่ ขอบเขต OAuth 2.0 สำหรับ Google APIs
หัวข้อที่เกี่ยวข้อง
- เลือกขอบเขต Google Drive API
- ศูนย์ช่วยเหลือการยืนยันแอปผ่าน OAuth
- คำถามที่พบบ่อยเกี่ยวกับการยืนยันแอป OAuth