第六節課：理解 API 與 Gemini 的介紹

暖身問題： 你是否好奇網頁如何獲取即時資訊，例如天氣或新聞？這背後的秘密是 API。今天，我們將學習如何調用 API 並結合 Apps Script 實現功能。

教學目標

教學內容與操作步驟

1. 認識 API 並調用免費天氣 API


function getWeather() {
    const apiUrl = 'https://api.open-meteo.com/v1/forecast?latitude=25.033&longitude=121.565¤t_weather=true';
    const response = UrlFetchApp.fetch(apiUrl);
    const data = JSON.parse(response.getContentText());
    Logger.log("當前天氣：" + data.current_weather.temperature + "°C");
}

步驟：

  1. 將上述程式碼複製到 Google Apps Script 編輯器中。
  2. 執行程式，並檢查日誌輸出是否顯示天氣數據。
問題：如果要查詢另一個城市的天氣，例如東京（緯度 35.6895，經度 139.6917），應該修改哪部分程式碼？

2. 認識 Gemini API 並自動生成訊息


const GEMINI_API_KEY = '你的API密鑰';

function generateMessage() {
    const apiUrl = 'https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateMessage?key=' + GEMINI_API_KEY;
    const payload = {
        "prompt": {
            "text": "生成一段歡迎學習 Google Apps Script 的訊息。"
        }
    };
    const options = {
        "method": "post",
        "contentType": "application/json",
        "payload": JSON.stringify(payload)
    };
    const response = UrlFetchApp.fetch(apiUrl, options);
    const data = JSON.parse(response.getContentText());
    Logger.log("生成的訊息：" + data.candidates[0].content);
}

步驟：

  1. 將程式碼添加到 Apps Script 編輯器中。
  2. 替換 `GEMINI_API_KEY` 為你的實際 API 密鑰。
  3. 執行程式，並檢查日誌輸出是否顯示生成的訊息。
問題：如果希望生成一段描述天氣的訊息，應該如何修改 `prompt` 的內容？

課程延伸與挑戰

上一節課下一節課