Google で投稿を作成する

Google My Business API を使用すると、Google 検索に表示される各カテゴリ（ニュース、イベント、特典など）の投稿を作成できます。

このチュートリアルでは、次の方法を説明します。

始める前に

Google My Business API を使用するには、事前にアプリケーションを登録して、OAuth 2.0 の認証情報を取得する必要があります。

Google My Business API の使用方法について詳しくは、基本設定をご覧ください。

イベントの投稿

ビジネスの次のイベントについて、顧客に投稿で通知します。イベントの投稿には、開始日時と終了日時が含まれています。これらの日時は、投稿で目立つように表示されます。

ユーザーに関連付けられているアカウントに投稿するには、accounts.locations.localPosts API を使用します。

認証済みユーザーの投稿を作成するには、次のように記述します。

HTTP
$ POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts
{
  "languageCode": "en-US",
  "summary": "Come in for our spooky Halloween event!",
  "event": {
    "title": "Halloween Spook-tacular!",
    "schedule": {
        "startDate": {
            "year": 2017,
            "month": 10,
            "day": 31,
          },
          "startTime": {
              "hours": 9,
              "minutes": 0,
              "seconds": 0,
              "nanos": 0,
          },
          "endDate": {
            "year": 2017,
            "month": 10,
            "day": 31,
          },
          "endTime": {
              "hours": 17,
              "minutes": 0,
              "seconds": 0,
              "nanos": 0,
          },
    }
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://www.google.com/real-image.jpg",
    }
  ],
  "topicType": "EVENT"
}

行動を促すフレーズの投稿

行動を促すフレーズの投稿にはボタンが含まれます。行動を促すフレーズのボタンのテキストは、投稿の actionType フィールドで定義されます。このボタンには、ユーザーが指定した URL へのリンクが追加されます。

行動を促すフレーズのボタンを含む投稿を作成するには、次のように記述します。

HTTP
$ POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts
{
  "languageCode": "en-US",
  "summary": "Order your Thanksgiving turkeys now!!",
  "callToAction": {
    "actionType": "ORDER",
    "url": "http://google.com/order_turkeys_here",
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://www.google.com/real-turkey-photo.jpg",
    }
  ],
  "topicType": "OFFER"
}

行動のタイプ

行動を促すフレーズの投稿は、行動を促すフレーズの投稿のタイプを決定するさまざまな行動のタイプがあります。

サポートされている行動を促すフレーズのタイプは次のとおりです。

行動のタイプ
BOOK 時間、席などを予約するようにユーザーに促す投稿を作成します。
ORDER ユーザーに注文を促す投稿を作成します。
SHOP ユーザーに商品カタログの閲覧を促す投稿を作成します。
LEARN_MORE ユーザーにウェブサイトで詳細を確認するように促す投稿を作成します。
SIGN_UP ユーザーに登録、申し込み、参加を促す投稿を作成します。
CALL ユーザーに電話問い合わせを促す投稿を作成します。

特典情報の投稿

特典情報の投稿を作成するには、次のように記述します。

HTTP
$ POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts
{
  "languageCode": "en-US",
  "summary": "Buy one Google jetpack, get a second one free!!",
  "offer": {
       "couponCode": “BOGO-JET-CODE”,
       "redeemOnlineUrl": “https://www.google.com/redeem”,
       "termsConditions": “Offer only valid if you can prove you are a time traveler”
  },
  "media": [
    {
      "mediaFormat": "PHOTO",
      "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg",
    }
  ],
  "topicType": "OFFER"
}

投稿の編集

作成した投稿は、PATCH リクエストで編集できます。

投稿を編集するには、次のように記述します。

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

投稿の削除

作成した投稿は、DELETE リクエストで削除できます。

投稿を削除するには、次のように記述します。

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}