Class AuthorizationInfo

AuthorizationInfo

Obiekt używany do określenia, czy użytkownik musi upoważnić ten skrypt do korzystania z co najmniej 1 usługi oraz podać adres URL okna dialogowego autoryzacji. Jeśli skrypt jest opublikowany jako dodatek, który korzysta z instalacyjnych reguł, możesz wykorzystać te informacje do kontrolowania dostępu do sekcji kodu, w przypadku których użytkownicy nie mają wymaganych uprawnień. Dodatek może też poprosić użytkownika o otwarcie adresu URL w celu rozwiązania problemu z oknem autoryzacji.

Ten obiekt jest zwracany przez ScriptApp.getAuthorizationInfo(authMode). Prawie wszystkie skrypty powinny wywoływać metodę ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), bo żaden inny tryb autoryzacji nie wymaga od użytkowników autoryzacji.

Metody

MetodaZwracany typKrótki opis
getAuthorizationStatus()AuthorizationStatusPobiera wartość, która wskazuje, czy użytkownik musi upoważnić ten skrypt do korzystania z jednej lub wielu usług (na przykład ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringPobiera adres URL autoryzacji, którego można użyć do przyznania dostępu do skryptu.

Szczegółowa dokumentacja

getAuthorizationStatus()

Pobiera wartość, która wskazuje, czy użytkownik musi upoważnić ten skrypt do korzystania z jednej lub wielu usług (na przykład ScriptApp.AuthorizationStatus.REQUIRED).

// Log the authorization status (REQUIRED or NOT_REQUIRED).
var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Zwróć

AuthorizationStatus – stan autoryzacji;


getAuthorizationUrl()

Pobiera adres URL autoryzacji, którego można użyć do przyznania dostępu do skryptu. Ta metoda zwraca wartość null, jeśli autoryzacja nie jest wymagana. Strona pod danym adresem URL zostanie automatycznie zamknięta, jeśli dostęp do niej będzie możliwy, a skrypt nie będzie wymagał autoryzacji.

// Log the URL used to grant access to the script.
var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

Zwróć

String – adres URL, którego można użyć do autoryzacji skryptu;