Faça a gestão do Resumo de áudio do seu bloco de notas (API)

Depois de criar o bloco de notas e adicionar origens de dados, pode gerar programaticamente um resumo de áudio do bloco de notas. De cada vez, um determinado bloco de notas só pode ter um resumo de áudio. Esta página descreve como criar e eliminar vistas gerais de áudio.

Diferença entre uma vista geral de áudio e um podcast

Um resumo de áudio é diferente de um podcast nos seguintes aspetos:

  • Um resumo de áudio tem de estar associado a um notebook com origens de dados adicionadas. Por outro lado, pode gerar um podcast sem um notebook do NotebookLM Enterprise, uma licença do Gemini Enterprise ou um repositório de dados. Para criar um podcast, só precisa de um projeto Google Cloud ativado e da função de utilizador da API Podcast.
  • Para criar um Resumo de áudio, chame o método notebooks.audioOverview. Para criar um podcast, chame o método podcasts, uma API autónoma.

Criar Resumo de áudio

Para gerar um resumo de áudio para o conteúdo no seu bloco de notas, chame o método notebooks.audioOverviews.create. Uma vez que só pode ter uma vista geral de áudio por bloco de notas, este método só é bem-sucedido se o bloco de notas não tiver uma vista geral de áudio existente.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

Substitua o seguinte:

  • ENDPOINT_LOCATION: a região múltipla para o seu pedido de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para a localização global
    Para mais informações, consulte o artigo Especifique várias regiões para o seu repositório de dados.
  • PROJECT_NUMBER: o número do seu projeto Google Cloud .
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte o artigo Localizações.
  • NOTEBOOK_ID: o identificador exclusivo do bloco de notas.
  • SOURCE_ID: o ID da origem com base na qual quer gerar a vista geral de áudio. O sourceIdsfield é uma matriz opcional. Se não especificar IDs de origem, são usadas todas as origens no bloco de notas. Para informações sobre o ID da origem, consulte o artigo Adicione e faça a gestão de origens de dados num bloco de notas (API).
  • EPISODE_FOCUS: uma string que descreve que tópicos ou conteúdo têm de ser realçados na vista geral de áudio.
  • LANGUAGE_CODE: o código do idioma no qual o resumo de áudio foi pedido.

Se o pedido for bem-sucedido, deve receber uma resposta JSON semelhante à seguinte. Esta resposta mostra que a geração do resumo de áudio está em curso.

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

Demora alguns minutos a gerar um Resumo de áudio.

Valide um Resumo de áudio gerado

Para validar o resumo de áudio gerado, faça o seguinte:

  1. Abra o bloco de notas. Para mais informações, consulte o artigo Aceda ao bloco de notas criado.

  2. No Studio do seu bloco de notas, clique em Carregar para carregar a conversa. O carregamento da vista geral demora alguns momentos.

    No estúdio, pode gerir o seu resumo de áudio com tarefas como alterar a velocidade de reprodução e transferir ou eliminar o ficheiro de resumo de áudio.

Elimine um Resumo de áudio

Para eliminar um resumo de áudio existente, chame o método notebooks.audioOverviews.delete.

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

Substitua o seguinte:

  • ENDPOINT_LOCATION: a região múltipla para o seu pedido de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para a localização global
    Para mais informações, consulte o artigo Especifique várias regiões para o seu repositório de dados.
  • PROJECT_NUMBER: o número do seu projeto Google Cloud .
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte o artigo Localizações.
  • NOTEBOOK_ID: o identificador exclusivo do bloco de notas.

Se o pedido for bem-sucedido, deve receber um JSON vazio.