ออบเจ็กต์ที่ใช้พิจารณาว่าผู้ใช้ต้องอนุญาตให้สคริปต์นี้ใช้บริการอย่างน้อย 1 รายการหรือไม่ และระบุ URL สำหรับกล่องโต้ตอบการให้สิทธิ์ หากเผยแพร่สคริปต์เป็นส่วนเสริมที่ใช้ทริกเกอร์ที่ติดตั้งได้ ก็จะใช้ข้อมูลนี้เพื่อควบคุมการเข้าถึงส่วนต่างๆ ของโค้ดที่ผู้ใช้ขาดการให้สิทธิ์ที่จำเป็นได้ หรืออีกวิธีหนึ่ง ส่วนเสริมสามารถขอให้ผู้ใช้เปิด URL ของกล่องโต้ตอบการให้สิทธิ์เพื่อแก้ไขปัญหา
ออบเจ็กต์นี้แสดงผลโดย ScriptApp.getAuthorizationInfo(authMode) ในเกือบทุกกรณี สคริปต์ควรเรียกใช้ ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) เนื่องจากโหมดการให้สิทธิ์อื่นๆ ไม่จำเป็นต้องมีการให้สิทธิ์ผู้ใช้
วิธีการ
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
getAuthorizationStatus() | AuthorizationStatus | รับค่าที่ระบุว่าผู้ใช้ต้องอนุญาตให้สคริปต์นี้ใช้บริการอย่างน้อย 1 รายการหรือไม่ (เช่น ScriptApp.AuthorizationStatus.REQUIRED) |
getAuthorizationUrl() | String | รับ URL การให้สิทธิ์ที่สามารถใช้เพื่อให้สิทธิ์เข้าถึงสคริปต์ |
เอกสารประกอบโดยละเอียด
getAuthorizationStatus()
รับค่าที่ระบุว่าผู้ใช้ต้องอนุญาตให้สคริปต์นี้ใช้บริการอย่างน้อย 1 รายการหรือไม่ (เช่น ScriptApp.AuthorizationStatus.REQUIRED)
// Log the authorization status (REQUIRED or NOT_REQUIRED). var 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. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
รีเทิร์น
String — URL ที่ใช้เพื่อให้สิทธิ์สคริปต์ได้