Class Browser

브라우저

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

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

참고 항목

속성

속성유형설명
ButtonsButtonSet

메서드

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

자세한 문서

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|null - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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|null - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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|null - 사용자가 입력한 텍스트입니다 (취소되거나 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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|null - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (또는 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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|null - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (또는 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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|null - 사용자가 클릭한 버튼의 소문자 텍스트입니다 (또는 닫힌 대화상자의 경우 'cancel').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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