REST Resource: documents

Recurso: Document

Un Document representa un fragmento de contenido del corpus de Developer Knowledge.

Representación JSON
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "dataSource": string,
  "title": string,
  "updateTime": string,
  "view": enum (DocumentView)
}
Campos
name

string

Es el identificador. Contiene el nombre del recurso del documento. Formato: documents/{uri_without_scheme} Ejemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets

uri

string

Solo salida. Proporciona el URI del contenido, como docs.cloud.google.com/storage/docs/creating-buckets.

content

string

Solo salida. Contiene el contenido completo del documento en formato Markdown.

description

string

Solo salida. Proporciona una descripción del documento.

dataSource

string

Solo salida. Especifica la fuente de datos del documento. Ejemplo de fuente de datos: firebase.google.com

title

string

Solo salida. Proporciona el título del documento.

updateTime

string (Timestamp format)

Solo salida. Representa la marca de tiempo en la que se actualizó por última vez el contenido o los metadatos del documento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

view

enum (DocumentView)

Solo salida. Especifica el DocumentView del documento.

DocumentView

Especifica qué campos del Document se incluyen.

Enums
DOCUMENT_VIEW_UNSPECIFIED Es el valor predeterminado o no establecido. Consulta cada método de la API para conocer su valor predeterminado si no se especifica DocumentView.
DOCUMENT_VIEW_BASIC

Incluye solo los campos de metadatos básicos: - name - uri - dataSource - title - description - updateTime - view

Este es el valor predeterminado de la vista para DeveloperKnowledge.SearchDocumentChunks.

DOCUMENT_VIEW_FULL Incluye todos los campos Document.
DOCUMENT_VIEW_CONTENT

Incluye los campos DOCUMENT_VIEW_BASIC y el campo content.

Este es el valor predeterminado de la vista para DeveloperKnowledge.GetDocument y DeveloperKnowledge.BatchGetDocuments.

Métodos

batchGet

Recupera varios documentos, cada uno con su contenido completo de Markdown.

get

Recupera un solo documento con su contenido completo de Markdown.

searchDocumentChunks

Busca conocimiento para desarrolladores en la documentación para desarrolladores de Google.