Dodatki mają dostęp do regionu i strefy czasowej użytkownika oraz mogą wykorzystać te informacje do dostosowania swojego interfejsu i działania. Aby umożliwić mu dostęp do tych informacji, musisz skonfigurować manifest dodatku.
Konfigurowanie pliku manifestu dodatku
Aby skonfigurować dodatek do informacji o języku i strefie czasowej użytkownika, wykonaj te czynności:
- W pliku manifestu dodatku ustaw pole
addOns.common.useLocaleFromAppnatrue. - Jeśli zakres nie jest już dostępny, dodaj ten wyraźny zakres do listy
oauthScopespliku manifestu:https://www.googleapis.com/auth/script.locale - Zapisz zmiany w pliku manifestu.
Jeśli dodasz zakres do listy oauthScope dodatku, użytkownicy będą musieli ponownie go autoryzować, gdy tylko zostanie on uruchomiony.
Uzyskiwanie informacji o lokalizacji i strefie czasowej
Po prawidłowym skonfigurowaniu obiekty zdarzeń przechowują informacje o języku użytkownika. Te pola są widoczne w podstrukturze commonEventObject obiektu zdarzenia:
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) względem 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.
Więcej informacji znajdziesz w sekcji Obiekty zdarzeń.
Obiekty zdarzeń są przekazywane do funkcji wywołania zwrotnego działań, gdy użytkownik wchodzi w interakcję z dodatkiem, a także do funkcji aktywatorów na stronie głównej i kontekstowych reguł. Każda funkcja wywołania zwrotnego lub aktywatora może odczytywać informacje o języku i strefie czasowej z obiektu zdarzenia i używać ich w razie potrzeby. Na przykład funkcja wywołania zwrotnego, która nawiguje do nowej karty, może odwoływać się do ciągu znaków języka podczas podejmowania decyzji o tym, jaki tekst dodać do karty.