Ressource REST : documents

Ressource : Document

Représente l'entrée fournie aux méthodes API.

Représentation JSON

{
  "type": enum(Type),
  "language": 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.
}
Champs
type

enum(Type)

Obligatoire. Si le type n'est pas défini ou est défini sur TYPE_UNSPECIFIED, une erreur INVALID_ARGUMENT est renvoyée.

language

string

Langue du document (si aucune valeur n'est spécifiée, la langue est détectée automatiquement). Les codes de langue ISO et BCP-47 sont acceptés.
La page Langues acceptées répertorie les langues compatibles pour chaque méthode API. Si la langue (spécifiée par l'appelant ou détectée automatiquement) n'est pas acceptée par la méthode API appelée, une erreur INVALID_ARGUMENT est renvoyée.

Champ d'union source. Source du document : chaîne contenant le contenu ou URI URI Google Cloud Storage. source ne peut être qu'un des éléments suivants :
content

string

Contenu de l'entrée au format de chaîne. Exclu de Cloud Audit Logging, car il est basé sur des données utilisateur.

gcsContentUri

string

URI Google Cloud Storage où se trouve le contenu du fichier. Cet URI doit être au format suivant : gs://nom_bucket/nom_objet. Pour en savoir plus, consultez la page https://cloud.google.com/storage/docs/reference-uris. REMARQUE : La gestion des versions d'objets Cloud Storage n'est pas compatible.

Type

Énumération des types de documents.

Enums
TYPE_UNSPECIFIED Le type de contenu n'est pas spécifié.
PLAIN_TEXT Texte brut
HTML HTML

Méthodes

analyzeEntities

Recherche les entités nommées (à l'heure actuelle, noms propres et noms communs) dans le texte, ainsi que les types d'entités, la saillance, les mentions pour chaque entité et d'autres propriétés.

analyzeEntitySentiment

Recherche les entités dans le texte, de manière similaire à AnalyzeEntities, et analyse le sentiment associé à chaque entité et à ses mentions.

analyzeSentiment

Analyse le sentiment du texte fourni.

analyzeSyntax

Analyse la syntaxe du texte et fournit les frontières et la tokenization des phrases, ainsi que les tags de classe de mots, les arbres de dépendances et autres propriétés.

annotateText

Méthode pratique fournissant en un seul appel toutes les caractéristiques renvoyées par les fonctions analyzeSentiment, analyzeEntities et analyzeSyntax.

classifyText

Classe un document en catégories.