Class AuthorizationInfo

AutoryzacjaInformacje

Obiekt, który sprawdza, czy użytkownik udzielił autoryzacji dla wymaganych zakresów skryptu. Obiekt zawiera też adres URL autoryzacji, który umożliwia użytkownikom przyznanie tych uprawnień.

Niektóre skrypty mogą się uruchamiać bez zgody użytkownika na wszystkie wymagane zakresy skryptu. Informacje w tym obiekcie umożliwiają kontrolowanie dostępu do sekcji kodu, które wymagają określonych zakresów, oraz żądanie autoryzacji tych zakresów na potrzeby kolejnych wykonań.

Ten obiekt jest zwracany przez ScriptApp.getAuthorizationInfo(authMode). W prawie wszystkich przypadkach skrypty powinny wywoływać funkcję ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), ponieważ żaden inny tryb autoryzacji nie wymaga autoryzacji przez użytkowników.

Metody

MetodaZwracany typKrótki opis
getAuthorizationStatus()AuthorizationStatusPobiera wartość wskazującą, czy użytkownik musi autoryzować ten skrypt do korzystania z co najmniej 1 usługi (na przykład ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringPobiera adres URL autoryzacji, którego można użyć do przyznania dostępu do skryptu.
getAuthorizedScopes()String[]Pobiera listę autoryzowanych zakresów skryptu.

Szczegółowa dokumentacja

getAuthorizationStatus()

Pobiera wartość wskazującą, czy użytkownik musi autoryzować ten skrypt do korzystania z co najmniej 1 usługi (na przykład ScriptApp.AuthorizationStatus.REQUIRED). 

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

Powrót

AuthorizationStatus – stan autoryzacji

getAuthorizationUrl()

Pobiera adres URL autoryzacji, którego można użyć do przyznania dostępu do skryptu. Ta metoda zwracanull, jeśli nie jest wymagana autoryzacja. Strona pod tym adresem URL zostanie automatycznie zamknięta, jeśli ktoś ją otworzy, a skrypt nie będzie wymagał autoryzacji. 

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

Powrót

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

getAuthorizedScopes()

Pobiera listę autoryzowanych zakresów skryptu. Jeśli żądane są informacje autoryzacyjne dotyczące określonej listy zakresów, zwraca autoryzowane zakresy z tej listy. 

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

Powrót

String[] – lista autoryzowanych zakresów.