Tutorial: Planilha de Ações Automática no Google Sheets com Apps Script

/**
 * Busca dados de uma ação na API da brapi.dev
 *
 * @param {string} ticker O código da ação (ex: "PETR4").
 * @param {string} atributo O dado desejado: "price", "change", "pl", "dy", "sector".
 * @return O valor do dado solicitado.
 * @customfunction
 */
function BRAPI(ticker, atributo) {
  if (!ticker) return "Ticker vazio";
  
  // SEU TOKEN AQUI (Pegue em https://brapi.dev)
  var token = "SEU_TOKEN_AQUI"; 
  
  // Cache para evitar chamar a API repetidamente para o mesmo ticker na mesma execução
  var cache = CacheService.getScriptCache();
  var cacheKey = ticker + "_" + atributo;
  var cached = cache.get(cacheKey);
  
  if (cached != null) {
    return isNaN(cached) ? cached : parseFloat(cached);
  }
  
  var url = "https://brapi.dev/api/quote/" + ticker + "?token=" + token + "&fundamental=true";
  
  try {
    var response = UrlFetchApp.fetch(url);
    var json = JSON.parse(response.getContentText());
    var stock = json.results[0];
    
    var valor = "";
    
    // Mapeamento de atributos
    switch(atributo.toLowerCase()) {
      case "price":
        valor = stock.regularMarketPrice;
        break;
      case "change":
        valor = stock.regularMarketChangePercent;
        break;
      case "pl":
        valor = stock.fundamentals.priceToEarnings;
        break;
      case "dy":
        valor = stock.fundamentals.dividendYield;
        break;
      case "pvp":
        valor = stock.fundamentals.priceToBook;
        break;
      case "sector":
        valor = stock.sector;
        break;
      default:
        return "Atributo inválido. Use: price, change, pl, dy, pvp, sector";
    }
    
    // Salva no cache por 10 minutos (600 segundos) para economizar requisições
    cache.put(cacheKey, String(valor), 600);
    
    return valor;
    
  } catch (e) {
    return "Erro: " + e.message;
  }
}