Solicitar sincronización

Request Sync activa una solicitud SYNC a tu cumplimiento para cualquier usuario de Google con dispositivos que tengan el agentUserId especificado asociado (que enviaste en la solicitud SYNC original). Esto te permite actualizar los dispositivos de los usuarios sin desvincular y volver a vincular sus cuentas. Todos los usuarios vinculados a este identificador recibirán una solicitud de SYNC.

Debes activar una solicitud SYNC:

• Si el usuario agrega un dispositivo nuevo
• Si el usuario quita un dispositivo existente
• Si el usuario cambia el nombre de un dispositivo existente.
• Si implementas un nuevo tipo de dispositivo, rasgo o agregas una nueva función del dispositivo

Comenzar

Para implementar la función Request Sync, sigue estos pasos:

• Habilita la API de Google HomeGraph
• Crea una clave de cuenta de servicio
• Llama a la API

Habilita la API de Google HomeGraph

1. En Google Cloud Console, ve a la página de la API de HomeGraph.

   Ir a la página de la API de HomeGraph
2. Selecciona el proyecto que coincida con tu ID del proyecto smart home.
3. Haz clic en HABILITAR.

Crea una clave de cuenta de servicio

Sigue estas instrucciones para generar una clave de cuenta de servicio desde Google Cloud Console:

1. En la Google Cloud Console, ve a la página Cuentas de servicio.

   Ir a la página Cuentas de servicio

   Es posible que debas seleccionar un proyecto antes de que se te redireccione a la página Cuentas de servicio.

2. Haz clic en addCrear cuenta de servicio.

3. Escribe un nombre en el campo Nombre de cuenta de servicio.

4. En el campo ID de cuenta de servicio, ingresa un ID.

5. Opcional: en el campo Descripción de la cuenta de servicio, escribe una descripción.

6. Haz clic en Crear y continuar.

7. En el menú desplegable Rol, selecciona Cuentas de servicio > Creador de tokens de identidad de OpenID Connect para cuentas de servicio.

8. Haz clic en Continuar.

9. Haz clic en Listo.

10. Selecciona la cuenta de servicio que acabas de crear en la lista de cuentas de servicio y, luego, selecciona Administrar claves en el menú more_vert Acciones.

11. Selecciona Agregar clave > Crear clave nueva.

12. En Tipo de clave, selecciona la opción JSON.

13. Haz clic en Crear. Se descargará a tu computadora un archivo JSON con la clave.

Llama a la API

const homegraphClient = homegraph({
  version: 'v1',
  auth: new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/homegraph'
  })
});

const res = await homegraphClient.devices.requestSync({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    async: false
  }
});
    

// Get Application Default credentials.
GoogleCredentials credentials =
    GoogleCredentials.getApplicationDefault()
        .createScoped(List.of("https://www.googleapis.com/auth/homegraph"));

// Create Home Graph service client.
HomeGraphService homegraphService =
    new HomeGraphService.Builder(
            GoogleNetHttpTransport.newTrustedTransport(),
            GsonFactory.getDefaultInstance(),
            new HttpCredentialsAdapter(credentials))
        .setApplicationName("HomeGraphExample/1.0")
        .build();

// Request sync.
RequestSyncDevicesRequest request =
    new RequestSyncDevicesRequest().setAgentUserId("PLACEHOLDER-USER-ID").setAsync(false);
homegraphService.devices().requestSync(request);
    

Respuestas de error

Es posible que recibas una de las siguientes respuestas de error cuando llames a Request Sync. Estas respuestas se presentan en forma de códigos de estado HTTP.

• 400 Bad Request: El servidor no pudo procesar la solicitud enviada por el cliente debido a una sintaxis no válida. Entre las causas comunes, se incluyen el uso de JSON con formato incorrecto o el uso de null en lugar de "" para un valor de cadena.
• 403 Forbidden: El servidor no pudo procesar la solicitud del agentUserId determinado debido a un error durante la actualización del token. Asegúrate de que tu extremo de OAuth responda correctamente a las solicitudes de tokens de actualización y verifica el estado de vinculación de la cuenta del usuario.
• 404 Not Found: No se encontró el recurso solicitado, pero es posible que esté disponible en el futuro. Por lo general, esto significa que la cuenta de usuario no está vinculada con Google o que recibimos un agentUserId no válido. Asegúrate de que agentUserId coincida con el valor proporcionado en tu respuesta de SYNC y de que controlas correctamente las intents de DISCONNECT.
• 429 Too Many Requests: Se excedió la cantidad máxima de solicitudes de sincronización simultáneas para el agentUserId determinado. Un llamador solo puede emitir una solicitud de sincronización simultánea, a menos que la marca async esté establecida como verdadera.