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 .