Laravel use Business Profile APIs

前置條件

前往 Google API 控制台，並選取您為商家檔案使用的專案。
如要確認專案 ID，請查看「Project ID」欄。
填寫並提交存取權申請表。
我們會在審查完成後，透過電子郵件通知您。
取得核准之後，請參閱「基本設定」來為專案啟用 Business Profile API。

送出審查表單後大約兩到三天就會收到一封確認信件，回信後大概兩三天就會收到審查通過的信件，就可以開始使用Business Profile API。

更多詳細內容

創建憑證

需先建立API金鑰以及OAuth

建立API金鑰

API部分需先將以下與商家檔案關聯API啟用:

啟用後建立，可以限制API可以呼叫的範圍

建立 OAuth 用戶端 ID

這邊填上要call back的url位置

建立好OAuth用戶端後點選下載JSON後面會用到

實戰範例

測試環境

"php": "^7.2",
"laravel/framework": "^7.0",

安裝Google client

下指令安裝googleapis/google-api-php-client

composer require google/apiclient:^2.12.1

安裝完成後你可以只選擇你需要的服務，有超過 200 個 Google API 服務。您很可能不想要所有這些。

composer/json:

{
    "require": {
        "google/apiclient": "^2.12.1"
    },
    "scripts": {
        "pre-autoload-dump": "Google\\Task\\Composer::cleanup"
    },
    "extra": {
        "google/apiclient-services": [
            "MyBusinessAccountManagement",
            "MyBusinessBusinessCalls",
            "MyBusinessBusinessInformation",
            "MyBusinessLodging",
            "MyBusinessNotificationSettings",
            "MyBusinessPlaceActions",
            "MyBusinessQA",
            "MyBusinessVerifications",
            "BusinessProfilePerformance"
        ]
    }
}

更改完成後記得下composer dump-autoload

新建`google`相關`config`檔案

新建完成後記得去 .env 檔案填入相關資訊

google.php

<?php

return [
    /*
    |----------------------------------------------------------------------------
    | Google application name
    |----------------------------------------------------------------------------
    */
    'application_name' => env('GOOGLE_APPLICATION_NAME', ''),

    /*
    |----------------------------------------------------------------------------
    | Google OAuth 2.0 access
    |----------------------------------------------------------------------------
    |
    | Keys for OAuth 2.0 access, see the API console at
    | https://developers.google.com/console
    |
    */
    'redirect_uri' => env('GOOGLE_REDIRECT_URI', ''),
    'scopes' => [
        'https://www.googleapis.com/auth/business.manage',
        'https://www.googleapis.com/auth/plus.business.manage',
    ],

    /*
    |----------------------------------------------------------------------------
    | Google developer key
    |----------------------------------------------------------------------------
    |
    | Simple API access key, also from the API console. Ensure you get
    | a Server key, and not a Browser key.
    |
    */
    'developer_key' => env('GOOGLE_DEVELOPER_KEY', ''),

    /*
    |----------------------------------------------------------------------------
    | Google service account
    |----------------------------------------------------------------------------
    */
    'service' => [
        /*
         * Path to service account json file. You can also pass the credentials as an array
         * instead of a file path.
         */
        'file' => env('GOOGLE_SERVICE_ACCOUNT_JSON_LOCATION', ''),
    ],
];

撈取商家檔案成效範例

接下來將透過API方式去取得經由商家檔案提出的路線要求次數

觀看文檔可以看到撈取商家相關數據是使用 Business Profile Performance API

接下來查看google已經寫好的services ->google-api-php-client-services

從下圖就可以看到使用此services的方法，那就實際操作試試

先到你管理的商家取得商家ID

創建Controller，並將{location_id}換成你的商家ID

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Google;

class TestController extends Controller
{
    public function __construct()
    {
        $this->client = new Google\Client();
        $this->client->setApplicationName(config('google.application_name'));
        $this->client->setDeveloperKey(config('google.developer_key'));
        $this->client->setAuthConfig(storage_path(config('google.service.file')));
        $this->client->addScope(config('google.scopes'));
    }

    public function redirect()
    {
        return redirect($this->client->createAuthUrl());
    }

    public function callback(Request $request)
    {
        $code = $request->get('code');
        $token = $this->client->fetchAccessTokenWithAuthCode($code);
        $this->client->setAccessToken($token);

        $businessprofileperformanceService = new Google\Service\BusinessProfilePerformance($this->client);
        $locations = $businessprofileperformanceService->locations;
        $location = $locations->getDailyMetricsTimeSeries('locations/{location_id}', [
            'dailyMetric' => 'BUSINESS_DIRECTION_REQUESTS',
            'dailyRange.endDate.day'    => 30,
            'dailyRange.endDate.month'  => 12,
            'dailyRange.endDate.year'   => 2022,
            'dailyRange.startDate.day'  => 1,
            'dailyRange.startDate.month'    => 7,
            'dailyRange.startDate.year' => 2022,
            // 'dailySubEntityType.timeOfDay.hours' => 0,
            // 'dailySubEntityType.timeOfDay.minutes' => 0,
            // 'dailySubEntityType.timeOfDay.nanos' => 0,
            // 'dailySubEntityType.timeOfDay.seconds' => 0,
        ]);
        $total = 0;
        foreach ($location->getTimeSeries() as $key => $value) {
            $date = $value->getDate();
            $total += $value->getValue();
        }
        return response()->json([
            'status' => 'success',
            'message' => '經由商家檔案提出的路線要求次數' . $total
        ], 200, [], JSON_UNESCAPED_UNICODE);
    }
}

路由:

Route::get('redirect/mybusiness', 'TestController@redirect');
Route::get('callback/google/mybusiness', 'TestController@callback');

完成後前往redirect/mybusiness，可以得到以下回傳值

{
    "status":"success",
    "message":"經由商家檔案提出的路線要求次數226"
}

如果要使用其他API也是依樣畫葫蘆，為以下步驟

需求 > 查看文檔 > 查找Google client services並使用

有些功能google還未其寫成services，就可以需要費點力了。

例如我們要對商家檔案的評論進行查看，仿照google撰寫services方式，之後就可以透過類似方法取得商家檔案相關評論。

$myBusinessAccountLocations = new MyBusinessAccountLocations($client);
$reviews = $myBusinessAccountLocations->reviews;
$resList = $reviews->listAccountsLocationsReviews('accounts/{acount_id}/locations/{location_id}');
foreach ($resList->getReviews() as $review) {
    // get the reply to the review
    $review->getComment();
}