Google Photos

Visão geral

O Google Photos é um serviço de armazenamento e organização de fotos na nuvem que oferece backup automático, pesquisa assistida por IA e álbuns compartilhados para gerenciamento pessoal e colaborativo de mídia. Com a integração no SquadOS, seus agentes podem criar álbuns, fazer upload de imagens e vídeos, pesquisar itens de mídia e gerenciar coleções fotográficas diretamente na biblioteca Google Photos do usuário.

• Site oficial: https://photos.google.com/
• Documentação na Composio: docs.composio.dev/toolkits/googlephotos

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar autorizar o acesso à sua conta Google. O fluxo é gerenciado pela Composio — nenhuma credencial manual é necessária.

Campo	Obrigatório	Descrição
Conta Google	Sim	Conta Google com acesso ao Google Photos, autorizada via OAuth 2.0.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Google Photos.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Google.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Adicionar enriquecimento

GOOGLEPHOTOS_ADD_ENRICHMENT

Adiciona um enriquecimento em uma posição especificada dentro de um álbum definido.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
albumId	string	Sim	Identificador do álbum onde o enriquecimento será adicionado.
albumPosition	object	Sim	Posição no álbum onde o enriquecimento será inserido. Tipos de posição válidos: FIRST_IN_ALBUM, LAST_IN_ALBUM, AFTER_MEDIA_ITEM (requer relativeMediaItemId), AFTER_ENRICHMENT_ITEM (requer relativeEnrichmentItemId).
newEnrichmentItem	object	Sim	O enriquecimento a ser adicionado; pode ser texto, localização ou mapa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar itens de mídia em lote

GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS

Adiciona um ou mais itens de mídia a um álbum no Google Photos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
albumId	string	Sim	Identificador do álbum ao qual os itens de mídia serão adicionados. Deve ser um álbum criado por esta aplicação.
mediaItemIds	array	Sim	Identificadores dos itens de mídia a serem adicionados. Máximo de 50 itens. Os itens devem ter sido criados por esta aplicação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar itens de mídia em lote

GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS

Faz upload e cria itens de mídia em lote no Google Photos. Suporta três métodos de entrada: 1. urls: lista simples de URLs públicas (nomes de arquivo extraídos automaticamente); 2. media_files: lista de objetos com url/arquivo, nome do arquivo e descrição; 3. files: lista de objetos FileUploadable para arquivos já enviados. Os itens podem ser opcionalmente adicionados a um álbum em uma posição específica. Máximo de 50 itens por requisição.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
urls	array	Não	Entrada simplificada: lista de URLs públicas dos arquivos de mídia a fazer upload. Os nomes de arquivo serão extraídos automaticamente das URLs. Use media_files para maior controle sobre nomes e descrições.
files	array	Não	Lista de arquivos a fazer upload no Google Photos.
albumId	string	Não	Identificador opcional do álbum onde os itens serão adicionados. Se não especificado, os itens são adicionados apenas à biblioteca do usuário.
media_files	array	Não	Lista de arquivos de mídia a fazer upload. Cada item pode especificar uma url (URL pública) ou um file (objeto FileUploadable). Máximo de 50 itens por requisição.
albumPosition	object	Não	Posição no álbum onde os itens de mídia serão adicionados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter itens de mídia em lote

GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMS

Retorna a lista de itens de mídia para os identificadores especificados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
mediaItemIds	array	Sim	Identificadores dos itens de mídia a serem solicitados. Não deve conter duplicatas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar álbum

GOOGLEPHOTOS_CREATE_ALBUM

Cria um novo álbum no Google Photos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Sim	Nome do álbum a ser criado no Google Photos. Máximo de 500 caracteres.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter álbum

GOOGLEPHOTOS_GET_ALBUM

Retorna o álbum com base no albumId especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
albumId	string	Sim	Identificador do álbum a ser solicitado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Baixar item de mídia do Google Photos

GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOAD

Faz o download de um item de mídia do Google Photos e o retorna como arquivo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
mediaItemId	string	Sim	ID do item de mídia a ser baixado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar álbuns

GOOGLEPHOTOS_LIST_ALBUMS

Lista todos os álbuns exibidos para o usuário na aba Álbuns do Google Photos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
pageSize	integer	Não	Número máximo de álbuns a retornar. Padrão: 20, máximo: 50.
pageToken	string	Não	Token de continuação para obter a próxima página de resultados.
excludeNonAppCreatedData	boolean	Não	Se verdadeiro, exclui itens de mídia não criados por esta aplicação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar itens de mídia (somente criados pelo app)

GOOGLEPHOTOS_LIST_MEDIA_ITEMS

Lista itens de mídia criados por esta aplicação no Google Photos. AVISO DE DESCONTINUAÇÃO: A partir de 31 de março de 2025, a Google Photos Library API retorna APENAS itens de mídia enviados ou criados pela sua aplicação. Esta ação NÃO pode acessar a biblioteca completa de fotos do usuário. Casos de uso suportados: listar fotos/vídeos que o app enviou anteriormente à biblioteca do usuário; gerenciar conteúdo criado pelo app no Google Photos. Casos de uso NÃO suportados: acessar fotos tiradas pela câmera do usuário; visualizar fotos de outros apps ou uploads via web; listar toda a biblioteca do usuário. Para acessar a biblioteca completa do usuário, use a Google Photos Picker API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
pageSize	integer	Não	Número máximo de itens a retornar. Padrão: 25, máximo: 100.
pageToken	string	Não	Token para obter a próxima página de resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar álbuns compartilhados (descontinuado)

GOOGLEPHOTOS_LIST_SHARED_ALBUMS

[DESCONTINUADO — encerrado em 31 de março de 2025] Lista todos os álbuns compartilhados disponíveis na aba Compartilhamento do Google Photos do usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
pageSize	integer	Não	Número máximo de álbuns a retornar. Padrão: 20, máximo: 50.
pageToken	string	Não	Token de continuação para obter a próxima página de resultados. Use o valor retornado em nextPageToken da resposta anterior.
excludeNonAppCreatedData	boolean	Não	Se verdadeiro, exclui itens de mídia não criados por este app. Padrão: falso (todos os álbuns são retornados). Este campo é ignorado se o escopo photoslibrary.readonly.appcreateddata for utilizado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar itens de mídia

GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS

Pesquisa itens de mídia na biblioteca do Google Photos do usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
albumId	string	Não	Álbum em que a pesquisa será realizada.
filters	object	Não	Filtros de pesquisa.
orderBy	string	Não	Ordem dos resultados, ex: MediaMetadata.creation_time desc.
pageSize	integer	Não	Número máximo de itens a retornar. Padrão: 25, máximo: 100.
pageToken	string	Não	Token para obter a próxima página.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar álbum

GOOGLEPHOTOS_UPDATE_ALBUM

Atualiza o título ou a foto de capa de um álbum no Google Photos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Não	Novo título para o álbum. Máximo de 500 caracteres.
albumId	string	Sim	Identificador do álbum a ser atualizado.
coverPhotoMediaItemId	string	Não	ID do item de mídia a usar como foto de capa do álbum.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar item de mídia

GOOGLEPHOTOS_UPDATE_MEDIA_ITEM

Atualiza a descrição de um item de mídia no Google Photos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
description	string	Sim	Nova descrição para o item de mídia. Deve ter menos de 1000 caracteres.
mediaItemId	string	Sim	Identificador do item de mídia a ser atualizado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de mídia

GOOGLEPHOTOS_UPLOAD_MEDIA

Faz upload de um arquivo de mídia para o Google Photos. Suporta imagens (até 200 MB) e vídeos (até 20 GB).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Não	URL pública do arquivo de mídia a fazer upload (deve ser diretamente acessível). A ação baixará o arquivo dessa URL e o enviará ao Google Photos. Alternativa ao parâmetro file_to_upload. Formatos suportados: imagens (JPEG, PNG, GIF, HEIC, etc.) e vídeos (MP4, MOV, etc.).
file_name	string	Não	Nome do arquivo para a mídia enviada. Obrigatório ao usar o parâmetro url. Deve incluir a extensão (ex: photo.jpg, video.mp4).
description	string	Não	Descrição opcional para o item de mídia.
file_to_upload	object	Não	O arquivo de mídia a fazer upload no Google Photos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.