Antes de comenzar
- Accede a tu Cuenta de Google.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
- Configura un proyecto de Cloud Console.
Haz clic para realizar alguna de las siguientes acciones:
- Crea o selecciona un proyecto.
- Habilita la API de Cloud Natural Language para ese proyecto.
- Crea una cuenta de servicio.
- Descargar una clave privada como JSON
Puedes ver y administrar estos recursos en cualquier momento desde Cloud Console.
-
Configura la variable de entorno
GOOGLE_APPLICATION_CREDENTIALS
en la ruta del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable. - Instala e inicializa el SDK de Cloud.
Realiza una solicitud de análisis de entidades
gcloud
Usa la herramienta de línea de comandos degcloud
para llamar al comando analyze-entities
y también usa la marca --content
para especificar el texto que se analizará.gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
Línea de comandos
Usacurl
para hacer una solicitud POST
al método documents:analyzeEntities
y proporciona el cuerpo de solicitud adecuado, como se muestra en el siguiente ejemplo.
En el ejemplo, se usa el comando gcloud auth application-default print-access-token
a fin de obtener un token de acceso para la cuenta de servicio que creaste cuando configuraste el proyecto.
curl -X POST
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token)
-H "Content-Type: application/json; charset=utf-8"
--data "{ 'document':{ 'type':'PLAIN_TEXT', 'content':'Michelangelo Caravaggio, Italian painter, is known for \'The Calling of Saint Matthew\'.' }, 'encodingType':'UTF8' }" "https://language.googleapis.com/v1/documents:analyzeEntities"
Deberías ver una respuesta similar a la siguiente:
{ "entities": [ { "name": "Michelangelo Caravaggio", "type": "PERSON", "metadata": { "wikipedia_url": "http://en.wikipedia.org/wiki/Caravaggio", "mid": "/m/020bg" }, "salience": 0.83047235, "mentions": [ { "text": { "content": "Michelangelo Caravaggio", "beginOffset": 0 }, "type": "PROPER" }, { "text": { "content": "painter", "beginOffset": 33 }, "type": "COMMON" } ] }, { "name": "Italian", "type": "LOCATION", "metadata": { "mid": "/m/03rjj", "wikipedia_url": "http://en.wikipedia.org/wiki/Italy" }, "salience": 0.13870546, "mentions": [ { "text": { "content": "Italian", "beginOffset": 25 }, "type": "PROPER" } ] }, { "name": "The Calling of Saint Matthew", "type": "EVENT", "metadata": { "mid": "/m/085_p7", "wikipedia_url": "http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)" }, "salience": 0.030822212, "mentions": [ { "text": { "content": "The Calling of Saint Matthew", "beginOffset": 69 }, "type": "PROPER" } ] } ], "language": "en" }
Felicitaciones. Enviaste tu primera solicitud a la API de Cloud Natural Language.
Limpia
A fin de evitar cargos innecesarios de Google Cloud Platform, usa Cloud Console para borrar tu proyecto si no lo necesitas.
¿Qué sigue?
- Comienza a usar la API de Natural Language en el idioma de tu elección con una biblioteca cliente de Cloud Natural Language.
- Consulta los Conceptos básicos de Natural Language para obtener información conceptual sobre la formación de solicitudes de la API de Natural Language y manejar respuestas.
- Revisa con atención el Instructivo de análisis de opiniones y explora las Aplicaciones de muestra.