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

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

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

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

शुरू करें

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

गड़बड़ी के जवाब

Request Sync को कॉल करने पर, आपको गड़बड़ी के ये जवाब मिल सकते हैं. ये जवाब, एचटीटीपी स्टेटस कोड के तौर पर मिलते हैं.

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