REST Resource: documents

Ressource: Document

Stellt die Eingabe für API-Methoden dar.

JSON-Darstellung
{
  "type": enum (Type),
  "languageCode": string,

  // Union field source can be only one of the following:
  "content": string,
  "gcsContentUri": string
  // End of list of possible types for union field source.
}
Felder
type

enum (Type)

Pflichtangabe. Wenn der Typ nicht festgelegt wurde oder TYPE_UNSPECIFIED ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

languageCode

string

Optional. Die Sprache des Dokuments (falls nicht angegeben, wird die Sprache automatisch erkannt). Sowohl ISO- als auch BCP-47-Sprachcodes sind zulässig.
Unter Sprachunterstützung finden Sie eine Liste der derzeit unterstützten Sprachen für jede API-Methode. Wenn die Sprache (entweder vom Aufrufer angegeben oder automatisch erkannt) von der aufgerufenen API-Methode nicht unterstützt wird, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Union-Feld source. Die Quelle des Dokuments: ein String mit dem Inhalt oder ein Google Cloud Storage-URI. Für source ist nur einer der folgenden Werte zulässig:
content

string

Der Inhalt der Eingabe im Stringformat. Cloud-Audit-Logs sind ausgenommen, da sie auf Nutzerdaten basieren.

gcsContentUri

string

Der Google Cloud Storage-URI, in dem sich der Dateiinhalt befindet. Dieser URI muss das Format gs://bucketName/object_name haben. Weitere Informationen finden Sie unter https://cloud.google.com/storage/docs/reference-uris. HINWEIS: Cloud Storage-Objektversionierung wird nicht unterstützt.

Typ

Die Enum der Dokumententypen.

Enums
TYPE_UNSPECIFIED Der Inhaltstyp ist nicht angegeben.
PLAIN_TEXT Nur Text
HTML HTML

Methoden

analyzeEntities

Es werden benannte Entitäten (derzeit Eigennamen und Gattungsnamen) im Text sowie Entitätstypen, Wahrscheinlichkeiten, Erwähnungen für jede Entität und andere Eigenschaften gefunden.

analyzeSentiment

Analysiert die Stimmung des jeweiligen Textes.

annotateText

Eine praktische Methode, die alle Funktionen in einem Aufruf bietet.

classifyText

Klassifiziert ein Dokument in Kategorien.

moderateText

Ein Dokument wird auf schädliche und sensible Inhalte überprüft.