REST Resource: projects.locations.notebooks.sources

Recurso: Source

A origem representa uma única fonte de conteúdo.

Representação JSON 
{
  "name": string,
  "title": string,
  "sourceId": {
    object (SourceId)
  },
  "metadata": {
    object (SourceMetadata)
  },
  "settings": {
    object (SourceSettings)
  }
}
Campos
name

string

Identificador. O nome completo do recurso da origem. Formato: projects/{project}/locations/{location}/notebooks/{notebook}/sources/{sourceId}.

Este campo precisa ser uma string codificada em UTF-8 com um limite de 1.024 caracteres.
title

string

Opcional. Título da fonte.
sourceId

object (SourceId)

Opcional. Apenas saída. ID da origem, que é o último segmento do nome do recurso da origem.
metadata

object (SourceMetadata)

Somente saída. Metadados sobre a origem.
settings

object (SourceSettings)

Apenas saída. Status da origem e motivos de falha.

SourceMetadata

Representa os metadados de uma fonte e algumas informações adicionais.

Representação JSON 
{

  // Union field metadata can be only one of the following:
  "googleDocsMetadata": {
    object (GoogleDocsSourceMetadata)
  },
  "youtubeMetadata": {
    object (YoutubeMetadata)
  },
  "agentspaceMetadata": {
    object (AgentspaceMetadata)
  }
  // End of list of possible types for union field metadata.
  "wordCount": integer,
  "tokenCount": integer,
  "sourceAddedTimestamp": string
}
Campos
Campo de união metadata. Metadados da origem. metadata pode ser apenas de um dos tipos a seguir:
googleDocsMetadata

object (GoogleDocsSourceMetadata)

Metadados de uma fonte de documento Google.
youtubeMetadata

object (YoutubeMetadata)

Metadados de uma fonte de vídeo do YouTube.
agentspaceMetadata

object (AgentspaceMetadata)

Metadados de uma fonte do Agentspace.
wordCount

integer

A contagem de palavras da fonte.
tokenCount

integer

O número de tokens na origem.
sourceAddedTimestamp

string (Timestamp format)

O carimbo de data/hora em que a fonte foi adicionada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

GoogleDocsSourceMetadata

Metadados sobre uma fonte de documento Google.

Representação JSON 
{
  "documentId": string,
  "revisionId": string
}
Campos
documentId

string

Apenas saída. O ID do documento do Google Docs.
revisionId

string

Apenas saída. ID da revisão do documento.

YoutubeMetadata

Metadados sobre uma fonte de vídeo do YouTube.

Representação JSON 
{
  "videoId": string,
  "channelName": string
}
Campos
videoId

string

Apenas saída. O ID do vídeo do YouTube.
channelName

string

Apenas saída. O nome do canal do vídeo do YouTube.

AgentspaceMetadata

Metadados sobre uma origem do espaço do agente.

Representação JSON 
{
  "documentName": string,
  "documentTitle": string
}
Campos
documentName

string

Apenas saída. O nome completo do documento no Agentspace.
documentTitle

string

Apenas saída. O título do documento.

SourceSettings

Permite a extensão das configurações de origem em "sources.batchCreate" (antiga solicitação "AddSource").

Representação JSON 
{
  "status": enum (SourceStatus),
  "failureReason": {
    object (FailureReason)
  }
}
Campos
status

enum (SourceStatus)

status da origem.
failureReason

object (FailureReason)

Motivo da falha com detalhes sobre por que uma origem não foi ingerida.

SourceStatus

Lista de possíveis status para uma fonte.

Tipos enumerados
SOURCE_STATUS_UNSPECIFIED Status não especificado.
SOURCE_STATUS_PENDING A fonte está pendente de adição.
SOURCE_STATUS_COMPLETE A adição de origem foi concluída e bem-sucedida.
SOURCE_STATUS_ERROR A adição da origem falhou permanentemente.
SOURCE_STATUS_PENDING_DELETION A exclusão da origem está pendente.
SOURCE_STATUS_TENTATIVE O usuário está tentando adicionar uma fonte, mas ainda não fizemos o upload nem verificamos os limites do usuário. Não conta para o limite de fontes do usuário.

FailureReason

Motivo da falha com detalhes sobre por que uma origem não foi ingerida.

Representação JSON 
{

  // Union field error can be only one of the following:
  "unknown": {
    object (Unknown)
  },
  "sourceTooLong": {
    object (SourceTooLong)
  },
  "ingestionError": {
    object (IngestionError)
  },
  "sourceEmpty": {
    object (SourceEmpty)
  },
  "uploadError": {
    object (UploadError)
  },
  "paywallError": {
    object (PaywallError)
  },
  "sourceUnreachable": {
    object (SourceUnreachable)
  },
  "googleDriveError": {
    object (GoogleDriveError)
  },
  "youtubeError": {
    object (YoutubeError)
  },
  "audioTranscriptionError": {
    object (AudioTranscriptionError)
  },
  "sourceLimitExceeded": {
    object (SourceLimitExceeded)
  },
  "domainBlocked": {
    object (DomainBlocked)
  }
  // End of list of possible types for union field error.
}
Campos
Campo de união error. O erro específico. error pode ser apenas de um dos tipos a seguir:
unknown

object (Unknown)

Indica que ocorreu um erro desconhecido.
sourceTooLong

object (SourceTooLong)

Indica que a contagem de palavras da fonte excedeu o limite do usuário.
ingestionError

object (IngestionError)

Indica que ocorreu um erro ao ingerir a origem.
sourceEmpty

object (SourceEmpty)

Indica que a origem está vazia.
uploadError

object (UploadError)

Indica que ocorreu um erro ao fazer o upload da origem.
paywallError

object (PaywallError)

Indica que a fonte está protegida por paywall e não pode ser ingerida.
sourceUnreachable

object (SourceUnreachable)

Indica que a origem está inacessível.
googleDriveError

object (GoogleDriveError)

Um erro específico do Google Drive.
youtubeError

object (YoutubeError)

Um erro específico do YouTube.
audioTranscriptionError

object (AudioTranscriptionError)

Um erro específico de transcrição de arquivo de áudio.
sourceLimitExceeded

object (SourceLimitExceeded)

Erro se o usuário tentar atualizar além dos limites.
domainBlocked

object (DomainBlocked)

Erro se o usuário tentar adicionar uma fonte de um domínio bloqueado.

Desconhecido

Esse tipo não tem campos.

Indica que ocorreu um erro desconhecido.

SourceTooLong

Indica que a contagem de palavras da fonte excedeu o limite do usuário.

Representação JSON 
{
  "wordCount": integer,
  "wordLimit": integer
}
Campos
wordCount

integer

O número de palavras na fonte.
wordLimit

integer

O limite de contagem de palavras para o usuário atual no momento do envio.

IngestionError

Esse tipo não tem campos.

Indica que ocorreu um erro ao ingerir a origem.

SourceEmpty

Esse tipo não tem campos.

Indica que a origem está vazia.

UploadError

Esse tipo não tem campos.

Indica que ocorreu um erro ao fazer o upload da origem.

PaywallError

Esse tipo não tem campos.

Indica que a fonte está protegida por paywall e não pode ser ingerida.

SourceUnreachable

Indica que a origem está inacessível. Isso é usado principalmente para fontes adicionadas por URL.

Representação JSON 
{
  "errorDetails": enum (SourceUnreachableErrorReason)
}
Campos
errorDetails

enum (SourceUnreachableErrorReason)

Descreve por que a origem está inacessível.

SourceUnreachableErrorReason

Detalhes sobre por que a origem está inacessível. Usado para mostrar a mensagem adequada ao usuário.

Tipos enumerados
ERROR_REASON_UNSPECIFIED Padrão
ERROR_REASON_INVALID_URL O URL de origem é inválido.
ERROR_REASON_NOT_ACCESSIBLE Não é possível acessar o URL de origem.
ERROR_REASON_NOT_REACHABLE Não é possível acessar o URL de origem.
ERROR_REASON_URL_NOT_FOUND O URL de origem retornou o erro 404.
ERROR_REASON_TRANSIENT_ERROR O URL de origem não está acessível devido a um erro de rede temporário, um tempo limite do host etc.
ERROR_REASON_FETCH_FAILED Não foi possível buscar o URL de origem devido a um erro interno.
ERROR_REASON_NOT_SUPPORTED O URL ainda não é compatível. Por exemplo, o conteúdo buscado excede o tamanho máximo de busca do rastreador, o conteúdo buscado é de um tipo que ainda não oferecemos suporte etc.

GoogleDriveError

Um erro específico do Google Drive.

Representação JSON 
{

  // Union field error can be only one of the following:
  "downloadPrevented": {
    object (DownloadPrevented)
  }
  // End of list of possible types for union field error.
}
Campos
Campo de união error. O erro específico do Drive. error pode ser apenas de um dos tipos a seguir:
downloadPrevented

object (DownloadPrevented)

O usuário não pôde fazer o download do arquivo.

DownloadPrevented

Esse tipo não tem campos.

O usuário não pôde fazer o download do arquivo.

YoutubeError

Um erro específico do YouTube.

Representação JSON 
{

  // Union field error can be only one of the following:
  "videoDeleted": {
    object (VideoDeleted)
  }
  // End of list of possible types for union field error.
}
Campos
Campo de união error. O erro específico do YouTube. error pode ser apenas de um dos tipos a seguir:
videoDeleted

object (VideoDeleted)

Erro para indicar que a origem foi removida porque o vídeo foi excluído.

VideoDeleted

Esse tipo não tem campos.

Erro para indicar que a origem foi removida porque o vídeo foi excluído.

AudioTranscriptionError

Um erro específico de transcrição de arquivo de áudio.

Representação JSON 
{

  // Union field error can be only one of the following:
  "languageDetectionFailed": {
    object (LanguageDetectionFailed)
  },
  "noAudioDetected": {
    object (NoAudioDetected)
  }
  // End of list of possible types for union field error.
}
Campos
Campo de união error. O erro específico da transcrição do arquivo de áudio. error pode ser apenas de um dos tipos a seguir:
languageDetectionFailed

object (LanguageDetectionFailed)

Não foi possível detectar o idioma do arquivo. Talvez ele não seja de fala.
noAudioDetected

object (NoAudioDetected)

Nenhum áudio foi detectado no arquivo de entrada (talvez fosse um vídeo).

LanguageDetectionFailed

Esse tipo não tem campos.

Não foi possível detectar o idioma do arquivo. Talvez ele não seja de fala.

NoAudioDetected

Esse tipo não tem campos.

Nenhum áudio foi detectado no arquivo de entrada.

SourceLimitExceeded

Esse tipo não tem campos.

Indica que o usuário não tem espaço para essa fonte.

DomainBlocked

Esse tipo não tem campos.

Erro para indicar que a origem foi removida porque o domínio foi bloqueado.

Métodos

batchCreate

 Cria uma lista de Sources.

batchDelete

 Exclui várias fontes.

get

 Recebe um Source.