Method: mediaItems.batchCreate

Создает один или несколько элементов мультимедиа в библиотеке Google Фото пользователя.

Это второй шаг создания медиа-элемента. Подробную информацию о шаге 1 (загрузка необработанных байтов на сервер Google) см. в разделе Загрузка мультимедиа .

Этот вызов добавляет элемент мультимедиа в библиотеку. Если указан id альбома, вызов также добавляет элемент мультимедиа в альбом. Каждый альбом может содержать до 20 000 медиа-элементов. По умолчанию элемент мультимедиа будет добавлен в конец библиотеки или альбома.

Если id альбома и позиция определены, элемент мультимедиа добавляется в альбом в указанную позицию.

Если вызов содержит несколько элементов мультимедиа, они добавляются в указанную позицию. Если вы создаете элемент мультимедиа в общем альбоме, владельцем которого вы не являетесь, вам не разрешено размещать этот элемент мультимедиа. Это приведет к ошибке BAD REQUEST .

HTTP-запрос

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

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

Тело запроса

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

JSON-представление
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Поля
albumId

string

Идентификатор альбома, в который добавляются элементы мультимедиа. Медиа-элементы также добавляются в библиотеку пользователя. Это необязательное поле.

newMediaItems[]

object ( NewMediaItem )

Необходимый. Список медиа-элементов, которые необходимо создать. Максимум 50 медиа-элементов за звонок.

albumPosition

object ( AlbumPosition )

Позиция в альбоме, куда добавляются элементы мультимедиа. Если не указано, элементы мультимедиа добавляются в конец альбома (в соответствии со значением по умолчанию, то есть LAST_IN_ALBUM ). Запрос завершается неудачно, если это поле установлено и не указан albumId . Запрос также не будет выполнен, если вы задали это поле и не являетесь владельцем общего альбома.

Тело ответа

Список созданных медиа-элементов.

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

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

object ( NewMediaItemResult )

Только вывод. Список созданных медиа-элементов.

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

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

НовыйМедиаЭлемент

Новый мультимедийный элемент, созданный в аккаунте пользователя в Google Фото.

JSON-представление
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Поля
description

string

Описание медиа-объекта. Это отображается пользователю в разделе информации об объекте в приложении Google Фото. Должно быть короче 1000 символов. Включайте только текст, написанный пользователями. Описания должны добавлять контекст и помогать пользователям понимать медиа. Не включайте автоматически сгенерированные строки, такие как имена файлов, теги и другие метаданные.

Поле объединения new_media_item_type . Новый медиа-элемент может быть разных типов — это зависит от пути загрузки. В настоящее время поддерживаемые загрузки используют только простой путь к элементу мультимедиа. new_media_item_type может быть только одним из следующих:
simpleMediaItem

object ( SimpleMediaItem )

Новый медиа-элемент, загруженный с помощью включенного uploadToken .

SimpleMediaItem

Простой медиа-элемент, который будет создан в Google Фото с помощью токена загрузки.

JSON-представление
{
  "uploadToken": string,
  "fileName": string
}
Поля
uploadToken

string

Токен, идентифицирующий байты мультимедиа, загруженные в Google.

fileName

string

Имя файла с расширением медиа-элемента. Это отображается пользователю в Google Фото. Имя файла, указанное в процессе загрузки байтов, игнорируется, если это поле установлено. Имя файла, включая расширение, не должно содержать более 255 символов. Это необязательное поле.

Ньюмедиаитемрезультат

Результат создания нового медиа-элемента.

JSON-представление
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Поля
uploadToken

string

Токен загрузки, используемый для создания этого нового (простого) элемента мультимедиа. Заполняется только в том случае, если элемент мультимедиа простой и требует одного токена загрузки.

status

object ( Status )

Если во время создания этого элемента мультимедиа произошла ошибка, это поле заполняется информацией, связанной с ошибкой. Подробную информацию об этом поле см. в разделе Статус .

mediaItem

object ( MediaItem )

Медиа-элемент, созданный с помощью токена загрузки. Он заполняется, если ошибок не произошло и элемент мультимедиа был успешно создан.