Dodatki Google Workspace mogą mieć dostęp do lokalizacji i strefy czasowej użytkownika oraz używać tych informacji do dostosowywania interfejsu i zachowania. Musisz skonfigurować plik manifestu dodatku, aby umożliwić mu dostęp do tych informacji.
Konfigurowanie pliku manifestu dodatku
Aby skonfigurować dodatek tak, aby miał dostęp do informacji o lokalizacji i strefie czasowej użytkownika, wykonaj te czynności:
- W pliku manifestu dodatku ustaw pole
addOns.common.useLocaleFromAppnatrue. - Jeśli nie ma go jeszcze na liście, dodaj ten wyraźny zakres na liście
oauthScopesw pliku manifestu:https://www.googleapis.com/auth/script.locale
Jeśli dodasz zakres do listy oauthScope dodatku, użytkownicy będą musieli ponownie zatwierdzić ten dodatek przy następnym jego otwarciu.
Pobieranie informacji o lokalizacji i strefie czasowej
Obiekty zdarzeń przekazują informacje o lokalizacji użytkownika, jeśli są prawidłowo skonfigurowane. W podstrukturze commonEventObject obiektu zdarzenia występują 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 i przesunięcie strefy czasowej użytkownika.
Więcej informacji znajdziesz w sekcji Obiekty zdarzeń.
Obiekty zdarzenia są przekazywane do funkcji wywołania zwrotnego działania, gdy użytkownik wchodzi w interakcję z Twoim dodatkiem, oraz do funkcji strony głównej i kontekstowych funkcji wyzwalacza. Każda funkcja wywołania zwrotnego lub funkcji wywołania może odczytać informacje o lokalizacji i strefie czasowej z obiektu zdarzenia i użyć ich w razie potrzeby. Na przykład funkcja wywołania zwrotnego, która przechodzi do nowej karty, może odwoływać się do ciągu danych języka i regionu, aby zdecydować, jaki tekst dodać do karty.