Bubble で Google 口コミの一覧を取得する方法

Bubble で Google 口コミの一覧を取得する方法

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 を使用した認証が必要です。本記事では[…]

BubbleでGoogle OAuth 2.0 APIを設定する方法

店舗情報の取得

口コミを取得するには、事前にLocationのIDを取得しておく必要があります。
LocationIDを取得する方法は以下の記事を参考にしてください。

関連記事

Google Business Profile API を利用することで、Bubble から Google マップに投稿された口コミを取得・編集・削除 することが可能です。本記事では、Bubble の API Connector を使って[…]

Bubble で Google 口コミの一覧を取得する方法

必須の 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 asAction

URL Parameters
この項目はエンドポイントを入力すると表示されます

accountIdアカウント情報を取得した時のaccount.name
“accounts/*********” の形式
locationIdLocation情報を取得した時のlocation.name
“locations/*********” の形式

Headers

AuthorizationBearer [アクセストークン]

アクセストークンについて
アクセストークンの有効期限は1時間です。期限が切れたアクセストークンを使用してAPIにアクセスしようとすると“401 UNAUTHENTICATED”のようなエラーレスポンスが返されます。
この際、再度アクセストークンを取得するためには「リフレッシュトークン」を使用して、アクセストークンを取得し直す必要があります。
詳細はこちら

Parameters

parametervalueallow blank説明
pageSize50no取得する口コミの最大数(最大 50 件)
pageToken取得したnextPageTokenyesこの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次のレビューリストを取得するためのトークン