注意: チェーンによる COVID-19(新型コロナウイルス感染症)に関連する投稿が一時的に許可されています。また、Google マイビジネスは現在一部の機能を制限しています。一時的なサービスの変更に関する詳細をご確認ください。

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",
        }
      ],
    }
    

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

行動を促すフレーズの投稿にはボタンが含まれます。行動を促すフレーズのボタンのテキストは、投稿の 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",
        }
      ],
    }
    

行動のタイプ

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

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

行動のタイプ
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",
        }
      ],
    }
    

投稿の編集

作成した投稿は、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}