Guia de início rápido da função personalizada

Você pode usar o Google Apps Script para escrever uma função personalizada e usá-la no Google Planilhas como uma função integrada.

O guia de início rápido a seguir cria uma função personalizada que calcula o preço promocional de itens com desconto. O preço promocional é formatado em dólares americanos.

Objetivos

  • Configure o script.
  • Execute o script.

Pré-requisitos

Para usar esta amostra, você precisa dos seguintes pré-requisitos:

  • Uma Conta do Google (as contas do Google Workspace podem exigir a aprovação do administrador).
  • Um navegador da Web com acesso à Internet.

Configurar o script

  1. Crie uma nova planilha.
  2. Na nova planilha, selecione o item de menu Extensões > Apps Script.
  3. Exclua qualquer código no editor de script e cole o código a seguir. Em seguida, clique em Salvar Ícone de um disquete, usado para salvar o projeto.

    /**
     * Calculates the sale price of a value at a given discount.
     * The sale price is formatted as US dollars.
     *
     * @param {number} input The value to discount.
     * @param {number} discount The discount to apply, such as .5 or 50%.
     * @return The sale price formatted as USD.
     * @customfunction
     */
    function salePrice(input, discount) {
      let price = input - (input * discount);
      let dollarUS = Intl.NumberFormat("en-US", {
        style: