Extension Google Cloud Natural Language

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

<ph type="x-smartling-placeholder">

Version 1.2.0

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

Utilisez cette extension pour classer le contenu en appliquant des catégories et pour analyser les sentiments exprimés dans le contenu sur une échelle positive ou négative.

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

<ph type="x-smartling-placeholder">

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é dans 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ètre Description Type Par défaut Obligatoire
données Contenu à analyser. Chaîne Aucun 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 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ètre Description Type Par défaut Obligatoire
données Contenu à analyser. Chaîne Aucun Oui.

Réponse

Objet contenant des scores de sentiment pour le document dans son ensemble 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 avec le contenu analysé.
  • Propriété "Score" qui indique le sentiment du contenu sur une échelle comprise entre 1 et -1, de positif (nombre positif) à négatif (nombre négatif).
  • Propriété de magnitude indiquant l'intensité générale de l'émotion (positive ou négative) exprimée dans le contenu.Elle est comprise 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 des entités et Interpréter les valeurs d'analyse des sentiments.

Paramètres de requête

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Paramètre Description Type Par défaut Obligatoire
données Contenu à analyser. Chaîne Aucun 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:

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

Documentation de référence sur la configuration

Procédez comme suit lorsque vous configurez et déployez cette extension afin de l'utiliser dans des proxys d'API.

Propriétés courantes des extensions

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 des valeurs pour les propriétés de configuration suivantes, spécifiques à cette extension.

Propriété Description Par défaut Obligatoire
credentials Lorsque vous le saisissez 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. Aucun Oui.