Gmail APIの設定とサンプルプログラムを動かすまで

Gmail APIをPHPから呼び出してメール情報を取得しようとしたが、苦戦したのでその時のメモを残す。
その際、以下の公式のページを参考に設定した。

Gmail APIの申請方法
https://developers.google.com/gmail/api/quickstart/php

# Gmail APIの設定

1.[Step 1: Turn on the Gmail API]の[this wizard]のリンクをクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/700e182c-23ea-1c3a-29f0-7eba0d62239d.png)

2.[続行]をクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/9b2ba792-4bdc-bc43-4a90-ac0f9e4528eb.png)

3.[認証情報に進む]をクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/01e85ad9-19c7-9376-1c08-f13665ca4202.png)

4.[プロジェクトへの認証情報の追加]で[キャンセル]をクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/620d0d0e-4c55-7c50-fce3-aae260376f64.png)

5.[OAuth 同意画面]タブをクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/26876e1d-00e0-13b7-6bd7-66d015bebfc3.png)

6.メールアドレスと適当なサービス名を入力して保存する
![図1.png](https://qiita-image-store.s3.amazonaws.com/0/129824/a5b107ca-f6c2-aac5-918c-d0e647fc0fcd.png)


7.[その他]を選択して、"Gmail API Quickstart"と入力して[作成]をクリックする
![image.png](https://qiita-image-store.s3.amazonaws.com/0/129824/66813d87-58c3-bb75-fb08-51b68f9f1635.png)

8.右側のダウンロードのアイコンをクリックし、JSONをダウンロードする
![No8.png](https://qiita-image-store.s3.amazonaws.com/0/129824/60268b93-9f0e-081d-7341-e6a275ecb8b8.png)

9.ダウンロードしたJSONファイルは、メール取得のプログラムと同じディレクトリに置く。その際、JSONファイルの名前をclient_secret.jsonに変更する

# Google Client Libraryのインストール
Composerを用いて以下のコマンドを実行する

```
php composer.phar require google/apiclient:^2.0
```

**composer.pharをJSONファイルと同じディレクトリに置いて、上記のコマンドを実行する**

# サンプルプログラムを実行
1.以下のプログラムをquickstart.phpという名前でclient_secret.jsonと同じディレクトリに保存する

```
<?php
require_once __DIR__ . '/vendor/autoload.php';


define('APPLICATION_NAME', 'Gmail API PHP Quickstart');
define('CREDENTIALS_PATH', '~/.credentials/gmail-php-quickstart.json');
define('CLIENT_SECRET_PATH', __DIR__ . '/client_secret.json');
// If modifying these scopes, delete your previously saved credentials
// at ~/.credentials/gmail-php-quickstart.json
define('SCOPES', implode(' ', array(
  Google_Service_Gmail::GMAIL_READONLY)
));

if (php_sapi_name() != 'cli') {
  throw new Exception('This application must be run on the command line.');
}

/**
 * Returns an authorized API client.
 * @return Google_Client the authorized client object
 */
function getClient() {
  $client = new Google_Client();
  $client->setApplicationName(APPLICATION_NAME);
  $client->setScopes(SCOPES);
  $client->setAuthConfig(CLIENT_SECRET_PATH);
  $client->setAccessType('offline');

  // Load previously authorized credentials from a file.
  $credentialsPath = expandHomeDirectory(CREDENTIALS_PATH);
  if (file_exists($credentialsPath)) {
    $accessToken = json_decode(file_get_contents($credentialsPath), true);
  } else {
    // Request authorization from the user.
    $authUrl = $client->createAuthUrl();
    printf("Open the following link in your browser:\n%s\n", $authUrl);
    print 'Enter verification code: ';
    $authCode = trim(fgets(STDIN));

    // Exchange authorization code for an access token.
    $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);

    // Store the credentials to disk.
    if(!file_exists(dirname($credentialsPath))) {
      mkdir(dirname($credentialsPath), 0700, true);
    }
    file_put_contents($credentialsPath, json_encode($accessToken));
    printf("Credentials saved to %s\n", $credentialsPath);
  }
  $client->setAccessToken($accessToken);

  // Refresh the token if it's expired.
  if ($client->isAccessTokenExpired()) {
    $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
    file_put_contents($credentialsPath, json_encode($client->getAccessToken()));
  }
  return $client;
}

/**
 * Expands the home directory alias '~' to the full path.
 * @param string $path the path to expand.
 * @return string the expanded path.
 */
function expandHomeDirectory($path) {
  $homeDirectory = getenv('HOME');
  if (empty($homeDirectory)) {
    $homeDirectory = getenv('HOMEDRIVE') . getenv('HOMEPATH');
  }
  return str_replace('~', realpath($homeDirectory), $path);
}

// Get the API client and construct the service object.
$client = getClient();
$service = new Google_Service_Gmail($client);

// Print the labels in the user's account.
$user = 'me';
$results = $service->users_labels->listUsersLabels($user);

if (count($results->getLabels()) == 0) {
  print "No labels found.\n";
} else {
  print "Labels:\n";
  foreach ($results->getLabels() as $label) {
    printf("- %s\n", $label->getName());
  }
}

```

2.以下のコマンドを実行する
```php quickstart.php
```
3.リンクが出力されるのでWebブラウザでアクセスする
4.googleの認証ページにアクセスされ、googleアカウントにログインする
5.遷移先のコードを実行中のコマンドラインに貼り付けエンターを押す。
6.~/.credentials/gmail-php-quickstart.jsonが作成される

もう一度、php quickstart.phpを実行すると成功する。