Komut dosyalarının, geri çağırma API'lerinde (OAuth akışları gibi) kullanılabilecek durum jetonları oluşturmasına olanak tanır.
// 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; }
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama | 
|---|---|---|
| create | String | Durum jetonunun şifrelenmiş dize temsilini oluşturur. | 
| with | State | Jetona bağımsız değişken ekler. | 
| with | State | Geri çağırma işlevi ayarlar. | 
| with | State | Jetonun geçerli olduğu süreyi (saniye cinsinden) ayarlar. | 
Ayrıntılı dokümanlar
create
Durum jetonunun şifrelenmiş dize temsilini oluşturur.
const stateToken = ScriptApp.newStateToken().createToken();
Return
String: Jetonu temsil eden şifrelenmiş bir dize
with
Jetona bağımsız değişken ekler. Bu yöntem birden çok kez çağrılabilir.
const stateToken = ScriptApp.newStateToken().withArgument('myField', 'myValue').createToken();
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| name | String | bağımsız değişkenin adı | 
| value | String | bağımsız değişkenin değeri | 
Return
State: zincirleme için durum jetonu oluşturucu
with
Geri çağırma işlevi ayarlar. Varsayılan değer callback() adlı bir işlevdir.
const stateToken = ScriptApp.newStateToken().withMethod('myCallback').createToken();
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| method | String | Geri çağırma işlevinin adı. Parantez veya bağımsız değişken içermeyen bir dize olarak temsil edilir. Dahil edilen kitaplıklardaki işlevleri (ör. 
    Library.libFunction1) kullanabilirsiniz. | 
Return
State: zincirleme için durum jetonu oluşturucu
with
Jetonun geçerli olduğu süreyi (saniye cinsinden) ayarlar. Varsayılan süre 60 saniyedir. Maksimum süre 3.600 saniyedir (1 saat).
const stateToken = ScriptApp.newStateToken().withTimeout(60).createToken();
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| seconds | Integer | jetonun geçerli olduğu süre; maksimum değer 3600'tür | 
Return
State: zincirleme için durum jetonu oluşturucu