Внимание! Вышла версия API 4.7. Подробная информация приведена в истории изменений. Публикации, связанные с COVID-19, по-прежнему временно разрешены для торговых сетей.

Загрузка медиаресурсов

Загрузить медиаресурсы в Google My Business API можно двумя способами:

Загрузка с помощью URL

Чтобы загрузить фотографии в Google My Business API с помощью URL, отправьте приведенный ниже вызов в 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, используя значение resourceName, полученное на шаге 1. Укажите подходящий формат и категорию.

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