Package google.developers.knowledge.v1alpha

Index

DeveloperKnowledge

Die Developer Knowledge API bietet programmatischen Zugriff auf die öffentliche Entwicklerdokumentation von Google. So können Sie diese Knowledge Base in Ihre eigenen Anwendungen und Workflows einbinden.

Die API ist als kanonische Quelle für den maschinenlesbaren Zugriff auf die Entwicklerdokumentation von Google konzipiert.

Ein typischer Anwendungsfall ist, zuerst DeveloperKnowledge.SearchDocumentChunks zu verwenden, um relevante Seiten-URIs basierend auf einer Anfrage zu finden, und dann DeveloperKnowledge.GetDocument oder DeveloperKnowledge.BatchGetDocuments, um den vollständigen Inhalt der Top-Ergebnisse abzurufen.

Alle Dokumentinhalte werden im Markdown-Format bereitgestellt.

BatchGetDocuments

rpc BatchGetDocuments(BatchGetDocumentsRequest) returns (BatchGetDocumentsResponse)

Ruft mehrere Dokumente ab, die jeweils den vollständigen Markdown-Inhalt enthalten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/devprofiles.full_control

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
GetDocument

rpc GetDocument(GetDocumentRequest) returns (Document)

Ruft ein einzelnes Dokument mit seinem vollständigen Markdown-Inhalt ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/devprofiles.full_control

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
SearchDocumentChunks

rpc SearchDocumentChunks(SearchDocumentChunksRequest) returns (SearchDocumentChunksResponse)

Sucht in der Entwicklerdokumentation von Google nach Informationen für Entwickler. Diese Methode gibt Dokumentabschnitte basierend auf der Anfrage des Nutzers zurück. Es kann viele Chunks desselben Dokuments geben. Wenn Sie vollständige Dokumente abrufen möchten, verwenden Sie DeveloperKnowledge.GetDocument oder DeveloperKnowledge.BatchGetDocuments mit dem in SearchDocumentChunksResponse.results zurückgegebenen DocumentChunk.parent.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/devprofiles.full_control

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

BatchGetDocumentsRequest

Anfragenachricht für DeveloperKnowledge.BatchGetDocuments.

Felder
names[]

string

Erforderlich. Die Namen der abzurufenden Dokumente. In einem Batch können maximal 20 Dokumente abgerufen werden. Die Dokumente werden in derselben Reihenfolge zurückgegeben wie die names in der Anfrage.

Format: documents/{uri_without_scheme} Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets

BatchGetDocumentsResponse

Antwortnachricht für DeveloperKnowledge.BatchGetDocuments.

Felder
documents[]

Document

Dokumente angefordert.

Dokument

Ein Dokument stellt einen Inhalt aus dem Developer Knowledge-Korpus dar.

Felder
name

string

ID. Der Ressourcenname des Dokuments. Format: documents/{uri_without_scheme} Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Nur Ausgabe. Der URI des Inhalts, z. B. docs.cloud.google.com/storage/docs/creating-buckets.
content

string

Nur Ausgabe. Der vollständige Inhalt des Dokuments im Markdown-Format.
description

string

Nur Ausgabe. Eine Beschreibung des Dokuments.

DocumentChunk

Ein DocumentChunk stellt einen Inhalt aus einem Dokument im DeveloperKnowledge-Korpus dar. Wenn Sie den gesamten Dokumentinhalt abrufen möchten, übergeben Sie parent an DeveloperKnowledge.GetDocument oder DeveloperKnowledge.BatchGetDocuments.

Felder
parent

string

Nur Ausgabe. Der Ressourcenname des Dokuments, aus dem dieser Chunk stammt. Format: documents/{uri_without_scheme} Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Nur Ausgabe. Die ID dieses Chunks im Dokument. Die Chunk-ID ist innerhalb eines Dokuments eindeutig, aber nicht global über alle Dokumente hinweg. Die Chunk-ID ist nicht stabil und kann sich im Laufe der Zeit ändern.
content

string

Nur Ausgabe. Der Inhalt des Dokumentabschnitts.

GetDocumentRequest

Anfragenachricht für DeveloperKnowledge.GetDocument.

Felder
name

string

Erforderlich. Der Name des abzurufenden Dokuments. Format: documents/{uri_without_scheme} Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets

SearchDocumentChunksRequest

Anfragenachricht für DeveloperKnowledge.SearchDocumentChunks.

Felder
query

string

Erforderlich. Der vom Nutzer bereitgestellte Rohabfragestring, z. B. „Wie erstelle ich einen Cloud Storage-Bucket?“.
page_size

int32

Optional. Die maximale Anzahl von zurückzugebenden Ergebnissen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn nicht angegeben, werden maximal 5 Ergebnisse zurückgegeben.

Der Höchstwert beträgt 20. Höhere Werte führen zu einem INVALID_ARGUMENT-Fehler.
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen SearchDocumentChunks-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

SearchDocumentChunksResponse

Antwortnachricht für DeveloperKnowledge.SearchDocumentChunks.

Felder
results[]

DocumentChunk

Die Suchergebnisse für die angegebene Anfrage. Jedes DocumentChunk in dieser Liste enthält einen Ausschnitt von Inhalten, die für die Suchanfrage relevant sind. Verwenden Sie das Feld DocumentChunk.parent jedes Ergebnisses mit DeveloperKnowledge.GetDocument oder DeveloperKnowledge.BatchGetDocuments, um den vollständigen Dokumentinhalt abzurufen.
next_page_token

string

Optional. Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.