Pobierz język i strefę czasową użytkownika

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:

  1. W pliku manifestu dodatku ustaw pole addOns.common.useLocaleFromApp na true.
  2. 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.