Verifications API と Business Information API がリリースされました。移行作業が必要です。サポートが終了したエンドポイントについて詳しくは、サポート終了スケジュールをご覧ください。メーリング リストに登録して最新情報をお受け取りいただくこともできます。

メディアをアップロードする

Google My Business API にメディアをアップロードする方法は 2 つあります。

URL からアップロードする

URL を使って Google My Business API に写真をアップロードするには、Media.Create に対して次の呼び出しを行います。必要に応じて、適切なカテゴリを使用してください。

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "PHOTO",
  "locationAssociation": {
    "category": "COVER"
  },
  "sourceUrl": “http://example.com/biz/image.jpg",
}

URL を使って動画をアップロードするには、Media.Create に対して次の呼び出しを行います。

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "VIDEO",
  "locationAssociation": {
    "category": "ADDITIONAL"
  },
  "sourceUrl": “http://example.com/biz/video.mp4",
}

バイトからアップロードする

バイトから Google My Business API にメディアをアップロードする手順は次のとおりです。

  1. 次の呼び出しを行って、アップロードを開始します。

      POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media:startUpload
      

    API からのレスポンスで MediaItemDataRef を含む本文が返されます。

      {
      "resourceName": "GoogleProvidedValue",
      }
  2. 前の手順の呼び出しで返された resourceName を使用して、バイトをアップロードします。アップロードするメディアが写真の場合は、次の例のように指定します。

    curl -X POST -T ~/Downloads/pictureToUpload.jpg  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"

    メディアが動画の場合は、次のように指定します。

    curl -X POST -T ~/Downloads/videoToUpload.mp4  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"
  3. 次のように Media.Create を呼び出します(手順 1 で返された resourceName を使用します)。適切な mediaFormatcategory を使用してください。

      POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
      {
        "mediaFormat": "PHOTO",
        "locationAssociation": {
          "category": "COVER"
        },
        "dataRef": {
          "resourceName": "GoogleProvidedValue"
        },
      }
      POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
      {
        "mediaFormat": "VIDEO",
        "locationAssociation": {
          "category": "ADDITIONAL"
        },
        "dataRef": {
          "resourceName": "GoogleProvidedValue"
        },
      }