사용자 언어 및 시간대 가져오기

Google Workspace 부가기능은 사용자의 언어 및 시간대에 액세스하여 해당 정보를 사용하여 인터페이스와 동작을 맞춤설정합니다. VM 인스턴스 부가기능의 매니페스트 부가기능에서 확인할 수 있습니다

부가기능 매니페스트 구성

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

  1. 부가기능의 매니페스트 파일에서 <ph type="x-smartling-placeholder">addOns.common.useLocaleFromApp</ph> 필드를 true로 변경합니다.
  2. 아직 없는 경우 다음 명시적 범위를 매니페스트의 oauthScopes list: 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 및 오프셋입니다.

이벤트 객체를 참고하세요. 를 참조하세요.

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