Dodatki Google Workspace mogą mieć dostęp do lokalizacji i strefy czasowej użytkownika oraz używać tych informacji do dostosowywania interfejsu i działania. 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.useLocaleFromApp
natrue
. - Jeśli go tam nie ma, dodaj ten wyraźny zakres na liście
oauthScopes
w 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ń zawierają 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 dodatkiem, oraz do funkcji strony głównej i kontekstowych funkcji wyzwalacza. Każda funkcja wywołania lub funkcji wyzwalającej 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ęzykowych, aby zdecydować, jaki tekst dodać do karty.