เลือกขอบเขต API ของ Google เอกสาร

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

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

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

ขอบเขต 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 เฉพาะ หากคุณจัดเก็บข้อมูลขอบเขตที่จำกัดไว้ในเซิร์ฟเวอร์ (หรือส่ง) คุณจะต้องเข้าสู่การประเมินความปลอดภัย

หากแอปต้องการเข้าถึง API อื่นๆ ของ Google คุณจะเพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต Google API ได้ที่การใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 ที่เฉพาะเจาะจงได้ที่ขอบเขต OAuth 2.0 สำหรับ Google APIs