Class Browser

브라우저

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

이 클래스의 메서드는 Google Sheets의 컨텍스트에서만 사용할 수 있습니다. 대신 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'.
const 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'.
const 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'.
const 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