หน้านี้ได้รับการแปลโดย Cloud Translation API

Class AuthorizationInfo

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

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

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

เมธอด

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

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

`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 — 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[] — รายการขอบเขตที่ได้รับอนุญาต