可能有很多人不懂 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 最早出現於 記下來。

上一篇文章我們示範了怎麼使用 Google 提供的 API 測試工具，透過這些工具產生相關 REST 指令，同時 Google 也提供 Java 及 Python 版本的使用範例，只要點進 Google Search Console APIs 就可以看到。

但是小蛙今天要使用的不是 Java 及 Python，而是 PHP 版本的 Client (beta)，只要點進 Install Client Libraries 拉到下面可以看到各種版本的 Client，將頁籤切換到 PHP，或是其它自己擅長的語言～點選 Get the latest Google Search Console API client library for PHP (beta)

接著開啟 Github 頁面，PHP 版本需在 5.6.0 以上才可以使用，並且需要透過 composer 安裝，沒有 composer 的話可參考這邊。安裝好後使用以下指令安裝

composer require google/apiclient:^2.10

安裝完 PHP Client 後，在要使用 Google APIs 的 PHP 最上面加上

require_once '/path/to/your-project/vendor/autoload.php';

就可以載入 Google API 的相關工具了，如果沒有或真的不想裝 composer 的話，其實也有提供直接下載的版本，只要到 這邊 去下載適合的版本，解壓縮後同樣在要使用 Google APIs 的 PHP 加入上面 require_once (注意路徑正確性) 就可以使用 Google API 了。

接著建一個 PHP 檔案，新增一個 Google_Client() 物件出來，如果下載或設定正確的話，畫面上應該空白不會噴任何錯誤

<?php
 ini_set('display_errors', '1');
 error_reporting(E_ALL);
 // 換成自己的實際路徑
 require_once '../googleapiclient/vendor/autoload.php';
 $client = new Google_Client();
?>

如果出現下面這種錯誤，可能是沒安裝正確或是路徑指定錯誤，再檢查看看是哪裡有問題。

Fatal error: Uncaught Error: Class 'Google_Client' not found in /var/www/xxx.php:6 Stack trace: #0 {main} thrown in /var/www/test/xxx.php on line 6

這篇文章比較短，只著重在 PHP 版本的安裝，下一篇文章再繼續介紹怎麼使用 OAuth 登入並查詢 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 超連結

這篇文章 PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP 最早出現於 記下來。

我們在前幾篇裡面瞭解了 Google APIs、安裝 Client for PHP 以及申請了 Google APIs Credentials 裡的 Service Account 並下載了 JSON (一定要好好保存，遺失了只能刪除再產生一次，沒辦法再次下載喔)，開始使用！

Google APIs 大致流程

使用 Google APIs 大致上的流程都差不多

• 載入 Google APIs Client for PHP (或其他語言版本)
• 加入 Service Account
• 建立並初始化物件
• 設定篩選條件
• 取得並解析結果

只要把握這幾個原則，之後若要使用 Google APIs 就不會再霧沙沙了 (但 API 還是要查，每個 API 的 Scope 跟條件設定上會有很大的不同)

載入 Google APIs Client for PHP

這個在前面 PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP 的時候已經講過了，在程式碼裡面很簡單，開頭放上這行就可以了，為了更方便 debug，可以多設定兩行條件，只要使用上出現錯誤，就會直接在網頁上呈現

// 顯示錯誤
ini_set('display_errors', '1');
// 所有錯誤都顯示
error_reporting(E_ALL);
// 載入 Google Client
require_once '../googleapiclient/vendor/autoload.php';

加入 Service Account

小蛙前面提到這次要做的事情是讓程式不經人工自動執行，而 Search Console 能使用的方式只有 OAuth 與 Service Account (忘記差別的這邊請 PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹)，要不需人工介入只有 Service Account 了，而要讓 Service Account 存取 Search Console 資料的話，就必須將該帳號加入 Search Console 裡面囉！

首先進入 Search Console 要使用的資源，左邊選單下面找到「設定」

點擊「使用者與權限」

點擊「新增使用者」並把從 GCP Credentials 那邊得到的 Service Account 貼上，權限選擇「完整」

建立並初始化物件

回到 PHP 的部份加入金鑰及設定 Scope

// 設定金鑰
putenv('GOOGLE_APPLICATION_CREDENTIALS=存放金鑰的路徑/server_secrets.json');
session_start();

// 建立基本 Google Client 
$client = new Google_Client();
// 載入預設金鑰位置
$client->useApplicationDefaultCredentials();
// 設定 Scope
$client->addScope([Google_Service_Webmasters::WEBMASTERS_READONLY, Google_Service_Webmasters::WEBMASTERS]);
$client->setAccessType('offline');
// 建立基本 Google Service Webmasters 物件
$master = new Google_Service_Webmasters($client);

設定篩選條件

建立完要用的 Google Service Webmasters 物件之後，對！以前 Google Search Console 叫做 Google Webmaster，雖然我們說要操作 Search Console 但建立的物件跟設定的 Scope 可以看出都還是 Webmasters。

$search = new Google_Service_Webmasters_SearchAnalyticsQueryRequest();
$search->setStartDate( '2021-07-06' );
$search->setEndDate( '2021-08-06' );
$search->setDimensions( ['QUERY'] );
$search->setAggregationType( 'BY_PROPERTY' );
$search->setRowLimit(10);

至於有哪些條件或是要怎麼操作取得自己要的內容，就自己到 API Explorer 測試，或到 PHP Client 操作 Google APIs (1) 開啟與測試 API 複習吧！

取得並解析結果

最後把他們全部串起來～丟回的結果可以先用 print_r 印出來看看，或是直接到 這邊 看回傳的結果 ~

$data = $master->searchanalytics->query('https://noter.tw/', $search);

$result = [];
$rows = $data->rows;
foreach ($rows as $row){
    // 剖析資料
}

到這邊基本上就大功告成了，上面的功能是取得網站上特定區間的關鍵字資訊 ~ 需要其他資料的話，釣竿已經在手了，就要靠自己囉！Good Luck ~

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 (4) 使用 Google Search Console APIs 最早出現於 記下來。