रिपोर्ट स्थिति

Report State एक अहम सुविधा है. इसकी मदद से, Google Home Action, उपयोगकर्ता के डिवाइस की मौजूदा स्थिति की जानकारी, Google Home Graph को पहले से ही भेजता रहता है. इसके लिए, QUERY इंटेंट का इंतज़ार नहीं करना पड़ता.

Report State Google को उपयोगकर्ता के डिवाइसों की स्थिति की जानकारी देता है साथ ही, उनके साथ जुड़ा agentUserId भी बताता है. यह जानकारी, ओरिजनल SYNC अनुरोध में भेजी जाती है. जब Google Assistant को कोई ऐसी कार्रवाई करनी होती है जिसके लिए डिवाइस की मौजूदा स्थिति को समझना ज़रूरी है, तो वह EXECUTE इंटेंट जारी करने से पहले, अलग-अलग तीसरे पक्ष के क्लाउड को QUERY इंटेंट जारी करने के बजाय, सीधे Home Graph में स्थिति की जानकारी देख सकता है.

Report State के बिना, अगर किसी लिविंग रूम में अलग-अलग कंपनियों के डिवाइस मौजूद हैं, तो Ok Google, मेरे लिविंग रूम की रोशनी बढ़ाओ जैसे निर्देश के लिए, कई क्लाउड को भेजे गए कई QUERY इंटेंट को हल करना पड़ता है. इसके बजाय, पहले से रिपोर्ट की गई रोशनी की मौजूदा वैल्यू को सीधे देखा जा सकता है. उपयोगकर्ता को बेहतर अनुभव देने के लिए, Assistant को डिवाइस की मौजूदा स्थिति की जानकारी होनी चाहिए. इसके लिए, डिवाइस को राउंड-ट्रिप करने की ज़रूरत नहीं होती.

किसी डिवाइस के लिए शुरुआती SYNC के बाद, प्लैटफ़ॉर्म एक QUERY इंटेंट भेजता है. इससे डिवाइस की स्थिति की जानकारी इकट्ठा करके, Home Graph में भरी जाती है. इसके बाद, Home Graph में सिर्फ़ वह स्थिति सेव होती है जो के साथ भेजी जाती है.Report State

Report State को कॉल करते समय, पक्का करें कि किसी खास एट्रिब्यूट के लिए स्थिति का पूरा डेटा दिया गया हो. Home Graph एट्रिब्यूट के हिसाब से स्थितियों को अपडेट करता है. साथ ही, Report State को कॉल करने पर, उस एट्रिब्यूट का सारा डेटा मिटा देता है. उदाहरण के लिए, अगर StartStop एट्रिब्यूट के लिए स्थिति की जानकारी रिपोर्ट की जा रही है, तो पेलोड में isRunning और isPaused, दोनों की वैल्यू शामिल होनी चाहिए.

शुरू करें

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

• 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.reportStateAndNotification({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        states: {
          "PLACEHOLDER-DEVICE-ID": {
            on: true
          }
        }
      }
    }
  }
});
    

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

  // Build device state payload.
  Map<?, ?> states = Map.of("on", true);

  // Report device state.
  ReportStateAndNotificationRequest request =
      new ReportStateAndNotificationRequest()
          .setRequestId("PLACEHOLDER-REQUEST-ID")
          .setAgentUserId("PLACEHOLDER-USER-ID")
          .setPayload(
              new StateAndNotificationPayload()
                  .setDevices(
                      new ReportStateAndNotificationDevice()
                          .setStates(Map.of("PLACEHOLDER-DEVICE-ID", states))));
  homegraphService.devices().reportStateAndNotification(request).execute();
}
    

Report State को टेस्ट करना

Cloud-to-cloud इंटिग्रेशन को सर्टिफ़िकेशन के लिए तैयार करने के लिए, Report State को टेस्ट करना ज़रूरी है.

इसके लिए, हमारा सुझाव है कि आप Home Graph Viewer टूल का इस्तेमाल करें, यह एक स्टैंडअलोन वेब ऐप्लिकेशन है. इसे डाउनलोड या डिप्लॉय करने की ज़रूरत नहीं होती.

Report State डैशबोर्ड अब भी उपलब्ध है, लेकिन इसे बंद कर दिया गया है और अब यह काम नहीं करता.

Report State डैशबोर्ड

ज़रूरी शर्तें

अपने Cloud-to-cloud इंटिग्रेशन को टेस्ट करने से पहले, आपके पास सेवा खाते की कुंजी और आपका agentUserId होना चाहिए. अगर आपके पास पहले से ही आपकी सेवा खाते की कुंजी और agentUserId है, तो डैशबोर्ड को Report State डिप्लॉय करना लेख पढ़ें.

Report State डैशबोर्ड को डिप्लॉय करना

अपने प्रोजेक्ट के लिए सेवा खाते की कुंजी और एजेंट यूज़र आईडी मिलने के बाद, नया वर्शन डाउनलोड करें और उसे Report State डैशबोर्डसे डिप्लॉय करें. नया वर्शन डाउनलोड करने के बाद, शामिल की गई README.MD फ़ाइल में दिए गए निर्देशों का पालन करें.

Report State डैशबोर्ड को डिप्लॉय करने के बाद, इस यूआरएल से डैशबोर्ड को ऐक्सेस करें. your_project_id की जगह अपना प्रोजेक्ट आईडी डालें:

http://<your-project-id>.appspot.com

डैशबोर्ड पर, यह काम करें:

• खाते की कुंजी वाली फ़ाइल चुनें
• अपना agentUserId जोड़ें

इसके बाद, सूची पर क्लिक करें.

आपके सभी डिवाइसों की सूची दिखती है. सूची भरने के बाद, डिवाइस की स्थितियों को अपडेट करने के लिए, रीफ़्रेश करें बटन का इस्तेमाल किया जा सकता है. अगर डिवाइस की स्थिति में कोई बदलाव होता है, तो उस पंक्ति को हरे रंग में हाइलाइट किया जाता है.

Report State में गड़बड़ी

क्वेरी के आधार पर, Report State की सटीक जानकारी से यह पता चलता है कि किसी डिवाइस के लिए, Report State की मौजूदा जानकारी, उपयोगकर्ता की क्वेरी करने पर डिवाइस की स्थिति से कितनी मेल खाती है. इस वैल्यू के 99.5% होने की उम्मीद है. अपने प्रोजेक्ट के Report State की सटीक जानकारी की मौजूदा स्थिति के बारे में ज़्यादा जानने के लिए, डिवाइस की स्थिति - की सटीक जानकारी लेख पढ़ें. Logs Explorer से, Report State में गड़बड़ी के लॉग की जानकारी भी देखी जा सकती है.

यहां Report State में गड़बड़ी के लॉग का एक उदाहरण दिया गया है:

{
  "insertId": "abcdefgh",
  "jsonPayload": {
    "reportStateLog": {
      "result": "INACCURATE",
      "detailedAccuracyResult": "DETAILED_ACCURACY_RESULT_INACCURATE",
      "isOffline": false,
      "queriedTime": "2026-01-17T03:22:01.732938Z",
      "reportedTime": "2024-11-30T15:24:34.052751Z",
      "agentId": "google-smart-home-agent-id-example",
      "requestId": "84920571364829501736",
      "queryReportStateDifferences": {
        "queryState": "on_off \t {\n  on: true\n}\n",
        "reportState": "on_off \t {\n  on: false\n}\n"
      },
      "traitName": "TRAIT_ON_OFF",
      "snapshotTime": "2026-01-17T03:22:01.732938Z",
      "isMissingField": false,
      "deviceType": "action.devices.types.OUTLET",
      "stateName": "on",
      "deviceId": "sample-device-id",
      "accuracy": "INACCURATE"
    }
  },
  "resource": {
    "type": "assistant_action_project",
    "labels": {
      "project_id": "google-smart-home-agent-id-example"
    }
  },
  "timestamp": "2026-01-17T07:16:13.712708257Z",
  "severity": "ERROR",
  "logName": "projects/google-smart-home-agent-id-example/logs/assistant_smarthome%2Fassistant_smarthome_logs",
  "receiveTimestamp": "2026-01-17T07:16:13.712708257Z"
}

Report State में गड़बड़ी के लॉग के फ़ील्ड की परिभाषाएं

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

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

400 खराब अनुरोध

**सिंटैक्स अमान्य** होने की वजह से, सर्वर, क्लाइंट के भेजे गए अनुरोध को प्रोसेस नहीं कर सका. आम तौर पर, इसकी वजहें गलत तरीके से बनाया गया JSON या स्ट्रिंग वैल्यू के लिए "" के बजाय null का इस्तेमाल करना हो सकती हैं.

पेज नहीं मिला

अनुरोध किया गया संसाधन नहीं मिला. हालांकि, यह आने वाले समय में उपलब्ध हो सकता है. आम तौर पर, इसका मतलब है कि हमें अनुरोध किया गया डिवाइस नहीं मिला. इसका मतलब यह भी हो सकता है कि उपयोगकर्ता का खाता, Google से लिंक नहीं है या हमें अमान्य agentUserId मिला है. SYNC

ReportState को कॉल करने पर, अगर 404 NOT_FOUND गड़बड़ी दिखती है, तो इसका मतलब है कि आपके क्लाउड और Home Graph के बीच सिंक करने में गड़बड़ी है. ऐसा तब हो सकता है, जब किसी डिवाइस को Home Graph से हटा दिया गया हो या अगर किसी उपयोगकर्ता ने अपना खाता अनलिंक कर दिया हो.

Report State से मिलने वाली 404 गड़बड़ियों को ठीक करने के लिए, यह तरीका अपनाएं:

1. उपयोगकर्ता खाते की स्थिति की जांच करना: उस agentUserId के लिए devices.sync को कॉल करें जिससे 404 गड़बड़ी मिली है. इससे यह पता चलता है कि गड़बड़ी, उपयोगकर्ता के पूरे खाते के लिए है या किसी खास डिवाइस के लिए.
   • अगर SYNC से 404 गड़बड़ी मिलती है, तो इसका मतलब है कि उपयोगकर्ता का खाता अब Google से लिंक नहीं है. इस उपयोगकर्ता के डिवाइसों के लिए, Report State और Request Sync भेजना बंद करें.
   • अगर SYNC से 200 OK मिलता है, तो इसका मतलब है कि उपयोगकर्ता का खाता अब भी लिंक है. इसका मतलब है कि 404 गड़बड़ी, डिवाइस से जुड़ी है.
2. डिवाइसों की सूची को ठीक करना: अगर SYNC से 200 OK मिलता है, तो आपको यह पता लगाना होगा कि Google को अब कौनसे डिवाइसों की जानकारी नहीं है. हमारा सुझाव है कि आप Google के पास मौजूद उपयोगकर्ता के डिवाइसों की सूची की तुलना, अपने डिवाइस डेटाबेस से करें. साथ ही, अपने सिस्टम में उन डिवाइसों की पहचान करें जो Google की सूची में मौजूद नहीं हैं. अगर किसी डिवाइस को Google के साथ सिंक किया जाना चाहिए, लेकिन उसे अब तक Google के साथ शेयर नहीं किया गया है, तो पक्का करें कि डिवाइस, Google के साथ सिंक हो. इसके लिए, SYNC का इस्तेमाल करें. अगर किसी डिवाइस को Google से अनलिंक किया जाना चाहिए, तो उस खास डिवाइस के लिए स्थिति की जानकारी रिपोर्ट करना बंद करें. साथ ही, उस agentUserId के तहत मौजूद अन्य मान्य डिवाइसों के लिए, स्थिति की जानकारी रिपोर्ट करना जारी रखें.

ऑनलाइन और ऑफ़लाइन स्थिति की जानकारी रिपोर्ट करना

"requestId": "test-request-id",
  "agentUserId": "agent-user-1",
    "payload":{
      "devices": {
        "states": {
          "device-id-1": {
            "brightness": 65,
            "on": true,
            "online": true
          }
          "notifications": {},
        }
      }
    }