跳到主要內容

[Python+LINE Bot教學]6步驟快速上手LINE Bot機器人

python_line_bot
Photo by Yura Fresh on Unsplash
每當朋友或家人要聚餐時,是不是總要花很長的時間尋找評價不錯的餐廳?不但要確認營業時間、消費價格及地點,還要觀看許多的美食文章才有辦法決定,這時候如果有人能夠明確提供幾間符合條件且有人氣的餐廳作為選擇,想必會省事許多。

所以筆者開發了一個美食的LINE Bot小作品,透過對談的方式瞭解使用者所要尋找的餐廳條件後,利用Python網頁爬蟲取得目前正在營業的五間最高人氣餐廳資料,回覆給使用者作為參考。

為了要讓想學習的您能夠由淺入深,瞭解其中的實作過程,所以將會分成三篇文章來進行教學。

2020/06/30補充說明
而在進行實作前,先來看一下LINE Bot主要的執行架構,如下圖:
python_line_bot
使用者透過LINE發送訊息時,LINE Platform將會進行接收,並且傳遞至我們所開發的LINE Bot執行邏輯運算後,透過LINE所提供的Messaging API回應訊息給LINE Platform,最後再將訊息傳遞給使用者。

其中Messaging API(Application Programming Interface),就是LINE官方定義的回應訊息標準介面,包含Text(文字)、Sticker(貼圖)、Video(影片)、Audio(聲音)及Template(樣板)訊息等,完整的說明可以參考LINE官方文件

所以在我們的LINE Bot回應訊息時,就要依據Messaging API定義的規範,傳入相應的參數後,Messaging API就會回應使用者相對的訊息類型。簡單來說,就是LINE PlatformLINE Bot的溝通橋樑。

而本文就先以最基本的使用者發送什麼訊息,LINE Bot就回應什麼訊息為例,讓讀者體會其中的運作方式,整體架構如下圖:
python_line_bot
LINE Bot的部分,使用Django框架來進行建置,並且透過Messaging API回應Text(文字)訊息。在下一篇文章中,將會加入Python網頁爬蟲,取得美食網站的資訊回應給使用者。

本文的實作步驟包含:
  • 建立Provider
  • 建立Messaging API channel
  • 設定LINE Bot憑證
  • 開發LINE Bot應用程式
  • 安裝Ngrok
  • 設定LINE Webhook URL

一、建立Provider

要開發LINE Bot前,首先需建立一個Provider,也就是服務提供者,主要用來讓LINE官方能夠識別這個LINE Bot是誰提供的,可以是個人、公司或服務名稱等

前往LINE Developers,「使用LINE帳號登入」後,會看到如下圖的畫面,輸入姓名及電子郵件即可,目的在於讓開發人員同意使用規範與聯絡使用:
python_line_bot
完成帳戶的建立,就會看到開發者控制台,如下圖:
python_line_bot
其中的三個圖示說明了開發流程,分別為「建立服務提供者(Provider)「建立頻道(Channel)「連結應用程式(APP)

第一步驟就是建立服務提供者(Provider),所以點擊「Create a new provider」,在按鈕下方就會出現輸入框,如下圖:
python_line_bot
這邊可以輸入姓名、公司或服務名稱等,LINE並沒有限定,點擊「Create」按鈕後,就會來到第二步驟,建立頻道(Channel)的畫面,如下圖:
python_line_bot

二、建立Messaging API channel

各位可以把頻道(Channel)想像是服務提供者(Provider)所建立的LINE帳號,藉此和使用者互動與傳遞訊息。

由於本文所建立的LINE Bot主要以傳訊息為主,所以選擇「Create a Messaging API channel。接著,會看到基本資料的輸入畫面,截取部分如下圖:
python_line_bot
python_line_bot
其中的Channel iconLINE帳號的大頭貼,之後的「Privacy policy URL」「Terms of use URL」可選擇性填寫,沒有的話保持空白即可。建立成功後,就可以看到如下畫面:
python_line_bot
最後的步驟就是要將這個頻道(Channel)與自己開發的應用程式連結,所以其中有兩個憑證會使用到,如下:
  • Channel secret(頻道密碼):位於Basic settings頁籤中,如下圖:
python_line_bot
  • Channel access token(頻道憑證):位於Messaging API頁籤中,要按下右方的「Issue」按鈕才會出現,如下圖:
python_line_bot

三、設定LINE Bot憑證

本文將以Django框架為例,利用Python來建置LINE Bot應用程式(APP)。首先,透過以下指令安裝會使用到的Python套件
$ pip install django

$ pip install line-bot-sdk

$ pip install beautifulsoup4

$ pip install requests
接著,建立Django專案應用程式資料庫遷移(Migration),其中詳細的觀念可以點擊連結參考之前所寫的部落格文章。如下指令
$ django-admin startproject mylinebot .  #建立Django專案

$ python manage.py startapp foodlinebot  #建立Django應用程式

$ python manage.py migrate  #值型資料遷移(Migration)
這時候的專案架構如下圖:
python_line_bot
開啟專案主程式下的settings.py檔案,增加LINE Developers上所取得的兩個憑證設定,來LINE頻道(Channel)進行連結如下範例
LINE_CHANNEL_ACCESS_TOKEN = 'Messaging API的Channel access token'

LINE_CHANNEL_SECRET = 'Basic settings的Channel Secret'
並且,在INSTALL_APPS的地方,加上剛剛所建立的Django應用程式(APP)如下範例
# Application definition
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    'foodlinebot.apps.FoodlinebotConfig',
]

四、開發LINE Bot應用程式

設定完成後,開啟Django應用程式(APP)views.py檔案,這邊就是撰寫LINE Bot接收訊息後,所要執行的運算邏輯,這邊先以使用者發送什麼訊息,就回覆什麼訊息為例,來測試Django應用程式(APP)能夠成功的和LINE頻道(Channel)進行連結,如下範例
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseBadRequest, HttpResponseForbidden
from django.views.decorators.csrf import csrf_exempt
from django.conf import settings

from linebot import LineBotApi, WebhookParser
from linebot.exceptions import InvalidSignatureError, LineBotApiError
from linebot.models import MessageEvent, TextSendMessage

line_bot_api = LineBotApi(settings.LINE_CHANNEL_ACCESS_TOKEN)
parser = WebhookParser(settings.LINE_CHANNEL_SECRET)


@csrf_exempt
def callback(request):

    if request.method == 'POST':
        signature = request.META['HTTP_X_LINE_SIGNATURE']
        body = request.body.decode('utf-8')

        try:
            events = parser.parse(body, signature)  # 傳入的事件
        except InvalidSignatureError:
            return HttpResponseForbidden()
        except LineBotApiError:
            return HttpResponseBadRequest()

        for event in events:
            if isinstance(event, MessageEvent):  # 如果有訊息事件
                line_bot_api.reply_message(  # 回復傳入的訊息文字
                    event.reply_token,
                    TextSendMessage(text=event.message.text)
                )
        return HttpResponse()
    else:
        return HttpResponseBadRequest()
這邊幾個地方說明一下,第10、11行為取得settings.py中的LINE Bot憑證來進行Messaging API的驗證。

而在callback檢視函式中,當偵測到使用者有傳入的事件,就會透過Python迴圈進行讀取(第28行),如果其中有訊息事件(第29行),則回覆使用者所傳入的文字(第30~33行)。

接下來就要設定這個LINE Bot應用程式(APP)的連結網址,所以在Django應用程式(APP)下建立一個urls.py檔案,加入以下的網址設定
from django.urls import path
from . import views

urlpatterns = [
    path('callback', views.callback)
]
而為了要將這個Django應用程式(APP)的網址也加入到專案主程式中,所以,在Django專案主程式下的urls.py檔案中,加入以下的網址設定
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('foodlinebot/', include('foodlinebot.urls')) #包含應用程式的網址
]

五、安裝Ngrok

LINE Bot應用程式(APP)都完備後,接下來就要讓網址能夠公開(Public)且具有HTTPSLINE頻道(Channel)才有辦法連結。

這時候除了可以將LINE Bot應用程式(APP)部署到像Heroku雲端平台,擁有對外公開的HTTPS網址外,還可以使用一個非常強大的工具-Ngrok

Ngrok簡單來說,就是能夠將你本機的IP埠號(http://127.0.0.1:8000),對應到一個隨機產生的HTTPS網址,並且這個HTTPS網址是對外公開的(Public)的,這時候外部使用者只要透過這個HTTPS網址,就能夠存取本機所運行的服務,是不是非常的強大阿。

首先,前往Ngrok官網,如下圖:
python_line_bot
點擊「Get started for free」後,會需要註冊一個帳戶,接著就會看到如下圖的畫面:
python_line_bot
依據作業系統進行下載即可,而這邊要特別注意的是,在下方會有專屬於你的憑證(Token),如下圖:
python_line_bot
將下載的檔案解壓縮,並且執行後,需要輸入以下的指令進行驗證
$ ngrok authtoken <YOUR TOKEN>
接著,就可以透過Ngrok,將本機的埠號對外公開,以本文為例,Django在本機運行的埠號為8000,所以輸入以下的指令
$ ngrok http 8000
執行結果
python_line_bot
Ngrok就會隨機產生一個HTTPS的網址,只要把這個網址填入LINE Webhook URL,以及LINE Bot應用程式(APP) settings.py檔案中的ALLOWED_HOSTS,如下範例,LINE頻道(Channel)就能夠與LINE Bot應用程式(APP)互相連結:
ALLOWED_HOSTS = [
    'cf3fb14f6910.ngrok.io'  #允許的網域名稱
]
接著,利用以下的指令執行LINE Bot應用程式(APP)
$ python manage.py runserver

六、設定LINE Webhook URL

2020/06/30補充說明
在一般的網路世界中,用戶端(Client)會發送請求(Request)給伺服器端(Server),處理完商業邏輯後,就會回傳結果(Response)給用戶端(Client),如下圖:
python_line_bot

而Webhook機制就是除了擁有上面一般請求(Request)的流程外,還能夠主動推播訊息給用戶端(Client),即便用戶端(Client)沒有向伺服器端(Server)發送請求(Request),所以Webhook機制讓用戶端(Client)與伺服器端(Server)成了雙向的溝通,如下圖:
python_line_bot
LINE Webhook URL位於LINE Developers開發者控制台的Messaging API頁籤中,如下圖:
python_line_bot
點擊「Edit」,輸入剛剛Ngrok所產生的HTTPS網址,如下圖:
python_line_bot
範例中,在Ngrok的網址後面,記得要加上LINE Bot應用程式(APP)的網址,這樣LINE頻道(Channel)才有辦法請求(Request)。除此之外,下方的「Use webhook」要啟用。

這邊點擊「Verify」進行驗證,如果發生錯誤,而LINE Bot應用程式(APP)的終端機(Terminal)中卻沒有出現問題的話,則無需擔心,還是可以繼續往下實作。

由於本文所開發的LINE Bot應用程式(APP)會自動回覆訊息,而無需LINE官方回覆,所以在下方的「Auto-reply messages」,點擊「Edit」,如下圖:

python_line_bot

設定自動回應訊息為「停用」,如下圖:

python_line_bot

最後,掃描Messaging API頁籤中的QR code,加入好友後就可以對LINE Bot傳送訊息,執行結果如下圖:
python_line_bot

七、小結

本文為基本的LINE Bot實作過程,在下一篇文章中,將會加入Python網頁爬蟲,依據使用者所傳入的需求,爬取知名美食網站的資料,回覆給使用者。希望本文的教學有幫助到您,歡迎分享給身邊在學習LINE Bot的朋友。

如果您喜歡我的文章,請幫我按五下Like(使用GoogleFacebook帳號免費註冊),支持我創作教學文章,回饋由LikeCoin基金會出資,完全不會花到錢,感謝大家。

留言

  1. python manage.py startapp foodlinebot

    File "manage.py", line 16
    ) from exc
    ^
    SyntaxError: invalid syntax

    請問要如何解決?

    回覆刪除
    回覆
    1. 試試看使用以下指令:
      python3 manage.py startapp foodlinebot

      刪除
  2. 大大您好
    我現在想要runserver的情況下 會出現下面的錯誤


    C:\Users\AlphaLin\bot>python manage.py runserver
    Watching for file changes with StatReloader
    Performing system checks...
    .
    .
    .
    .(一堆錯誤代碼)
    path('dblinebot/', include('dblinebot.urls')),
    NameError: name 'include' is not defined

    我以為是我的電腦沒有裝include害的 所以我就

    C:\Users\AlphaLin\bot>pip install include
    Requirement already satisfied: include in c:\python38\lib\site-packages (0.2.2)

    然後還是出現一樣的錯誤

    請問是可能哪邊有錯?
    謝謝

    回覆刪除
    回覆
    1. 另外 我試著把webhook更新上去 Verify之後 結果會出現 The webhook returned an HTTP status code other than 200

      然後再ngrok下面會出現 POST /dblinebot/callback 502 Bad Gateway 的錯誤

      是因為我上面的問題導致 下面這個問題嗎?

      刪除
    2. ALPHAGXX您好:
      include()是Django內建的方法,不是套件,用來讓Django結合專案中各個應用程式的網址設定(urls.py)。檢查一下您的Django專案主程式下的urls.py檔案中,是否有引用include()方法,如下:

      from django.urls import path, include

      引用後,就不會出現NameError: name 'include' is not defined的錯誤,也就不會導致ngrok的502 Bad Gateway(找不到網址)錯誤。

      希望以上有解決您的問題,如果沒有,歡迎至Learn Code With Mike粉絲專頁私訊我,將會協助您解決,謝謝 :)

      刪除
    3. 這個錯誤解決了 可是又有錯誤發生了XD

      server跑起來了

      然後我按了Line Developer 的Verify之後
      他出現這個問題
      The webhook returned an HTTP status code other than 200

      ngrok
      POST /dblinebot/callback 500 Internal Server Error

      LINEBOT server

      Internal Server Error: /dblinebot/callback
      linebot.exceptions.LineBotApiError: LineBotApiError: status_code=400, request_id=5ead826d-cb29-43d1-908f-05366221be0a, error_response={"details": [{"message": "May not be empty", "property": "messages[0].text"}], "message": "The request body has 1 error(s)"}, headers={'Server': 'openresty', 'Content-Type': 'application/json', 'x-line-request-id': '5ead826d-cb29-43d1-908f-05366221be0a', 'x-content-type-options': 'nosniff', 'x-xss-protection': '1; mode=block', 'x-frame-options': 'DENY', 'Content-Length': '118', 'Expires': 'Thu, 01 Oct 2020 11:33:20 GMT', 'Cache-Control': 'max-age=0, no-cache, no-store', 'Pragma': 'no-cache', 'Date': 'Thu, 01 Oct 2020 11:33:20 GMT', 'Connection': 'close'}
      [01/Oct/2020 19:33:19] "POST /dblinebot/callback HTTP/1.1" 500 84333

      是還有哪邊有問題呢= =?

      刪除
    4. ALPHAGXX您好:
      應該是訊息不能為空值的關係所導致,請您將ngrok及LINEBOT server跑起來,直接使用LINE傳送訊息試試看 :)

      刪除
    5. 大大你好
      我傳送訊息後出現
      Bad Request: /foodlinebot/callback
      [12/Oct/2020 16:00:45] "POST /foodlinebot/callback HTTP/1.1" 400 66635
      ngrok也出現400 Bad Request
      請問是哪裡可能出錯?
      謝謝

      刪除
    6. 可以檢查一下LINE Develops的Webhook URL是否有正確配對Django專案主程式及應用程式的urls.py檔案設定,也確認一下settings.py檔案中的LINE_CHANNEL_ACCESS_TOKEN及LINE_CHANNEL_SECRET設定,另外,line-bot-sdk記得安裝。

      希望以上有解決您的問題,如果還有其它疑問,歡迎至Learn Code With Mike粉絲專頁私訊我,將會協助您解決,謝謝 :)

      刪除

張貼留言

這個網誌中的熱門文章

Python學習資源整理

Photo by Pablo Heimplatz on Unsplash 本文將分享在學習Python的過程中,所參考的學習資源,由於喜歡做中學,所以分享的教學資源大部分都會有應用實作,除了能夠瞭解基本的Python語法外,透過實際的專案開發,可以增加熟悉度,並且從中培養解決問題的能力。而今天分享的Python學習資源,分別有: 網站書籍YouTube頻道線上課程一、網站以下是除了Python官方之外,推薦的教學網站,除了附有範例程式碼說明之外,觀念講解清楚且易於理解,包含: 1.Real Python: Python Tutorials
2.Python Programming Language - GeeksforGeeks
3.ccClub(Coding&Co-working Club)

二、書籍 1.Python初學特訓班(第四版):從快速入門到主流應用全面實戰(附250分鐘影音教學/範例程式)這本書從Python的基本語法教學開始,最後進行幾個應用程式的開發,包含了YouTube、LINE Bot聊天機器人、網頁爬蟲及資訊圖表繪製等Python專案的開發,這也是我非常喜歡的原因,學習任何的程式語言,在學習完基礎語法後,就是要透過實際的專案開發來練習及增加熟悉度,其中的實戰專案也是我目前正在學習的,並且還有附影音教學,非常適合初學者入門或是想要增加自己實戰經驗的開發人員。

2.Python自動化的樂趣:搞定重複瑣碎&單調無聊的工作(第二版)這本書同樣是先介紹Python的基本重要語法,簡潔易懂,不過這裡的專案實作比較是針對Python自動化的處理,包含Web擷取資訊、工作排程、影像圖片處理及Email發送等,是我在開發自動化專案時的參考書籍,實作範例都很實用,適合初學者及對Python自動化處理有興趣的開發人員。

3.Python設計模式實務上在開發專案時,大家都知道需求會隨著業務一直改變,這時候就會有機會修改程式碼,而有好的架構會讓程式碼好維護,相信這是開發人員所追求的,這本書就是介紹Python常用的設計模式(Design Pattern)及設計原則(Design Principle),藉此設計出好維護及簡潔的程式碼,適合進階且已有實務經驗的開發人員,未來在部落格中,會參考本書來分享學習心得。
三、YouTube頻道 1.Programming with …

[Python爬蟲教學]7個Python使用BeautifulSoup開發網頁爬蟲的實用技巧

Photo by Stanley Dai on Unsplash 在實務上開發專案時,很多時候會利用其他網站的資料來進行分析或運用,而取得的方式除了透過網站所提供的API(Application Programming Interface)外,也可以利用Python來開發爬蟲程式,將網頁的HTML內容下載下來,接著利用BeautifulSoup套件(Package),擷取所需的資訊。

本文將開發一個簡單的爬蟲程式,爬取「ETtoday旅遊雲」網頁,擷取桃園旅遊景點的標題資訊,如下圖: 取自ETtoday的旅遊雲 而在開發的過程中,常會需要搜尋HTML的節點,本文將分享幾個常用的方法,包含: BeautifulSoup安裝以HTML標籤及屬性搜尋節點以CSS屬性搜尋節點搜尋父節點搜尋前、後節點取得屬性值取得連結文字一、BeautifulSoup安裝BeautifulSoup是一個用來解析HTML結構的Python套件(Package),將取回的網頁HTML結構,透過其提供的方法(Method),能夠輕鬆的搜尋及擷取網頁上所需的資料,因此廣泛的應用在網頁爬蟲的開發上。

Beautifulsoup套件(Package)可以透過pip指令來進行安裝,如下範例: pip install beautifulsoup4而要解析網頁的HTML程式碼前,還需要安裝Python的requests套件(Package),將要爬取的網頁HTML程式碼取回來,安裝方式如下: pip install requests安裝完成後,首先引用requests套件(Package),並且透過get()方法(Method)存取ETtoday旅遊雲的桃園景點網址,如下範例: import requests response = requests.get( "https://travel.ettoday.net/category/%E6%A1%83%E5%9C%92/")將網頁的HTML程式碼取回來後,接著引用BeautifulSoup類別(Class),傳入取回的HTML結構字串,並且指定HTML的解析型態來建立其物件,如下範例: import requests from bs4 import BeautifulSoup response = requests.get( "…

[Python爬蟲教學]Python網頁爬蟲結合LINE Notify打造自動化訊息通知服務

Photo by William Hook on Unsplash 日常生活中,每個人都有關注的事情,像是演唱會門票的開賣、喜歡的商品降價或新電影上檔等,而為了要及時自動取得這些資訊,Python網頁爬蟲就被廣泛的使用,除了將爬取的資訊透過 [Python實戰應用]Python寄送Gmail電子郵件實作教學文章介紹的電子郵件進行通知外,另一個備受歡迎的接收通知管道就是LINE。
而LINE官方提供了LINE Notify的服務,只要完成和LINE網站的連動設定,就可以透過LINE Notify推播或傳送訊息至目標使用者的LINE中。
本文即以Udemy線上課程網站為例,利用Python網頁爬蟲關注想購買的線上課程,只要低於指定的價格,就透過LINE Notify服務傳送訊息給使用者。本文的重點包含: 登錄LINE Notify服務 發行LINE Notify權杖(Token) 整合Python網頁爬蟲及LINE Notify服務 一、登錄LINE Notify服務首先,前往LINE Notify官網,來進行Python網頁爬蟲與LINE Notify的連動設定,如下圖: 點選右上角的登入,輸入LINE帳號及密碼,如下圖: 成功登入後,就可以看到「管理登錄服務」頁面,如下圖: 接著,點擊「登錄服務」,輸入LINE Notify服務的基本資料,由於本文的Python爬蟲是跑在本機上,所以「服務網址」及「Callback URL」皆為http://127.0.0.1,如下範例: 填寫完成後,點擊「同意並前往下一步」,就可以看到剛剛所輸入的基本資料,確認沒問題點選「登錄」按鈕即可,如下範例: 這時後LINE Notify會發送認證郵件到登錄服務時,所填寫的電子郵件帳號中,如下圖: 完成電子郵件認證後,點擊「前往服務一覽」,可以看到LINE Notify配發了一個Client ID(帳號)給我們,如下圖: 而密碼則需點擊服務,才可以看到,如下圖:
以上就完成了LINE Notify服務的基本資料登錄了。 二、發行LINE Notify權杖(Token)有了的服務帳號及密碼後,接下來,就可以向LINE Notify取得權杖(token),各位可以把它想像是一張活動的門票,只要參加者有這張門票,就可以進入會場,並且主辦單位會為參加者提供多樣的服務。
同樣的道理,只要程式碼中帶有LINE Notify所給的權杖(t…

解析Python模組(Module)和套件(Package)的概念

Photo by Helloquence on Unsplash 當我們在開發大型應用程式時,如果沒有適當的組織程式碼,除了會降低開發的效率外,也不易於維護,所以模組(Module)化就顯得相當的重要,讓程式碼能夠透過引用的方式來重複使用,提升重用性(Reusable)。
但是隨著專案模組(Module)的增加,將難以管理及問題的追蹤,這時候就能將模組(Module)打包成套件(Package),利用其階層式的結構來彈性規劃模組(Module)。
本篇文章就帶大家瞭解Python模組(Module)及套件(Package)的重要觀念,包含: 什麼是模組(Module)模組引用方式(Import)什麼是套件(Package)dir()函式(dir function)將模組當作腳本來執行(Executing a Module as a Script)一、什麼是模組(Module)模組(Module)就是一個檔案,包含了相關性較高的程式碼。隨著應用程式的開發規模越來越大,我們不可能把所有的程式碼都寫在同一份Python檔案中,一定會將關聯性較高的程式碼抽出來放在不同的檔案中來形成模組(Module),主程式再透過引用的方式來使用。所以模組(Module)可以提高程式碼的重用性(Reusable)且易於維護。
假設我們現在要開發一個部落格,主程式為 app.py ,在還沒有模組化時,程式碼可能長得像這樣: #取得作者 def get_author(): return "Mike" #取得電子郵件 def get_email(): return "learncodewithmike@gmail.com" #新增文章 def add_post(title): pass #刪除文章 def delete_post(title): pass add_post() author = get_author() email = get_email()各位應該可以想像,隨著部落格功能的增加,將所有程式碼都寫在 app.py 主程式中會變得怎麼樣。所以這時候就可以將相關性較高的功能進行模組化的動作。
以此範例來說,取得作者及電子郵件可以獨立出來建立一個關於模組(about.py),而新增及刪除文章則可以獨立出來為文章模…

[Python實戰應用]瞭解Python存取API的重要觀念-以KKBOX Open API為例

Photo by Nirmal Rajendharkumar on Unsplash 在現今很多網站,都會透過API(Application Programming Interface)的方式來提供服務,讓用呼端能夠藉由這個介面存取其資料,進行多樣化的應用開發。本文就以KKBOX Open API為例,實作一個簡單的專案,示範Python如何存取音樂排行榜API,並且可以讓使用者選擇想聽的排行榜類別,試聽其中的歌曲。

經過本文的教學,將會瞭解API的基本觀念,以及學會如何解析Python存取API後的回傳結果,並且篩選所需的欄位,重點包含了: 什麼是API專案前置準備KKBOX Open API用戶端憑證(Client Credentials)KKBOX Open API - Charts 一、什麼是API 各位可以將API(Application Programming Interface)想像是一個大門,要進入存取必須提供合法的帳號及密碼,才能拿到存取憑證(Access Token),之後要存取門後的API資源,只要帶著這個憑證,就可以進行存取。

而實際上API就是一組網址,透過HTTP協定來和用戶端進行溝通。舉例來說,各位可以開啟Chrome瀏覽器,按下F12進入開發者視窗,點擊Network頁籤,接著輸入google.com.tw網址,可以看到類似下圖的結果: 點選任一個網址,可以看到以下的資訊: 其中的Headers(標頭)就是瀏覽器發送至Google的資訊,如果換成是存取KKBOX Open API,Request URL就是API網址,Request Method有幾個常用的類型,分別有: GET(查詢資料)POST(新增資料)PUT(修改資料)DELETE(刪除資料) 以上四個是在存取API時,常用的HTTP動詞。而Response頁籤中的內容即是Google回傳給瀏覽器的結果。 二、專案前置準備有了基本的API觀念後,

[Python物件導向]淺談Python類別(Class)

Photo by Bram Naus on Unsplash 在學習程式語言時,或多或少都有聽過物件導向程式設計(Object-oriented programming,簡稱OOP),它是一個具有物件(Object)概念的開發方式,能夠提高軟體的重用性、擴充性及維護性,在開發大型的應用程式時更是被廣為使用,所以在現今多數的程式語言都有此種開發方式,Python當然也不例外。而要使用物件導向程式設計就必須對類別(Class)及物件(Object)等有一些基本的了解,包含了: 類別(Class)物件(Object)屬性(Attribute)建構式(Constructor)方法(Method)我們先來看一下今天要來建立的類別: # 汽車類別 class Cars: # 建構式 def __init__(self, color, seat): self.color = color # 顏色屬性 self.seat = seat # 座位屬性 # 方法(Method) def drive(self): print(f"My car is {self.color} and {self.seat} seats.") 接下來就針對類別(Class)各個部分來進行介紹。 一、類別(Class) 簡單來說,就是物件(Object)的藍圖(blueprint)。就像要生產一部汽車時,都會有設計圖,藉此可以知道此類汽車會有哪些特性及功能,類別(Class)就類似設計圖,會定義未來產生物件(Object)時所擁有的屬性(Attribute)及方法(Method)。而定義類別的語法如下: class classname:   statement 首先會有class關鍵字,接著自定類別名稱,最後加上冒號。類別名稱的命名原則習慣上使用Pascal命名法,也就是每個單字字首大寫,不得使用空白或底線分隔單字,如下範例: #範例一 class Cars: #範例二 class MyCars:二、物件(Object) 就是透過類別(Class)實際建立的實體,就像實際生產出來的汽車(例如:Mazda)。類別(Class)與物件(Object)的關係就像汽車設計圖與汽車實體。而建立物件(Object)的語法如…

有效管理Python套件(Package)的工具及概念

Photo by Kevin Bhagat on Unsplash 在實務上發展應用程式時,除了可以自行開發模組(Module)與套件(Package)外,很多時候會安裝使用第三方套件(Package),來提升專案的開發效率。
所以本文將介紹如何在PyPI中搜尋所需的Python套件(Package),並且以Windows作業系統及Visual Studio Code開發工具為例,瞭解Python強大的套件管理工具,讓您有效管理專案中的Python套件(Package)。
由於是在Visual Studio Code的Terminal視窗中下指令的方式來操作,所以使用命令提示字元視窗,也可以達到相同的效果。本文重點包含: PyPI(Python Package Index)pip套件管理工具pipenv套件管理工具Pipfile及Pipfile.lock檔案一、PyPI(Python Package Index)PyPI是一個套件庫,位於https://pypi.org,其中包含了各式各樣的Python套件(Package),在開發應用程式的過程中,可以到這邊來搜尋是否有所需的功能套件(Package),安裝後透過引用的方式來進行使用,藉此提升開發效率。

現在就來介紹幾個在使用PyPI時,需要瞭解的基本功能。首先,PyPI的首頁如下圖: 各位可以在搜尋的地方查詢所需的套件,例如搜尋常應用在網路爬蟲的beautifulsoup4套件(Package),從查詢結果可以看到許多相關的套件(Package),如下圖: 以beautifulsoup4 4.8.2為例,點進此套件(Package)後,可以看到安裝的指令及最新版的發佈日期,如下圖: 一個套件(Package)要如何使用,一定會有文件可以參考,往下即可看到Documentation的連結,如下圖: 而套件(Package)的版本演進歷史則可以透過左邊的Release history來查看,如下圖: 以上是在使用PyPI上查找套件(Package)時,較常使用的部分,接下來,就來教大家如何透過指令來安裝套件(Package)吧。 二、pip套件管理工具pip是一個全域環境的套件管理工具,用來安裝及管理PyPI上的Python套件(Package),也就是說利用pip指令所安裝的Python套件(Package),所有專案皆可使用。其中包…

[Python爬蟲教學]整合Python Selenium及BeautifulSoup實現動態網頁爬蟲

Photo by LAUREN GRAY on Unsplash 相信大家都知道,取得資料後能夠進行許多的應用,像是未來的趨勢預測、機器學習或資料分析等,而有效率的取得資料則是這些應用的首要議題,網頁爬蟲則是其中的一個方法。
網頁爬蟲就是能夠取得網頁原始碼中的元素資料技術,但是,有一些網頁較為特別,像是社群平台,需先登入後才能進行資料的爬取,或是電商網站,無需登入,但是要透過滾動捲軸,才會動態載入更多的資料,而要爬取這樣類型的網頁爬蟲,就稱為動態網頁爬蟲。
該如何實作呢?本文將使用Python Selenium及BeautifulSoup套件來示範動態網頁爬蟲的開發過程,重點包含: BeautifualSoup vs Selenium安裝Selenium及Webdriver安裝BeautifulSoupSelenium get()方法Selenium元素定位Selenium send_keys()方法Selenium execute_script方法BeautifulSoup find_all()方法BeautifulSoup getText()方法 一、BeautifualSoup vs SeleniumBeautifulSoup套件相信對於開發網頁爬蟲的人員來說,應該都有聽過,能夠解析及取得HTML原始碼各個標籤的元素資料,擁有非常容易上手的方法(Method),但是,對於想要爬取動態網頁資料來說,則無法達成,因為BeautifulSoup套件並沒有模擬使用者操作網頁的方法(Method),像是輸入帳號密碼進行登入或滾動捲軸等,來讓網頁動態載入資料,進行爬取的動作。
所以,這時候,就可以使用被設計於自動化測試的Selenium套件,來模擬使用者的動作,進行登入後爬取資料或滾動卷軸,並且能夠執行JavaScript程式碼,這些就是Selenium與BeautifulSoup套件最大不同的地方。對於開發Python動態爬蟲來說,就可以結合Selenium套件以上的特點,讓網頁動態載入資料後,再利用BeautifulSoup套件簡潔的方法(Method),將所需的資料爬取下來。
本文就是利用這樣的概念,利用Selenium套件登入Facebook後,前往粉絲專頁,執行滾動卷軸的JavaScript程式碼,讓網頁動態載入資料後,再使用BeautifulSoup套件爬取貼文標題。 二、…

[Django教學1]3步驟快速安裝Django網站框架

Photo by Danielle MacInnes on Unsplash 在現今網路發達的時代,許多人都會透過網站來經營個人的品牌或生意,在上面能夠展示各種的產品、課程或部落格等,甚至是社群平台,皆是利用網站的方式來連接全世界的使用者,是傳達訊息非常重要的媒介。

而想要利用Python簡潔的語法及特性來開發網站,則可以使用最受歡迎的網站框架Django,能夠快速的建置出具有安全性且模組化的網站應用程式,知名的網站像Instagram、YouTube及Spotify等,皆使用Django網站框架來進行開發。
為什麼這些國際性的網站會選擇使用Django來進行開發呢?接下來,將會撰寫一系列的Django教學文章,從安裝到開發出一個簡單的網站,最後發佈到雲端,帶大家來體會一下強大的Django網站框架吧。本文的重點包含: Django的架構Django的優點Django安裝步驟一、Django的架構 Django是一個由Python建構而成的網站框架(Web Framework),其中能夠包含許多的應用程式(APP),其架構就是將網站的各個功能,模組化為多個應用程式(APP),而每一個應用程式(APP),其實就是Python的套件(Package),如下圖: 就像是如果要開發一個旅遊社群網站,可以把整個網站的功能切分為多個不同的應用程式(APP),例如登入(Login)、貼文(Post)、旅遊規劃(Plan)及搜尋景點(Search)等,每一個應用程式(APP)皆專注在特定的功能邏輯,這就是Django框架的基本架構。 二、Django的優點擴展性由於Django的架構是將網站中關聯性高的功能模組化為多個套件(Package),所以未來要擴展新功能時非常的容易,並且不會影響到既有的專案架構。 移值性Django模組化的架構,讓專案中的應用程式(APP),可以移植至其它的Django專案中使用,擁有非常高的程式碼重用性(Reusable)。 快速開發Django框架定義了專案的基本架構及程式碼撰寫規範,開發人員在參與多個專案時,無需重新適應,可以快速的進入狀況,也因為遵循了Django的規範,提高了Django專案的維護性。 強大的後台在建立Django專案後,預設即提供了一個功能完整的後台,包含使用者的管理、群組管理及資料庫等,並且能夠依需求客製化,無須從頭開發,這也是Django能夠…