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

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

부가기능 매니페스트 구성

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

  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 및 오프셋입니다.

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

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