Class Browser

브라우저

이 클래스는 Google 시트 관련 대화상자에 대한 액세스를 제공합니다.

이 클래스의 메서드는 Google 스프레드시트의 컨텍스트에서만 사용할 수 있습니다. 대신 Google Workspace 대화상자를 사용하세요.

참고 항목

속성

속성유형설명
ButtonsButtonSet

방법

메서드반환 유형간략한 설명
inputBox(prompt)String사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.
inputBox(prompt, buttons)String사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.
inputBox(title, prompt, buttons)String사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.
msgBox(prompt)String사용자의 브라우저에 지정된 메시지와 확인 버튼이 있는 대화상자를 표시합니다.
msgBox(prompt, buttons)String사용자의 브라우저에 주어진 메시지와 지정된 버튼이 있는 대화상자를 표시합니다.
msgBox(title, prompt, buttons)String사용자의 브라우저에서 주어진 제목, 메시지, 지정된 버튼이 있는 대화상자를 표시합니다.

자세한 문서

inputBox(prompt)

사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.

inputBox 메서드는 사용자에게 지정된 프롬프트를 표시하는 클라이언트 측 입력 상자를 발생시킵니다. 이 함수로 인해 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
이 방법은 권장되지 않습니다. 대신 UI 프롬프트를 사용하세요.

매개변수

이름유형설명
promptString대화상자에 표시되는 텍스트입니다.

리턴

String - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우에는 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.

inputBox 메서드는 사용자에게 지정된 메시지를 표시하는 클라이언트 측 입력 상자를 표시하고 표시할 버튼 옵션을 제공합니다. 이 함수로 인해 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
이 방법은 권장되지 않습니다. 대신 UI 프롬프트를 사용하세요.

매개변수

이름유형설명
promptString대화상자에 표시되는 텍스트입니다.
buttonsButtonSet사용하도록 설정된 버튼 유형입니다.

리턴

String - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우에는 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

사용자의 브라우저에 텍스트 입력 상자가 있는 대화상자를 표시합니다.

inputBox 메서드는 지정된 제목으로 클라이언트 측 입력 상자를 발생시켜, 사용자에게 지정된 프롬프트를 표시하고, 표시할 버튼 옵션을 제공합니다. 이 함수를 사용하면 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
이 방법은 권장되지 않습니다. 대신 UI 프롬프트를 사용하세요.

매개변수

이름유형설명
titleString대화상자의 제목입니다.
promptString대화상자에 표시되는 텍스트입니다.
buttonsButtonSet사용하도록 설정된 버튼 유형입니다.

리턴

String - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우에는 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

사용자의 브라우저에 지정된 메시지와 확인 버튼이 있는 대화상자를 표시합니다.

msgBox 메서드는 지정된 메시지를 사용자에게 표시하는 클라이언트 측 메시지 상자를 발생시킵니다. 이 방법을 사용하면 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
이 방법은 권장되지 않습니다. 대신 UI 알림 대화상자를 사용하세요.

매개변수

이름유형설명
promptString대화상자에 표시되는 텍스트입니다.

리턴

String - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (닫힌 대화상자의 경우 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

사용자의 브라우저에 주어진 메시지와 지정된 버튼이 있는 대화상자를 표시합니다.

msgBox 메서드는 사용자에게 지정된 메시지를 표시하는 클라이언트 측 메시지 상자를 발생시키고 표시할 버튼 선택을 제공합니다. 이 메서드를 사용하면 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below displays "hello world" in a dialog box with OK and Cancel buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
이 방법은 권장되지 않습니다. 대신 UI 알림 대화상자를 사용하세요.

매개변수

이름유형설명
promptString대화상자에 표시되는 텍스트입니다.
buttonsButtonSet사용하도록 설정된 버튼 유형입니다.

리턴

String - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (닫힌 대화상자의 경우 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

사용자의 브라우저에서 주어진 제목, 메시지, 지정된 버튼이 있는 대화상자를 표시합니다.

msgBox 메서드는 지정된 제목으로 클라이언트 측 메시지 상자를 표시하여 사용자에게 지정된 메시지를 표시하고 표시할 버튼 옵션을 제공합니다. 이 메서드를 사용하면 서버 측 스크립트가 정지됩니다. 사용자가 대화상자를 지우면 자동으로 다시 시작되지만 JDBC 연결은 정지 기간 동안 유지되지 않습니다.

// The code below displays "hello world" in a dialog box with a custom title and Yes and
// No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
이 방법은 권장되지 않습니다. 대신 UI 알림 대화상자를 사용하세요.

매개변수

이름유형설명
titleString대화상자의 제목입니다.
promptString대화상자에 표시되는 텍스트입니다.
buttonsButtonSet사용하도록 설정된 버튼 유형입니다.

리턴

String - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (닫힌 대화상자의 경우 '취소').

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets