사용자 언어 및 시간대 액세스

부가기능은 사용자의 언어와 시간대에 액세스하고 이 정보를 사용하여 인터페이스와 동작을 맞춤설정할 수 있습니다. 부가기능이 이 정보에 액세스할 수 있도록 부가기능의 매니페스트를 구성해야 합니다.

부가기능 매니페스트 구성

다음 단계에 따라 사용자 언어 및 시간대 정보에 액세스하도록 부가기능을 구성할 수 있습니다.

1. 부가기능의 매니페스트 파일에서 addOns.common.useLocaleFromApp 필드를 true로 설정합니다.
2. 다음 명시적 범위가 아직 없다면 매니페스트의 oauthScopes 목록에 다음 명시적 범위를 추가합니다. https://www.googleapis.com/auth/script.locale
3. 매니페스트 변경사항을 저장합니다.

부가기능의 oauthScope 목록에 범위를 추가한 경우 사용자는 다음에 부가기능을 열 때 부가기능을 다시 승인해야 합니다.

언어 및 시간대 정보 가져오기

이벤트 객체는 제대로 구성된 경우 사용자 언어 정보를 전달합니다. 다음 필드는 이벤트 객체의 commonEventObject 하위 구조에 표시됩니다.

• commonEventObject.userLocale: 사용자의 언어 및 국가/지역 식별자 예를 들면 다음과 같습니다. en-US
• commonEventObject.timeZone.offset: 협정 세계시(UTC)를 기준으로 한 사용자의 시간대 오프셋(단위: 밀리초)
• commonEventObject.timeZone.id: 사용자의 시간대 식별자입니다. 예를 들면 다음과 같습니다. America/New_York
• commonEventObject.timeZone: 사용자의 시간대 ID 및 오프셋입니다.

자세한 내용은 이벤트 객체를 참조하세요.

이벤트 객체는 사용자가 부가기능과 상호작용할 때 작업 콜백 함수, 홈페이지 및 컨텍스트 트리거 함수에 전달됩니다. 각 콜백 또는 트리거 함수는 이벤트 객체에서 언어 및 시간대 정보를 읽고 필요에 따라 사용할 수 있습니다. 예를 들어 새 카드로 이동하는 콜백 함수는 카드에 추가할 텍스트를 결정할 때 언어 문자열을 참조할 수 있습니다.