Extension Google Cloud Natural Language

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Version 2.0.2

Accès à l'API Google Cloud Natural Language.

Utilisez cette extension pour classer le contenu en appliquant des catégories, ainsi que pour analyser le sentiment du contenu sur une échelle allant de positif à négatif.

Ce contenu fournit des informations de référence pour configurer et utiliser cette extension. Pour savoir comment configurer une extension à l'aide de la console Apigee, consultez Ajouter et configurer une extension.

Actions

classifyContent

Analyse une partie du texte et renvoie une liste de catégories de contenu qui s'appliquent au texte.

Pour en savoir plus sur cette fonctionnalité dans l'API Natural Language, consultez Classifier des contenus et Catégories de contenu.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Paramètre Description Type Valeur par défaut Obligatoire
données Contenu à analyser. Chaîne Aucune. Oui.

Réponse

Tableau Categories dans lequel chaque élément contient une catégorie pour classer le contenu et un score de confiance.

sentenceSentiment

Analyse le texte donné et identifie l'opinion émotionnelle dominante qu'il contient, en particulier pour déterminer si l'attitude de l'auteur est positive, négative ou neutre.

Pour en savoir plus sur cette fonctionnalité de l'API Natural Language, consultez Analyser les sentiments et Principes de base de l'API Natural Language.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Paramètre Description Type Valeur par défaut Obligatoire
données Contenu à analyser. Chaîne Aucune. Oui.

Réponse

Objet contenant les scores de sentiment pour l'ensemble du document et pour chacune de ses phrases (dans un tableau). Les propriétés suivantes sont incluses pour le document et ses phrases :

  • Propriété "Content" avec le contenu analysé.
  • Une propriété "Score" indiquant le sentiment du contenu sur une échelle de 1 à -1, de positif (nombre positif) à négatif (nombre négatif).
  • Propriété "Magnitude" indiquant l'intensité globale de l'émotion (positive ou négative) dans le contenu, entre 0.0 et +inf.

entitySentiment

Analyse le texte spécifié pour déterminer le sentiment (positif ou négatif) exprimé à propos de chaque entité dans le texte. Le sentiment de l'entité est représenté par un score numérique et une valeur de magnitude. Il est déterminé pour chaque mention d'une entité. Ces scores sont ensuite agrégés pour former un score et une magnitude de sentiment globaux pour une entité.

Pour en savoir plus sur l'analyse des entités dans l'API Google Cloud Natural Language, consultez Analyser les sentiments des entités et Interpréter les valeurs de l'analyse des sentiments.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Paramètre Description Type Valeur par défaut Obligatoire
données Contenu à analyser. Chaîne Aucune. Oui.

Réponse

Tableau d'objets contenant les scores de sentiment pour les entités du texte. Les propriétés suivantes sont incluses pour le document et ses phrases :

  • Une propriété "Name" avec .
  • Propriété Type décrivant le type d'entité.
  • Une propriété "Score" indiquant le sentiment de l'entité sur une échelle de 1 à -1, de positif (nombre positif) à négatif (nombre négatif).
  • Propriété "Magnitude" indiquant l'intensité de l'émotion (positive ou négative) pour l'entité, entre 0,0 et +infini.

Documentation de référence sur la configuration

Utilisez les éléments suivants lorsque vous configurez et déployez cette extension pour l'utiliser dans des proxys d'API.

Propriétés d'extension courantes

Les propriétés suivantes sont présentes pour chaque extension.

Propriété Description Par défaut Obligatoire
name Nom que vous attribuez à cette configuration de l'extension. Aucune Oui
packageName Nom du package d'extension tel qu'indiqué par Apigee Edge. Aucune Oui
version Numéro de version du package d'extension à partir duquel vous configurez une extension. Aucune Oui
configuration Valeur de configuration spécifique à l'extension que vous ajoutez. Consultez Propriétés de ce package d'extension. Aucune Oui

Propriétés de ce package d'extension

Spécifiez les valeurs des propriétés de configuration suivantes propres à cette extension.

Propriété Description Par défaut Obligatoire
identifiants Lorsqu'il est saisi dans la console Apigee Edge, il s'agit du contenu de votre fichier de clé de compte de service. Lorsqu'il est envoyé à l'aide de l'API Management, il s'agit d'une valeur encodée en base64 générée à partir du fichier de clé du compte de service. Aucune. Oui.