Solicitar sincronización

La sincronización de solicitudes activa una solicitud SYNC en tu entrega para cualquier usuario de Google con dispositivos que tengan asociado el agentUserId especificado (que enviaste en la solicitud original de SYNC). Esto te permite actualizar los dispositivos de los usuarios sin desvincular ni volver a vincular su cuenta. Todos los usuarios vinculados a este identificador recibirán una solicitud 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, característica o característica nueva.

Cómo comenzar

Para implementar la sincronización de solicitudes, sigue estos pasos:

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

Habilitar la API de Google HomeGraph

1. Google Cloud Console , go to the HomeGraph API page.

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

Crear una clave de cuenta de servicio

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

1. En la Google Cloud Console, ve a la página Crear clave de la cuenta de servicio.

   Ir a la página Crear clave de la cuenta de servicio
2. En la lista Cuenta de servicio, selecciona Cuenta de servicio nueva.
3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
4. Ingresa un ID en el campo ID de cuenta de servicio.

5. En la lista Función, selecciona Cuentas de servicio > Creador de tokens de cuenta de servicio.

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

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

Llamar 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 Sync Sync. Estas respuestas se proporcionan en forma de códigos de estado HTTP.

• 400 Bad Request: el servidor no pudo procesar la solicitud que envió el cliente debido a la sintaxis no válida. Las causas comunes incluyen JSON con formato incorrecto o el uso de null en lugar de "" para un valor de string.
• 403 Forbidden: El servidor no pudo procesar la solicitud de agentUserId debido a un error mientras se actualizaba el token. Asegúrate de que tu extremo de OAuth responda de forma correcta para actualizar las solicitudes de token y verificar el estado de vinculación de la cuenta del usuario.
• 404 Not Found: no se pudo encontrar el recurso solicitado, pero podría estar disponible en el futuro. Por lo general, esto significa que la cuenta de usuario no está vinculada con Google o recibimos un agentUserId no válido. Asegúrate de que agentUserId coincida con el valor proporcionado en tu respuesta SYNC y de que manejes correctamente los intents DISCONNECT.
• 429 Too Many Requests: Se superó la cantidad máxima de solicitudes de sincronización simultáneas para la agentUserId determinada. Un emisor solo puede emitir una solicitud de sincronización simultánea, a menos que la marca async esté configurada como verdadera.