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

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

5. भूमिका सूची में, सेवा खाते > सेवा खाता टोकन क्रिएटर चुनें.

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

7. बनाएं पर क्लिक करें. आपके कंप्यूटर पर, एक 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 फ़्लैग को 'सही है' पर सेट नहीं किया जाता, तब तक कॉल करने वाला व्यक्ति एक साथ सिर्फ़ एक सिंक अनुरोध कर सकता है.