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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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