Senkronizasyon İste

Senkronizasyon İsteyin, kendileriyle ilişkilendirilmiş agentUserId cihazları olan (orijinal SYNC isteğinde gönderdiğiniz) tüm Google kullanıcıları için karşılamanıza bir SYNC isteği tetikler. Bu sayede, kullanıcıların hesaplarını bağlantısını kaldırmadan ve yeniden bağlamadan cihazlarını güncelleyebilirsiniz. Bu tanımlayıcıya bağlı tüm kullanıcılara SYNC isteği gönderilir.

SYNC isteğini tetiklemeniz gerekir:

• Kullanıcı yeni bir cihaz eklerse.
• Kullanıcı mevcut bir cihazı kaldırırsa.
• Kullanıcı mevcut bir cihazı yeniden adlandırırsa.
• Yeni bir cihaz türü uygularsanız veya özellik ekleyin ya da yeni bir cihaz özelliği ekleyin.

Başlayın

Senkronizasyon İsteğinde bulunmak için şu 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 içinde 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 üzerinden hizmet hesabı anahtarı oluşturmak için aşağıdaki talimatları uygulayın:

1. Google Cloud Console bölümünde Hizmet hesabı anahtarı oluştur sayfasına gidin.

   Hizmet Hesabı Anahtarı Oluştur sayfasına git
2. Hizmet hesabı listesinden Yeni hizmet hesabı'nı seçin.
3. Service account name (Hizmet hesabı adı) alanına bir ad girin.
4. Service account ID (Hizmet hesabı kimliği) alanına bir kimlik girin.

5. Rol listesinden Hizmet Hesapları > Hizmet Hesabı Jeton Oluşturucu'yu seçin.

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

7. Create'i (Oluştur) tıklayın. Anahtar indirmelerinizi 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 İsteğinde bulunurken aşağıdaki hata yanıtlarından birini alabilirsiniz. Bu yanıtlar HTTP durum kodları biçimindedir.

• 400 Bad Request - Sunucu, geçersiz söz dizimi nedeniyle istemci tarafından gönderilen isteği işleyemedi. Yaygın nedenler arasında, bozuk JSON veya bir dize değeri için "" yerine null kullanılması sayılabilir.
• 403 Forbidden - Sunucu, jetonu yenilerken bir hata oluştuğundan belirtilen agentUserId için isteği işleyemedi. OAuth uç noktanızın, jeton isteklerini yenilemek ve kullanıcının hesap bağlama durumunu kontrol etmek için doğru şekilde yanıt verdiğinden emin olun.
• 404 Not Found: İstenen kaynak bulunamadı ancak ileride kullanılabilir. Bu genellikle, kullanıcı hesabının Google'a bağlı olmadığı veya geçersiz bir agentUserId aldığımız anlamına gelir. agentUserId öğesinin SYNC yanıtınızda sağlanan değerle eşleştiğinden ve DISCONNECT niyetlerini doğru ş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 değerine ayarlanmadığı sürece, arayan yalnızca bir eşzamanlı senkronizasyon isteğinde bulunabilir.