Empezar a usar la API de Firestore en modo Datastore

En esta página se propone un breve ejercicio para crear una aplicación de lista de tareas de línea de comandos con la API de Firestore en modo Datastore. La aplicación TaskList almacena, muestra, actualiza y elimina tareas.

Requisitos previos

  1. Capacidad para escribir y ejecutar una aplicación de línea de comandos en los lenguajes de programación que se usan en este tema
    Además de tener conocimientos básicos sobre cómo desarrollar aplicaciones, debes poder descargar e instalar bibliotecas adicionales antes de intentar completar este tutorial.
  2. Un proyecto de Google Cloud con la API del modo Datastore habilitada
    Las aplicaciones que usan el modo Datastore están asociadas a un proyecto de Google Cloud con la API del modo Datastore habilitada. Este proyecto proporciona las credenciales de autenticación que usas en tu aplicación para identificarla en Google y autorizar su uso de la API del modo Datastore.
    Sigue estas instrucciones para crear un proyecto, habilitar el modo Datastore API y configurar tu entorno de desarrollo local con credenciales de autenticación mediante el comando gcloud auth login. Anota el ID del proyecto, que usarás más adelante.

Instalación y configuración

Instala las bibliotecas de cliente y configura los ajustes adicionales de tu entorno de desarrollo.

C#

  1. Asegúrate de tener instalado Visual Studio (versión 2013 o posterior).
  2. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.
  3. Extrae los archivos del archivo ZIP en un directorio de la carpeta Documentos.
  4. En Visual Studio, abre el archivo dotnet-docs-samples-master\datastore\api\Datastore.sln.
  5. En la ventana Explorador de soluciones de Visual Studio, haz clic con el botón derecho en el proyecto TaskList y elige Establecer como proyecto de inicio.
  6. Vuelve a hacer clic con el botón derecho en el proyecto TaskList y elige Propiedades.

  7. En la ventana Propiedades, haga clic en Depurar y escriba el ID de su Google Cloud proyecto en el cuadro Argumentos de línea de comandos:.

    Ventana de depuración de Visual Studio

  8. Haz clic en Archivo y, a continuación, en Guardar para guardar los cambios.

  9. Ejecuta la aplicación. Pulsa F5 en el teclado.

Go

  1. Clona la aplicación de ejemplo TaskList.

    go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks

  2. Cambia al directorio donde hayas clonado el ejemplo:

    cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks

  3. En el símbolo del sistema, ejecuta el siguiente comando, donde <project-id> es el ID de tu proyecto Google Cloud .

    export DATASTORE_PROJECT_ID=<project-id>

    (Usuarios de Windows: usad set en lugar de export).

  4. Ejecuta la aplicación.

    go run tasks.go

Java

  1. Asegúrate de que tienes instalados Maven y Java (versión 8 o posterior).

  2. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.

  3. En el símbolo del sistema, extrae la descarga:

    unzip main.zip

  4. Cambia de directorio a la aplicación TaskList:

    cd java-datastore-main/samples/snippets

  5. Ejecuta lo siguiente, donde <project-id> es el ID de tu Google Cloud proyecto.

    gcloud config set project <project-id>

  6. Compila y ejecuta la aplicación.

    mvn clean compile
mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"

Node.js

  1. Prepara tu entorno para el desarrollo de Node.js.

  2. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.

  3. Extrae la descarga:

    unzip master.zip

  4. Cambia de directorio a la aplicación TaskList:

    cd nodejs-datastore-master/samples

  5. Instala las dependencias y vincula la aplicación:

    npm install

  6. En el símbolo del sistema, ejecuta el siguiente comando, donde <project-id> es el ID de tu proyecto Google Cloud .

    export GCLOUD_PROJECT=<project-id>

    (Usuarios de Windows: usad set en lugar de export).

  7. Ejecuta la aplicación.

    node tasks.js

PHP

  1. Asegúrate de que tienes instalados PHP (versión 5.6 o posterior) y Composer.
  2. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.

  3. Extrae la descarga:

    unzip master.zip

  4. Cambia de directorio a la aplicación TaskList:

    cd php-docs-samples-master/datastore/tutorial

  5. Instala las dependencias.

    composer install

  6. Ejecuta la aplicación.

    php src/list_tasks.php

Python

  1. Asegúrate de que tienes instalados Python (versión 2.7.9 o posterior), pip y virtualenv.

  2. Activa una sesión de virtualenv.

    virtualenv venv
source venv/bin/activate

  3. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.

  4. Extrae la descarga:

    unzip master.zip

  5. Cambia de directorio a la aplicación TaskList:

    cd python-docs-samples-master/datastore/cloud-client

  6. Instala las dependencias:

    pip install -r requirements.txt

  7. Ejecuta la aplicación. Usa el ID de tu proyecto de Google Cloud para <project-id>.

    python tasks.py new project-id

Ruby

  1. Asegúrate de que tienes instalados Ruby y Bundler.

  2. Descarga la aplicación de ejemplo TaskList del repositorio de ejemplos.

  3. Extrae la descarga:

    unzip master.zip

  4. Cambia de directorio a la aplicación TaskList: