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 usando 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.000 itens de mídia.

Só é possível adicionar itens de mídia que estão na biblioteca do usuário a um álbum. Para álbuns compartilhados, o álbum precisa ser de propriedade do usuário ou do usuário deve ter ingressado no álbum como colaborador.

Não há suporte para sucesso parcial. A solicitação inteira vai 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 do OAuth:

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