Extension Google Cloud Natural Language

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Version 1.4.1

Fournit l'accès à l'API Google Cloud Natural Language.

Utilisez cette extension pour classer des contenus en appliquant des catégories, et pour analyser le sentiment général sur une échelle positive ou négative.

Ce contenu fournit une documentation de référence sur la configuration et l'utilisation de 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 de texte et renvoie une liste de catégories de contenu qui s'appliquent au texte.

Pour en savoir plus sur cette fonctionnalité de l'API Natural Language, consultez les pages Classifier le contenu et Catégories de contenu.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>

Paramètres	Description	Type	Par défaut	Obligatoire
données	Contenu à analyser.	Chaîne	Aucune	Oui.

Réponse

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

sentenceSentiment

Analyse le texte donné et identifie l'opinion émotionnelle dominante qui y est dominante, 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 les pages 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ètres	Description	Type	Par défaut	Obligatoire
données	Contenu à analyser.	Chaîne	Aucune	Oui.

Réponse

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

• Propriété de contenu dont le contenu a été analysé.
• Propriété "Score" indiquant le sentiment exprimé par le contenu sur une échelle de 1 à -1, du positif (nombre positif) au nombre négatif (nombre négatif).
• Propriété Magnitude indiquant l'intensité générale des émotions (positives et négatives) 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é du 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 les pages Analyser les sentiments d'entités et Interpréter les valeurs d'analyse des sentiments.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>

Paramètres	Description	Type	Par défaut	Obligatoire
données	Contenu à analyser.	Chaîne	Aucune	Oui.

Réponse

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

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

Documentation de référence sur la configuration

Utilisez le code suivant 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 spécifiques à cette extension.

Propriété	Description	Par défaut	Obligatoire
identifiants	Une fois saisi dans la console Apigee Edge, il s'agit du contenu de votre fichier de clé de compte de service. Lorsqu'elle est envoyée via l'API de gestion, 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.