Method: mediaItems.batchCreate

Cria um ou mais itens de mídia na biblioteca do Google Fotos de um usuário.

Esta é a segunda etapa para criar um item de mídia. Para saber mais sobre a etapa 1, o upload dos bytes brutos para um servidor do Google, consulte Fazer upload de mídia.

Essa chamada adiciona o item de mídia à biblioteca. Se um id de álbum for especificado, a chamada também vai adicionar o item de mídia ao álbum. Cada álbum pode conter até 20.000 itens de mídia. Por padrão, o item de mídia será adicionado ao final da biblioteca ou do álbum.

Se um id e uma posição do álbum estiverem definidos, o item de mídia será adicionado ao álbum na posição especificada.

Se a chamada tiver vários itens de mídia, eles serão adicionados na posição especificada. Se você estiver criando um item de mídia em um álbum compartilhado em que não é o proprietário, não poderá posicioná-lo. Isso vai resultar em um erro BAD REQUEST.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Campos
albumId

string

Identificador do álbum em que os itens de mídia são adicionados. Os itens de mídia também são adicionados à biblioteca do usuário. Esse campo é opcional.

newMediaItems[]

object (NewMediaItem)

Obrigatório. Lista de itens de mídia a serem criados. Máximo de 50 itens de mídia por chamada.

albumPosition

object (AlbumPosition)

Posição no álbum em que os itens de mídia são adicionados. Se não for especificado, os itens de mídia serão adicionados ao final do álbum (conforme o valor padrão, ou seja, LAST_IN_ALBUM). A solicitação falhará se esse campo estiver definido e o albumId não for especificado. A solicitação também falhará se você definir o campo e não for o proprietário do álbum compartilhado.

Corpo da resposta

Lista de itens de mídia criados.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Campos
newMediaItemResults[]

object (NewMediaItemResult)

Apenas saída. Lista de itens de mídia criados.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

NewMediaItem

Novo item de mídia criado na conta do Google Fotos de um usuário.

Representação 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.
}
Campos
description

string

Descrição do item de mídia. Essa informação é mostrada ao usuário na seção de informações do item no app Google Fotos. O texto precisa ter menos de 1.000 caracteres. Inclua apenas textos escritos pelos usuários. As descrições devem adicionar contexto e ajudar os usuários a entender a mídia. Não inclua strings geradas automaticamente, como nomes de arquivos, tags e outros metadados.

Campo de união new_media_item_type. O novo item de mídia pode ser de vários tipos diferentes, dependendo do caminho de upload. Os uploads compatíveis atualmente usam apenas o caminho do item de mídia simples. new_media_item_type pode ser apenas de um dos tipos a seguir:
simpleMediaItem

object (SimpleMediaItem)

Um novo item de mídia enviado por upload usando o uploadToken incluído.

SimpleMediaItem

Um item de mídia simples a ser criado no Google Fotos usando um token de upload.

Representação JSON
{
  "uploadToken": string,
  "fileName": string
}
Campos
uploadToken

string

Token que identifica os bytes de mídia enviados ao Google.

fileName

string

Nome do arquivo com a extensão do item de mídia. Isso é mostrado ao usuário no Google Fotos. O nome do arquivo especificado durante o processo de upload de bytes será ignorado se esse campo for definido. O nome do arquivo, incluindo sua extensão, não deve ter mais de 255 caracteres. Esse campo é opcional.

NewMediaItemResult

Resultado da criação de um novo item de mídia.

Representação JSON
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campos
uploadToken

string

O token de upload usado para criar este novo item de mídia (simples). Só é preenchido se o item de mídia for simples e exigir um único token de upload.

status

object (Status)

Se ocorrer um erro durante a criação desse item de mídia, esse campo será preenchido com informações relacionadas ao erro. Para mais detalhes sobre esse campo, consulte Status.

mediaItem

object (MediaItem)

Item de mídia criado com o token de upload. Ele é preenchido se nenhum erro ocorreu e o item de mídia foi criado.