gbp-api-automation

GBP API と自動化

Google Business Profile API の機能と、大規模なプログラムによる管理に精通しています。目標は、企業や代理店が 10～500 か所以上の拠点における GBP の運用を、効率的かつ安全に自動化できるよう支援することです。

API の概要

Google は GBP の機能を複数の API に分割しています。

Google My Business API（レガシー）

• 新しい API に置き換えられる予定です
• 移行期間中も一部のエンドポイントは引き続き利用できます
• 開発を始める前に、現在の廃止状況を確認してください

現行の API（2026 年初頭時点）

Business Profile API

• アカウントと拠点の管理
• 拠点の確認
• ビジネス情報の読み取り・更新

Business Information API

• カテゴリ、属性、チェーン
• 拠点の詳細情報に対する CRUD 操作
• 拠点の検索

Business Profile Performance API

• インプレッション、アクション、ルート検索リクエスト
• 検索キーワードデータ
• 過去のパフォーマンス指標

My Business Notifications API

• プロフィールの変更に関する Webhook 通知 -クチコミ通知
• 質問通知

My Business Q&A API

• Q&A の閲覧と返信

My Business Lodging API

• ホテル固有のデータと機能

My Business Verifications API

• 確認手続きの開始と完了

別の API が必要な機能

• クチコミ：API で読み取れますが、返信には別のアクセス権が必要です
• 投稿：GBP の投稿は API で作成できます
• 写真：メディアのアップロードと管理
• インサイト：パフォーマンスデータの抽出

---

認証とセットアップ

要件

1. Google Cloud プロジェクト
2. 関連する Business Profile API の有効化
3. OAuth 2.0 認証情報（サービスアカウントまたはウェブアプリフロー）
4. GBP アカウントへのアクセス権（オーナーまたは管理者のロール）
5. API クォータの承認（上限引き上げを希望する場合）

アクセスレベル

• オーナー：API へのフルアクセスが可能で、ユーザーを管理できます
• 管理者：所有権の移行を除く、ほとんどの操作が可能です
• コミュニケーション管理者：投稿、Q&A、クチコミのみ操作できます

レート制限

• デフォルトのクォータは、一括操作には制限が厳しくなっています
• Google Cloud Console からクォータの引き上げを申請してください
• API 呼び出しを減らすため、リクエストをバッチ処理してください
• レート制限エラーに備えて、指数バックオフを実装してください
• 適切な場合はレスポンスをキャッシュしてください

---

一般的な自動化パターン

ビジネス情報の一括更新

For each location:
  1. Read current data
  2. Compare to master database
  3. Patch only changed fields
  4. Log changes for audit

注意：一度に更新する拠点が多すぎると、自動審査が行われる可能性があります。更新は数時間から数日に分けてください。

投稿の自動化

For each location:
  1. Generate post from template + location variables
  2. Attach location-specific photo
  3. Create post via API
  4. Log post ID and timestamp
  5. Schedule next post

頻度：拠点ごとに週 1～3 件投稿してください。すべての拠点に同じ内容を同時に投稿しないでください。

クチコミのモニタリング

On schedule (hourly/daily):
  1. Fetch new reviews for all locations
  2. Classify sentiment and urgency
  3. Route negative reviews for immediate response
  4. Queue positive reviews for batch response
  5. Track metrics (count, rating, velocity)

パフォーマンスデータの抽出

Monthly:
  1. Pull performance metrics for all locations
  2. Aggregate into reporting database
  3. Generate comparison reports
  4. Flag locations with declining metrics

確認手続きの管理

For new locations:
  1. Create location
  2. Initiate verification
  3. Track verification status
  4. Retry if verification expires
  5. Alert on failures

---

API 利用による停止リスク

リスクの高い操作

• 名前の一括変更（正当な変更でも審査の対象になることがあります）
• カテゴリの一括変更
• 多数の新しい拠点を短期間で作成する
• 多数の拠点の住所を同時に更新する
• テンプレートの使い回しやスパムのように見える自動生成コンテンツ

リスクの軽減策

• 一括操作は数日から数週間に分けて行ってください
• 主要な項目は一度に 1 つずつ変更してください（名前、住所、カテゴリをまとめて更新しないでください）
• 一括操作後に停止のフラグが付いていないか確認してください
• API によるすべての変更について、詳細な監査ログを保管してください
• 全拠点に適用する前に、少数の拠点で変更をテストしてください
• Google の更新が予定されている時期には、変更を避けてください

安全性の高い操作（停止リスクが低い）

• データの読み取り・エクスポート
• 営業時間の更新
• 写真の追加
• 投稿の作成（適切な頻度で行う場合）
• クチコミへの返信
• 説明の更新
• サービスや商品情報の追加

---

サードパーティプラットフォーム

カスタム API 統合を構築したくないチーム向け：

拠点管理プラットフォーム

• Yext：エンタープライズ向け拠点データ管理
• Uberall：複数拠点向けマーケティングプラットフォーム
• Rio SEO：エンタープライズ向けローカルマーケティング
• Synup：拠点管理と分析
• BrightLocal：代理店向けローカル SEO ツール

GBP 専用ツール

• Whitespark：リスティングの管理と追跡
• Local Viking：GBP の管理と投稿
• Publer / Loomly：ソーシャルメディアと GBP の投稿

構築と購入の判断

要素	カスタム構築	プラットフォームを利用
拠点数	具体的なニーズがある50拠点以上	何拠点でも
予算	開発リソースを確保できる	月額SaaS予算がある
カスタマイズ	独自のワークフローが必要	標準的なワークフローで問題ない
メンテナンス	継続的にメンテナンスできる	マネージドソリューションを利用したい
データの所有権	生データへのアクセスが必要	レポートで十分

---

複数拠点向けのデータアーキテクチャ

拠点マスターデータベース

必須フィールド：

• 拠点 ID（内部）
• Google Place ID
• GBP アカウント／拠点の参照情報
• ビジネス名（正式名称）
• 住所（USPS 形式）
• 電話番号（E.164 形式）
• メインカテゴリ
• 追加カテゴリ
• サービス提供地域
• 営業時間（通常＋特別）
• ウェブサイト URL
• ステータス（有効、停止、保留中）
• 最終更新タイムスタンプ

同期ロジック

Master DB → API → GBP
         ↑
API reads ← GBP (detect unauthorized edits)

マスターデータと GBP 上の最新データとの不一致を監視します。Google やユーザーが編集を提案し、データが上書きされる場合があります。

---

監視とアラート

監視対象

• 未承認の編集：Google またはユーザーがデータを変更した
• 停止イベント：拠点が停止または無効化された
• クチコミアラート：新しいクチコミ（特に否定的なもの）
• 確認ステータス：拠点の確認が失われた
• パフォーマンスの異常：インプレッション数またはアクション数の急激な減少
• API エラー：操作の失敗、レート制限、認証の問題

アラートの優先度

• P0（即時）：停止、確認の喪失、ビジネス名の変更
• P1（当日中）：否定的なクチコミ、住所の編集提案、営業時間の変更
• P2（翌営業日）：パフォーマンスの低下、新しい Q&A、肯定的なクチコミ
• P3（週次レビュー）：写真の提案、属性の変更、カテゴリの提案

---

タスク固有の質問

1. API 管理が必要な拠点はいくつありますか？
2. どの操作を自動化する必要がありますか？（更新、投稿、クチコミ、レポート作成）
3. カスタム構築とプラットフォームの利用、どちらにしますか？
4. 現在の技術スタックは何ですか？
5. Google Cloud プロジェクトと API 認証情報は誰が管理していますか？
6. 一括更新の変更管理プロセスはどうなっていますか？

---

次に行うこと

見つかったこと	次のアクション	スキル
API は設定済みで、何を最適化すべきか知りたい	拠点ごとの最適化基準を定める	gbp-optimization
複数拠点への投稿を自動化したい	拠点ごとの変数を使った投稿テンプレートを作成する	gbp-posts
API 操作によって停止が発生した	API 呼び出しを直ちに停止し、復旧プロセスに従う	gbp-suspension-recovery
レポート用にパフォーマンスデータを抽出したい	API 経由で指標を取得し、レポートに取り込む	local-reporting
大規模にクチコミを管理したい	クチコミの監視と返信のワークフローを設定する	review-management

次のデフォルトのステップ： API は配信手段です。まず最適化戦略を定め（gbp-optimization、multi-location-seo）、その後に自動化します。