Demander la synchronisation

La synchronisation des requêtes déclenche une requête SYNC dans votre traitement pour tout utilisateur Google avec des appareils dont le agentUserId qui leur sont associés (que vous envoyé dans la demande SYNC d'origine). Cela vous permet de mettre à jour appareils sans dissocier ni réassocier leur compte. Tous les utilisateurs associés recevra une requête SYNC.

Vous devez déclencher une requête SYNC:

• si l'utilisateur ajoute un appareil ;
• Si l'utilisateur supprime un appareil existant.
• si l'utilisateur renomme un appareil existant ;
• Si vous implémentez un nouveau type d'appareil ou une nouvelle caractéristique, ou si vous ajoutez une nouvelle fonctionnalité d'appareil.

Commencer

Pour implémenter la synchronisation des requêtes, procédez comme suit:

• Activer l'API Google HomeGraph
• Créer une clé de compte de service
• Appeler l'API

Activer l'API Google HomeGraph

1. Dans Google Cloud Console, accédez à la page API HomeGraph.

   Accéder à la page de l'API HomeGraph
2. Sélectionnez le projet qui correspond à l'ID de votre projet smart home.
3. Cliquez sur ENABLE (ACTIVER).

Créer une clé de compte de service

Suivez ces instructions pour générer une clé de compte de service à partir de Google Cloud Console:

1. Dans Google Cloud Console, accédez à la page Créer une clé de compte de service.

   Accéder à la page Créer une clé de compte de service
2. Dans la liste Compte de service, sélectionnez Nouveau compte de service :
3. Dans le champ Nom du compte de service, saisissez un nom.
4. Dans le champ ID de compte de service, saisissez un ID.

5. Dans la liste Rôle, sélectionnez Comptes de service > <ph type="x-smartling-placeholder"></ph> Créateur de jetons du compte de service

6. Dans le champ Type de clé, sélectionnez l'option JSON.

7. Cliquez sur Créer. Un fichier JSON contenant votre clé des téléchargements sur votre ordinateur.

Appeler 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);
    

Réponses d'erreur

Vous pouvez recevoir l'une des réponses d'erreur suivantes lorsque vous appelez Request Sync. Ces réponses se présentent sous la forme de codes d'état HTTP.

• 400 Bad Request : impossible de traiter le serveur. la requête envoyée par le client en raison d'une syntaxe non valide. Causes courantes Incluez un fichier JSON mal formé ou utilisez null au lieu de "" pour une valeur de chaîne.
• 403 Forbidden : le serveur n'a pas pu traiter le fichier la requête pour l'élément agentUserId donné en raison d'une erreur en actualisant le jeton. Assurez-vous que votre point de terminaison OAuth répond pour actualiser les demandes de jetons et vérifier l'association du compte de l'utilisateur état.
• 404 Not Found : la ressource demandée n'a pas pu être mais elle sera peut-être disponible à l'avenir. En général, cela signifie que le compte utilisateur n'est pas associé à Google ou nous avons reçu un message d'erreur agentUserId Assurez-vous que agentUserId correspond à la valeur fournie dans votre réponse SYNC, et vous avez correctement qui gère les intents DISCONNECT.
• 429 Too Many Requests : nombre maximal de synchronisations simultanées ont été dépassés pour le agentUserId donné. Un appelant ne peut émettre qu'une seule requête de synchronisation simultanée, sauf si async est défini sur "true".