อนุญาตให้สคริปต์สร้างโทเค็นสถานะที่ใช้ใน API เรียกกลับได้ (เช่น โฟลว์ OAuth)
// Reusable function to generate a callback URL, assuming the script has been // published as a web app (necessary to obtain the URL programmatically). If the // script has not been published as a web app, set `var url` in the first line // to the URL of your script project (which cannot be obtained // programmatically). function getCallbackURL(callbackFunction) { let url = ScriptApp.getService().getUrl(); // Ends in /exec (for a web app) url = `${ url.slice(0, -4)}usercallback?state=`; // Change /exec to /usercallback const stateToken = ScriptApp.newStateToken() .withMethod(callbackFunction) .withTimeout(120) .createToken(); return url + stateToken; }
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
create | String | สร้างการแสดงสตริงที่เข้ารหัสของโทเค็นสถานะ |
with | State | เพิ่มอาร์กิวเมนต์ลงในโทเค็น |
with | State | ตั้งค่าฟังก์ชัน Callback |
with | State | กำหนดระยะเวลา (เป็นวินาที) ที่โทเค็นใช้งานได้ |
เอกสารโดยละเอียด
create Token()
สร้างการแสดงสตริงที่เข้ารหัสของโทเค็นสถานะ
const stateToken = ScriptApp.newStateToken().createToken();
รีเทิร์น
String - สตริงที่เข้ารหัสซึ่งแสดงโทเค็น
with Argument(name, value)
เพิ่มอาร์กิวเมนต์ลงในโทเค็น เรียกใช้เมธอดนี้ได้หลายครั้ง
const stateToken = ScriptApp.newStateToken().withArgument('myField', 'myValue').createToken();
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของอาร์กิวเมนต์ |
value | String | ค่าของอาร์กิวเมนต์ |
รีเทิร์น
State — เครื่องมือสร้างโทเค็นสถานะสำหรับการเชื่อมโยง
with Method(method)
ตั้งค่าฟังก์ชัน Callback ค่าเริ่มต้นคือฟังก์ชันชื่อ callback()
const stateToken = ScriptApp.newStateToken().withMethod('myCallback').createToken();
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
method | String | ชื่อของฟังก์ชันเรียกกลับ ซึ่งแสดงเป็นสตริงที่ไม่มีวงเล็บหรือ
อาร์กิวเมนต์ คุณสามารถใช้ฟังก์ชันจากไลบรารีที่รวมไว้ เช่น
Library.libFunction1 |
รีเทิร์น
State — เครื่องมือสร้างโทเค็นสถานะสำหรับการเชื่อมโยง
with Timeout(seconds)
กำหนดระยะเวลา (เป็นวินาที) ที่โทเค็นใช้งานได้ ค่าเริ่มต้นคือ 60 วินาที และระยะเวลาสูงสุดคือ 3,600 วินาที (1 ชั่วโมง)
const stateToken = ScriptApp.newStateToken().withTimeout(60).createToken();
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
seconds | Integer | ระยะเวลาที่โทเค็นใช้งานได้ โดยค่าสูงสุดคือ 3600 |
รีเทิร์น
State — เครื่องมือสร้างโทเค็นสถานะสำหรับการเชื่อมโยง