Class StateTokenBuilder

StateTokenBuilder

סקריפטים יכולים ליצור אסימוני מצב שבהם אפשר להשתמש בממשקי 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){
  var url = ScriptApp.getService().getUrl();      // Ends in /exec (for a web app)
  url = url.slice(0, -4) + 'usercallback?state='; // Change /exec to /usercallback
  var stateToken = ScriptApp.newStateToken()
      .withMethod(callbackFunction)
      .withTimeout(120)
      .createToken();
  return url + stateToken;
}

שיטות

שיטהסוג הערך המוחזרתיאור קצר
createToken()Stringיוצר ייצוג של מחרוזת מוצפנת של אסימון המצב.
withArgument(name, value)StateTokenBuilderמוסיפה ארגומנט לאסימון.
withMethod(method)StateTokenBuilderמגדירה פונקציית קריאה חוזרת.
withTimeout(seconds)StateTokenBuilderמגדיר את משך הזמן (בשניות) שבו האסימון תקף.

מסמכי תיעוד מפורטים

createToken()

יוצרת ייצוג של מחרוזת מוצפנת של אסימון המצב.

var stateToken = ScriptApp.newStateToken().createToken();

חזרה

String – מחרוזת מוצפנת שמייצגת את האסימון


withArgument(name, value)

מוסיפה ארגומנט לאסימון. אפשר לקרוא לשיטה הזו כמה פעמים.

var stateToken = ScriptApp.newStateToken().withArgument('myField', 'myValue').createToken();

פרמטרים

שםסוגתיאור
nameStringשם הארגומנט
valueStringערך הארגומנט

חזרה

StateTokenBuilder – הכלי ליצירת אסימוני מצב לשרשורים


withMethod(method)

מגדירה פונקציית קריאה חוזרת. ברירת המחדל היא פונקציה בשם callback().

var stateToken = ScriptApp.newStateToken().withMethod('myCallback').createToken();

פרמטרים

שםסוגתיאור
methodStringהשם של פונקציית הקריאה החוזרת, שמיוצג כמחרוזת ללא סוגריים או ארגומנטים. תוכלו להשתמש בפונקציות מספריות כלולות, כמו Library.libFunction1.

חזרה

StateTokenBuilder – הכלי ליצירת אסימוני מצב לשרשורים


withTimeout(seconds)

מגדיר את משך הזמן (בשניות) שבו האסימון תקף. ברירת המחדל היא 60 שניות. ה משך הזמן המקסימלי הוא 3,600 שניות (שעה).

var stateToken = ScriptApp.newStateToken().withTimeout(60).createToken();

פרמטרים

שםסוגתיאור
secondsIntegerמשך הזמן שבו האסימון תקף. הערך המקסימלי הוא 3600

חזרה

StateTokenBuilder – הכלי ליצירת אסימוני מצב לשרשורים