Class AuthorizationInfo

ข้อมูลการให้สิทธิ์

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

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

ScriptApp.getAuthorizationInfo(authMode) จะส่งคืนออบเจ็กต์นี้ ในเกือบทุกกรณี สคริปต์ควรเรียกใช้ ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) เนื่องจากโหมดการให้สิทธิ์อื่นๆ ไม่ได้กำหนดให้ผู้ใช้ต้องให้สิทธิ์

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getAuthorizationStatus()AuthorizationStatusรับค่าที่ระบุว่าผู้ใช้ต้องให้สิทธิ์สคริปต์นี้เพื่อใช้บริการอย่างน้อย 1 รายการ (เช่น ScriptApp.AuthorizationStatus.REQUIRED) หรือไม่
getAuthorizationUrl()String|nullรับ URL การให้สิทธิ์ที่ใช้ให้สิทธิ์เข้าถึงสคริปต์ได้
getAuthorizedScopes()String[]|nullรับรายการขอบเขตที่ได้รับอนุญาตสำหรับสคริปต์

เอกสารโดยละเอียด

getAuthorizationStatus()

รับค่าที่ระบุว่าผู้ใช้ต้องให้สิทธิ์สคริปต์นี้เพื่อใช้บริการอย่างน้อย 1 รายการ (เช่น ScriptApp.AuthorizationStatus.REQUIRED) หรือไม่ 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

รีเทิร์น

AuthorizationStatus — สถานะการให้สิทธิ์

getAuthorizationUrl()

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

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

รีเทิร์น

String|null - URL ที่ใช้ให้สิทธิ์สคริปต์ได้

getAuthorizedScopes()

รับรายการขอบเขตที่ได้รับอนุญาตสำหรับสคริปต์ หากมีการขอข้อมูลการให้สิทธิ์สำหรับ รายการขอบเขตที่ระบุ ระบบจะแสดงขอบเขตที่ได้รับอนุญาตจากรายการที่ระบุ 

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

รีเทิร์น

String[]|null — รายการขอบเขตที่ได้รับอนุญาต