Method: albums.batchAddMediaItems

Adiciona um ou mais itens de mídia da biblioteca do Google Fotos de um usuário a um álbum. Os itens de mídia e os álbuns precisam ter sido criados pelo desenvolvedor com a API.

Os itens de mídia são adicionados ao final do álbum. Se vários itens de mídia forem fornecidos, eles serão adicionados na ordem especificada nesta chamada.

Cada álbum pode conter até 20 mil itens de mídia.

Somente itens de mídia que estão na biblioteca do usuário podem ser adicionados a um álbum. Nos álbuns compartilhados, o álbum deve ser de propriedade do usuário ou essa pessoa precisa participar do álbum como colaborador.

Não é possível fazer sucesso parcial. Toda a solicitação falhará se um item de mídia ou álbum inválido for especificado.

Solicitação HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

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

Parâmetros de caminho

Parâmetros
albumId

string

Obrigatório. Identificador do Album ao qual os itens de mídia são adicionados.

Corpo da solicitação

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

Representação JSON 
{
  "mediaItemIds": [
    string
  ]
}
Campos
mediaItemIds[]

string

Obrigatório. Identificadores dos MediaItems a serem adicionados. O número máximo de itens de mídia que podem ser adicionados em uma chamada é 50.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

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