Dodatki do Google Workspace mają dostęp do języka i strefy czasowej użytkownika te informacje, aby dostosować jego interfejs i działanie. Musisz skonfigurować manifest dodatku aby zezwolić dodatkowi na dostęp te informacje.
Skonfiguruj plik manifestu dodatku
Możesz skonfigurować dodatek tak, aby uzyskiwać dostęp do ustawień regionalnych użytkownika informacje o strefie czasowej wykonując te czynności:
- W pliku manifestu dodatku
ustaw wartość
addOns.common.useLocaleFromApp
dotrue
. - Jeśli jeszcze go tam nie ma, dodaj ten jawny zakres do
oauthScopes
w pliku manifestu lista:https://www.googleapis.com/auth/script.locale
Jeśli dodasz zakres do listy oauthScope
dodatku,
użytkownicy muszą ponownie autoryzować
dodatek
przy następnym uruchomieniu programu.
Uzyskiwanie informacji o regionie i strefie czasowej
Obiekty zdarzeń
przenoszenia informacji o języku użytkownika, jeśli jest on poprawnie skonfigurowany. Następujące pola
wyświetlają się w commonEventObject
podstruktura obiektu zdarzenia:
commonEventObject.userLocale
– język i kraj/region użytkownika. Na przykład:en-US
.commonEventObject.timeZone.offset
– przesunięcie strefy czasowej użytkownika w polu milisekund od uniwersalnego czasu koordynowanego (UTC).commonEventObject.timeZone.id
– identyfikator strefy czasowej użytkownika. Na przykład:America/New_York
.commonEventObject.timeZone
– identyfikator strefy czasowej i przesunięcie użytkownika.
Patrz sekcja Obiekty zdarzeń. .
Obiekty zdarzeń są przekazywane do funkcje wywołania zwrotnego działania po interakcji użytkownika z dodatkiem, a także na stronę główną i kontekstowe funkcji aktywujących. Każda funkcja wywołania zwrotnego lub aktywującego może odczytać informacje o regionie i strefie czasowej z obiektu zdarzenia oraz użyj ich w razie potrzeby. Na przykład funkcja wywołania zwrotnego, która jest otwieranie nowej karty może odnosić się do ciągu znaków języka przy wyborze tekstu, który ma zostać dodany do karty.