이 가이드에서는 부가기능이 사용자의 언어와 시간대를 가져온 다음 이 정보를 사용하여 인터페이스와 동작을 맞춤설정하는 방법을 설명합니다. Google Apps Script 관련 가이드는 Apps Script 개발자 문서의 사용자 언어 및 시간대 가져오기를 참조하세요.
부가기능의 배포 리소스 구성
부가기능이 사용자의 언어와 시간대를 가져올 수 있도록 허용하려면 부가기능의 배포 리소스를 구성합니다.
- 부가기능의 배포 리소스에서
addOns.common.useLocaleFromApp
필드를true
로 설정합니다. - 배포 리소스의
oauthScopes
목록에https://www.googleapis.com/auth/script.locale
승인 범위를 추가합니다. 이 범위는 부가기능에 사용자의 국가, 언어, 시간대를 볼 수 있는 권한을 부여합니다. - 업데이트된 배포 리소스를 저장합니다.
부가기능의 oauthScopes
목록에 범위를 추가한 후 사용자는 다음에 부가기능을 사용할 때 부가기능을 다시 승인해야 합니다.
언어 및 시간대 정보 가져오기
이벤트 객체에는 사용자 언어 정보가 포함되며, 이 정보는 다음 commonEventObject
속성에서 가져올 수 있습니다.
commonEventObject.userLocale
: 사용자의 언어 및 국가/지역 식별자. 예를 들어en-US
는 미국에서 사용되는 영어를 나타냅니다.commonEventObject.timeZone.offset
: 협정 세계시(UTC)를 기준으로 한 사용자의 시간대 오프셋(단위: 밀리초)입니다.commonEventObject.timeZone.id
: 사용자의 시간대 식별자입니다. 예를 들면America/New_York
입니다.commonEventObject.timeZone
: 사용자의 시간대 ID 및 오프셋입니다.
사용자가 부가기능과 상호작용(예: 버튼 클릭)할 때 이벤트 객체는 action
콜백 함수, homepageTrigger
함수, contextualTrigger
함수에 전달됩니다. 각 콜백 또는 트리거 함수는 이벤트 객체에서 언어 및 시간대 정보를 가져와 필요에 따라 사용할 수 있습니다. 예를 들어 새 카드로 이동하는 콜백 함수는 카드에 추가할 텍스트를 결정할 때 언어 문자열을 참조할 수 있습니다.