Extensão de linguagem natural do Google Cloud

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Versão 1.2.0

Dá acesso à API Google Cloud Natural Language.

Use esta extensão para classificar conteúdo aplicando categorias, bem como para analisar o sentimento do conteúdo em uma escala positiva a negativa.

Este conteúdo fornece referência para configurar e usar essa extensão. Para ver as etapas para configurar uma extensão usando o console da Apigee, consulte Como adicionar e configurar uma extensão.

Ações

classifyContent

Analisa uma parte do texto e retorna uma lista de categorias de conteúdo que se aplicam a ele.

Para saber mais sobre esse recurso da API Natural Language, consulte Como classificar conteúdo e Categorias de conteúdo.

Parâmetros de solicitação

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parâmetro Descrição Tipo Padrão Obrigatório
dados O conteúdo a ser analisado. String Nenhum. Sim.

Resposta

Uma matriz Categories, na qual cada item contém uma categoria para classificar o conteúdo e uma pontuação de confiança.

sentenceSentiment

Analisa o texto e identifica a opinião emocional que prevalece dentro dele, especialmente para determinar a atitude de um escritor como positiva, negativa ou neutra.

Para saber mais sobre esse recurso da API Natural Language, consulte Como analisar sentimentos e Princípios básicos da API Natural Language.

Parâmetros de solicitação

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parâmetro Descrição Tipo Padrão Obrigatório
dados O conteúdo a ser analisado. String Nenhum. Sim.

Resposta

Um objeto que contém pontuações de sentimento para o documento como um todo e cada uma das frases dele (em uma matriz). Tanto para o documento quanto suas frases, as seguintes propriedades estão incluídas:

  • Uma propriedade Content com o conteúdo analisado.
  • Uma propriedade Score que indica o sentimento do conteúdo em uma escala entre 1 e -1, de positivo (número positivo) a negativo (número negativo).
  • Uma propriedade Magnitude que indica a intensidade geral da emoção (positiva e negativa) no conteúdo, entre 0,0 e +inf.

entitySentiment

Analisa o texto especificado para determinar o sentimento (positivo ou negativo) expresso sobre cada entidade no texto. O sentimento da entidade é representado por pontuações numéricas e valores de magnitude e é determinado para cada menção de uma entidade. Depois, essas pontuações são agregadas a uma pontuação de sentimento geral e à magnitude de uma entidade.

Para mais informações sobre a análise de entidade na API Google Cloud Natural Language, consulte Como analisar o sentimento da entidade e Como interpretar os valores da análise de sentimento.

Parâmetros de solicitação

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parâmetro Descrição Tipo Padrão Obrigatório
dados O conteúdo a ser analisado. String Nenhum. Sim.

Resposta

Uma matriz de objetos que contêm pontuações de sentimento para entidades no texto. Tanto para o documento quanto suas frases, as seguintes propriedades estão incluídas:

  • Uma propriedade Name com .
  • Uma propriedade Type que descreve o tipo da entidade.
  • Uma propriedade Score que indica o sentimento da entidade em uma escala entre 1 e -1, de positivo (número positivo) a negativo (número negativo).
  • Uma propriedade Magnitude que indica a intensidade da emoção (positiva e negativa) para a entidade, entre 0,0 e +inf.

Referência de configuração

Use o seguinte ao configurar e implantar esta extensão para uso em proxies de API.

Propriedades de extensão comuns

As propriedades a seguir estão presentes para cada extensão.

Propriedade Descrição Padrão Obrigatório
name Nome que será dado a esta configuração da extensão. Nenhum Sim
packageName Nome do pacote de extensão fornecido pelo Apigee Edge. Nenhum Sim
version Número da versão do pacote de extensão a partir do qual você está configurando uma extensão. Nenhum Sim
configuration Valor de configuração específico da extensão que você está adicionando. Consulte Propriedades para este pacote de extensão. Nenhum Sim

Propriedades deste pacote de extensões

Especifique valores para as seguintes propriedades de configuração específicas desta extensão.

Propriedade Descrição Padrão Obrigatório
credenciais Quando inserido no console do Apigee Edge, este é o conteúdo do arquivo de chave da conta de serviço. Quando enviado pela API de gerenciamento, é um valor codificado em base64 gerado a partir do arquivo de chave da conta de serviço. Nenhum. Sim.