gdrive3 要設定的部分比較多也比較麻煩，不像前一版只要下載回來，gdrive about授權完成就可以了，跟著小蛙來一步一步設定吧。

下載 gdrive 套件

gdrive3 套件連結下載。

點進去之後找到 the release section，小蛙寫這篇文章的時候最新版本是 3.9.1，下載對應自己作業系統的版本

在 shell 環境中下，下載 gdrive、解壓縮，並移動到 /usr/sbin/ 讓他可以全域執行

wget https://github.com/glotlabs/gdrive/releases/download/3.9.1/gdrive_linux-x64.tar.gz
tar -xzvf gdrive_linux-x64.tar.gz
mv ./gdrive /usr/sbin/

設定 Google 帳號授權

這版本的 Google 授權跟上一版比較起來真的超級麻煩，github 主頁上也有完整且詳細授權教學 Create Google API credentials in 50 easy steps，有 50 個步驟看起來真的是超級麻煩 … 不過點進去看的話就會發現其實不到 50 個步驟啦！大約只有 28 個 (…. 還是很多啊！！！)

建立 Google Cloud 專案

首先進入到 Google Clound 控制台，第一次使用的話點擊左上角「選取專案」，然後「新增專案」，如果原本就有專案存在的話，使用既有的專案也可以。

輸入可以辨識的專案名稱，點擊建立，建立完成後右上角會跳出通知，點擊選取專案進入專案頁面

啟用 Google Drive API

在上方搜尋欄輸入「drive api」，點擊第一個搜尋結果「Google Drive API」，點擊「啟用」來使用 Google Drive API

設定 OAuth 同意畫面

成功啟用 Google Drive API 後，點擊左側選單「憑證」，點擊「設定同意畫面」

點擊「開始」設定 Google 驗證平台，輸入應用程式名稱及使用者支援電子郵件

目標對象選擇「外部」，填入聯絡資訊，同意條款後點擊「建立」

新增資料存取權

點擊「資料存取權」->「新增或移除範圍」

篩選條件輸入「Google Drive API」，下方範圍選擇 …/auth/drive 及 …/auth/drive.metadata.readonly 兩個，選完後點擊最下方「更新」

接著畫面會顯示剛剛選擇的那兩個，點擊 Save 儲存

新增目標對象

接著點擊「目標對象」->「Add users」

輸入要使用 gdrive3 的使用者

建立 Oauth 用戶端

點擊「用戶端」->「建立用戶端」，應用程式類型選擇「電腦版應用程式」，接著輸入自己可以辨認的名稱即可

建立完成，點擊「下載 JSON」可以把密鑰下載下來，要注意這邊的密碼要記起來，關閉這視窗之後就再也看不到這個密碼了，只能刪除重建一個新的喔。

發布應用程式

點擊左側「目標對象」->「發布應用程式」

確認後就完成 Google Drive API 的設定囉 ~

gdrive3 認證

這部分要依照「本機是否可以開啟瀏覽器」來區分，因為小蛙安裝在 VPS 上沒有辦法開啟瀏覽器來驗證，也不像前一版可以遠端驗證

因此這邊需要在 Windows 本機也安裝 gdrive，在本機驗證成功後，把設定檔匯出，在到 VPS 上匯入設定檔，這樣就能讓不能開瀏覽器的主機也能正常使用 gdrive，下面小蛙就示範怎麼執行這些步驟。

下載 Windows 版本的 gdrive，解壓縮後進入到目錄，接著執行gdrive account add，輸入上面取得的用戶端編號與用戶端密碼後，會得到一個連結，複製貼到瀏覽器進行認證

gdrive account add
# Client ID (輸入用戶端編號)
# Client secrent (輸入用戶端密碼)
# 取得驗證連結 (貼到瀏覽器進行認證)
# 驗證成功顯示 Logged in as xxxxx@gmail.com

輸入剛剛上面 Add user 中輸入的 gmail 帳號

遇到下面這個畫面沒關係，點擊顯示進階設定，點擊下方前往「GDrive3」(不安全)

兩個權限都勾選後點擊繼續

驗證成功

接著將驗證成功的檔案匯出，輸入gdrive export剛驗證成功的 gmail 帳號

把上面產生的檔案上傳到 VPS 主機上，使用gdrive account import匯入就成功囉~

gdrive3 基本使用

只要輸入gdrive就可以看到使用說明

# gdrive
Usage: gdrive <COMMAND>

Commands:
  about        Print information about gdrive
  account      Commands for managing accounts
  drives       Commands for managing drives
  files        Commands for managing files
  permissions  Commands for managing file permissions
  version      Print version information
  help         Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help information

輸入gdrive files mkdir 資料夾名稱可建立資料夾，小蛙要用來放備份的，因此輸入gdrive files mkdir backup，建立一個名稱為 backup 的資料夾，接著會回傳一個 directory id，之後存取這個資料夾都是認這個 directory id 而不是資料夾名稱喔。

建立資料夾

# gdrive files mkdir backup
Created directory 'backup' with id: 1MuLg1nlmZwudTdW4MJqhNO1z88i9Vur2

到 Google 雲端硬碟可以看到成功建立了 backup 資料夾

上傳檔案

這一版不支援前一版可以gdrive sync upload 本機資料夾 雲端資料夾id直接同步整個本機資料夾內的檔案，只能透過以下指另一個一個上傳

gdrive files upload --parent 1MuLg1nlmZwudTdW4MJqhNO1z88i9Vur2 1.txt
gdrive files upload --parent 1MuLg1nlmZwudTdW4MJqhNO1z88i9Vur2 2.txt
...

或者是批量把資料夾下的資料都上傳可透過以下指令，不過這樣會在原本要上傳的 backup 資料夾下又在建立一個 backup 資料夾 …

~/backup# gdrive files upload --parent 1MuLg1nlmZwudTdW4MJqhNO1z88i9Vur2 --recursive ./
Found 2 files in 1 directories with a total size of 70 B
Creating directory 'backup' with id: 1elbAeqJGIA_h8VeKSGveWWuyVL_vZevp
Uploading file 'backup/1.txt' with id: 1HuMgkjhnLwWnCkub3hwfU2WVXvC-o3IQ
Uploading file 'backup/2.txt' with id: 1S76vQWzWtR1AzR-IzxDMPBh2RBzNAvOB
Uploaded 2 files in 1 directories with a total size of 70 B

大概 gdrive 的教學就到這邊，如果遇到參數不知道怎麼下的時候，只要在最後面加上-h就可以看到指令教學。

這篇文章 gdrive3 : Google Drive CLI Client 最早出現於 記下來。

可能有很多人不懂 Google 提供的 APIs 能做什麼，以及有哪些 Google APIs，只要到 Google Cloud Platform 就可以看到 Google 提供的所有 API，所有你想得到的 Google 服務，幾乎都有對應開放的 API，差別在於每個 API 使用的次數跟頻率有所限制，還有另一個是 Google 開放的 API 裡面「並不會」接露所有功能。

舉個 Google Maps 的例子，使用 Google Maps 時除了地圖、店家資訊及使用者評論等等，中間還有一個熱門時段，讓使用者可以清楚知道哪個時段會比較多人，就可以避開熱門時段，挑個比較少人的時間去，好友當時就是因為 Google Maps API 沒有提供這個功能，因此小蛙才幫忙用爬蟲的方式解決這個問題。

連上 Google Cloud Platform 可以看到很多各式各樣你想得到或想不到的服務

開啟 Google APIs

小蛙這系列都會用 Google Search Console 來當作範例，其他 API 原理基本上都差不多，只是呼叫的方式跟屬性設定有所不同，開始吧！

首先連到 Google Cloud Platform 從上方(1)選取一個要使用 API 的專案(2)，如果沒有專案的話可以建一個新的(3)

搜尋要開啟的 API (1)，點進去 (2)

點上面的 Enable 就可以開啟該 API 了，下面有一些 API 說明可以看看

API 成功開啟後，左邊的 Credentials 可以設定 API 認證的部份，不過這裡小蛙到第三篇文章的時候才會提到

測試 API 說明

回到剛剛啟動 Google Search Console API 的頁面，這次點選右邊 TRY THIS API

開出來的頁面是 Search Console URL Testing Tools API，不過小蛙這邊要用的不是這個 API，而是能取得 Google Search Console 裡面資料的 API，因此點選左上角 (1)

回到 Google Search Console APIs 首頁後進入 Search Console API

找到下面的 Try it in your browser

接著隨便點一個 api 功能

右邊會開啟一個側欄，這邊就是 Google API 的測試工具了，點選右上角的方框 (1) 可將螢幕放大顯示更多資訊

Google Search Console 原本就是以「網站」為目標，因此必填欄位是在 Search Console 裡面的網址 (1)，Request body 的部份填入查詢的參數 (2)，輸入完成後點選 EXECUTE 執行 (3)，下圖 (4) 的地方是真正發送出的 request

使用測試 API

小蛙用記下來 https://noter.tw/ 測試一下 (1)，填入一些必要的參數 (2) 取得 2021-05-01 ~ 2021-07-01 區間的資料，只要回傳前 10 筆就好，點選 (3) 的驚嘆號會顯示有哪些屬性可以設定，確定沒問題後 EXECUTE 送出吧！注意：這邊的 siteUrl 一定要是自己的 Search Console 原本就有的資源才可以，也就是說不能去查別人的，不然就太恐怖了！

點了 EXECUTE 後瀏覽器跳出登入畫面，有些可以透過 API Key 來使用，有些則是必須透過 OAuth 2.0 才可以使用，選擇一個帳戶來使用吧～

執行成功後，右上角會產生實際送出的 API

右下角則是顯示回傳結果，可以看見在這區間被點擊的次數為 46,812 次，搜尋曝光有 838,324 次 … 等

這看起來好像只能取到很基本的資料？不～來把參數做個調整，加上 aggregationType 及 dimensions 的設定回傳各個頁面的資訊～

查詢結果會根據區間內的點擊數排列，看看剛剛我們加的 dimensions 都在 keys 陣列裡面，包含搜尋字串、頁面、來源國家及日期

Google Search Console API 啟用跟測試就到這邊，下一篇將繼續介紹環境設定部份。

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 超連結

這篇文章 PHP Client 操作 Google APIs (1) 開啟與測試 API 最早出現於 記下來。