REST Resource: documents

Risorsa: Document

Un documento rappresenta una pagina di documentazione nel corpus di conoscenze per sviluppatori, come la pagina all'indirizzo https://docs.cloud.google.com/storage/docs/creating-buckets.

Rappresentazione JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "dataSource": string,
  "title": string,
  "updateTime": string,
  "view": enum (DocumentView),
  "contentLengthBytes": integer
}
Campi
name

string

Identificatore. Contiene il nome della risorsa del documento. Formato: documents/{uri_without_scheme} Esempio: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Solo output. Fornisce l'URI del contenuto, ad esempio docs.cloud.google.com/storage/docs/creating-buckets.
content

string

Solo output. Contiene l'intero contenuto del documento in formato Markdown.
description

string

Solo output. Fornisce una descrizione del documento.
dataSource

string

Solo output. Specifica l'origine dati del documento. Esempio di origine dati: firebase.google.com
title

string

Solo output. Fornisce il titolo del documento.
updateTime

string (Timestamp format)

Solo output. Rappresenta il timestamp dell'ultimo aggiornamento dei contenuti o dei metadati del documento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
view

enum (DocumentView)

Solo output. Specifica il DocumentView del documento.
contentLengthBytes

integer

Solo output. La lunghezza del campo content in byte.

DocumentView

Specifica i campi di Document inclusi.

Enum
DOCUMENT_VIEW_UNSPECIFIED Il valore predefinito / non impostato. Per il valore predefinito di ogni metodo API, consulta la documentazione relativa se DocumentView non è specificato.
DOCUMENT_VIEW_BASIC

Include solo i campi dei metadati di base:

  • name
  • uri
  • dataSource
  • title
  • description
  • updateTime
  • view
  • contentLengthBytes

Questo è il valore predefinito della visualizzazione per DeveloperKnowledge.SearchDocumentChunks.
DOCUMENT_VIEW_FULL Include tutti i campi Document.
DOCUMENT_VIEW_CONTENT

Include i campi DOCUMENT_VIEW_BASIC e il campo content.

Questo è il valore predefinito della visualizzazione per DeveloperKnowledge.GetDocument e DeveloperKnowledge.BatchGetDocuments.

Metodi

batchGet

 Recupera più documenti, ognuno con il suo contenuto Markdown completo.

get

 Recupera un singolo documento con il suo contenuto Markdown completo.

searchDocumentChunks

 Cerca informazioni per sviluppatori nella documentazione per sviluppatori di Google.