เลือกขอบเขต 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 ของผู้ใช้

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

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

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

  • จำกัด: ขอบเขตเหล่านี้ให้สิทธิ์เข้าถึงข้อมูลผู้ใช้ Google ในวงกว้างและ กำหนดให้คุณต้องผ่านกระบวนการยืนยันขอบเขตที่จำกัด ดูข้อมูลเกี่ยวกับข้อกำหนดนี้ได้ที่นโยบายข้อมูลผู้ใช้ของบริการ Google API และข้อกำหนดเพิ่มเติมสำหรับขอบเขต API เฉพาะ หากคุณจัดเก็บ (หรือส่ง) ข้อมูลขอบเขตที่จำกัดไว้ในเซิร์ฟเวอร์ คุณจะต้อง เข้ารับการประเมินความปลอดภัย

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

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