Google Meet

Visão geral

O Google Meet é uma plataforma segura de videoconferência integrada ao Google Workspace, facilitando reuniões remotas, compartilhamento de tela e chat. Com a integração no SquadOS, seus agentes podem criar e gerenciar salas de reunião, encerrar conferências ativas, listar participantes, recuperar gravações e acessar transcrições detalhadas de reuniões.

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

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar autorizar o acesso à sua conta Google com os escopos necessários para o Google Meet.

Campo	Obrigatório	Descrição
Conta Google	Sim	Autorização OAuth 2.0 para acesso ao Google Meet via Composio.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Google Meet.
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.)

Perguntas frequentes

Como configurar credenciais OAuth personalizadas para o Google Meet?

Para um guia passo a passo de como criar e configurar suas próprias credenciais OAuth do Google com a Composio, consulte How to create OAuth2 credentials for Google Apps.

Por que estou vendo “App is blocked” ao conectar o Google Meet?

O cliente OAuth está solicitando escopos que o Google não verificou para aquele cliente. Isso geralmente acontece quando você adiciona escopos além dos padrão.

Remova os escopos adicionais da sua configuração de autenticação, ou crie seu próprio aplicativo OAuth e envie os escopos para verificação. Consulte How to create OAuth2 credentials for Google Apps.

Por que estou recebendo o erro “Google Meet API has not been used in project”?

Ao usar credenciais OAuth personalizadas, a API do Google Meet deve estar habilitada no projeto do Google Cloud que possui essas credenciais. Habilite-a no Google Cloud Console em APIs & Services, aguarde alguns minutos e tente novamente.

Por que estou recebendo “Error 400: invalid_scope”?

Os escopos solicitados são inválidos ou estão incorretamente formatados na URL de autorização. Verifique os valores dos escopos na documentação de escopos OAuth do Google.

Por que a tela de consentimento OAuth mostra “Composio” em vez do meu aplicativo?

Por padrão, a tela de consentimento usa o aplicativo OAuth da Composio. Para exibir o nome e logotipo do seu próprio aplicativo, crie seu próprio aplicativo OAuth e defina uma URL de redirecionamento personalizada.

Por que estou recebendo erros 401 nas chamadas de ferramentas?

O token de acesso do usuário não é mais válido. Causas comuns: o usuário revogou o acesso, alterou sua senha ou 2FA, uma política de administrador do Workspace foi alterada, ou o limite de tokens de atualização do Google (~50 por conta) foi excedido. Reautenticar o usuário geralmente resolve o problema.

Por que estou recebendo “Quota Exhausted” ou “rate limit exhausted”?

O Google impõe cotas de requisição por minuto e diárias. Se você estiver usando o aplicativo OAuth padrão da Composio, você compartilha essa cota com outros usuários, o que pode fazer com que os limites sejam atingidos mais rapidamente. Use suas próprias credenciais de aplicativo OAuth para obter uma cota dedicada, e adicione backoff exponencial e tentativas para lidar com limites transientes.

Ações disponíveis

Criar sala do Google Meet

GOOGLEMEET_CREATE_MEET

Cria uma nova sala do Google Meet com configuração opcional. Não vincula a nenhum evento de calendário — a vinculação ao calendário requer uma chamada separada à ferramenta Calendar. Capture meetingUri, meetingCode e space.name da resposta imediatamente para consultas posteriores. Requer o escopo OAuth meetings.space.created. Retorna HTTP 429 em chamadas rápidas; aplique backoff exponencial. Use quando precisar de uma sala de reunião com controles de acesso, moderação, gravação ou configurações de transcrição específicas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
config	object	Não	Configuração opcional para a sala de reunião. Se não fornecido, as configurações padrão serão usadas. Subcampos principais: accessType e entryPointAccess têm padrões permissivos — defina explicitamente quando o público ou nível de acesso for conhecido, pois os padrões permissivos podem conflitar com políticas organizacionais. Combinações inválidas desses campos ou configurações de moderação podem ser rejeitadas com base nas políticas de domínio/conta. Recursos de gravação e transcrição requerem uma edição do Workspace que suporte gravação em nuvem; contas pessoais podem não suportar essas opções.

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.

Encerrar conferência ativa

GOOGLEMEET_END_ACTIVE_CONFERENCE

Encerra uma conferência ativa em uma sala do Google Meet. Requer o parâmetro space_name (ex.: spaces/jQCFfuBOdN5z ou apenas jQCFfuBOdN5z). Use quando precisar terminar uma conferência em andamento em uma sala especificada. Esta operação só tem êxito se uma conferência estiver ativa na sala. Desconecta imediatamente todos os participantes ativos — obtenha confirmação explícita do usuário antes de chamar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
space_name	string	Sim	Nome do recurso da sala no formato spaces/{space}, onde {space} é um ID único gerado pelo servidor, com distinção entre maiúsculas e minúsculas. Exemplo: spaces/jQCFfuBOdN5z. Pode ser o nome completo do recurso incluindo o prefixo spaces/ ou apenas o ID da sala.

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 registro de conferência pelo nome

GOOGLEMEET_GET_CONFERENCE_RECORD_BY_NAME

Obtém um registro de conferência específico pelo nome do recurso. Use quando tiver o ID do registro de conferência e precisar recuperar informações detalhadas sobre uma única instância de reunião.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do recurso do registro de conferência. Formato: conferenceRecords/{conference_record}, onde {conference_record} é um ID único para cada instância de chamada dentro de uma sala. Exemplo: conferenceRecords/GLkPdCDLsjSXet2-QH9dDxIPOAIIigIgABgECA.

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 detalhes da sala do Meet

GOOGLEMEET_GET_MEET

Recupera detalhes de uma sala do Google Meet usando seu identificador único. Salas recém-criadas podem retornar dados incompletos; tente novamente após 1–3 segundos se necessário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
space_name	string	Sim	O identificador único (ID da sala) para a sala do Google Meet. Forneça apenas o ID bruto da sala sem o prefixo spaces/. Exemplo: mV63iV9-KxoB.

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 detalhes de sessão do participante

GOOGLEMEET_GET_PARTICIPANT_SESSION

Recupera informações detalhadas sobre uma sessão de participante específica de um registro de conferência do Google Meet. Retorna detalhes da sessão incluindo horário de início e fim para uma única sessão de entrada/saída. Uma sessão de participante representa cada entrada e saída única quando um usuário ingressa em uma conferência por um dispositivo. PRÉ-REQUISITO: obtenha primeiro o nome do recurso da sessão do participante usando LIST_PARTICIPANT_SESSIONS com um ID de registro de conferência e ID de participante. O parâmetro name é obrigatório e deve seguir o formato: conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome completo do recurso da sessão do participante a recuperar. Formato: conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}. Você pode obter esse valor no campo name retornado pela ação LIST_PARTICIPANT_SESSIONS.

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 gravações pelo ID do registro de conferência

GOOGLEMEET_GET_RECORDINGS_BY_CONFERENCE_RECORD_ID

Recupera gravações do Google Meet para um determinado ID de registro de conferência. Retorna gravações apenas se a gravação foi habilitada e permitida pelas políticas de domínio do organizador; um conference_record_id válido não garante que existam gravações. Após o término da reunião, as gravações podem levar vários minutos para processar — um resultado vazio pode ser temporário, não permanente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
conference_record_id	string	Sim	Identificador único do registro de conferência.

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 transcrição

GOOGLEMEET_GET_TRANSCRIPT

Recupera uma transcrição específica pelo nome do recurso. Retorna detalhes da transcrição incluindo estado (STARTED, ENDED, FILE_GENERATED), horários de início/fim e destino no Google Docs. PRÉ-REQUISITO: obtenha primeiro o nome do recurso da transcrição usando GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID ou construa-o a partir de IDs conhecidos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do recurso da transcrição. Formato: conferenceRecords/{conferenceRecord}/transcripts/{transcript}. Você pode obtê-lo na ação “Obter transcrições pelo ID do registro de conferência” ou construí-lo usando IDs conhecidos de registro e transcriçã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.

Obter entrada de transcrição

GOOGLEMEET_GET_TRANSCRIPT_ENTRY

Busca uma única entrada de transcrição pelo nome do recurso para inspeção direcionada ou processamento incremental. Use quando tiver o nome de um recurso de entrada de transcrição específica e precisar recuperar seus detalhes (texto, palestrante, timestamps, idioma). PRÉ-REQUISITO: obtenha o nome do recurso de entrada de transcrição usando LIST_TRANSCRIPT_ENTRIES ou construa-o a partir de IDs conhecidos. O parâmetro name é obrigatório e deve seguir o formato: conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome completo do recurso da entrada de transcrição. Formato: conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}. Você pode obtê-lo na ação LIST_TRANSCRIPT_ENTRIES ou construí-lo usando IDs conhecidos de registro, transcrição e entrada.

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 transcrições pelo ID do registro de conferência

GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID

Recupera todas as transcrições de uma conferência específica do Google Meet usando seu conference_record_id. As transcrições exigem tempo de processamento após o término da reunião — resultados vazios podem ser transitórios; tente novamente após um atraso antes de concluir que não existem transcrições. Retorna resultados apenas se a transcrição foi habilitada durante a reunião e permitida pelas políticas de domínio do organizador.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page_size	integer	Não	Número máximo de transcrições a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 10 transcrições são retornadas. O valor máximo é 100; valores acima de 100 são truncados para 100.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior, usado para recuperar a próxima página de resultados.
conference_record_id	string	Sim	Identificador único do registro de conferência. É a parte do ID do nome do recurso do registro de conferência (formato: conferenceRecords/{id}). Você pode obter IDs válidos usando a ação “Listar registros de conferência” ou no campo name das respostas de registro de conferência. Exemplo de ID: kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ. Não passe o nome completo do recurso — apenas a parte do ID após conferenceRecords/.

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 registros de conferência

GOOGLEMEET_LIST_CONFERENCE_RECORDS

Lista registros de conferência. Use quando precisar recuperar uma lista de conferências passadas, filtrando opcionalmente por critérios como código de reunião, nome da sala ou intervalo de tempo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
filter	string	Não	Condição de filtragem opcional em formato EBNF. Campos filtráveis: space.meeting_code, space.name, start_time, end_time. Exemplos: space.name = "spaces/NAME", space.meeting_code = "abc-mnop-xyz", start_time>="2024-01-01T00:00:00.000Z" AND start_time<="2024-01-02T00:00:00.000Z", end_time IS NULL. Os valores de tempo devem ser em UTC RFC3339 (ex.: 2024-01-01T00:00:00.000Z); fusos horários não UTC ou limites invertidos omitem registros silenciosamente.
page_size	integer	Não	Número máximo de registros de conferência a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 25 registros são retornados. O valor máximo é 100; valores acima de 100 são truncados para 100.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior. Itere usando os valores de page_token retornados até que nenhum token seja retornado para recuperar o conjunto completo 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 participantes

GOOGLEMEET_LIST_PARTICIPANTS

Lista os participantes de um registro de conferência. Por padrão, ordenados por horário de entrada em ordem decrescente. Use para recuperar todos os participantes que ingressaram em uma conferência específica do Google Meet, com suporte a filtragem de participantes ativos (onde latest_end_time IS NULL).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
filter	string	Não	Condição de filtragem opcional em formato EBNF. Campos filtráveis: earliest_start_time, latest_end_time. Exemplo: latest_end_time IS NULL retorna participantes ativos na conferência.
parent	string	Sim	Formato: conferenceRecords/{conference_record}. O ID do registro de conferência pode ser obtido na ação LIST_CONFERENCE_RECORDS.
page_size	integer	Não	Número máximo de participantes a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 100 participantes são retornados. O valor máximo é 250; valores acima de 250 são truncados para 250.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior, usado para recuperar 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 sessões de participante

GOOGLEMEET_LIST_PARTICIPANT_SESSIONS

Lista todas as sessões de participante para um participante específico em uma conferência do Google Meet. Uma sessão de participante representa cada entrada e saída única quando um usuário ingressa em uma conferência por um dispositivo. Se um usuário ingressar várias vezes pelo mesmo dispositivo, cada entrada cria uma nova sessão. Retorna detalhes da sessão incluindo horário de início e fim para cada sessão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
filter	string	Não	Condição de filtragem opcional em formato EBNF. Campos filtráveis incluem start_time e end_time. Os valores de tempo devem usar o formato UTC RFC3339 (ex.: start_time >= '2024-01-01T00:00:00Z'). Nomes de campo não suportados ou expressões malformadas podem silenciosamente reduzir ou descartar resultados em vez de gerar erros.
page_size	integer	Não	Número máximo de sessões de participante a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 100 sessões são retornadas. O valor máximo é 250; valores acima de 250 são truncados para 250.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior, usado para recuperar a próxima página de resultados. Itere usando valores sucessivos de page_token até que a resposta omita page_token para evitar perder sessões silenciosamente.
participant_id	string	Sim	Identificador único do participante dentro da conferência. Exemplo: xyz-456.
conference_record_id	string	Sim	Identificador único do registro de conferência. Exemplo: abc-123-def.

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 gravações

GOOGLEMEET_LIST_RECORDINGS

Lista recursos de gravação de um registro de conferência. Use quando precisar recuperar gravações de uma conferência específica do Google Meet. As gravações são criadas quando a gravação da reunião está habilitada e salvas no Google Drive como arquivos MP4.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
parent	string	Sim	O registro de conferência para listar gravações. Formato: conferenceRecords/{conference_record}.
page_size	integer	Não	Número máximo de gravações a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 10 gravações são retornadas. O valor máximo é 100; valores acima de 100 são truncados para 100.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior. Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros fornecidos à chamada de lista devem corresponder à chamada que forneceu o token de 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.

Listar entradas de transcrição

GOOGLEMEET_LIST_TRANSCRIPT_ENTRIES

Lista entradas de transcrição estruturadas (segmentos de palestrante/tempo/texto) para uma transcrição específica do Google Meet. Use quando precisar acessar o conteúdo detalhado de uma transcrição, incluindo segmentos de fala individuais com timestamps e informações do palestrante. Observação: as entradas de transcrição retornadas pela API podem não corresponder à transcrição no Google Docs devido a palestrantes intercalados ou modificações pós-geração.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page_size	integer	Não	Número máximo de entradas de transcrição a retornar. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 10 entradas são retornadas. O valor máximo é 100; valores acima de 100 são truncados para 100.
page_token	string	Não	Token de página retornado de uma chamada de lista anterior, usado para recuperar a próxima página de resultados.
transcript_id	string	Sim	Identificador único da transcrição dentro do registro de conferência.
conference_record_id	string	Sim	Identificador único do registro de conferência.

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 sala do Google Meet

GOOGLEMEET_UPDATE_SPACE

Atualiza as configurações de uma sala existente do Google Meet. Requer privilégios de organizador/host e o escopo OAuth meetings.space.created. Parâmetro obrigatório: name (identificador da sala, ex.: spaces/jQCFfuBOdN5z). Parâmetros opcionais: config (novas configurações a aplicar) e updateMask (especifica quais campos atualizar; se omitido, todos os campos de configuração fornecidos são atualizados).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Identificador único da sala do Google Meet a atualizar. Formato: spaces/{space}, onde {space} é o ID da sala.
config	object	Não	Configurações a atualizar para a sala de reunião. Forneça os campos que deseja modificar (ex.: accessType, entryPointAccess, configurações de moderação). Algumas configurações requerem edições específicas do Google Workspace e políticas de administrador; configurações não suportadas podem ser aplicadas silenciosamente sem efeito.
updateMask	string	Não	Máscara de campo especificando quais campos atualizar. Lista separada por vírgulas de nomes de campo totalmente qualificados (ex.: config.accessType,config.entryPointAccess). Se não fornecido, apenas os campos explicitamente definidos em config serão atualizados. Atenção: usar "*" tentará atualizar TODOS os campos de configuração, o que pode causar erros. Recomenda-se especificar apenas os campos sendo atualizados.

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.