Senkronizasyon İsteği, belirtilen agentUserId
ile ilişkilendirilmiş cihazlara sahip (orijinal SYNC isteğinde gönderdiğiniz) tüm Google kullanıcıları için sipariş karşılamaya yönelik bir SYNC
isteğini tetikler. Bu sayede, hesap bağlantısını kaldırmadan ve hesabı yeniden bağlamadan
kullanıcıların cihazlarını güncelleyebilirsiniz. Bu tanımlayıcıya bağlı tüm kullanıcılar bir SYNC
isteği alır.
Bir SYNC
isteğini tetiklemeniz gerekir:
- Kullanıcı yeni bir cihaz eklerse.
- Kullanıcının mevcut cihazı kaldırması.
- Kullanıcı mevcut bir cihazı yeniden adlandırırsa.
- Yeni bir cihaz türü veya özelliği uygularsanız ya da yeni cihaz özelliği eklerseniz.
Başlayın
Senkronizasyon İsteğini uygulamak için aşağıdaki adımları uygulayın:
Google HomeGraph API'yi etkinleştirme
-
Google Cloud Console uygulamasında HomeGraph API sayfasına gidin.
HomeGraph API sayfasına gidin - smart home proje kimliğinizle eşleşen projeyi seçin.
- ETKİNLEŞTİR'i tıklayın.
Hizmet Hesabı Anahtarı Oluşturma
Google Cloud Console öğesinden bir hizmet hesabı anahtarı oluşturmak için şu talimatları uygulayın:
-
Google Cloud Console sayfasında Hizmet hesabı anahtarı oluştur sayfasına gidin.
Hizmet Hesabı Anahtarı Oluşturma sayfasına git - Hizmet hesabı listesinden Yeni hizmet hesabı'nı seçin.
- Hizmet hesabı adı alanına bir ad girin.
- Hizmet hesabı kimliği alanına bir kimlik girin.
Role (Rol) listesinden Hizmet Hesapları > Hizmet Hesabı Jetonu Oluşturucu'yu seçin.
Anahtar türü olarak JSON seçeneğini belirleyin.
- Oluştur'u tıklayın. Anahtarınızı içeren bir JSON dosyası, bilgisayarınıza indirilir.
API'yi çağırma
HTTP
Home Graph API, bir HTTP uç noktası sağlar
- İndirilen hizmet hesabı JSON dosyasını kullanarak JSON Web Token (JWT) oluşturun. Daha fazla bilgi için bkz. Hizmet Hesabı Kullanarak Kimlik Doğrulama.
- oauth2l kullanarak
https://www.googleapis.com/auth/homegraph
kapsamıyla bir OAuth 2.0 erişim jetonu alın: agentUserId
ile JSON isteğini oluşturun. Aşağıda, Senkronizasyon İsteği için örnek bir JSON isteği verilmiştir:- Request Sync JSON öğesini ve HTTP POST isteğinizdeki jetonu Google Home Graph uç noktasına birleştirin. Test amacıyla
curl
kullanarak komut satırında nasıl istek yapacağınıza dair bir örneği aşağıda bulabilirsiniz:
oauth2l fetch --credentials service-account.json \ --scope https://www.googleapis.com/auth/homegraph
{ "agentUserId": "user-123" }
curl -X POST -H "Authorization: Bearer ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d @request-body.json \ "https://homegraph.googleapis.com/v1/devices:requestSync"
gRPC
Home Graph API, bir gRPC uç noktası sağlar
- Home Graph API'nin protokol arabellekleri hizmeti tanımını öğrenin.
- Desteklenen dillerden biri için istemci saplaması oluşturmak üzere gRPC geliştirici belgelerini izleyin.
- RequestSync yöntemini çağırın.
Node.js
Google API'leri Node.js istemcisi, Home Graph API için bağlamalar sağlar.
- Application Default Credentials'ı (Uygulama Varsayılan Kimlik Bilgileri) kullanarak
google.homegraph
hizmetini başlatın. - RequestSyncDevicesRequest ile
requestSync
yöntemini çağırın. RequestSyncDevicesResponse değerinin boş olduğu birPromise
döndürür.
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 } });
Java
Java için HomeGraph API İstemci Kitaplığı, Home Graph API için bağlamalar sağlar.
- Application Default Credentials'ı (Uygulama Varsayılan Kimlik Bilgileri) kullanarak
HomeGraphApiService
'ı başlatın. RequestSyncDevicesRequest
ilerequestSync
yöntemini çağırın. Boş birReportStateAndNotificationResponse
değeri döndürür.
// 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ği'ni çağırırken 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. Bozuk JSON veya dize değeri için "" yerinenull
kullanımı, bu durumun sık karşılaşılan nedenlerinden bazılarıdır.403 Forbidden
- Sunucu, jetonu yenilerken oluşan bir hata nedeniyle, belirtilenagentUserId
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 olabilir. Bu durum genellikle kullanıcı hesabının Google'a bağlanmadığı veya geçersiz biragentUserId
aldığımız anlamına gelir.agentUserId
değerinin SENKRONİZE yanıtınızda sağlanan değerle eşleştiğinden ve DISCONNECT amaçlarını düzgün bir şekilde yönettiğinizden emin olun.429 Too Many Requests
- BelirtilenagentUserId
için maksimum eşzamanlı senkronizasyon isteği sayısı aşıldı. Bir arayan,async
işareti doğru değerine ayarlanmadığı sürece yalnızca bir eşzamanlı senkronizasyon isteği gönderebilir.