Method: mediaItems.batchCreate

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

Essa é a segunda etapa para criar um item de mídia. Para mais detalhes sobre a etapa 1, como fazer o upload dos bytes brutos para um servidor do Google, consulte Como fazer upload de mídia.

Essa chamada adiciona o item de mídia à biblioteca. Se um id for especificado, a chamada também adicionará o item de mídia a ele. Cada álbum pode conter até 20 mil 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 forem definidos, o item de mídia será adicionado ao álbum na posição especificada.

Se a chamada contiver vários itens de mídia, eles serão adicionados na posição especificada. Ao criar um item de mídia em um álbum compartilhado em que você não é o proprietário, não será possível posicionar o item de mídia. Isso 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 ao qual 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 (de acordo com o valor padrão, ou seja, LAST_IN_ALBUM). A solicitação falhará se esse campo for 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 de 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 é exibida ao usuário na seção de informações do item no app Google Fotos. Precisa ter menos de 1.000 caracteres. Inclua apenas texto escrito pelos usuários. As descrições precisam agregar 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 atualmente compatíveis usam apenas o caminho de 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 que foi enviado pelo uploadToken incluído.

SimpleMediaItem

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

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

string

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

string

Nome do arquivo com extensão do item de mídia. Essa informação é exibida ao usuário no Google Fotos. O nome do arquivo especificado durante o processo de upload de bytes será ignorado se este campo estiver definido. O nome do arquivo, incluindo a 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 esse 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 as informações relacionadas ao erro. Saiba mais sobre este campo em Status.
mediaItem

object (MediaItem)

Item de mídia criado com o token de upload. Ele é preenchido se não ocorreram erros e o item de mídia foi criado.