Google Workspace 부가기능은 사용자의 언어 및 시간대에 액세스하고 이 정보를 사용하여 인터페이스와 동작을 맞춤설정할 수 있습니다. 부가기능이 이 정보에 액세스할 수 있도록 하려면 부가기능의 매니페스트를 구성해야 합니다.
부가기능 매니페스트 구성
다음 단계에 따라 사용자 언어 및 시간대 정보에 액세스하도록 부가기능을 구성할 수 있습니다.
- 부가기능의 매니페스트 파일에서
addOns.common.useLocaleFromApp
필드를true
로 설정합니다. - 아직 없는 경우 매니페스트의
oauthScopes
목록에 다음과 같은 명시적 범위를 추가합니다.https://www.googleapis.com/auth/script.locale
부가기능의 oauthScope
목록에 범위를 추가한 경우 다음에 부가기능을 열 때 사용자가 부가기능을 재승인해야 합니다.
언어 및 시간대 정보 가져오기
이벤트 객체는 올바르게 구성된 경우 사용자 언어 정보를 전달합니다. 다음 필드는 이벤트 객체의 commonEventObject
하위 구조에 표시됩니다.
commonEventObject.userLocale
: 사용자의 언어 및 국가/지역 식별자입니다. 예를 들면en-US
입니다.commonEventObject.timeZone.offset
: 사용자의 시간대 오프셋(협정 세계시(UTC) 기준, 밀리초)입니다.commonEventObject.timeZone.id
: 사용자의 시간대 식별자입니다. 예를 들면America/New_York
입니다.commonEventObject.timeZone
: 사용자의 시간대 ID 및 오프셋입니다.
자세한 내용은 이벤트 객체를 참고하세요.
이벤트 객체는 사용자가 부가기능과 상호작용할 때 작업 콜백 함수에 전달되며 홈페이지 및 문맥 트리거 함수에도 전달됩니다. 각 콜백 또는 트리거 함수는 이벤트 객체에서 언어 및 시간대 정보를 읽고 필요에 따라 사용할 수 있습니다. 예를 들어 새 카드로 이동하는 콜백 함수는 카드에 추가할 텍스트를 결정할 때 언어 문자열을 참조할 수 있습니다.