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

सिंक करने का अनुरोध करने पर, Google के किसी भी ऐसे उपयोगकर्ता के लिए SYNC अनुरोध ट्रिगर होता है जिसके पास ऐसे डिवाइस हैं जिनसे agentUserId जुड़ा है. यह वही agentUserId है जिसे आपने सिंक करने के मूल अनुरोध में भेजा था. इससे उपयोगकर्ताओं के डिवाइसों को अपडेट किया जा सकता है. इसके लिए, उनके खाते को अनलिंक और फिर से लिंक करने की ज़रूरत नहीं होती. इस आइडेंटिफ़ायर से लिंक किए गए सभी उपयोगकर्ताओं को 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);
    

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

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 फ़्लैग को 'सही है' पर सेट न किया गया हो.