Method: mediaItems.batchCreate

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

Essa é a segunda etapa da criação de um item de mídia. Para detalhes sobre a Etapa 1 e 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 álbum id for especificado, a chamada adicionará o item de mídia ao álbum também. Cada álbum pode conter até 20.000 itens de mídia. Por padrão, o item de mídia é 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 estiver criando 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 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 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 forem especificados, 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 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. Ela 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, dependendo do caminho de envio. Os uploads compatíveis no momento usam apenas o caminho simples do item de mídia. 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. 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 estiver 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 esse novo item de mídia (simples). Preenchido apenas 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 detalhes sobre esse campo, consulte Status.

mediaItem

object (MediaItem)

Item de mídia criado com o token de upload. Ele será preenchido se nenhum erro tiver ocorrido e se o item de mídia tiver sido criado.