PHPMailer + Gmail OAuth 發信大概有幾個步驟：

1. 安裝必要套件：使用 composer 在網站上安裝 phpmailer/phpmailer 及 league/oauth2-google 套件。
2. 建立 OAuth 2.0 用戶端 ID 憑證：到 Goolge Cloud 建立一個專案，並開啟 Gmail API 與建立一個 OAuth 2.0 用戶端 ID 憑證。
3. 取得 Refresh Token：設定 get_oauth_token.php 通過 OAuth 驗證，取得 Refresh Token。
4. 使用 PHPMailer 寄信：使用 PHPMailer 搭配前幾步得到的資訊寄送郵件。

安裝必要套件

需使用 composer 安裝必要套件，沒有 composer 的話可參考這邊。

composer require phpmailer/phpmailer
composer require league/oauth2-google

建立 OAuth 2.0 用戶端 ID 憑證

啟用 Gmail API

進入到 Google Cloud，點擊左上方專案下拉選單 -> 新增專案 -> 輸入專案名稱，只要自己能辨識的即可，下面若有機構、位置，也都必須填寫上去

專案建立完成後進入該專案，左側選擇「已啟用的 API 和服務」，點擊「啟用 API 和服務」

找到並啟用 Gmail API

建立 OAuth 用戶端 ID 憑證

成功啟用 Gmail API 後，左側進入「憑證」選單 -> 點擊「建立憑證」 -> OAuth 用戶端 ID

第一次建立需要先設定同意畫面，點擊「設定同意畫面」

我們的目的是完成至少一次 OAuth 驗證取得 Refresh Token，這邊選「內部」就可以了

應用程式名稱、使用者支援電子郵件及開發人員聯絡資訊為必填項目，其餘部份視情況填寫，填寫完成後點擊「儲存並繼續」。

第二步範圍部份直接留空，點擊「儲存並繼續」

OAuth 同意畫面建立完成

再回到「憑證」->「建立憑證」->「OAuth 用戶端 ID」

應用程式類型選擇「網頁應用程式」，名稱為必填，可以跟小蛙一樣輸入 PHPMailer，只要能辨識即可。「已授權的重新導向 URI」填入網站下 phpmailer 套件下的 get_oauth_token.php 路徑 (也可以把它拉出來到外層比較好處理的地方)，小蛙這邊的例子是

https://xx.xxx/vendor/phpmailer/phpmailer/get_oauth_token.php

建立完成後會得到用戶端編號及用戶端密鑰，先存起來等一下馬上會用到。

取得 Refresh Token

找到 PHPMailer 下的 get_oauth_token.php (預設應該會在網頁目錄下的 vender/phpmailer/phpmailer/)，PHPMailer 原始附帶的檔案會一直卡在 Provider missing 或 Invalid state，沒辦法正確取得 Refresh Token，因此小蛙對 get_oauth_token.php 做了一些修改，確保可以拿到 token。

<?php
/**
 * PHPMailer - PHP email creation and transport class.
 * PHP Version 5.5
 * @package PHPMailer
 * @see https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project
 * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>
 * @author Jim Jagielski (jimjag) <jimjag@gmail.com>
 * @author Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>
 * @author Brent R. Matzelle (original founder)
 * @copyright 2012 - 2020 Marcus Bointon
 * @copyright 2010 - 2012 Jim Jagielski
 * @copyright 2004 - 2009 Andy Prevost
 * @license https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
 * @note This program is distributed in the hope that it will be useful - WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.
 */

/**
 * Get an OAuth2 token from an OAuth2 provider.
 * * Install this script on your server so that it's accessible
 * as [https/http]://<yourdomain>/<folder>/get_oauth_token.php
 * e.g.: http://localhost/phpmailer/get_oauth_token.php
 * * Ensure dependencies are installed with 'composer install'
 * * Set up an app in your Google/Yahoo/Microsoft account
 * * Set the script address as the app's redirect URL
 * If no refresh token is obtained when running this file,
 * revoke access to your app and run the script again.
 */

namespace PHPMailer\PHPMailer;

// 用來看錯誤訊息以及刪除 opcache
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
@opcache_reset();
	
/**
 * Aliases for League Provider Classes
 * Make sure you have added these to your composer.json and run `composer install`
 * Plenty to choose from here:
 * @see https://oauth2-client.thephpleague.com/providers/thirdparty/
 */
//@see https://github.com/thephpleague/oauth2-google
use League\OAuth2\Client\Provider\Google;

// 根據自己的 vendor 路徑進行調整
require '../../autoload.php';

session_start();

// 改成剛剛在 Google Cloud 上設定的值
$providerName = 'Google';
// 用戶端編號
$clientId = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com';
// 用戶端密碼
$clientSecret = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
// 已授權的重新導向 URI
$redirectUri = 'https://xxx.xxxx.xxx/get_oauth_token.php';

$_SESSION['provider'] = $providerName;
$_SESSION['clientId'] = $clientId;
$_SESSION['clientSecret'] = $clientSecret;

$params = [
    'clientId' => $clientId,
    'clientSecret' => $clientSecret,
    'redirectUri' => $redirectUri,
    'accessType' => 'offline'
];

$options = [];
$provider = null;

switch ($providerName) {
    case 'Google':
        $provider = new Google($params);
        $options = [
            'scope' => [
                'https://mail.google.com/'
            ]
        ];
        break;
}

if (null === $provider) {
    exit('Provider missing');
}

if (!isset($_GET['code'])) {
    //If we don't have an authorization code then get one
    $authUrl = $provider->getAuthorizationUrl($options);
    $_SESSION['oauth2state'] = $provider->getState();
    header('Location: ' . $authUrl);
    exit;
    //Check given state against previously stored one to mitigate CSRF attack
	// 這段不註解掉的話，會一直卡在 Invalid state，沒辦法拿到正確的 token
/*} elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) {
	error_log("3333");
	error_log("state 3333 " . $_SESSION['oauth2state']);
    //unset($_SESSION['oauth2state']);
    //unset($_SESSION['provider']);
    exit('Invalid state');*/
} else {
    //unset($_SESSION['provider']);
    //Try to get an access token (using the authorization code grant)
    $token = $provider->getAccessToken(
        'authorization_code',
        [
            'code' => $_GET['code']
        ]
    );
    //Use this to interact with an API on the users behalf
    //Use this to get a new access token if the old one expires
    echo 'Refresh Token: ', htmlspecialchars($token->getRefreshToken());
}

將內容貼上後，開啟瀏覽器連到該網址 (就是已授權的重新導向 URI) 開始進入 OAuth 登入流程，選擇要登入的帳號

確認登入

信任應用程式

最後會印出 Refresh Token: xxxxxxxxxx，這個 token 一定要存好，少了這個 PHPMailer 就沒辦法透過 OAuth 驗證寄信喔，原本以為 get_oauth_token.php 每次執行應該 “有機會” 去換一個可使用的 Token 回來，不過再執行一次會發現 Refresh Token: 變成空白。

到這邊就成功取得可以使用的 Token 了，回到 PHPMailer 寄信程式吧！

使用 PHPMailer 寄信

複製下面的檔案，視自身情況修改幾個地方：

1. require(‘./vendor/autoload.php’);：將位置指向正確的路徑。
2. $client_id：前面步驟取得的用戶端編號。
3. $client_secret：前面步驟取得的用戶端密碼。
4. $refresh_token：前面步驟取得的 Token。
5. $email：前面步驟通過 OAuth 的信箱。
6. 信件相關之寄件人、收件人、主旨、內容 … 等。

<?php

// 用來看錯誤訊息以及刪除 opcache
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
@opcache_reset();

// 根據自己的路徑修改 composer 的載入位置
require('./vendor/autoload.php');

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\OAuth;
use League\OAuth2\Client\Provider\Google;

// 用戶端編號
$client_id 	= 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com';
// 用戶端密碼
$client_secret 	= 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
// 從前一個步驟取得的 Token
$refresh_token  = '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxg';
// OAuth 的信箱
$email		= 'xxxxxxx@xxxxxxx';

$mail = new PHPMailer(true);

$provider = new Google(
	[
		'clientId' => $client_id,
		'clientSecret' => $client_secret,
	]
);

$mail->setOAuth(
	new OAuth(
		[
			'provider'     => $provider,
			'clientId'     => $client_id,
			'clientSecret' => $client_secret,
			'refreshToken' => $refresh_token,
			'userName'     => $email,
		]
	)
);

$mail->isSMTP();

$mail->SMTPDebug 	= 3;				// 如果需要顯示debug內容,測完確定沒問題請改成 0
$mail->SMTPAuth 	= true; 
$mail->SMTPSecure 	= 'tls';
$mail->AuthType 	= 'XOAUTH2';
$mail->Host 		= "smtp.gmail.com";
$mail->Port 		= 587;
$mail->CharSet 		= "utf-8";

$mail->setFrom('寄件人信箱', '寄件人名稱');    // 寄件人
$mail->addAddress('收件人信箱', '收件人名稱'); // 收件人
$mail->isHTML(true);                         // 寄送 HTML 格式郵件

$mail->Subject = "郵件主旨";                  // 主旨
$mail->Body    = "<Strong>測試</Strong>";     // 信件內容
$mail->AltBody = "測試";                      // 無法顯示 HTML 時的內容

$mail->send();

?>

一切就緒後連到該寄信的 PHP 頁面，就可以成功把信寄出囉！

延伸閱讀：Google 試算表批量發送 Email (免費版每日 50 封)

這篇文章 PHPMailer + Gmail OAuth2 寄信 最早出現於 記下來。

上一次掃出來的時候已經修正過了，這次加了一些功能後又出現，下圖是安全掃描報告，看到 _ga, _gid 之類的很快就知道是使用 Google 分析 (Google Analytics) 造成的。

要修正這個嚴重性被標示為「中」的問題很簡單，只要到載入及初始化 Google 分析的部份，例如小蛙找到其中一個頁面 Google 分析的載入有這段

ga('create', 'UA-xxxxxxxx-x', 'auto');

這時候要用到 Google 分析提供的 cookieFlags，把上述設定改成

ga('create', 'UA-xxxxxxxx-x', {'cookieFlags': 'SameSite=None; Secure'});

就可以囉 ~ 更多 cookieFlags 的設定可參考：Google Analytics设置cookieFlags – GA 小站analytics.html，F12 看看設定前跟設定後的差別。

打完收工～！再次送掃！站上還有其他不錯的 技巧分享 喔～

這篇文章 加密的階段作業 (SSL) Cookie 中遺漏安全屬性 最早出現於 記下來。

PHP 壓縮檔案

這邊是留給自己的 ZipArchive 用法的 memo，確定載入此模組後，只要使用以下方法就可以輕鬆把檔案壓縮成 zip

// 建立 ZipArchive 物件
$zip = new ZipArchive();
// 在指定路徑中建立一個 zip 檔
$res = $zip->open('tmp_callback/123.zip', ZipArchive::CREATE);
// 把 tmp_callback/file1 新增至 zip 內，並改名為 00000001.txt
$zip->addFile('tmp_callback/file1', '00000001.txt');
// 關閉 zip 物件
$zip->close();

透過網頁下載 zip 檔

透過以下的語法可以讓瀏覽器直接下載 zip 檔，一方面在之前做權限控管以及避免洩漏檔案真實路徑

$path = "/var/www/html/uploads/";
$filename = '03082358.zip';
	
header("Pragma: public");
header("Expires: 0");
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header("Cache-Control: public");
header("Content-Description: File Transfer");
header("Content-type: application/octet-stream");
header("Content-Disposition: attachment; filename=\"".$filename."\"");
header("Content-Transfer-Encoding: binary");
header("Content-Length: " . filesize($path . $filename));
@readfile($file);

無法開啟壓縮檔的原因

直到有使用者反應壓縮檔無法開啟，透過 unzip-online.com 線上解壓縮也失敗

使用 notepad++ 開啟後才發現 zip 檔開頭有三行空白，可是有些電腦可以正常開啟有些電腦卻不行

只要把那三行空白刪除，就可以正常解壓縮了 …

無法開啟壓縮檔的解決方法

一開始以為是 ZipArchive 模組的問題，做了各種嘗試後發現，產出來的 zip 是正常的，並沒有上面那三行空白，那問題就是出在下載這段了。

試了很多方法發現只要有<?php include_once "xxx.php" ?>就會有三行空白的狀況，一開始笨笨的試著把所有用到的 include 都拔進來放，後來覺得這樣實在是又累又蠢，最後終於找到簡單解法 … 只要在readfile之前呼叫ob_clean();就可以避免這個問題 …

// 以上省略
ob_clean();
@readfile($file);

這篇文章 無法開啟 PHP ZipArchive 下載的 zip 檔 最早出現於 記下來。

text-indent 文字縮排

小蛙無設定縮排的文字（由左至右、上至下排列），樣式如下

報章雜誌上常可見首行縮排兩個字的排版

使用 text-indent: 2em; 即可輕鬆達成首行縮排兩個字，也可以透過 px 或其他單位進行調整

<style>
.indent-2{
  text-indent: 2em;
}
</style>

<h3>首行縮排二字</h3>
<div class="indent-2">現在雲端儲存服務眾星雲集，例如：Google 雲端硬碟、Apple iCloud、Microsoft OneDrive、Dropbox、Box … 等，在共同編輯及使用的情況下，版本管理就非常重要了，這篇文章把 Google 雲端硬碟檔案版本管理的方法記下來。</div>

text-indent 還能做什麼

小蛙一開始遇到 text-indent 是因為要做出下面這種排版

這個例子有 5 個字（包含一個全形：），我們先把 2em 改成 5em，剛剛我們設定 text-indent: 2em; 是首行往右邊縮 2 個字，那這個需求的理解是不是照理推改成 text-indent: -5em; 就可以變成往左邊的了？

結果是 … 最左邊的字超出畫面，嗯，既然提到邊界，css 有一個左邊邊界的屬性 margin-left，加入 margin-left: 5em; 看看能不能把凸出去的內容再擠回來

效果看起來的確是我們要的了，統整使用到的 css，只要把 text-indent 擠出去的位移，再用 margin-left 推回來，不管後面幾行要縮排多少，都可以自己調整囉！

<style>
.indent-title-5{
  text-indent: -5em;
  margin-left: 5em;
}
</style>

<div class="indent-title-5">文章摘要：現在雲端儲存服務眾星雲集，例如：Google 雲端硬碟、Apple iCloud、Microsoft OneDrive、Dropbox、Box … 等，在共同編輯及使用的情況下，版本管理就非常重要了，這篇文章把 Google 雲端硬碟檔案版本管理的方法記下來。</div>

CSS 相關文章：

1. CSS 段落文字縮排、凸排 (text-indent)

這篇文章 CSS 段落文字縮排、凸排 (text-indent) 最早出現於 記下來。

可能有很多人不懂 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 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 超連結

這篇文章 PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹 最早出現於 記下來。

我們在前幾篇裡面瞭解了 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 最早出現於 記下來。

早期很多網站都是 http 的，到現在各家大廠的推波助瀾下，你沒有 https 就被當作是不合群的、有危險的、跟不上潮流的網站(?!)，總之當有人上你的網站，但你的網站沒有 https 的時候，各大瀏覽器就會很不客氣的提示：您與這個網站的連線不安全，有些人看到這些提示怕都怕死了根本不敢連～

小蛙這次要處理的系統是早期抓網站圖片的工具，由於是早期開發的，當時幾乎都是 http 為主的網站，這支程式也完全沒有考慮 https 的問題 (當時合作的單位完全沒有 https)，這一兩年來這個問題慢慢顯露出來，有些要抓的網站也在我們自己單位，因此可以透過一些特殊的方法來處理，但是今天遇到 … 要抓外面單位的網站，這 … 折騰了小蛙一整天啊。

小蛙給一個最簡單卻也是最困難的建議：更新到 JRE 1.8

小蛙試了超多網路上找到的方法，如果你已經在網路上找很久了，那小蛙用的方法你一定都試過，應該也都還是失敗 … (跟小蛙一樣)，最後決定直接安裝 JRE 1.8。來看一下這討人厭的錯誤訊息

Exception in thread "main" javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure
     at sun.security.ssl.Alerts.getSSLException(Alerts.java:192)
     at sun.security.ssl.Alerts.getSSLException(Alerts.java:154)
     at sun.security.ssl.SSLSocketImpl.recvAlert(SSLSocketImpl.java:1959)
     at sun.security.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:1077)
     at sun.security.ssl.SSLSocketImpl.performInitialHandshake(SSLSocketImpl.java:1312)
     at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1339)
     at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1323)
     at sun.net.www.protocol.https.HttpsClient.afterConnect(HttpsClient.java:563)
     at sun.net.www.protocol.https.AbstractDelegateHttpsURLConnection.connect(AbstractDelegateHttpsURLConnection.java:185)
     at sun.net.www.protocol.https.HttpsURLConnectionImpl.connect(HttpsURLConnectionImpl.java:153)
     at TESTSSL.downloadRemoteImage(TESTSSL.java:37)
     at TESTSSL.downloadRemoteImage(TESTSSL.java:53)
     at TESTSSL.main(TESTSSL.java:74)

直接看小蛙 Eclipse 的設定，Compiler 的地方使用 1.7

Java Build Path 也是使用 jdk 1.7.0_45

Run Configurations 的 JRE 設定也是選擇 jdk 1.7.0_45

執行下去就是這個錯誤 …

如果手動安裝了 JRE 8，然後把 Run Configurations 的 JRE 設定成 JRE 8

就打完收工了 … 真的是太敢動 (嗚嗚嗚)，原本小蛙一直想要在 1.7 的環境下想辦法處理，試了一大堆方法沒有一個可以動的，因為改來改去改到亂七八糟，就連把環境升上 1.8 也都還是不行 … 後來發現 Eclipse 執行的時候可以選擇運行環境，就決定專案的 Compiler 跟 Build Path 維持 1.7，Run Configurations 改成 JRE 1.8 … 不想繼續糾結下去 Orz … 但有一些 JSP 環境下沒辦法這樣處理的還是很頭大啊 ><

這篇文章 javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure 抗戰歷程 最早出現於 記下來。

平常瀏覽網頁的時候也會遇到，當送出表單後，點選「上一頁」常可以看到文件已過期，或是重新傳送這些資料才可以正確顯示之類的錯誤訊息，記得以前會看到ERR_CACHE_MISS錯誤的字樣，小蛙這次遇到的只有顯示如下圖

小蛙接手處理的這個系統則是原本點選上一頁沒有問題，經過資安掃描修正後發生的，Google 及跟處理過該狀況的同事討論過之後找到相同的答案，如果在 header 中加入Cache-Control: private的設定，就可以解決掉這個問題！

PHP

// 在 session_start(); 後加入
header("Cache-Control:private");

JSP

response.setHeader("Cache-Control", "private");

參考資料：

• Chrome浏览器对于POST页面执行history.back返回或表单数据丢失的解决办法
  (連結失效 https://www.unixso.com/Php/post-header.html)
• ERR_CACHE_MISS 搜尋回上一頁空白或錯誤
• ERR_CACHE_MISS 上一页提示确认重新提交表单

這篇文章 Post 後上一頁 history.back() 發生文件已到期/認重新提交表單 ERR_CACHE_MISS 最早出現於 記下來。