Google Business Profile API を利用することで、Bubble から Google マップに投稿された口コミを取得・編集・削除 することが可能です。本記事では、Bubble の API Connector を使って、Google 口コミの取得・返信・削除を行う方法を解説します。
事前準備
アクセストークンの取得
Google Business Profile(GBP) APIを使用するには、まずOAuth2.0認証を行いアクセストークンを取得する必要があります。
アクセストークンを取得する方法は以下の記事で解説しています。
Google Calendar API や Google Drive API、Gmail API などの Google アカウントに紐づいたサービスを Bubbleで利用するには、OAuth 2.0 を使用した認証が必要です。本記事では[…]
店舗情報の取得
口コミを取得するには、事前にLocationのIDを取得しておく必要があります。
LocationIDを取得する方法は以下の記事を参考にしてください。
Google Business Profile API を利用することで、Bubble から Google マップに投稿された口コミを取得・編集・削除 することが可能です。本記事では、Bubble の API Connector を使って[…]
必須の API & 設定
Google 口コミを操作するには、以下の API を有効にする必要があります。
API名 | 用途 | 申請の有無 |
---|---|---|
Business Profile API | 口コミ取得 | 必要 |
Google Cloud Console で上記の API を有効化し、OAuth 2.0 認証を設定してください。
サイドメニューの「APIとサービス」→「ライブラリ」から使用したいGoogle APIを検索し、APIの詳細画面でそのAPIを有効化します。
口コミ一覧の取得
Google Business Profile API を使って、特定のビジネスの口コミを取得します。
メソッドとエンドポイント
メソッド | GET |
エンドポイント | https://mybusiness.googleapis.com/v4/[accountId]/[locationId]/reviews |
Use as | Action |
URL Parameters
この項目はエンドポイントを入力すると表示されます
accountId | アカウント情報を取得した時のaccount.name “accounts/*********” の形式 |
locationId | Location情報を取得した時のlocation.name “locations/*********” の形式 |
Headers
Authorization | Bearer [アクセストークン] |
アクセストークンについて
アクセストークンの有効期限は1時間です。期限が切れたアクセストークンを使用してAPIにアクセスしようとすると“401 UNAUTHENTICATED”のようなエラーレスポンスが返されます。
この際、再度アクセストークンを取得するためには「リフレッシュトークン」を使用して、アクセストークンを取得し直す必要があります。
詳細はこちら
Parameters
parameter | value | allow blank | 説明 |
---|---|---|---|
pageSize | 50 | no | 取得する口コミの最大数(最大 50 件) |
pageToken | 取得したnextPageToken | yes | このAPIを実行した後、まだレビューがある場合のレスポンスに含まれます。 初回は空白で設定 |
レスポンスの解説
レスポンス例
{"reviews": [{"reviewId": "0123456","reviewer": {"profilePhotoUrl": "https://asdfggh","displayName": "山田太郎"},"starRating": "FIVE","createTime": "2000-12-19T04:42:20.899442Z","updateTime": "2000-12-19T04:42:20.899442Z","reviewReply": {"comment": "ビジネスオーナーの返信が表示されます","updateTime": "2000-12-20T04:42:20.899442Z"},"name": "accounts/1241234/locations/1234134/reviews/A12341234123","comment": "口コミ内容が表示されます"}],"averageRating": 4.900000095367432,"totalReviewCount": 200,"nextPageToken": "12351235123"}
項目 | 内容 |
---|---|
reviews.reviewId | 各レビューのID |
reviews.reviewer.profilePhotoUrl | 各レビューのユーザー画像 |
reviews.reviewer.displayName | 各レビューの表示名 |
reviews.starRating | 各レビューの評価(星) |
reviews.createTime | 各レビューの作成時刻 |
reviews.updateTime | 各レビューの更新時刻 |
reviews.reviewReply.comment | 各レビューのオーナー返信コメント |
reviews.reviewReply.updateTime | 各レビューのオーナー返信更新時刻 |
reviews.name | 各レビューのname accounts/[アカウントID]/locations/[ロケーションID]/reviews/[レビューID] |
reviews.comment | 各レビューの口コミ内容 |
averageRating | 口コミ全体の平均評価 |
totalReviewCount | 口コミの総数 |
nextPageToken | 次のレビューリストを取得するためのトークン |