Method: documents.searchDocumentChunks

Pesquisa o conhecimento do desenvolvedor na documentação do Google para desenvolvedores. Retorna DocumentChunks com base na consulta do usuário. Pode haver muitos blocos do mesmo Document. Para recuperar documentos completos, use DeveloperKnowledge.GetDocument ou DeveloperKnowledge.BatchGetDocuments com o DocumentChunk.parent retornado em SearchDocumentChunksResponse.results.

Solicitação HTTP

GET https://developerknowledge.googleapis.com/v1alpha/documents:searchDocumentChunks

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
query

string

Obrigatório. Fornece a string de consulta bruta fornecida pelo usuário, como "Como criar um bucket do Cloud Storage?". A consulta não pode exceder 500 caracteres. Valores maiores que 500 caracteres vão resultar em um erro INVALID_ARGUMENT.
pageSize

integer

Opcional. Especifica o número máximo de resultados a serem retornados. O serviço pode retornar um valor inferior a este.

Se não for especificado, no máximo cinco resultados serão retornados.

O valor máximo é 100. Valores acima de 100 serão forçados a 100.
pageToken

string

Opcional. Contém um token de página, recebido de uma chamada documents.searchDocumentChunks anterior. Forneça isso para recuperar a página subsequente.
filter

string

Opcional. Aplica um filtro estrito aos resultados da pesquisa. A expressão oferece suporte a um subconjunto da sintaxe descrita em https://google.aip.dev/160.

Embora documents.searchDocumentChunks retorne DocumentChunks, o filtro é aplicado aos campos DocumentChunk.document.

Campos compatíveis com a filtragem:

  • contentLengthBytes (INTEGER): o comprimento do campo Document.content em bytes.
  • dataSource (STRING): a origem do documento, por exemplo, docs.cloud.google.com. Consulte https://developers.google.com/knowledge/reference/corpus-reference para conferir a lista completa de fontes de dados no corpus.
  • updateTime (TIMESTAMP): o carimbo de data/hora da última atualização significativa do documento. Uma atualização significativa é aquela que muda o conteúdo ou os metadados do documento em Markdown.
  • uri (STRING): o URI do documento, por exemplo, https://docs.cloud.google.com/bigquery/docs/tables.

Os campos INTEGER oferecem suporte aos operadores =, <, <=, >, e >=.

Os campos STRING oferecem suporte aos operadores = (igual) e != (não igual) para correspondência exata em toda a string. A correspondência parcial, de prefixo e de expressão regular não são aceitas.

Os campos TIMESTAMP oferecem suporte aos operadores =, <, <=, >, e >=. Os carimbos de data/hora precisam estar no formato RFC-3339, por exemplo, "2025-01-01T00:00:00Z".

É possível combinar expressões usando operadores lógicos AND, OR e NOT (ou -). OR tem precedência maior que AND. Use parênteses para agrupamento de precedência explícito.

Exemplos:

  • Filtrar por Document.content_length_bytes: contentLengthBytes < 50000
  • dataSource = "docs.cloud.google.com" OR dataSource = "firebase.google.com"
  • dataSource != "firebase.google.com"
  • updateTime < "2024-01-01T00:00:00Z"
  • updateTime >= "2025-01-22T00:00:00Z" AND (dataSource = "developer.chrome.com" OR dataSource = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

A string filter não pode exceder 500 caracteres. Valores maiores que 500 caracteres vão resultar em um erro INVALID_ARGUMENT.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para DeveloperKnowledge.SearchDocumentChunks.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ],
  "nextPageToken": string
}
Campos
results[]

object (DocumentChunk)

Contém os resultados da pesquisa para a consulta fornecida. Cada DocumentChunk nessa lista contém um snippet de conteúdo relevante para a consulta de pesquisa. Use o campo DocumentChunk.parent de cada resultado com DeveloperKnowledge.GetDocument ou DeveloperKnowledge.BatchGetDocuments para recuperar o conteúdo completo do documento.
nextPageToken

string

Fornece um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte OAuth 2.0 Overview.