Class AuthorizationInfo

AutoryzacjaInformacje

Obiekt, który sprawdza, czy użytkownik przyznał autoryzację w wymaganych zakresach skryptu. Obiekt zawiera też adres URL autoryzacji, który umożliwia użytkownikom przyznanie tych uprawnień.

Niektóre skrypty mogą być uruchamiane bez zgody użytkownika na wszystkie wymagane zakresy używane przez skrypt. 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 w przypadku kolejnych wykonań.

Ten obiekt jest zwracany przez ScriptApp.getAuthorizationInfo(authMode). W większości przypadków skrypty powinny wywoływać ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), ponieważ żaden inny tryb autoryzacji nie wymaga od użytkowników przyznania autoryzacji.

Metody

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

Szczegółowa dokumentacja

getAuthorizationStatus()

Zwraca wartość wskazującą, czy użytkownik musi autoryzować ten skrypt, aby używać co najmniej 1 usługi (np. 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 zwraca wartość null, jeśli autoryzacja nie jest wymagana. Strona pod adresem URL zamknie się automatycznie, jeśli uzyskasz do niej dostęp, a skrypt nie będzie wymagać żadnej 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|null – adres URL, którego można użyć do autoryzacji skryptu.

getAuthorizedScopes()

Pobiera listę autoryzowanych zakresów skryptu. Jeśli informacje o autoryzacji są wymagane w przypadku 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[]|null – lista autoryzowanych zakresów.