PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹

總算沒偷懶已經來到第三篇了，還不清楚怎麼回事的朋友可以看前面兩篇 PHP Client 操作 Google APIs (1) 開啟與測試 API 及 PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP，這篇記錄如何建立 Google APIs Credentials 進行認證，並說明各認證方式的差別。

這系列小蛙以 Google Search Console API 當作例子，其他的 Google APIs 大致上使用的流程類似，差別可能在於用到的物件不同 (Google 分析就要改成使用 Google_Service_Analytics 物件)、要設定的 Scope 不同 (Google_Service_Analytics::ANALYTICS_READONLY，這些在 Google APIs 文件上都會有)，可以使用的認證方式不同 (有的限定只能 OAuth) 等等。

認證方式 (Google APIs Credentials)

Google 在 API Console 裡提供了 3 種認證方式，分別是：API Key、OAuth client ID 及 Service account。如果不清楚該使用哪一種的話，可以點最下面的 Help me choose。

API Key

API Key 是最簡單也最單純的，如果使用到 Google APIs 的功能是支援 API Key 存取的話，這是一個非常簡單的好選項，只要設定完成後，會得到一組 API Key，接著設定在 API Client 內就可以使用了。

OAuth client ID

透過自己的 Gmail 帳號登入後並授權後才可以使用，用來存取自己帳號相關的資料，例如：行事曆、Search Console 資料、Google Analytics 資料 … 等。第一篇測試 APIs Explorer 時跳出的視窗就是使用 OAuth 2.0 登入的畫面。

Service account

主要在 Server 端的應用，有些 APIs 需要透過 OAuth 取得帳號相關資料，但是如果要讓它自動執行或是做成機器人 (robot) 的話，沒辦法每次跳出視窗讓你去按登入授權，因此這種狀況選擇 Service account 就對了。

建立 Service Account

繼續到 GCP 左側選單，點擊 APIs & Services -> Credentials

點擊上方 CREATE CREDENTIALS 後選擇 Service account

輸入帳號名稱 (Service account name) 後會自動產生 (Service account ID)，輸入描述避免太多 Credentials 的時候可以弄清楚哪個是哪個，輸入完成後點擊 CREATE AND CONTINUE

這步驟是選用的，小蛙直接跳過

這步驟也是選用的，直接跳過

回到主畫面後可以看到剛剛新增的帳號出現了，點選右邊的鉛筆進入修改畫面

上方切換到 KEYS 頁籤 (1)，點擊下方 ADD KEY (2)，選擇 Create new key (3)

選擇 Key type，Google 建議使用 JSON 格式 (1) 的就好，點擊右下角的 CREATE (2)

接著會開始下載 JSON，這個 JSON 一定要保存好喔，如果遺失了是沒辦法再下載的，只能把原本的刪除後再產生一個，一定要注意。

到這邊 Service Account 就建立完成了，下一篇將會說明如何透過 PHP Client 操作 Google Search Console APIs 來取得相關數據。

Google 系列文章：

• PHP Client 操作 Google APIs (1) 開啟與測試 API
• PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP
• PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹
• PHP Client 操作 Google APIs (4) 使用 Google Search Console APIs
• Google 表單應用：設定選項次數上限
• 複製 Google 表單 (Copy A Google Form)
• Google Adsense: 向 Google 提交稅務資料 | 填寫 W-8BEN 稅務表單
• Google 雲端外帶服務 (Takeout)：輕鬆打包雲端硬碟、相簿 … 等資料
• Google 相簿取得真實圖片位置（插入圖片到文章）
• gdirve 讓你在 Linux 文字介面也能好好使用 Google Drive
• Microsoft Office Word 無法開啟 Google Drive 超連結