Senkronizasyon İste

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Senkronizasyon isteği, belirtilen agentUserId ile ilişkili cihazlara sahip tüm Google kullanıcıları için fulfillment'inize bir SYNC isteği tetikler (orijinal SYNC isteğinde gönderdiğiniz). Bu sayede, kullanıcıların hesaplarının bağlantısını kaldırıp yeniden bağlamadan cihazlarını güncelleyebilirsiniz. Bu tanımlayıcıya bağlı tüm kullanıcılar bir SYNC isteği alır.

SYNC isteği tetiklemeniz gerekir:

• Kullanıcı yeni bir cihaz eklerse
• Kullanıcı mevcut bir cihazı kaldırırsa.
• Kullanıcı mevcut bir cihazı yeniden adlandırır.
• Yeni bir cihaz türü, özellik veya cihaz özelliği eklersiniz.

Başlayın

İstek senkronizasyonunu uygulamak için aşağıdaki adımları uygulayın:

• Google HomeGraph API'yi etkinleştirme
• Hizmet Hesabı Anahtarı Oluşturma
• API'yi çağırma

Google HomeGraph API'yi etkinleştirme

1. Google Cloud Console sayfasında HomeGraph API sayfasına gidin.

   HomeGraph API sayfasına gidin.
2. smart home proje kimliğinizle eşleşen projeyi seçin.
3. ETKİNLEŞTİR'i tıklayın.

Hizmet Hesabı Anahtarı Oluşturma

Google Cloud Console'ten hizmet hesabı anahtarı oluşturmak için aşağıdaki talimatları uygulayın:

1. Google Cloud Console'te Hizmet hesapları sayfasına gidin.

   Hizmet Hesapları sayfasına gidin.

   Hizmet Hesapları sayfasına yönlendirilmeden önce bir proje seçmeniz gerekebilir.

2. addHizmet hesabı oluştur'u tıklayın.

3. Hizmet hesabı adı alanına bir ad girin.

4. Hizmet hesabı kimliği alanına bir kimlik girin.

5. Hizmet hesabı açıklaması alanına bir açıklama girin.

6. Oluştur ve devam et'i tıklayın.

7. Rol açılır menüsünden Hizmet Hesapları > Hizmet Hesabı OpenID Connect Kimlik Jetonu Oluşturucu'yu seçin.

8. Devam'ı tıklayın.

9. Bitti'yi tıklayın.

10. Hizmet hesapları listesinden yeni oluşturduğunuz hizmet hesabını seçin ve more_vert İşlemler menüsünden Anahtarları yönet'i seçin.

11. Anahtar ekle > Yeni anahtar oluştur'u seçin.

12. Anahtar türü için JSON seçeneğini belirleyin.

13. Oluştur'u tıklayın. Anahtarınızı içeren bir JSON dosyası bilgisayarınıza indirilir.

API'yi çağırma

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

Hata yanıtları

Senkronizasyon isteğinde bulunurken aşağıdaki hata yanıtlarından birini alabilirsiniz. Bu yanıtlar HTTP durum kodları biçiminde gelir.

• 400 Bad Request: Sunucu, geçersiz söz dizimi nedeniyle istemci tarafından gönderilen isteği işleyemedi. Yaygın nedenler arasında hatalı biçimlendirilmiş JSON veya dize değeri için "" yerine null kullanılması yer alır.
• 403 Forbidden: Sunucu, jetonu yenileme sırasında oluşan bir hata nedeniyle belirli bir agentUserId isteğini işleyemedi. OAuth uç noktanızın, yenileme jetonu isteklerine doğru şekilde yanıt verdiğinden emin olun ve kullanıcının hesap bağlama durumunu kontrol edin.
• 404 Not Found: İstenen kaynak bulunamadı ancak gelecekte kullanılabilir. Bu durum genellikle kullanıcı hesabının Google'a bağlı olmadığı veya geçersiz bir agentUserId aldığımız anlamına gelir. agentUserId değerinin, SYNC yanıtınızda sağlanan değerle eşleştiğinden ve DISCONNECT intent'lerini düzgün şekilde işlediğinizden emin olun.
• 429 Too Many Requests: Belirtilen agentUserId için maksimum eşzamanlı senkronizasyon isteği sayısı aşıldı. async işareti true olarak ayarlanmamışsa bir araya çağıran yalnızca bir eşzamanlı senkronizasyon isteği gönderebilir.