Registra un dispositivo de forma manual con la API de REST

Para un desarrollo rápido, puedes usar la herramienta de registro. que se proporcionan con el SDK de Asistente de Google para registrar o actualizar rápidamente un dispositivo instancia y modelo.

Si no quieres usar esta herramienta, puedes registrarte manualmente o actualizar un dispositivo con un archivo JSON y la API de REST. Puedes hacer esto en cualquier que ya almacenaste en tu computadora. Primero, obtén un token de acceso y, luego, ve a la sección adecuada.

Obtén un token de acceso

  1. Asegúrate de que la herramienta de autorización esté actualizada: 

    python -m pip install --upgrade google-auth-oauthlib[tool]

  2. Obtén credenciales para poder registrar un modelo de dispositivo nuevo. Haz referencia al archivo JSON que copiaste en el dispositivo en una paso. 

    google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --headless --client-secrets /path/to/client_secret_client-id.json

    Deberías ver una URL en la terminal: 

    Please visit this URL to authorize this application: https://...

  3. Copia la URL y pégala en un navegador (puedes hacerlo en tu una máquina de desarrollo de software, o cualquier otra máquina). Después de tu aprobación, se te enviará aparecerá en tu navegador, por ejemplo, "4/XXXX". Copia y pega este código en la terminal:

    Enter the authorization code:

    Si la autorización se realizó correctamente, verás una respuesta JSON similar a esta: lo siguiente: 

    {
   "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"],
   "token_uri": "https://accounts.google.com/o/oauth2/token",
   "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW",
   "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com",
   "client_secret": "Un8_TNFnb55555auSAGasvAg",
   "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U"
 }

    Si, en cambio, ves UNAUTHENTICATED, significa que se ingresó un código no válido. Vuelve a intentarlo, pero asegúrate de copiar y pegar todo el código.

  4. Busca token en la respuesta JSON. Copia este token de acceso (sin incluir el comillas dobles) en una variable de entorno:

    ACCESSTOKEN=access-token

Operaciones por modelo de dispositivo

Define y registra el modelo de dispositivo

  1. Crea un archivo (p.ej., device_model.json) que describen las características del modelo de tu dispositivo. Consulta la referencia de JSON de modelos de dispositivo. para obtener más información.

  2. Registra el modelo de tu dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id asociado con el modelo de dispositivo en las siguientes URLs.

    • Usa el siguiente comando:

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/

    • Envía una solicitud HTTPS con los siguientes atributos:

    Para cualquiera de los métodos, el servidor debe mostrar una copia del JSON del modelo de dispositivo. que enviaste. Si el modelo ya existe en el servidor, recibirás un error ALREADY_EXISTS.

Obtén un modelo de dispositivo

Obtén un modelo de dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id y device_model_id asociado con tu modelo de dispositivo en las siguientes URLs.

Obtén una lista de los modelos de dispositivos

Obtén una lista de todos los modelos de dispositivos para un proyecto determinado usando cualquiera de los siguientes métodos. Recuerda sustituye project_id asociados con tus modelos de dispositivos en las siguientes URLs.

Actualiza el modelo del dispositivo

Actualiza el modelo del dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id y device_model_id asociados con el modelo de tu dispositivo.

Para cualquiera de los métodos, el servidor debe mostrar una copia del dispositivo actualizado. JSON que enviaste.

Cómo borrar un modelo de dispositivo

Borra un modelo de dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id y device_model_id asociado con tu modelo de dispositivo en las siguientes URLs.

Operaciones de instancias de dispositivos

Define y registra una instancia de dispositivo

  1. Crea un archivo (p.ej., test_device.json) que identifica tu dispositivo. Consulta la referencia de JSON de la instancia de dispositivo. para obtener más información.

  2. Registra tu dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id asociado con el modelo de dispositivo en las siguientes URLs.

    • Usa el siguiente comando:

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/

    • Envía una solicitud HTTPS con los siguientes atributos:

    Para cualquiera de los métodos, el servidor debe mostrar una copia del JSON de la instancia del dispositivo. que enviaste. Si la instancia ya existe en el servidor, recibirás un error ALREADY_EXISTS.

Obtén una instancia de dispositivo

Obtén tu instancia de dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id asociado con el modelo y el dispositivo id en las siguientes URLs.

Obtén una lista de las instancias de dispositivos

Obtén una lista de todas las instancias de dispositivo para un proyecto determinado usando cualquiera de los siguientes métodos. Recuerda reemplazar project_id asociadas con las instancias de dispositivos en las siguientes URLs.

Borra una instancia de dispositivo

Borra tu instancia de dispositivo con cualquiera de los siguientes métodos. Recuerda sustituye project_id asociado con el modelo y el dispositivo id en las siguientes URLs.