सिंक करने का अनुरोध करें

Request Sync, Google के किसी भी उपयोगकर्ता के लिए, आपके फ़ुलफ़िलमेंट को SYNC अनुरोध ट्रिगर करता है. इसके लिए, उपयोगकर्ता के पास ऐसे डिवाइस होने चाहिए जिनसे agentUserId जुड़ा हो. यह वही है जिसे आपने ओरिजनल SYNC अनुरोध में भेजा था. इससे उपयोगकर्ताओं के खाते को अनलिंक और फिर से लिंक किए बिना, उनके डिवाइसों को अपडेट किया जा सकता है. इस आइडेंटिफ़ायर से जुड़े सभी उपयोगकर्ताओं को SYNC का अनुरोध मिलेगा.

आपको SYNC का अनुरोध ट्रिगर करना होगा:

• अगर उपयोगकर्ता कोई नया डिवाइस जोड़ता है.
• अगर उपयोगकर्ता किसी मौजूदा डिवाइस को हटाता है.
• अगर उपयोगकर्ता किसी मौजूदा डिवाइस का नाम बदलता है.
• अगर आपने कोई नया डिवाइस टाइप, ट्रेट या डिवाइस की नई सुविधा जोड़ी है.

अपनी प्रोफ़ाइल बनाना शुरू करें

सिंक करने का अनुरोध लागू करने के लिए, यह तरीका अपनाएं:

• Google HomeGraph API को चालू करना
• सेवा खाते की कुंजी बनाना
• एपीआई को कॉल करना

Google HomeGraph API को चालू करना

1. Google Cloud Console में, HomeGraph API पेज पर जाएं.

   HomeGraph API पेज पर जाएं
2. वह प्रोजेक्ट चुनें जो आपके smart home प्रोजेक्ट आईडी से मैच करता हो.
3. चालू करें पर क्लिक करें.

सेवा खाते की कुंजी बनाना

Google Cloud Console से सेवा खाते की कुंजी जनरेट करने के लिए, यह तरीका अपनाएं:

1. Google Cloud Console में, सेवा खाते पेज पर जाएं.

   सर्विस खातों वाले पेज पर जाएं.

   सेवा खातों वाले पेज पर जाने से पहले, आपको कोई प्रोजेक्ट चुनना पड़ सकता है.

2. addसेवा खाता बनाएं पर क्लिक करें.

3. सेवा खाते का नाम फ़ील्ड में, कोई नाम डालें.

4. सेवा खाता आईडी फ़ील्ड में, कोई आईडी डालें.

5. सेवा खाते की जानकारी फ़ील्ड में, जानकारी डालें.

6. बनाएं और जारी रखें पर क्लिक करें.

7. भूमिका ड्रॉपडाउन से, सेवा खाते > सेवा खाता OpenID Connect आइडेंटिटी टोकन क्रिएटर को चुनें.

8. जारी रखें पर क्लिक करें.

9. हो गया पर क्लिक करें.

10. सेवा खातों की सूची से, वह सेवा खाता चुनें जिसे आपने अभी-अभी बनाया है. इसके बाद, more_vert कार्रवाइयां मेन्यू से कुंजियां मैनेज करें को चुनें.

11. कुंजी जोड़ें > नई कुंजी बनाएं को चुनें.

12. कुंजी का टाइप के लिए, JSON विकल्प चुनें.

13. बनाएं पर क्लिक करें. आपके कंप्यूटर पर एक JSON फ़ाइल डाउनलोड होगी, जिसमें आपकी कुंजी मौजूद होगी.

एपीआई को कॉल करना

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

गड़बड़ी के रिस्पॉन्स

सिंक करने का अनुरोध करने पर, आपको गड़बड़ी के इनमें से कोई एक जवाब मिल सकता है. ये जवाब, एचटीटीपी स्टेटस कोड के तौर पर मिलते हैं.

• 400 Bad Request - अमान्य सिंटैक्स की वजह से, सर्वर क्लाइंट के अनुरोध को प्रोसेस नहीं कर सका. इसकी सामान्य वजहों में, गलत तरीके से फ़ॉर्मैट किया गया JSON या स्ट्रिंग वैल्यू के लिए "" के बजाय null का इस्तेमाल करना शामिल है.
• 403 Forbidden - टोकन रीफ़्रेश करते समय हुई गड़बड़ी की वजह से, सर्वर दिए गए agentUserId के अनुरोध को प्रोसेस नहीं कर सका. पक्का करें कि आपका OAuth एंडपॉइंट, टोकन रीफ़्रेश करने के अनुरोधों का सही जवाब दे. साथ ही, उपयोगकर्ता के खाते के लिंक होने की स्थिति की जांच करें.
• 404 Not Found - अनुरोध किया गया संसाधन नहीं मिला. हालांकि, हो सकता है कि यह आने वाले समय में उपलब्ध हो. आम तौर पर, इसका मतलब यह होता है कि उपयोगकर्ता का खाता Google से लिंक नहीं है या हमें अमान्य agentUserId मिला है. पक्का करें कि agentUserId, आपके SYNC रिस्पॉन्स में दी गई वैल्यू से मेल खाता हो. साथ ही, यह भी पक्का करें कि DISCONNECT इंटेंट को सही तरीके से मैनेज किया जा रहा हो.
• 429 Too Many Requests - दिए गए agentUserId के लिए, एक साथ सिंक करने के अनुरोधों की तय सीमा पूरी हो गई है. कॉल करने वाला व्यक्ति, एक बार में सिंक करने का सिर्फ़ एक अनुरोध कर सकता है. हालांकि, अगर async फ़्लैग को 'सही है' पर सेट किया गया है, तो एक से ज़्यादा अनुरोध किए जा सकते हैं.