Atenção: em breve, haverá grandes mudanças na API que exigirão um trabalho de migração. Para ver as atualizações, consulte com frequência nossa página de lançamentos.
A versão 4.9 da API foi lançada. Consulte o registro de alterações.

Fazer upload de mídia

Você pode usar os dois métodos a seguir para fazer o upload de mídia na API Google My Business:

Fazer upload usando um URL

Se você quiser fazer o upload de fotos para a API Google My Business usando um URL, chame Media.Create. Use a categoria relevante conforme necessário.

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

Se você quiser usar um URL para enviar vídeos, chame 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",
}

Fazer upload usando bytes

Se você quiser fazer o upload de mídia para a API Google My Business usando bytes, siga as etapas abaixo:

  1. Para iniciar o upload, faça a seguinte chamada:

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

    A resposta da API retorna um corpo que contém uma MediaItemDataRef:

      {
      "resourceName": "GoogleProvidedValue",
      }
  2. Use o resourceName retornado pela chamada feita na etapa anterior para fazer o upload do bytes. Veja a seguir um exemplo em que a mídia enviada é uma foto:

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

    Veja a seguir um exemplo em que a mídia é um vídeo:

    curl -X POST -T ~/Downloads/videoToUpload.mp4  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"
  3. Chame Media.Create usando o resourceName retornado na Etapa 1. Use o mediaFormat e a categoria relevantes.

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