เลือกขอบเขต Google Sheets API

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

โปรดทราบว่าขอบเขต Sheets API จะใช้กับไฟล์ สเปรดชีตและ จำกัดเฉพาะชีตใดชีตหนึ่งไม่ได้ หากต้องการป้องกันไม่ให้มีการแก้ไขชีต ให้ใช้ ProtectedRange เพื่อกำหนดเซลล์หรือช่วงของเซลล์ที่แก้ไขไม่ได้ ดูตัวอย่างได้ที่ ช่วงที่มีชื่อและช่วงที่ป้องกันไว้

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

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

ขอบเขต Sheets API

หากต้องการกำหนดระดับการเข้าถึงที่มอบให้แอป คุณต้องระบุและประกาศ ขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง URI ของ OAuth 2.0 ที่มีชื่อแอป Google Workspace, ประเภทข้อมูลที่เข้าถึง และระดับการเข้าถึง ขอบเขตคือคำขอของแอปในการทำงานกับข้อมูล Google Workspace ซึ่งรวมถึงข้อมูลในบัญชี Google ของผู้ใช้

เมื่อติดตั้งแอป ระบบจะขอให้ผู้ใช้ตรวจสอบขอบเขตที่แอปใช้ โดยทั่วไป คุณควรเลือกขอบเขตที่แคบที่สุดเท่าที่จะเป็นไปได้ และหลีกเลี่ยงการขอขอบเขตที่แอปไม่จำเป็นต้องใช้ ผู้ใช้จะให้สิทธิ์เข้าถึงขอบเขตที่จำกัดและอธิบายไว้อย่างชัดเจนได้ง่ายกว่า

เมื่อเป็นไปได้ เราขอแนะนำให้ใช้ขอบเขตที่ไม่ละเอียดอ่อน เนื่องจากขอบเขตดังกล่าวให้สิทธิ์เข้าถึงระดับไฟล์และจำกัดการเข้าถึงเฉพาะฟีเจอร์ที่แอปต้องการ

Sheets API รองรับขอบเขตต่อไปนี้

รหัสขอบเขต คำอธิบาย การใช้งาน
https://www.googleapis.com/auth/spreadsheets ดู แก้ไข สร้าง และลบสเปรดชีต Google ชีตทั้งหมด ละเอียดอ่อน
https://www.googleapis.com/auth/spreadsheets.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 API อื่นๆ คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต Google API ได้ที่ การใช้ OAuth 2.0 เพื่อ เข้าถึง Google API

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