Dodatki mogą mieć dostęp do ustawień regionalnych i strefy czasowej użytkownika, a także korzystać z tych informacji do dostosowywania interfejsu i działania. Musisz skonfigurować plik manifestu dodatku, aby zezwolić na dostęp do tych informacji.
Skonfiguruj plik manifestu dodatku
Możesz skonfigurować dodatek, aby uzyskać dostęp do informacji o regionie i strefie czasowej użytkownika, wykonując te czynności:
- W pliku pliku manifestu dodatku ustaw w polu
addOns.common.useLocaleFromAppwartośćtrue. - Jeśli nie istnieje, dodaj ten konkretny zakres do listy
oauthScopesw pliku manifestu:https://www.googleapis.com/auth/script.locale - Zapisz zmiany w pliku manifestu.
Jeśli zakres oauthScope został dodany do listy dodatku, użytkownicy będą musieli ponownie go autoryzować przy następnym otwarciu dodatku.
Uzyskiwanie informacji o regionie i strefie czasowej
Obiekty zdarzeń po prawidłowym skonfigurowaniu zbierają informacje o języku użytkownika. W strukturze commonEventObject obiektu zdarzenia znajdują się te pola:
commonEventObject.userLocale– identyfikator języka i kraju/regionu użytkownika, Na przykład:en-US.commonEventObject.timeZone.offset– przesunięcie strefy czasowej użytkownika (w milisekundach) od uniwersalnego czasu koordynowanego (UTC).commonEventObject.timeZone.id– identyfikator strefy czasowej użytkownika, Na przykład:America/New_York.commonEventObject.timeZone– identyfikator strefy czasowej użytkownika i przesunięcie.
Więcej informacji znajdziesz w sekcji Obiekty zdarzeń.
Obiekty zdarzeń są przekazywane do funkcji wywołania zwrotnego działania, gdy użytkownik korzysta z dodatku, oraz do funkcji na stronie głównej i kontekstowych reguł. Każda funkcja wywołania zwrotnego lub aktywatora może odczytywać informacje o regionie i strefie czasowej z obiektu zdarzenia i w razie potrzeby ich używać. Na przykład funkcja wywołania zwrotnego, która przechodzi do nowej karty, może odnosić się do ciągu tekstowego przy wyborze tekstu do dodania do karty.