Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 na true.
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.
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.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-12-22 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
