Listings API の概要
ListingsAPI アカウントの有効化と管理の方法を説明します。ガイドでは連携の始め方を順を追って説明し、エンドポイントの使い方ではリソースのすべてのエンドポイントを扱います。初めての方は最初の API 呼び出しから始めてください。
ここから始める
拠点
国・州・カテゴリを調べる
拠点を作成する前に、サポートされている国と州のコードを取得し、ビジネスカテゴリに対応する数値の ID を調べ、プランに含まれる掲載先を確認します。
ガイドを読む拠点を追加する
掲載先が必要とするフィールドを指定して拠点を作成し、検証エラーに対処して、送信用のキューに登録されたことを確認します。
ガイドを読む拠点の詳細と営業時間を更新する
連絡先情報を変更し、特定日の例外設定を含む1週間分のスケジュールを公開し、臨時休業を設定し、Google カテゴリを設定して、変更内容を再取得して確認します。
ガイドを読むロゴ、カバー画像、写真をアップロードする
URLを指定してロゴ、カバー画像、ギャラリー写真を拠点に添付し、添付済みの画像を一覧表示し、メイン画像にスターを付け、古くなった画像を削除します。
ガイドを読む拠点を検索し、管理対象でなくなった拠点をアーカイブする
キーワードで検索し、店舗コードとidから拠点を一括で取得し、閉鎖した支店を請求サイクルの終了時にアーカイブするよう予約し、アーカイブの予約を取り消します。
ガイドを読む掲載先を接続
Google Business Profile接続・拠点取込
Google接続リンクを作成し、オーナーのGoogle掲載情報を自分の拠点と照合して対応関係を確定し、対応する拠点がまだない掲載情報をインポートします。
ガイドを読むFacebookページを接続する
Facebookの接続リンクを作成し、オーナーのページを拠点と照合し、候補を確認してリンクを確定するか手動でリンクを選択し、クライアントとの契約が終了したらアカウントの接続を解除します。
ガイドを読むApple Business Connect に接続する
オーナーの確認済み Apple Business アカウントを通じて、またはオーナーにそのアカウントがない場合は ListingsAPI アカウントを通じて、拠点を Apple Maps に公開し、その後で掲載情報を確認して、クライアントが契約を終了したら接続を解除します。
ガイドを読む未登録の拠点に Google Business Profileを作成
接続済みの Google アカウント配下で、拠点の新しい Google Business Profileを作成するリクエストを送信し、拠点、その掲載情報、Webhook を通じて確認手続きの進行状況を追跡します。
ガイドを読む掲載情報
掲載情報のステータスを確認し、公開中のリンクを取得する
拠点のすべての掲載先の同期ステータスを読み取り、公開中の掲載情報のURLを収集し、掲載状況を集計し、音声アシスタントを確認し、ポーリングの代わりにWebhookで通知を受け取ります。
ガイドを読む掲載情報のエラーを見つけて修正する
拠点の掲載情報を対応が必要な行に絞り込み、掲載先が示す理由を確認し、原因に合った修正を適用して、安全に再ポーリングしたうえで、アカウント全体を確認します。
ガイドを読む重複する掲載情報を見つけて非表示にする
拠点単位およびアカウント全体で検出された重複する掲載情報を一覧表示し、実際の重複を非表示の対象として確定し、誤検出を除外して、それぞれが解決するまで追跡します。
ガイドを読むレビュー
1つの拠点またはアカウント全体のレビューを取得する
拠点の最新レビューを一覧表示し、未返信の低評価レビューに絞り込み、カーソルでページを順に取得し、アカウント全体を巡回して、Webhookで通知を受け取ります。
ガイドを読むレビューに返信し、返信を編集またはアーカイブする
オーナーからの返信を受け付けるレビューを探し、返信を投稿して掲載先に届いたことを確認してから、文面を修正するかアーカイブします。
ガイドを読むレビューのパフォーマンスを測定する
拠点のレビューのKPIを取得し、日別の推移をグラフにし、ソースを比較し、よく使われるフレーズを抽出し、日次および週次のスナップショットをWebhookで受信します。
ガイドを読む投稿
分析
自動化
AI エージェント
エンドポイントの使い方
拠点
拠点の全エンドポイントを、cURL、Python、Nodeのサンプルとともに、利用順に紹介します。一覧取得、検索、idと店舗コードによる取得、作成、更新、アーカイブ、写真管理を扱います。
ガイドを読む掲載情報
すべての掲載情報エンドポイントを、cURL、Python、Nodeのサンプルとともに紹介します。対象は、プレミアム掲載先の同期ステータス、音声アシスタント、拠点単位およびアカウント単位の重複検出、重複の非表示化です。
ガイドを読む接続済みアカウント
GoogleとFacebookの接続、アカウント一覧の取得、掲載情報の照合とリンク、フォルダー、GMB作成、接続解除に関する、接続済みアカウントの全エンドポイントを、cURL、Python、Nodeのサンプル付きで説明します。
ガイドを読むレビュー
すべてのレビューエンドポイントにcURL、Python、Nodeのサンプルを掲載しています。ソースと設定、一覧、集約、詳細、返信、編集、アーカイブ、フレーズ、分析を扱います。
ガイドを読む投稿
すべての投稿エンドポイントを、cURL、Python、Nodeのサンプルとともに紹介します。お知らせ、イベント、特典、スケジュール設定、拠点ごとおよび一括のキャンペーン、ステータスのポーリング、削除を扱います。
ガイドを読むSocial
Social の全エンドポイント：ブランド、ホスト型の接続リンク、単一および一括での公開、予約、インサイト、そしてこれらすべてに適用される接続数の上限です。
ガイドを読む分析
すべてのプロフィール分析エンドポイントと、cURL、Python、Node のサンプル：拠点の Google と Facebook の日次指標、および Bing の週次閲覧数を取得します。
ガイドを読む補助 API
補助 API の全エンドポイントを、cURL、Python、Node のサンプルとともに紹介します。対象は、サポートされている国と州、サブカテゴリカタログ、ご利用のプランに含まれる掲載先サイトです。
ガイドを読む