Google Business Profile API

Google Business Profileへの投稿

以前はGoogle My Businessとして知られていたGoogle Business Profileでは、Google Business Profile APIを使用して4種類の投稿を作成できます。以下の例では、postテキストがユーザーのGoogleビジネスページへの更新として投稿されます。 Google Business Profile(GBP)の詳細についてはこちらをご覧ください。

AyrshareにリンクさせるまえにGoogle Business Profileページを請求する必要があります。リンク認証時には、GBPページの管理者であるGoogleアカウントを必ず選択してください。ビジネスプロフィールも認証済みで公開されている必要があります。GBPの管理コンソールへのアクセスや認証ステータスの確認はhttps://business.google.com/で行えます。

Google Business Profile APIでは、現在のところ商品投稿を作成できません。 GBPへのテキストのみの基本投稿用JSON。「What’s New」セクションに表示されます:

Google Business Profile Post

{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}

または、GBPへの画像付き基本投稿用JSON:

Google Business Profile Post with Image

{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}

動画がmp4などの既知の動画拡張子で終わらない場合は、isVideoパラメータを使用してください。詳細は/postエンドポイントを参照してください。
詳細については、Google Business ProfileメディアガイドラインおよびGoogle Business Profile認証をご覧ください。

Google Business Profile投稿の要件

投稿に以下の内容が含まれていないことを確認してください。Googleは投稿を拒否し、投稿は「この投稿は利用できなくなりました」または、Googleコンソールに「拒否済み」ラベル付きで表示されます:

電話番号。Googleは電話番号を含むすべての投稿を拒否します。
スパム、虚偽の主張、虚偽の表現。
ビジネスに関係のないオフトピックな投稿。
重複コンテンツ。
不適切なコンテンツ。
攻撃的な言葉。

詳細については、Google Business Profileのコンテンツポリシーをご覧ください。

標準投稿(What’s New)

標準ローカル投稿は、「Posts」GBPセクションに表示され、「What’s New」として分類されます。投稿テキスト、画像、またはCall to Action(下記参照)を含めることができます。 Google Business Profile API経由でWhat’s Newセクションに公開される動画はサポートされていません。 Google Business Profileへの動画公開方法の詳細については、画像または動画投稿を参照してください。 これらの投稿はGMB管理コンソールの「Posts -> What’s New」セクションに表示されます。

Google Business Profile Standard Post

{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}

画像または動画投稿

Google Business Profileに画像または動画の投稿を公開できます。画像や動画はGBP管理コンソールの「Photos」セクションに表示されます。

要件

GBPロケーションには、1つの画像または1つの動画のみを追加でき、これはGBPコンソールの「Photos」セクションに表示されます。
1つの投稿につき1つの画像または動画のみが許可されます。
投稿テキストはエンドポイントによって必要ですが、GBPでは使用されません。
画像または動画投稿では、Call to Actionはサポートされていません。
gmbOptionsオブジェクトに必ずisPhotoVideoパラメータを含めてください。

Google Business Profile Image Post

{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}

動画処理

Googleはアップロードされた動画の処理に追加時間を要する場合があります。 Google Business Profileコンソールでメディアのステータスを確認できます:

Google Business Profileコンソールにアクセスします。
「See your profile」ボタンをクリックします。GBPページに移動します。
「Photos」タブをクリックします。
写真と動画のリストが表示されます。
表示したい写真または動画をクリックします。

動画のステータスが「pending」の場合、Googleがまだ処理中です。数分待ってからページを更新してください。Google Business Profileが認証済みで、プロフィールが公開されていることを確認してください。動画が「pending」のままの場合、Google側のバグの可能性があります。サポートについては、Google Business supportにお問い合わせください。

商品カテゴリー

画像または動画に商品カテゴリーを指定して、GBPコンソールの「Photos」セクションにメディアを分類することができます。例えば、画像に「product」カテゴリーがあると、Photosの「Product」タブに表示されます。特定のビジネスタイプでは、一部のカテゴリーが許可されていません。例えば、Ayrshareは食品/飲料業界ではないため、food_and_drinkを使用できませんでした。利用可能なカテゴリー:

cover: カバー写真。1つのロケーションには1つのカバー写真のみが存在します。
profile: プロフィール写真。1つのロケーションには1つのプロフィール写真のみが存在します。
logo: ロゴ写真。
exterior: 外観メディア。
interior: 内観メディア。
product: 商品メディア。
at_work: 業務中メディア。
food_and_drink: 食品・飲料メディア。
menu: メニューメディア。
common_area: 共用エリアメディア。
rooms: 部屋メディア。
teams: チームメディア。

イベント投稿

ビジネスでのイベントを告知します。イベントにはタイトル、開始日と終了日が必要で、動画を含めることができます。例えば、不動産業者がオープンハウスの内覧会を宣伝することができます。

イベントはCall to Actionをサポートします。
mediaUrlsパラメータでオプションの画像を含めます。
イベントでは動画はサポートされていません。
イベント投稿はGBP管理コンソールの「Posts -> Events」セクションに表示されます。
postテキストはイベント詳細に使用されます。

Google Business Profile Event Post

{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}

オファー投稿

ビジネスからのプロモーション・セールやオファーを提供します。オファーにはタイトルと開始日時、終了日時が必要です。「View offer」アクションボタンが投稿に自動的に追加されます。写真、説明、クーポンコード、リンク、利用規約も投稿に含めることができます。例えば、おもちゃ店が1週間、すべてのビニーベイビーを20%オフで宣伝することができます。 mediaUrlsパラメータで画像を含めます。 オファーでは動画はサポートされていません。 これらの投稿はGBP管理コンソールの「Posts -> Offers」セクションに表示されます。

Google Business Profile Offers Post

{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}

couponCodeの最大文字数は58文字です。

Call to Action

ビジネスに関する一般情報を提供し、アクションボタンとして表示されます。例えば、ウェブサイトが自社サイトへのリダイレクトとして_Learn More_ボタンを宣伝することができます。 Call to Actionは標準投稿またはイベントに追加できます。オファーにはCall to Actionを追加できません。 mediaUrlsパラメータで画像を含めます。

Google Business Profile Call to Action Post

{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}

actionTypeは投稿にボタンとして表示されます。可能な値は以下のとおりです:

book: ユーザーに予約、テーブル予約、または類似のアクションを促します。
order: ユーザーに注文を促します。
shop: ユーザーに商品カタログの閲覧を促します。
learn_more: ユーザーにウェブサイトでの追加詳細の閲覧を促します。
sign_up: ユーザーに登録、サインアップ、または参加を促します。
call: ユーザーにビジネスへの電話発信を促します。callではurlフィールドは不要です。ただし、Call actionを投稿に表示させるには、まずGoogle Business Profileに電話番号を設定しておく必要があります。

urlパラメータは、クリック時にユーザーが誘導されるURLです。追加のGoogle Business Profile情報はこちら。

Google Business Profileの連携

First Comment

Google Business Profileは投稿コメントをサポートしていないため、Google Business Profileのみの投稿ではfirstCommentパラメータはスキップされます。 firstCommentの警告/スキップオブジェクトが返されますが、投稿自体は成功し、エラーは発生しません。

Google Business Profileのメンション

Google Business Profileの投稿に@handleを追加できますが、Google Business Profileは投稿テキスト内のメンション解決をサポートしていません。 @handleはプレーンテキストとして残ります。

文字数制限

詳細については、Google Business Profileの文字数制限を参照してください。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Google Business Profileへの投稿

Google Business Profile投稿の要件

標準投稿(What’s New)

画像または動画投稿

要件

動画処理

商品カテゴリー

イベント投稿

オファー投稿

Call to Action

Google Business Profileの連携

First Comment

Google Business Profileのメンション

文字数制限

​Google Business Profileへの投稿

​Google Business Profile投稿の要件

​標準投稿(What’s New)

​画像または動画投稿

​要件

​動画処理

​商品カテゴリー

​イベント投稿

​オファー投稿

​Call to Action

Google Business Profileの連携

​First Comment

​Google Business Profileのメンション

​文字数制限

Google Business Profileへの投稿

Google Business Profile投稿の要件

標準投稿(What’s New)

画像または動画投稿

要件

動画処理

商品カテゴリー

イベント投稿

オファー投稿

Call to Action

First Comment

Google Business Profileのメンション

文字数制限