Class StateTokenBuilder

StateTokenBuilder

스크립트가 OAuth 흐름과 같은 콜백 API에 사용할 수 있는 상태 토큰을 만들도록 허용합니다.

// 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초 (1시간)입니다.

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

매개변수

이름유형설명
secondsInteger토큰이 유효한 기간. 최댓값은 3600입니다.

리턴

StateTokenBuilder - 체이닝을 위한 상태 토큰 빌더