Method: photos.batchUpdate

Обновляет метаданные Photos , такие как поза, привязка к месту, связи и т. д. Изменение пикселей фотографий не поддерживается.

Обратите внимание, что в случае сбоя photos.batchUpdate либо отсутствуют критические поля, либо произошла ошибка аутентификации. Даже если photos.batchUpdate завершится успешно, отдельные фотографии в пакете могут иметь ошибки. Эти ошибки указаны в каждом параметре PhotoResponse.status в BatchUpdatePhotosResponse.results . Подробнее об ошибках, которые могут возникнуть для каждой фотографии, см. в описании photo.update .

Используются только поля, указанные в поле updateMask . Если updateMask отсутствует, обновление применяется ко всем полям.

Количество сообщений UpdatePhotoRequest в BatchUpdatePhotosRequest не должно превышать 20.

Примечание: Для обновления Pose.altitude необходимо также заполнить Pose.latLngPair . В противном случае запрос завершится ошибкой.

HTTP-запрос

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

URL использует синтаксис перекодировки gRPC .

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Поля
updatePhotoRequests[]

object

Обязательно. Список UpdatePhotoRequests .

updatePhotoRequests[].photo

object ( Photo )

Обязательно. Объект Photo , содержащий новые метаданные.

updatePhotoRequests[].updateMask

string ( FieldMask format)

Обязательно. Маска, определяющая поля метаданных фотографии для обновления. Если она отсутствует, старые метаданные Photo полностью заменяются новыми метаданными Photo в этом запросе. Обновление завершается ошибкой, если указаны недопустимые поля. Можно указать несколько полей, разделённых запятыми.

Допустимы следующие поля:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Примечание: Если updateMask содержит повторяющиеся поля, весь набор повторяющихся значений заменяется новым содержимым. Например, если updateMask содержит connections , а UpdatePhotoRequest.photo.connections пуст, все соединения удаляются.

Тело ответа

Ответ на пакетное обновление метаданных одной или нескольких Photos .

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Поля
results[]

object ( PhotoResponse )

Список результатов для каждой отдельной Photo обновлен в том же порядке, что и запрос.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Для получения более подробной информации см.OAuth 2.0 Overview .