Richiedi sincronizzazione

La sincronizzazione delle richieste attiva una richiesta SYNC al tuo fulfillment per qualsiasi utente Google con dispositivi con agentUserId associati (che hai inviato nella richiesta SYNC originale). Questo ti permette di aggiornare dispositivi senza scollegare e ricollegare il proprio account. Tutti gli utenti collegati all'account riceverà una richiesta SYNC.

Devi attivare una richiesta SYNC:

• Se l'utente aggiunge un nuovo dispositivo.
• Se l'utente rimuove un dispositivo esistente.
• Se l'utente rinomina un dispositivo esistente.
• Se implementi un nuovo tipo o trait di dispositivo o aggiungi una nuova funzionalità del dispositivo.

Inizia

Per implementare la sincronizzazione della richiesta, segui questi passaggi:

• Abilita l'API Google HomeGraph
• Creare una chiave dell'account di servizio
• Chiamare l'API

Attiva l'API Google HomeGraph

1. In Google Cloud Console, vai alla pagina dell'API HomeGraph.

   Vai alla pagina dell'API HomeGraph
2. Seleziona il progetto che corrisponde al tuo ID progetto smart home.
3. Fai clic su ABILITA.

Creare una chiave dell'account di servizio

Segui queste istruzioni per generare una chiave dell'account di servizio dal Google Cloud Console:

1. In Google Cloud Console, vai alla pagina Crea chiave account di servizio.

   Vai alla pagina Crea chiave dell'account di servizio
2. Dall'elenco Account di servizio, seleziona Nuovo account di servizio.
3. Nel campo Nome account di servizio, inserisci un nome.
4. Nel campo ID account di servizio, inserisci un ID.

5. Nell'elenco Ruolo, seleziona Account di servizio > Creatore token account di servizio.

6. In Tipo di chiave, seleziona l'opzione JSON.

7. Fai clic su Crea. Un file JSON contenente la chiave vengono scaricati sul computer.

Chiama l'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);
    

Risposte di errore

Quando chiami la sincronizzazione della richiesta, è possibile che venga visualizzata una delle seguenti risposte di errore. Queste risposte si presentano sotto forma di codici di stato HTTP.

• 400 Bad Request - Il server non è riuscito a elaborare la richiesta inviata dal client a causa di una sintassi non valida. Cause comuni includi un file JSON non corretto o utilizzi null al posto di "" per un valore stringa.
• 403 Forbidden - Il server non è riuscito a elaborare il la richiesta per agentUserId a causa di un errore durante aggiornare il token. Assicurati che il tuo endpoint OAuth risponda per aggiornare le richieste di token e controllare il collegamento dell'account dell'utente .
• 404 Not Found - Impossibile eseguire la risorsa richiesta trovati, ma potrebbero essere disponibili in futuro. Generalmente, ciò significa che l'account utente non è collegato a Google o abbiamo ricevuto un messaggio non valido agentUserId. Assicurati che agentUserId corrisponda al valore specificato in la risposta SYNC, dopodiché potrai e gestire gli intent DISCONNECT.
• 429 Too Many Requests - Numero massimo di sincronizzazioni simultanee richieste sono state superate per il agentUserId specificato. Un chiamante può inviare una sola richiesta di sincronizzazione in contemporanea a meno che l'async sia impostato su true.