Esta página foi traduzida pela API Cloud Translation.

Class StateTokenBuilder

Permite que os scripts criem tokens de estado que podem ser usados em APIs de callback (como fluxos 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;
}

Métodos

Método	Tipo de retorno	Breve descrição
`createToken()`	`String`	Constrói uma representação de string criptografada do token de estado.
`withArgument(name, value)`	`StateTokenBuilder`	Adiciona um argumento ao token.
`withMethod(method)`	`StateTokenBuilder`	Define uma função de retorno de chamada.
`withTimeout(seconds)`	`StateTokenBuilder`	Define a duração (em segundos) da validade do token.

Documentação detalhada

`createToken()`

Constrói uma representação de string criptografada do token de estado.

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

Retornar

String: uma string criptografada que representa o token.

`withArgument(name, value)`

Adiciona um argumento ao token. Esse método pode ser chamado várias vezes.

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

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do argumento
`value`	`String`	o valor do argumento

Retornar

StateTokenBuilder: o builder de token de estado para encadeamento

`withMethod(method)`

Define uma função de retorno de chamada. O padrão é uma função chamada callback().

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

Parâmetros

Nome	Tipo	Descrição
`method`	`String`	O nome da função de retorno de chamada, representado como uma string sem parênteses ou . É possível usar funções de bibliotecas incluídas, como `Library.libFunction1`.

Retornar

StateTokenBuilder: o builder de token de estado para encadeamento

`withTimeout(seconds)`

Define a duração (em segundos) da validade do token. O padrão é 60 segundos. as duração máxima de 3.600 segundos (1 hora).

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

Parâmetros

Nome	Tipo	Descrição
`seconds`	`Integer`	a duração da validade do token; o valor máximo é `3600`

Retornar

StateTokenBuilder: o builder de token de estado para encadeamento