Analizar entidades

Análisis de entidades: inspecciona el texto proporcionado para buscar entidades conocidas (nombres propios, como personajes públicos, monumentos, etc.) y devuelve información sobre esas entidades. El análisis de entidades se realiza con el método analyzeEntities. Para obtener información sobre los tipos de entidades que identifica Natural Language, consulta la documentación sobre entidades. Para obtener información sobre los idiomas que admite la API Natural Language, consulta Idiomas admitidos.

En esta sección se muestran algunas formas de detectar entidades en un documento. Para cada documento, debes enviar una solicitud independiente.

Analizar entidades en una cadena

A continuación, se muestra un ejemplo de cómo realizar un análisis de entidades en una cadena de texto enviada directamente a la API Natural Language:

Protocolo

Para analizar entidades en un documento, haz una solicitud POST al método REST documents:analyzeEntities y proporciona el cuerpo de la solicitud adecuado, como se muestra en el siguiente ejemplo.

En el ejemplo se usa el comando gcloud auth application-default print-access-token para obtener un token de acceso de una cuenta de servicio configurada para el proyecto con la CLI de gcloud de Google Cloud Platform. Para obtener instrucciones sobre cómo instalar la CLI de gcloud y configurar un proyecto con una cuenta de servicio, consulta la guía de inicio rápido.

curl -X POST \
     -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
  'encodingType': 'UTF8',
  'document': {
    'type': 'PLAIN_TEXT',
    'content': 'President Trump will speak from the White House, located
  at 1600 Pennsylvania Ave NW, Washington, DC, on October 7.'
  }
}" "https://language.googleapis.com/v2/documents:analyzeEntities"

Si no especifica document.language_code, el idioma se detectará automáticamente. Para obtener información sobre los idiomas admitidos por la API Natural Language, consulta Idiomas admitidos. Consulta la documentación de referencia de Document para obtener más información sobre cómo configurar el cuerpo de la solicitud.

Si la solicitud se realiza de forma correcta, el servidor devuelve un código de estado HTTP 200 OK y la respuesta en formato JSON:

{
  "entities": [
    {
      "name":