महत्वपूर्ण

तृतीय पक्षों के लिए मेरा डेटा साझा करें

तृतीय-पक्ष को आपके ऊर्जा उपयोग डेटा तक पहुंच की अनुमति दें

ícono de aviso importante नोट: एक कंप्यूटर ने इस पृष्ठ का अनुवाद किया। यदि आपके कोई प्रश्न हैं, तो भाषा सेवाओं को 1-877-660-6789 पर कॉल करें।

तीसरे पक्ष की कंपनियां आपको पैसे बचाने में मदद करने के लिए विश्लेषण और उपकरण प्रदान करती हैं।

मेरा डेटा साझा करना क्या है?

 

मेरा डेटा साझा करें ग्रीन बटन कनेक्ट मेरा डेटा एग्रीमेंट टूल की अगली पीढ़ी है।

 

पहले से ही एक अनुमोदित शेयर मेरा डेटा विक्रेता के रूप में पंजीकृत है?

साइन इन करें

 

मेरा डेटा साझा करने के लिए कौन उपयोग कर सकता है?

 

  • वाणिज्यिक ग्राहक
  • आवासीय ग्राहक
  • विश्वविद्यालय और अनुसंधानकर्ता
  • सॉफ्टवेयर विक्रेता
  • ऊर्जा स्टार्ट-अप
  • सौर कंपनियां
  • सामुदायिक विकल्प एग्रीगेटर्स
  • मांग प्रतिक्रिया
  • इलेक्ट्रिक वाहन
  • और कई और

मेरा डेटा साझा करने के क्या लाभ हैं?

 

ग्राहकों को ग्रीन बटन फ़ाइलों को बार-बार डाउनलोड करने और भेजने के लिए अपने ऑनलाइन खाते में लॉग इन नहीं करना पड़ता है। इसके बजाय, एक बार जब कोई ग्राहक आपकी कंपनी को अपने PG&E खाते के डेटा तक पहुंचने के लिए अधिकृत करता है, तो स्थानांतरण को मानकों-आधारित एप्लिकेशन प्रोग्रामिंग इंटरफेस (एपीआई) का उपयोग करके स्वचालित रूप से और बार-बार संभाला जाता है। मेरा डेटा साझा करें प्लेटफ़ॉर्म ग्राहक के डेटा को पैकेज करता है, डेटा तैयार होने और सुरक्षित रूप से इसे भेजने पर आपके सिस्टम को सूचित करता है।

 

विश्वसनीय डेटा एक्सेस

एपीआई के माध्यम से लगातार, विश्वसनीय डेटा एक्सेस। अब "स्क्रीन स्क्रैप" या डेटा डाउनलोड करने की आवश्यकता नहीं है।

 

मानक एपीआई

अन्य ऊर्जा प्रदाताओं के साथ अंतर-संचालन के लिए राष्ट्रीय स्तर पर मान्यता प्राप्त मानक ऊर्जा सेवा प्रदाता इंटरफेस एपीआई प्रारूप।

 

बिलिंग और खाता

PG&E ग्राहक अपने बिलिंग और खाते की जानकारी तक पहुंच को भी अधिकृत कर सकते हैं।

 

डेटा की मात्रा और गुणवत्ता

एक ही स्रोत से सभी उपयोग और बिलिंग डेटा तक पहुंचें।

 

बिजली और गैस

मेरे डेटा को साझा करने में बिजली और गैस दोनों के उपयोग के लिए PG&E ग्राहक अंतराल डेटा शामिल है।

 

नवाचार खोलें

उपयोग के मामले केवल आपकी कल्पना (और कुछ नियम और शर्तों) द्वारा सीमित हैं।

 

मेरा डेटा साझा करें के साथ आरंभ करें

एपीआई के माध्यम से ग्राहक-अधिकृत डेटा तक पहुंचने के कई तरीके हैं। हमारे नवीनतम एपीआई वर्तमान उत्तर अमेरिकी ऊर्जा मानक बोर्ड (NAESB) ऊर्जा सेवा प्रदाता इंटरफेस (ESPI) मानक का पालन करते हैं और रिस्टफुल इंटरफेस के एक सेट के माध्यम से ऊर्जा उपयोग जानकारी (EUI) तक पहुंच प्रदान करते हैं।

 

लेकिन सबसे पहले, आपको अपना डेटा साझा करें प्लेटफॉर्म का उपयोग करने के लिए पंजीकरण करना होगा इससे पहले कि ग्राहक आपको अपने डेटा तक पहुंचने के लिए अधिकृत कर सकें। पहुंच प्राप्त करने के लिए नीचे दिए गए चरणों का पालन करें।

पंजीकरण प्रक्रिया शुरू करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित जानकारी है।

 

  • टैक्स आईडी: आपका 9-अंकीय अमेरिकी नियोक्ता पहचान संख्या (ईआईएन)
  • व्यापार और तकनीकी संपर्क जानकारी
  • यूनिफॉर्म रिसोर्स पहचानकर्ता (URI): साझा मेरा डेटा प्लेटफ़ॉर्म प्राधिकरण के लिए OAUth2.0 प्रोटोकॉल का उपयोग करता है। यदि आपके द्वारा चुने गए उपयोगकर्ता प्रकार को डेटा तक पहुंचने के लिए तीन-पैर वाले ओएथ की आवश्यकता होती है, तो आपको अपना पंजीकरण स्वीकार करने से पहले वैध यूआरआई प्रदान करने की आवश्यकता होगी।
    परीक्षण विवरण के बारे में अधिक जानें
  • यूआरआई: आपको एक अधिसूचना यूआरआई प्रदान करने की आवश्यकता होगी ताकि हमारे सिस्टम आपको सूचित कर सकें जब आपका अनुरोधित डेटा तैयार हो।
    डेटा एक्सेस टैब पर अधिसूचना URL के बारे में अधिक जानें
  • सुरक्षित हाइपरटेक्स्ट ट्रांसफर प्रोटोकॉल (HTTPS): आपको किसी मान्यता प्राप्त SSL प्रदाता द्वारा एक वैध TLS1.2 X.509 प्रमाण पत्र प्राप्त करना होगा। स्व-हस्ताक्षरित प्रमाण पत्र स्वीकार नहीं किए जाते हैं और स्व-हस्ताक्षरित एसएसएल प्रमाण पत्र जमा करने से आपके पंजीकरण की मंजूरी में देरी होगी।

साझा मेरा डेटा पंजीकरण प्रक्रिया आपको PG&E को एक कंपनी—या अन्य इकाई—के रूप में पहचानने की अनुमति देती है, जो ग्राहक-अधिकृत डेटा तक पहुँचना चाहती है और हमारे APIs तक पहुँच स्थापित करना चाहती है। मेरे डेटा को साझा करने के लिए चार अलग-अलग उपयोगकर्ता प्रकार हैं। अपनी अनुरोधित पहुंच के लिए उपयुक्त उपयोगकर्ता प्रकार का चयन करें।

 

  • मानक उपयोगकर्ता: एक मानक तृतीय-पक्ष उपयोगकर्ता। पंजीकरण प्रकार: स्टैंडअलोन
  • स्व-पहुंच उपयोगकर्ता: अपने स्वयं के डेटा तक पहुंच का अनुरोध करने वाली इकाई के लिए एक व्यक्ति या प्रतिनिधि।
  • ऊर्जा दक्षता वित्त: एक संगठन है कि पर बिल चुकौती, पर बिल वित्त या आवासीय ऊर्जा दक्षता वित्त कार्यक्रमों से संबंधित सेवाएं प्रदान करता है
  • सामुदायिक विकल्प एग्रीगेटर: PG&E के सेवा क्षेत्र में एक पंजीकृत सामुदायिक विकल्प एग्रीगेटर (CCA)। वर्तमान पंजीकृत CCA की सूची की समीक्षा करने के लिए, सामुदायिक विकल्प एकत्रीकरण पर जाएं

एक बार जब आप सभी आवश्यक तत्वों को इकट्ठा कर लेते हैं, तो मेरा डेटा साझा करें एपीआई पोर्टल पर पंजीकरण करें

डेटा अनुरोध और प्रतिक्रियाएं HTTPS प्रोटोकॉल का उपयोग करके की जाती हैं और PG&E के साथ दो-तरफा प्रमाणपत्र विनिमय के माध्यम से प्रमाणित की जाती हैं। आपको सुरक्षित इनबाउंड और आउटबाउंड एपीआई संचार के लिए सुरक्षा प्रमाणपत्र लागू करने की आवश्यकता होगी।

आपको कम से कम 2048 बिट्स की सार्वजनिक कुंजी लंबाई के साथ अप्राप्य, अनियंत्रित आरएसए प्रमाणपत्र बनाए रखने की भी आवश्यकता होगी। एसएसएल प्रमाणपत्र परीक्षण पूरा करने के लिए एक शर्त है, इसलिए कृपया सुनिश्चित करें कि आपका प्रमाणपत्र तैयार और उपलब्ध है। PG&E वर्तमान में केवल SHA-2 X.509 प्रमाणपत्रों का समर्थन करता है जो प्रतिष्ठित प्रमाणपत्र प्राधिकरणों द्वारा जारी किए जाते हैं (PG&E स्व-हस्ताक्षरित प्रमाणपत्र स्वीकार नहीं करता है), जिसमें AddTrust, Comodo, DigiCert शामिल हैं। भरोसा करें, GlobalSign, जाओ डैडी,USERTrust और VeriSign।

मेरा डेटा साझा करें के उपयोगकर्ता के रूप में, आपको PG&E के मेरे डेटा नियम और शर्तें साझा करने के लिए सहमत होना होगा, साथ ही साथ कैलिफोर्निया सार्वजनिक उपयोगिता आयोग के गोपनीयता नियमों को स्वीकार करना होगा।

मेरे डेटा नियम और शर्तें साझा करें (PDF, 175 KB)
ऊर्जा उपयोग डेटा के लिए गोपनीयता और सुरक्षा संरक्षण डाउनलोड करें (PDF)

 

ईमेल पते की पुष्टि करें

अपना ऑनलाइन पंजीकरण फॉर्म जमा करने पर, हम प्रदान किए गए व्यावसायिक संपर्क ईमेल पते पर एक ईमेल भेजेंगे। यह पुष्टि करने के लिए है कि हमारे पास आपकी सही संपर्क जानकारी है। कृपया प्राप्ति के पांच दिनों के भीतर इस ईमेल में निहित लिंक का चयन करें। यदि आप नहीं करते हैं, तो आपको ऑनलाइन पंजीकरण फॉर्म फिर से सबमिट करना होगा। एक बार जब आप अपने ईमेल पते की पुष्टि कर लेते हैं, तो हम आपके पंजीकरण को संसाधित करेंगे।

परीक्षण का उद्देश्य यह सत्यापित करना है कि आप हमारे सिस्टम से कनेक्ट करने में सक्षम हैं। एक बार जब हम आपकी पंजीकरण जानकारी की समीक्षा कर लेते हैं, तो हम आपको एक ईमेल भेजकर सूचित करेंगे कि आप परीक्षण शुरू कर सकते हैं। समग्र परीक्षण प्रक्रिया के तीन घटक हैं:

  • एपीआई कनेक्टिविटी परीक्षण
  • OAuth परीक्षण
  • आवेदन सूचना संसाधन अनुरोध

निर्देशों का परीक्षण करना जारी रखें

नोट: आपको अधिसूचना प्राप्त करने के 90 दिनों के भीतर परीक्षण पूरा करना होगा।

एक बार परीक्षण पूरा हो जाने के बाद, आपको एक पुष्टिकरण ईमेल प्राप्त होगा जो परीक्षण सफलतापूर्वक पूरा हो गया है। अंतिम समीक्षा के बाद, आपके पंजीकरण की स्थिति अनुमोदित हो जाएगी। इस बिंदु पर, आप डेटा तक पहुंच सकते हैं और, यदि आपका उपयोगकर्ता प्रकार आपको ग्राहक के डेटा तक पहुंचने के लिए अधिकृत करता है, तो ग्राहक आपको प्राधिकरण प्रदान करने में सक्षम होगा। इसके अतिरिक्त, अपने डेटा को जारी करने के लिए अधिकृत ग्राहक यह देख पाएंगे कि आपके संगठन की पहुंच है। यदि आप ग्राहक दृश्यता को अक्षम करना चाहते हैं, तो आप तीसरे पक्ष के पोर्टल के भीतर से ऐसा कर सकते हैं।

प्राधिकरण प्रक्रिया के बारे में जानने के लिए, कृपया ग्राहक प्राधिकरण अवलोकन पृष्ठ पर जाएं।

प्राधिकरण विवरण पर जाएं

पूर्वापेक्षाएं

हमारे API तक पहुंचने से पहले निम्नलिखित पूर्वापेक्षाओं को पूरा किया जाना चाहिए:

 

  1. ग्राहक आपको अपने डेटा तक पहुंचने के लिए अधिकृत करने से पहले आपको मेरे डेटा साझा करें प्लेटफॉर्म का उपयोग करने के लिए पंजीकरण करना होगा। यदि आपने पंजीकरण नहीं किया है, तो कृपया पंजीकरण करें और परीक्षण पूरा करें।
  2. आपको एक ईमेल प्राप्त होना चाहिए था जिसमें आपको सूचित किया गया था कि आपका पंजीकरण स्वीकार कर लिया गया है। यदि आपको यह ईमेल नहीं मिला है, तो कृपया अपने मेरा डेटा साझा करें खाते में लॉग इन करें और अपनी पंजीकरण स्थिति देखने के लिए "पंजीकरण प्रबंधित करें" चुनें।

 

आपके पंजीकरण स्वीकार किए जाने के 90 दिनों के भीतर परीक्षण पूरा करना महत्वपूर्ण है। यदि आप 90 दिनों के भीतर परीक्षण पूरा करने में असमर्थ हैं, तो आपका पंजीकरण समाप्त हो जाएगा और आपको फिर से पंजीकरण करने की आवश्यकता होगी।

 

महत्वपूर्ण: OAuth 2.0 के दौरान ब्राउज़र रीडायरेक्ट के अपवाद के साथ, आपके और PG&E के बीच अन्य सभी अनुरोध आपसी SSL पर हैं और आपको अपने अनुरोध के लिए अपने क्लाइंट SSL प्रमाणपत्र को संलग्न करने की आवश्यकता है। (यह वही प्रमाणपत्र होना चाहिए जो आपने स्वीकार किए जाने से पहले PG&E को भेजा था।)

एपीआई कनेक्टिविटी परीक्षण पूरा करने के लिए निम्नलिखित उपयोगकर्ता प्रकारों की आवश्यकता होती है:

मानक उपयोगकर्ता, स्व-पहुंच, ऊर्जा दक्षता वित्त और सामुदायिक विकल्प एग्रीगेटर

उद्देश्य:

एपीआई कनेक्टिविटी टेस्ट का उद्देश्य यह सुनिश्चित करना है कि आप मेरे डेटा एपीआई को साझा करने में सक्षम हैं।

अनुशंसित: SOAP UI का उपयोग करके क्लाइंट एक्सेस टोकन प्राप्त करना
SOAP UI टूल का उपयोग करके कनेक्टिविटी परीक्षण (ग्राहक एक्सेस टोकन को पुनर्प्राप्त करना) के पहले चरण को करने के लिए नमूना कदम।
SOAP UI टूल (PDF, 520 KB) डाउनलोड करें

चूंकि कार्यान्वयन अलग-अलग हो सकते हैं, इसलिए इसका उद्देश्य केवल यह बताने में मदद के लिए एक संदर्भ के रूप में है कि PG&E के लिए एपीआई कनेक्शन आपसी (2-तरफा) एसएसएल पर कैसे किया जाना चाहिए।

एपीआई कनेक्टिविटी परीक्षण चरण:

आरंभ करने के लिए, अपने खाते में लॉग इन करके PG&E के एसएसएल प्रमाणपत्र को डाउनलोड करें। फिर अपना पुनः प्राप्त करने के लिए "पंजीकरण प्रबंधित करें" चुनें

क्लाइंट एक्सेस टोकन प्राप्त करने के लिए क्लाइंट क्रेडेंशियल्स का उपयोग करें:

  • परीक्षण प्राधिकरण के खिलाफ एक पोस्ट अनुरोध करेंसर्वोच्च उद्देश्य: https://api.pge.com/datacustodian/test/oauth/v2/token
  • पैरामीटर अनुदान_टाइप = क्लाइंट_क्रेडेंशियल जोड़ें।
  • Base64 एन्कोडिंग "क्लाइंट_आईडी:क्लाइंट_सेक्रेट" द्वारा मूल प्राधिकरण हेडर पैरामीटर जोड़ें। हेडर पैरामीटर प्रारूप में होगा, नीचे:
    परम नाम: प्राधिकरण
    परम मूल्य: मूल "base64encoded स्ट्रिंग"
  • प्रतिक्रिया आपको ग्राहक एक्सेस टोकन और इसकी समाप्ति का समय देगी (उदाहरण):
          <प्रतिक्रिया xmlns="https://api.pge.com/datacustodian/oauth/v2/token">
          c03a9825-16f7-400a-b546-9a206ab995db
          3600
          <स्कोप>3
          Bearer
         

सेवा स्थिति API को कॉल करने के लिए क्लाइंट एक्सेस टोकन का उपयोग करें:

  • इस URL के खिलाफ एक GET अनुरोध करें:
    https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ReadServiceStatus
  • क्लाइंट एक्सेस टोकन को नीचे दिए गए प्रारूप में प्राधिकरण हेडर में पास करें:
    हेडर पैराम नाम = प्राधिकरण
    मान = वाहक
  • जवाब इस प्रकार होना चाहिए:
         
          <वर्तमानस्थिति>1
         

नमूना डेटा का अनुरोध करने के लिए क्लाइंट एक्सेस टोकन का उपयोग करें:

  • इस URL के खिलाफ एक GET अनुरोध करें:
    https://api.pge.com/GreenButtonConnect/espi/1_1/resource/DownloadSampleData
  • क्लाइंट एक्सेस टोकन को नीचे दिए गए प्रारूप में प्राधिकरण हेडर में पास करें:
    हेडर पैराम नाम = प्राधिकरण
    मान = वाहक
  • प्रतिक्रिया निम्नानुसार होनी चाहिए:मीटर रीडिंग उदाहरण डाउनलोड करें (XML, 273 KB)

    नमूना डेटा सफलतापूर्वक प्राप्त करने के बाद आपने एपीआई कनेक्टिविटी टेस्ट पूरा कर लिया होगा और आपको "एपीआई कनेक्टिविटी टेस्ट: जैसा कि नीचे दिखाया गया है, पंजीकरण मील का पत्थर तालिका में "मील का पत्थर" पूरा किया।

निम्नलिखित उपयोगकर्ताओं को OAuth परीक्षण पूरा करना आवश्यक है:

मानक उपयोगकर्ता और ऊर्जा दक्षता वित्त

उद्देश्य:

OAuth टेस्ट का उद्देश्य यह सुनिश्चित करना है कि आपका OAuth कार्यान्वयन सही ढंग से काम करता है।

नोट:

इस परीक्षण के प्रयोजनों के लिए, आपके आवेदन को "परीक्षण प्राधिकरण कोड" और "परीक्षण पहुंच टोकन" का अनुरोध करने के लिए निम्नलिखित समापन बिंदुओं की ओर इंगित करने की आवश्यकता होगी:

  • परीक्षण authorizationServerAuthorizationEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/authorize
  • परीक्षण प्राधिकरणसर्वव्यापीटोकनइंटपॉइंट: https://api.pge.com/datacustodian/test/oauth/v2/token

OAuth परीक्षण निर्देश:

  • मेरा डेटा तृतीय-पक्ष पोर्टल साझा करें में लॉग-इन करें
  • OAuth टेस्ट बॉक्स में "Go>" पर क्लिक करें
  • ओऑथ टेस्ट नई विंडों में खुलेगा। ध्यान दें कि यदि यह खुलता नहीं है तो कृपया सुनिश्चित करें कि आपके पास पॉप-अप अवरोधक बंद या अक्षम है।
  • प्रारंभ चुनें: प्रारंभ का चयन करके आप OAuth परीक्षण शुरू करेंगे और सही कार्यान्वयन पुनर्निर्देश के निम्नलिखित अनुक्रम का पालन करेगा।

    ShareMyData OAuth परीक्षण:

    302 रीडायरेक्ट को OAuth URL (तृतीय पक्षपोर्टलयूआरआई) पर जारी करता है जिसे आपने पंजीकरण के दौरान प्रदान किया था, डमी स्कोप मापदंडों के साथ:
    उदाहरण:{ThirdPartyPortalURI}?scope=xxx&ThirdPartyID={dataCustodianId}

    आपका ऐप्लिकेशन:

    वैकल्पिक:आपका आवेदन: आपके आवेदन की वेबसाइट पर लॉगिन करने के लिए संकेत (ग्राहक)

    आपका ऐप्लिकेशन:

    <परीक्षण authorizationServerAuthorizationEndpoint > और प्राधिकरण संहिता के लिए एक GET अनुरोध करता है:

    उदाहरण के लिए, केवल परीक्षण के लिए इस लिंक का उपयोग करें:

    https://api.pge.com/datacustodian/test/oauth/v2/authorize?client_id={क्लाइंटिड मान को RegistrationMilestones}औरredirect_uri={redirect_uri}&scope={scope}और Response_type=code में प्राप्त करें

    उदाहरण के लिए, केवल प्रॉडक्शन के लिए इस लिंक का उपयोग करें:

    GEThttps://sharemydata.pge.com/myAuthorization?client_id={Cilstones}औरredirect_uri={redirect_uri}और Response_type=code&state={optionalState} में क्लाइंटिड मान

    ShareMyData OAuth परीक्षण:

    302 को पर रीडायरेक्ट करता है जो आपने डमी प्राधिकरण कोड के साथ पंजीकरण के दौरान प्रदान किया था:

    उदाहरण: https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219

    आपका आवेदन: प्राप्त प्राधिकरण कोड का उपयोग करके और <परीक्षण प्राधिकरण को कॉल करके एक्सेस टोकन के लिए एक पोस्ट अनुरोध करेंसर्वर टोकनइंटपॉइंट>:

    नोट: एक्सेस टोकन अनुरोध के लिए आपको अपना एसएसएल प्रमाणपत्र संलग्न करना होगा।
    उदाहरण:

    POST: https://api.pge.com/datacustodian/test/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

    Base64 एन्कोडिंग "क्लाइंट_ID:क्लाइंट_सीक्रेट" द्वारा मूल प्राधिकरण हेडर पैरामीटर जोड़ें

    हेडर पैरामीटर निम्नलिखित प्रारूप में होगा:

    • परम नाम: प्राधिकरण
    • परम मूल्य: मूल "base64encoded स्ट्रिंग"

    ShareMyData OAuth परीक्षण: एक परीक्षण एक्सेस टोकन के साथ जवाब देता है:

    एक सफल जवाब इस तरह दिखेगा:
    "एक्सेस_टोकन":" 774ff105-7ad5-40c8-a6ec-f60675dc0e41"
    "expires_in":"3600"
    "refresh_token":998c6654-5b3b-4385-af4f-4e5c46c1bb04
    "स्कोप":"{ScopeString}"
    "संसाधनURI":"{ResourceURI}"
    "प्राधिकरणURI":"{AuthorizationURI}"
    "टोकन_टाइप":"भालू"

इस बिंदु पर, आपने ओथ टेस्ट सफलतापूर्वक पूरा कर लिया होगा और आपको "ओथ टेस्ट: पंजीकरण मील का पत्थर तालिका में "पूरा हुआ" मील का पत्थर जैसा कि नीचे दिखाया गया है:

महत्वपूर्ण: परीक्षण पूरा करने पर, आपको अपने आवेदन को प्राधिकरण कोड और एक्सेस टोकन अनुरोध के लिए प्रोडक्शन एंडपॉइंट्स पर फिर से भेजना होगा ताकि ग्राहक आपको उनके डेटा तक पहुंच के लिए अधिकृत कर सकें। ये समापन बिंदु आपको अनुप्रयोग सूचना संसाधन में प्रदान किए जाएंगे।

आवेदन सूचना संसाधन अनुरोध करने के लिए निम्नलिखित उपयोगकर्ता प्रकारों की आवश्यकता होती है:

मानक उपयोगकर्ता और ऊर्जा दक्षता वित्त

उद्देश्य:

आवेदन सूचना संसाधन अनुरोध का उद्देश्य यह सुनिश्चित करना है कि आप डेटा के साथ प्राधिकरण के लिए उत्पादन यूआरएल प्राप्त करेंसर्वोन्मुख बिंदु और प्राधिकरणसर्वोन्मुख बिंदु

आवेदन सूचना संसाधन अनुरोध चरण:

आवेदन सूचना संसाधन का अनुरोध करने के लिए आपको अपनी पंजीकरण एक्सेस टोकन और आवेदन सूचना आईडी की आवश्यकता होगी।

पंजीकरण एक्सेस टोकन पुनर्प्राप्त करें

अपने पंजीकरण एक्सेस टोकन लॉग को अपने मेरा डेटा साझा करें खाते में पुनः प्राप्त करने और "पंजीकरण प्रबंधित करें" का चयन करने के लिए। आपका <पंजीकरण एक्सेस टोकन> पंजीकरण Milestone तालिका में प्रदर्शित किया जाएगा जब आपका पंजीकरण स्वीकार किया जाता है।

आवेदन सूचना आईडी पुनर्प्राप्त करें

प्राधिकरण xml को कॉल करने के लिए API कनेक्टिविटी परीक्षण के दौरान पुनर्प्राप्त किए गए क्लाइंट एक्सेस टोकन का उपयोग करें:
इस URL के खिलाफ एक GET अनुरोध करें:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization

नीचे दिए गए प्रारूप में प्राधिकरण हेडर में क्लाइंट एक्सेस टोकन पास करें:
हेडर पैराम नाम = प्राधिकरण
मूल्य = वाहक <ग्राहक पहुंच टोकन>
जवाब में आपको एप्लिकेशन सूचना आईडी दिखाई देगी:

आवेदन सूचना संसाधन का अनुरोध करें

GET के साथ आवेदन जानकारी समापन बिंदु को निम्नलिखित URL पर कॉल करें: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ApplicationInformation/{ApplicationInformationID}।
आपके द्वारा पुनर्प्राप्त की गई एप्लिकेशन जानकारी आईडी के साथ {ApplicationInformationID} प्रतिस्थापित करें
मूल प्राधिकरण हेडर पैरामीटर जोड़ें। हेडर पैरामीटर प्रारूप में होगा, नीचे:

परम नाम: प्राधिकरण
परम मूल्य: बियरर <पंजीकरण_एक्सेस_टोकन>
प्रतिक्रिया आपको आवेदन सूचना संसाधन प्रदान करेगी

महत्वपूर्ण: हस्ताक्षर को पूरा करने के निर्देशों के लिए, कृपया समीक्षा करें ग्रीन बटन कार्यान्वयन समझौता ।

अनुप्रयोग सूचना संसाधन में निम्नलिखित जानकारी शामिल होगी:

  • डेटासंरक्षक आईडी
  • डेटासंरक्षकप्रयोग तंत्र
  • तृतीयपक्षप्रयोगविवरण
  • तृतीयपक्षएप्लिकेशन प्रकार
  • थर्डपार्टीफोन
  • प्राधिकरणसर्वरउरी
  • तृतीयपक्षसूचनाउरी
  • authorizationServerAuthorizationEndpoint
  • प्राधिकरणसर्वव्यापीटोकनइंटपॉइंट
  • डेटाग्राहक बुल्क रिक्वेस्टयूआरआई
  • डेटासंरक्षकसंसाधनअंद बिंदु
  • तृतीयपक्षScopeSelectionScreenURI
  • तृतीयपक्षUserPortalScreenURI
  • क्लाइंट_गुप्त
  • क्लाइंट_नाम
  • रीडायरेक्ट_uri
  • क्लाइंट_id
  • सॉफ्टवेयर_id
  • सॉफ्टवेयर_संस्करण
  • क्लाइंट_id_issued_at
  • क्लाइंट_secret_expires_at
  • संपर्क
  • token_endpoint_auth_method
  • दायरा
  • अनुदान_प्रकार
  • अनुदान_प्रकार
  • अनुदान_प्रकार
  • प्रतिक्रिया_प्रकार
  • पंजीकरण_क्लाइंट_uri
  • Registration_access_token
  • डेटाअभिरक्षकस्कोपचयनस्क्रीनयूआरआई

यदि आप एक मानक उपयोगकर्ता या ऊर्जा दक्षता वित्त उपयोगकर्ता हैं, तो यह तीन परीक्षण आवश्यकताओं में से अंतिम है, और, समीक्षा के बाद, आपका पंजीकरण नीचे दिखाए गए अनुसार अनुमोदित किया जाएगा। एक अनुमोदित पंजीकरण ग्राहक अब आपको अपने My Energy खाते के माध्यम से, या आवेदन सूचना संसाधन अनुरोध में आपको प्रदान किए गए <डेटाकस्टोडियनस्कोप्सोलोच्युरी> का उपयोग करके अपनी वेबसाइट के माध्यम से अपने डेटा तक पहुंचने के लिए अधिकृत कर सकते हैं।

महत्वपूर्ण: आपको अपने आवेदन को प्राधिकरण कोड और एक्सेस टोकन अनुरोध के लिए प्रोडक्शन एंडपॉइंट्स पर फिर से इंगित करना होगा ताकि ग्राहक आपको उनके डेटा तक पहुंच के लिए अधिकृत कर सकें। ये समापन बिंदु आपको अनुप्रयोग सूचना संसाधन में प्रदान किए जाते हैं।

इस बारे में अधिक जानने के लिए कि ग्राहक तृतीय पक्षों को अपने डेटा विजिट प्राधिकरण विवरण तक कैसे पहुंच प्रदान करते हैं।

एक बार जब आप ग्राहक प्राधिकरण प्राप्त कर लेते हैं, तो आप अधिकृत डेटा तक पहुंचने के लिए हमारे एपीआई का उपयोग शुरू कर सकते हैं। अधिक जानकारी के लिए, पर जाएंडेटा एक्सेस

पूर्वापेक्षाएं

हमारे API तक पहुंचने से पहले निम्नलिखित पूर्वापेक्षाओं को पूरा किया जाना चाहिए:

 

  1. ग्राहक आपको अपने डेटा तक पहुंचने के लिए अधिकृत कर सकते हैं इससे पहले कि आप मेरा डेटा साझा करें प्लेटफ़ॉर्म का उपयोग करने के लिए पंजीकरण करें। यदि आपने पंजीकरण नहीं किया है, तो कृपया पंजीकरण करें और परीक्षण पूरा करें।
  2. आपको एपीआई कनेक्टिविटी और ओएथ परीक्षण पूरा करना चाहिए था। यदि आपने अभी तक परीक्षण पूरा नहीं किया है, तो कृपया परीक्षण निर्देश देखें।
    नोट: नीचे वर्णित नवीनतम OAuth 2.0 कार्यक्षमता को प्रतिबिंबित करने के लिए भविष्य की रिलीज में OAuth परीक्षण चरणों को अपडेट किया जाएगा (यानी, थर्डपार्टीस्कोपस्पेसेलेक्शनस्क्रीनयूआरआई को हटाना)।
    मुलाकात परीक्षण विवरण

प्राधिकार प्रक्रिया

प्राधिकरण के लिए वर्तमान उत्तर अमेरिकी ऊर्जा मानक बोर्ड (NAESB) ऊर्जा सेवा प्रदाता इंटरफेस (ESPI) मानक का अनुपालन करने के लिए, PG&E ने डेटा की पहुंच को अधिकृत करने के लिए OAuth 2.0 प्राधिकरण ढांचा लागू किया है। नीचे दिया गया आरेख दर्शाता है कि ग्राहक प्राधिकरण कैसे शुरू करते हैं, दायरे के मापदंडों का चयन करते हैं और फिर अपना प्राधिकरण प्रस्तुत करते हैं।

नीचे दी गई जानकारी से परे अतिरिक्त संदर्भ सामग्री:

ESPI OAuth 2.0 अनुक्रम आरेख डाउनलोड करें (PDF, 193 KB)
Github में ग्रीन बटन डेटा SDK देखें

नोट: सामुदायिक विकल्प एग्रीगेटर्स के लिए, डेटा का अनुरोध करने के लिए केवल क्लाइंट_एक्सेस_टोकन की आवश्यकता होती है (2-Legged OAuth के माध्यम से) और निम्नलिखित लागू नहीं होता है।

Diagram of Authorization process initiated at a third-party site

Diagram of authorizations initated at PG&E

प्राधिकरण का अनुरोध करने के लिए कदम

तीसरे पक्ष की साइट पर शुरू किए गए प्राधिकरण

ऊपर दिए गए पहले आरेख में बताए गए अनुसार किसी तृतीय पक्ष साइट से प्राधिकरण शुरू करने के लिए, ग्राहक के ब्राउज़र को आपकी तृतीय पक्ष साइट से PG&E के प्राधिकरण सर्वर प्राधिकरण समापन बिंदु URL पर पुनर्निर्देशित करके एक प्राधिकरण कोड अनुरोध किया जाता है, जैसा कि नीचे दिए गए उपयुक्त अनुरोध मापदंडों के साथ किया गया है। पुनर्निर्देशन पर, ग्राहक को प्रमाणीकरण के लिए एक PG&E लॉग-इन पृष्ठ प्रस्तुत किया जाएगा, जिसके बाद आपके तीसरे पक्ष तक डेटा पहुंच को अधिकृत करने के लिए एक प्राधिकरण पृष्ठ प्रस्तुत किया जाएगा:

authorizationServerAuthorizationEndpoint URI (अनुरोध मापदंडों के साथ)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

  • अनिवार्य अनुरोध पैरामीटर:
    • Client_id = आपके Share My Data Registration Milestones (यानी, Client_id/client_secret युग्म) से क्लाइंट ID।
    • रीडायरेक्ट_uri = रीडायरेक्ट URL जिसे आपने अपने Share My Data Registration (URLs को मेल खाना चाहिए) में निर्दिष्ट किया है।
      नोट: हम अनुशंसा करते हैं कि URL एन्कोडिंग को नीचे दिए गए उदाहरण के अनुसार redirect_uri पर लागू किया जाए।
    • Response_type = कोड (स्थैतिक मान)
  • वैकल्पिक अनुरोध पैरामीटर(पैरामीटर):
    • राज्य = वैकल्पिक अपारदर्शी राज्य पैरामीटर जैसा कि OAuth 2.0 मानक द्वारा अनुमति दी गई है जिसे राज्य को बनाए रखने में मदद के लिए प्राधिकरण कोड के साथ वापस कर दिया जाता है। उदाहरण के लिए, राज्य पैरामीटर का उपयोग किसी तीसरे पक्ष द्वारा विशिष्ट रूप से ग्राहक उत्पत्ति की पहचान करने और क्रॉस-साइट जालसाजी को रोकने के लिए किया जा सकता है।
    • लॉगिन={guest} ऑनलाइन प्राधिकरण प्रवाह के हिस्से के रूप में ग्राहकों को या तो PG&E के मेरी ऊर्जा लॉग-इन या अतिथि एक्सेस टैब पर रीडायरेक्ट करने का विकल्प प्रदान करें।

उदाहरण: ऑथ कोड अनुरोध

प्राप्त करें: https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri=https%3A%2F%2Fthirdparty.com%2FredirectUrl&response_type=code&state=pge12advertisement

नोट: ऊपर दिए गए उदाहरण redirect_uri पैरामीटर में URL एन्कोडिंग लागू है (यानी https://thirdparty.com/redirectUrl का URL एन्कोडिंग)

यदि आप ऊपर के रूप में एक वैध अनुरोध करते हैं, और ग्राहक सफलतापूर्वक प्रमाणित और अधिकृत करता है, तो ग्राहक को बाद में प्राधिकरण कोड, (अधिकृत) गुंजाइश पैरामीटर, और वैकल्पिक राज्य पैरामीटर (यदि प्राधिकरण अनुरोध के हिस्से के रूप में प्रदान किया गया है) के साथ आपके पुनर्निर्देशित किया जाएगा:

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_37_ 38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=दैनिक; इतिहास लंबाई={3P Registered historical length length={SAs} का गिनती={16100_110_Tititit_Ped_Pitit_Pin_Pitit_Pululd_Pin_Pit_Pin_Pin_Pin_Pin_Pin_Pin_Pindddd_संपादितसंपादितसंपादितसंपादित करें))); दैनिक; दैनिक; दैनिक; इतिहास इतिहास में दर्ज किया गया है।

नोट: प्राधिकरण कोड अल्पकालिक है (600 सेकंड में समाप्त होता है), और बाद में एक एक्सेस टोकन / ताज़ा टोकन जोड़ी के लिए आदान-प्रदान किया जाना चाहिए ताकि प्राधिकरण को पूरा किया जा सके और जारी डेटा एक्सेस की अनुमति दी जा सके। एक्सेस टोकन/ताजा टोकन अनुरोध पर विवरण के लिए अगला अनुभाग (अनुभाग 2) देखें।

ऊपर दिए गए (अधिकृत) दायरे पैरामीटर को प्राधिकरण कोड अनुरोध, एक्सेस टोकन अनुरोध, साथ ही प्राधिकरण एपीआई के जवाबों के हिस्से के रूप में लौटा दिया जाता है। यह गुंजाइश पैरामीटर ग्राहक प्राधिकरण के अंतिम दायरे को संप्रेषित करने की अनुमति देता है। विशेष रूप से, स्कोप पैरामीटर में एक "अतिरिक्त स्केलोप" मान शामिल है जो डेटा समूहों के PG&E के समर्थित ग्राहक प्राधिकरण चयनों को मैप करता है (उदाहरण के लिए, "उपयोग", "बिलिंग", "बुनियादी", "खाता", "प्रोग्राम नामांकन")। दायरे पैरामीटर मानों को आगे निम्नलिखित संदर्भ दस्तावेज के अनुसार कैप्चर किया गया है: समर्थित कार्य ब्लॉक स्कोप स्ट्रिंग मैपिंग डाउनलोड करें क्लिक थ्रू 2.0 (पीडीएफ, 222 केबी)

त्रुटि परिदृश्य

तृतीय पक्ष कार्यान्वयन त्रुटियां: यदि क्लाइंट_id या रीडायरेक्ट_uri के आवश्यक अनुरोध पैरामीटर अमान्य हैं या प्राधिकरण कोड का अनुरोध करने पर गायब हैं, तो ग्राहक को मानक HTTP 400 श्रृंखला त्रुटि के साथ एक व्याख्यात्मक संदेश दिखाया जाएगा। इसी तरह, यदि response_type का आवश्यक अनुरोध पैरामीटर गायब या अमान्य है, तो ग्राहक को OAuth 2.0 परिभाषित "अमान्य_request" त्रुटि पैरामीटर के साथ-साथ वैकल्पिक राज्य पैरामीटर के साथ आपके redirect_uri पर वापस भेज दिया जाएगा यदि पहली बार मूल प्राधिकरण कोड अनुरोध के हिस्से के रूप में प्रदान किया गया है।

ग्राहक अधिकृत करने से इनकार करते हैं: किसी तीसरे पक्ष पर किसी ग्राहक को PG&E के साथ अधिकृत करने के लिए पुनर्निर्देशित करने पर, ग्राहक के पास लॉग-इन पृष्ठ और प्राधिकरण पृष्ठ दोनों पर "रद्द" बटन के माध्यम से अस्वीकार करने का विकल्प होता है। ऐसे मामलों में, ग्राहक को आपके रीडायरेक्ट_uri पर वापस भेज दिया जाएगा, जिसमें OAuth 2.0 परिभाषित "एक्सेस_डेनिड" त्रुटि पैरामीटर है जो यह इंगित करने के लिए संलग्न है कि ग्राहक ने अधिकृत करने से इनकार कर दिया है। इसके अलावा, वैकल्पिक राज्य पैरामीटर वापस कर दिया जाएगा यदि पहले मूल प्राधिकरण कोड अनुरोध के हिस्से के रूप में प्रदान किया गया था।

PG&E में शुरू किए गए प्राधिकरण

जब ग्राहक PG&E के ग्राहक वेब पोर्टल, "आपका खाता" पर शुरू करते हैं और फिर मेरे डेटा को साझा करें लैंडिंग पृष्ठ पर नेविगेट करते हैं, तो उन्हें पंजीकृत और दृश्य तृतीय पक्षों का एक ड्रॉपडाउन प्रस्तुत किया जाता है। जैसा कि ऊपर दिए गए दूसरे आरेख में दिखाया गया है, पंजीकृत तीसरे पक्ष की सूची से तीसरे पक्ष का चयन करने वाले ग्राहक पर और "अगला" का चयन करने पर, ग्राहक को तीसरे पक्ष के पंजीकृत "तृतीय पक्ष पोर्टल यूआरआई" पर पुनर्निर्देशित किया जाएगा, जिस बिंदु पर ग्राहक तीसरे पक्ष के साथ आगे बढ़ सकते हैं।

नोट: कुछ तृतीय पक्षों ने इस उपयोग के मामले (यानी, PG&E की साइट पर शुरू किए गए प्राधिकरण) के लिए ग्राहक अनुभव को सुव्यवस्थित करने के तरीके के बारे में पूछताछ की है ताकि ग्राहक को ऐसा लगे कि उन्हें ड्रॉपडाउन से किसी तीसरे पक्ष का चयन करने पर सीधे प्राधिकरण पृष्ठ पर ले जाया जाता है। इस तरह के ग्राहक अनुभव को सुविधाजनक बनाने के लिए, तीसरे पक्ष अपने "तृतीय पक्ष पोर्टल यूआरआई" (साझा मेरा डेटा प्रबंधन पंजीकरण पृष्ठ के माध्यम से) को एक एंडपॉइंट पर सेट करने का विकल्प चुन सकते हैं जो स्वचालित रूप से ग्राहक को प्राधिकरण कोड अनुरोध के हिस्से के रूप में PG&E पर वापस भेज देता है। स्वचालित रूप से PG&E के प्राधिकरण सर्वर प्राधिकरण एंडपॉइंट पर वापस रीडायरेक्ट करने पर, ग्राहक ग्राहक लॉगिन पृष्ठ को छोड़ देगा (जैसा कि वे पहले से लॉग इन हैं) और सीधे प्राधिकरण पृष्ठ पर जाएगा। कुछ तृतीय पक्षों के लिए जिन्होंने जून 2018 के अंत में शेयर मेरा डेटा क्लिक थ्रू 2.0 रिलीज से पहले पंजीकरण किया है, यह केवल तीसरे पक्ष पोर्टल यूआरआई को परिभाषित करके पूरा किया जा सकता है ताकि अब "तृतीय पक्ष स्कोप चयन स्क्रीन" यूआरआई (भविष्य की रिलीज में सेवानिवृत्त होने के लिए क्षेत्र) का उपयोग न किया जा सके।

इसके विपरीत, कुछ तृतीय पक्ष पहले अपने पक्ष में ग्राहकों को संलग्न करना और स्क्रीन करना चाह सकते हैं जब ग्राहकों को प्राधिकरण कोड का अनुरोध करने से पहले उनके "तृतीय पक्ष पोर्टल" यूआरआई पर पुनर्निर्देशित किया जाता है, इसलिए उपरोक्त दृष्टिकोण केवल एक सुझाव है।

एक्सेस टोकन प्राप्त करने के लिए, प्राप्त प्राधिकरण कोड का उपयोग करें और नीचे वर्णित अनुरोध मापदंडों के साथ नीचे दिए गए एंडपॉइंट को कॉल करें। जैसा कि ऊपर बताया गया है, प्राधिकरण कोड अल्पकालिक है, 10 मिनट (600 सेकंड) के बाद समाप्त हो रहा है, इसलिए कृपया सुनिश्चित करें कि प्राधिकरण कोड प्राप्त होने पर एक्सेस टोकन का तुरंत अनुरोध किया जाए।

authorizationServerAuthorizationEndpoint:https://api.pge.com/datacustodian/oauth/v2/token

  • अनिवार्य अनुरोध पैरामीटर:
    • अनुदान_प्रकार = प्राधिकरण_कोड (स्थिर मान)
    • कोड = प्राधिकरण कोड अनुरोध के जवाब में प्राप्त प्राधिकरण कोड
    • रीडायरेक्ट_uri = रीडायरेक्ट URL जिसे आपने अपने Share My Data Registration (URLs को मेल खाना चाहिए) में निर्दिष्ट किया है।
      नोट: प्राधिकरण कोड अनुरोध के साथ, हम अनुशंसा करते हैं कि URL एन्कोडिंग को redirect_uri पर लागू किया जाए।

उदाहरण: एक्सेस टोकन अनुरोध
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Base64 एन्कोडिंग के साथ मूल प्राधिकरण हेडर पैरामीटर जोड़ें "क्लाइंटआईडी: क्लाइंटसीक्रेट" लागू किया गया

नोट: क्लाइंट आईडी:क्लाइंटसीक्रेट मान आपके साझा मेरा डेटा पंजीकरण मील के पत्थर में प्रदान किए गए क्लाइंटआईडी मूल्यों के अनुरूप हैं।
हेडर पैरामीटर निम्नलिखित प्रारूप में होगा:
परम नाम: प्राधिकरण
परम मूल्य: मूल "base64encoded स्ट्रिंग"

एक सफल जवाब इस तरह दिखेगा:

<प्रतिक्रिया xmlns="https://api.pge.com/datacustodian/oauth/v2/token">
<एक्सेस_टोकन>774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
998c6654-5b3b-4385-af4f-4e5c46c1bb04
scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=90_360;Buld=Dult_T_Din__Tinin___Tii_Culii___Culii____Culi_10_Cin_Cin_130__Cin_Cin_Cin_Culd=Culd_130_130_Cin_Cin_1
संसाधनURI:{ResourceURI} जैसे: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
प्राधिकरणURI:{AuthorizationURI} जैसे: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
ग्राहकसंसाधन:{ग्राहकसंसाधन} जैसे:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

नोट: एक एक्सेस टोकन 3600 सेकंड (1 घंटे) में समाप्त हो जाता है, जबकि संबंधित ताज़ा टोकन 1 वर्ष में समाप्त हो जाता है। एक नई एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के विवरण के लिए अगला अनुभाग 3 देखें।

एक्सेस सहेजें और टोकन जोड़ी को ताज़ा करें।
प्रारंभिक ऐतिहासिक डेटा और चल रहे दैनिक डेटा का अनुरोध करने के लिए, डेटा एक्सेस पर जाएं

सर्वोत्तम अभ्यास के अनुसार, एक्सेस टोकन एक अल्पकालिक टोकन (1 घंटे) है, जबकि संबंधित ताज़ा टोकन एक लंबे समय तक जीवित टोकन (1 वर्ष) है जिसका उपयोग आप एक्सेस टोकन समाप्त होने पर एक नई एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के लिए कर सकते हैं। मौजूदा गैर-समाप्त प्राधिकरणों के लिए एक नई एक्सेस टोकन और ताज़ा टोकन जोड़ी प्राप्त करने के लिए, "वर्तमान ताज़ा टोकन" का उपयोग करें और नीचे वर्णित मापदंडों के साथ नीचे एंडपॉइंट को कॉल करें।

authorizationServerAuthorizationEndpoint:https://api.pge.com/datacustodian/oauth/v2/token ?grant_type= refresh_token&refresh_token={current_refresh_token}

उदाहरण: टोकन अनुरोध ताज़ा करें
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Base64 एन्कोडिंग के साथ मूल प्राधिकरण हेडर पैरामीटर जोड़ें "क्लाइंटआईडी: क्लाइंटसीक्रेट" लागू किया गया

नोट: क्लाइंट आईडी:क्लाइंटसीक्रेट मान आपके साझा मेरा डेटा पंजीकरण मील के पत्थर में प्रदान किए गए क्लाइंटआईडी मूल्यों के अनुरूप हैं।
हेडर पैरामीटर निम्नलिखित प्रारूप में होगा:
परम नाम: प्राधिकरण
परम मूल्य: मूल "base64encoded स्ट्रिंग"

एक सफल जवाब इस तरह दिखेगा:
{
"एक्सेस_टोकन": "677e6ef8-1e1a-43f0-85b8-5692fcc72b2",
"टोकन_टाइप": "बियरर",
"expires_in": 3600,
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"स्कोप": "scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_
प्रोग्राम नामांकन;अंतर्स्थ अवधि=900_3600;ब्लॉक अवधि=दैनिक;इतिहास लंबाई={3P पंजीकृत ऐतिहासिक लंबाई};खाता संग्रह = अधिकृत SAs} का{गिनती={बर्बाद ={तृतपक्षीयआईडी};डेटा कस्टोडियनआईडी=पीजीई",
"संसाधनURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
"प्राधिकरणURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

नोट: इसी तरह, क्लाइंट एक्सेस टोकन एक अल्पकालिक टोकन (1 घंटे) है, जबकि इसके संबंधित ताज़ा टोकन एक लंबे समय तक रहने वाला टोकन (1 वर्ष) है जिसका उपयोग आप क्लाइंट एक्सेस टोकन समाप्त होने पर एक नया क्लाइंट एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के लिए कर सकते हैं। एक नई क्लाइंट एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के लिए, ऊपर वर्णित समान चरणों का संदर्भ लें।

प्राधिकरणों को अपडेट करना और प्रबंधित करना

ग्राहक निम्नलिखित करके अपने प्राधिकरणों को अपडेट कर सकेंगे:

  • सेवा आईडी को उनके प्राधिकरणों से हटाना
  • प्राधिकरण अवधि की समाप्ति तिथि को बढ़ाना
  • प्राधिकरण रद्द करना

नोट: ग्राहक केवल अपने ऑनलाइन PG&E खाते में लॉग इन करके और आवश्यक चरणों का पालन करके अपने प्राधिकरणों में परिवर्तन करने में सक्षम होंगे। यदि इनमें से कोई भी कार्रवाई की जाती है, तो हम आपको अधिसूचना यूआरआई के माध्यम से सूचित करेंगे जो आपने पंजीकरण के दौरान प्रदान की थी।

आपके ग्राहक प्राधिकरणों के विवरणों को प्रबंधित करने और देखने के विकल्प हैं:

  • आप अपने ग्राहक_एक्सेस_टोकन का उपयोग करके प्राधिकरण एपीआई (http GET ऑपरेशन) को या तो तीसरे पक्ष के स्तर पर (सभी प्राधिकरणों के विवरण के लिए) https://api.pge.com/GreenButtonConnect /espi/1_1/संसाधन/प्राधिकरण पर या https://api.pge.com/GreenButtonConnect /espi/1_1/संसाधन/प्राधिकरण/{AuthorizationID} पर व्यक्तिगत ग्राहक प्राधिकरण स्तर पर कॉल कर सकते हैं।
  • अलग-अलग, आप तृतीय पक्ष पोर्टल के माध्यम से अपने साझा मेरा डेटा खाते में लॉग इन करके और उस प्राधिकरण के लिए सदस्यता आईडी दर्ज करके मैन्युअल रूप से व्यक्तिगत प्राधिकरण विवरण भी देख सकते हैं जिसे आप खोज रहे हैं।

यदि आप अब किसी प्राधिकरण से जुड़े डेटा तक पहुँच प्राप्त नहीं करना चाहते हैं, तो प्राधिकरण को रद्द करने के वैकल्पिक तरीके हैं:

  • आप https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID} पर अपने क्लाइंट_access_token का उपयोग करके प्राधिकरण निरसन API (http DELETE ऑपरेशन) को कॉल कर सकते हैं।
  • वैकल्पिक रूप से, आप तृतीय पक्ष पोर्टल के माध्यम से अपने साझा मेरा डेटा खाते में लॉग इन करके और उस प्राधिकरण के लिए सदस्यता आईडी दर्ज करके एक प्राधिकरण को मैन्युअल रूप से रद्द कर सकते हैं जिसे आप रद्द करना चाहते हैं।

नोट: ग्राहक को सूचित किया जाएगा कि आपने उनका प्राधिकरण रद्द करने के लिए चुना है। इसके अलावा, एक बार प्राधिकरण रद्द हो जाने के बाद, कार्रवाई को उलट नहीं किया जा सकता है।

आवश्यक शर्तें

इससे पहले कि आप हमारे एपीआई तक पहुंच सकें, निम्नलिखित पूर्वापेक्षाओं को पूरा किया जाना चाहिए:

  1. ग्राहक आपको अपने डेटा तक पहुंचने के लिए अधिकृत करने से पहले आपको मेरे डेटा साझा करें प्लेटफॉर्म का उपयोग करने के लिए पंजीकरण करना होगा।
  2. आपको एपीआई कनेक्टिविटी और ओएथ परीक्षण पूरा करना चाहिए था। यदि आपने अभी तक परीक्षण पूरा नहीं किया है, तो कृपया परीक्षण निर्देश देखें।
    मुलाकात परीक्षण विवरण
  3. यदि आपके उपयोगकर्ता प्रकार को डेटा तक पहुंचने के लिए ग्राहक प्राधिकरण की आवश्यकता है, तो कृपया सुनिश्चित करें कि ग्राहक ने आपको उनके डेटा तक पहुंचने का प्राधिकरण दिया है और आपने एक्सेस टोकन के लिए प्राधिकरण कोड का आदान-प्रदान किया है। यदि आपको अभी तक ग्राहक प्राधिकरण प्राप्त नहीं हुआ है, तो कृपया ग्राहक प्राधिकरण प्रक्रिया की समीक्षा करें।
    प्राधिकरण विवरण पर जाएं

अवलोकन

एपीआई के माध्यम से ग्राहक-अधिकृत डेटा तक पहुंचने के कई तरीके हैं। हमारे नवीनतम एपीआई वर्तमान उत्तर अमेरिकी ऊर्जा मानक बोर्ड (NAESB) ऊर्जा सेवा प्रदाता इंटरफेस (ESPI) मानक का पालन करते हैं और रिस्टफुल इंटरफेस के एक सेट के माध्यम से ऊर्जा उपयोग जानकारी (EUI) तक पहुंच प्रदान करते हैं

समर्थित एपीआई डाउनलोड करें (PDF, 217 KB)

समर्थित APIs दस्तावेज़ PG&E द्वारा Share My Data के कार्यान्वयन के साथ-साथ PG&E विशिष्ट API URL द्वारा समर्थित API को दर्शाता है।

समर्थित फंक्शन ब्लॉक स्कोप स्ट्रिंग मैपिंग डाउनलोड करें (PDF, 222 KB)

समर्थित फंक्शन ब्लॉक स्कोप स्ट्रिंग मैपिंग दस्तावेज़ उस स्कोप स्ट्रिंग पर विवरण कैप्चर करता है जो प्राधिकरण कोड अनुरोध, एक्सेस टोकन अनुरोध, साथ ही प्राधिकरण एपीआई के जवाबों के हिस्से के रूप में लौटाया जाता है जैसा कि प्राधिकरण विवरण अवलोकन में वर्णित है। स्कोप पैरामीटर ग्राहक प्राधिकरण के अंतिम दायरे को संप्रेषित करने की अनुमति देता है। इसके अलावा, यह दस्तावेज़ सूचीबद्ध करता है कि PG&E के Share My Data कार्यान्वयन को ESPI मानक फ़ंक्शन ब्लॉक करता है।

समर्थित संबंधपरक डेटा मॉडल (ESPI का PG&E कार्यान्वयन) (PDF, 482 KB) डाउनलोड करें।

समर्थित डेटा तत्व दस्तावेज़ के साथ संयोजन में, समर्थित रिलेशनल डेटा मॉडल दर्शाता है कि विभिन्न PG&E डेटा तत्वों के बीच संबंध ESPI मानक द्वारा कैसे कैप्चर किया जाता है।

समर्थित डेटा तत्व डाउनलोड करें (PDF, 283 KB)

समर्थित डेटा तत्व दस्तावेज़ ESPI मानक डेटा तत्वों और PG&E के डेटा तत्वों के बीच एक मैपिंग प्रदान करता है।
PG&E का कार्यान्वयन ESPI द्वारा GitHub पर दी गई स्कीमा परिभाषाओं के अनुकूल है। विशेष रूप से, हमारा वर्तमान कार्यान्वयन निम्नलिखित स्कीमा संस्करणों का उपयोग करता है:

XSDs डाउनलोड करें (ZIP, 50 KB)
गिथब पर जाएं

कृपया प्रत्येक एपीआई अनुरोध के लिए हस्ताक्षर कैसे पूरा करें और जीबीसी के एपीआई सैंडबॉक्स के खिलाफ एपीआई कॉल का परीक्षण करने के लिए निम्नलिखित स्रोतों का संदर्भ लें:

ग्रीन बटन दस्तावेज़ लाइब्रेरी पर जाएं
ग्रीन बटन एपीआई पर जाएं

अधिसूचना यूआरआई

पंजीकरण के दौरान, आपको एक अधिसूचना यूआरआई प्रदान करने की आवश्यकता होगी ताकि हमारे सिस्टम आपको आपके प्राधिकरणों (जैसे, ग्राहक रद्दीकरण), अतुल्यकालिक डेटा अनुरोधों (केवल बड़े डेटा सेट के लिए) के मामले में, और जब आपका अनुरोधित डेटा तैयार हो, तो आपको सूचित कर सकें। अलग से, यदि आप पिछले 24 घंटों से पिछले डेटा के लिए सबसे हाल ही में उपलब्ध डेटा के साथ-साथ किसी भी सुधार की दैनिक सदस्यता सूचनाएं प्राप्त करना चाहते हैं, तो मुझे सूचित करें का चयन करें क्योंकि डेटा आपके पंजीकरण में चेकबॉक्स तैयार है। हम नवीनतम दिन के डेटा को प्रीपैक करेंगे और आपको वापस आने और डेटा को पुनर्प्राप्त करने के लिए आपकी अधिसूचना URI पर सूचित करेंगे।

नोट: यदि आप दैनिक आधार पर डेटा पुनर्प्राप्त करने का इरादा नहीं रखते हैं, तो हम आपको सूचित करें की जांच न करने के लिए कहते हैं क्योंकि डेटा तैयार विकल्प है ताकि हमारे द्वारा संसाधित अनावश्यक डेटा की मात्रा को कम किया जा सके। आप अभी भी डेटा के लिए तदर्थ अनुरोध करने में सक्षम होंगे।

  • PG&E पंजीकरण के दौरान प्रदान की गई आपकी अधिसूचना URI को सूचनाएं भेजेगा। अधिसूचनाओं में यूआरआई शामिल हैं जो पहले से ही प्रीपैक किए गए डेटा के अनुरूप हैं जो आपके लिए वापस आने और प्रदान किए गए यूआरएल पर अनुरोध करने के लिए तैयार हैं। डेटा को प्रीपैक किया जाता है और निम्नलिखित दो परिदृश्यों में सूचनाएं भेजी जाती हैं: (1) आपने अपनी पंजीकरण प्रोफ़ाइल में "मुझे डेटा के रूप में सूचित करें तैयार है" का चयन किया है, इस स्थिति में हम पिछले तिथियों के लिए किसी भी सुधार के साथ नवीनतम दैनिक डेटा को पैकेज करेंगे, या (2) आपने पहले एक विज्ञापन किया है।
  • परिदृश्य 1 को "डेटा एक्सेस: डेटा एक्सेस विधियों के आरेखों और परिदृश्य 2 के दैनिक उपलब्धता" अनुभाग को "डेटा एक्सेस: AD HOC अनुरोध (ASYNCHRONOUS)" नीचे दिए गए समान आरेखों का अनुभाग।

डेटा एक्सेस विधियाँ

Data Access: Daily Subscription Model

डेटा अनुरोध उदाहरण

कृपया एक्सेस टोकन, क्लाइंट एक्सेस टोकन और डेटा अनुरोधों में उपयोग किए जाने वाले उनके संबंधित ताज़ा टोकन के टोकन जीवनकाल को ध्यान में रखें। सर्वोत्तम अभ्यास के अनुसार, एक्सेस टोकन एक अल्पकालिक टोकन (1 घंटे) है, जबकि ताज़ा टोकन एक लंबे समय तक रहने वाला टोकन (1 वर्ष) है जिसका उपयोग आप एक्सेस टोकन समाप्त होने पर एक नई एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के लिए कर सकते हैं। इसी तरह, क्लाइंट एक्सेस टोकन एक अल्पकालिक टोकन (1 घंटे) है जबकि इसके संबंधित ताज़ा टोकन एक लंबे समय तक रहने वाला टोकन (1 वर्ष) है जिसका उपयोग आप क्लाइंट एक्सेस टोकन समाप्त होने पर एक नए क्लाइंट एक्सेस टोकन / ताज़ा टोकन जोड़ी प्राप्त करने के लिए कर सकते हैं। एक नई टोकन जोड़ी प्राप्त करने के बारे में अधिक जानकारी के लिए, हमारे प्राधिकरण विवरण टैब में चरण 3 देखें, एक नई पहुंच टोकन का अनुरोध करना। प्राधिकरण विवरण पर जाएं

यदि आप ग्राहक द्वारा "खाता जानकारी" (खाता आईडी, सेवा समझौते आईडी और सेवा प्रारंभ तिथियां) और / या "मूल जानकारी" (यानी, ग्राहक नाम और सेवा पता) प्राप्त करने के लिए अधिकृत हैं, तो आप ESPI परिभाषित रिटेल कस्टमर एपीआई के माध्यम से ऐसी ग्राहक जानकारी का अनुरोध कर सकते हैं, जिसके लिए डेटा ऊपर दिए गए स्कीमा, रिटेल कस्टमर.xd के अनुरूप है।

सिंक्रोनस (मानक और EEF तृतीय पक्ष)

ग्राहक डेटा का अनुरोध करने का एक तरीका ग्राहक डेटा के लिए एकल ग्राहक प्राधिकरण (यानी, खुदरा ग्राहक) के लिए ग्राहक जानकारी का अनुरोध करने के लिए सिंक्रोनस एपीआई का उपयोग करना है:

उदाहरण सिंक्रोनस अनुरोध URL:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID जिसे आपने एक्सेस टोकन प्राप्त करने के लिए OAuth प्राधिकरण अनुक्रम के अंत में प्राप्त किया था। खुदराग्राहकआईडी टोकन प्रतिक्रिया में ग्राहकसंसाधन उरी पथ पैरामीटर का हिस्सा है। (रिटेल कस्टमर आईडी=सब्सक्रिप्शनआईडी)

HTTP हेडर = प्राधिकरण:Bearer {इस प्राधिकरण के लिए टोकन तक पहुंच}

प्रतिक्रिया = आपको उस RetailCustomerID के लिए तुल्यकालिक रूप से डेटा वापस मिल जाएगा। डेटा खुदराग्राहक.xsd के अनुरूप है

नोट: सिंक्रोनस रिटेल ग्राहक एपीआई व्यक्तिगत खुदरा ग्राहक स्तर पर है जो एकल ग्राहक प्राधिकरण से मेल खाता है।

संदर्भ के लिए: नीचे दिया गया पदानुक्रमित आरेख PG&E ग्राहक डेटा मॉडलिंग में ESPI डेटा तत्वों के लिए संबंध पदानुक्रम दिखाता है।

आप ग्राहक डेटा (यानी खुदरा ग्राहक) के लिए अपने सभी ग्राहक प्राधिकरणों के लिए ग्राहक जानकारी का अनुरोध करने के लिए एसिंक्रोनस एपीआई के माध्यम से ग्राहक डेटा का अनुरोध भी कर सकते हैं।

एसिंक्रोनस अनुरोधों का समर्थन करने के लिए, आपके आवेदन को पोस्ट अधिसूचनाओं का समर्थन करने की आवश्यकता होगी जो हम आपको भेजेंगे (पंजीकरण के दौरान आपके द्वारा प्रदान की गई अधिसूचना URL के अनुसार)।

उदाहरण एसिंक्रोनस अनुरोध URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

बल्कआईडी = बल्कआईडी को आवेदन सूचना संसाधन में पंजीकरण परीक्षण के दौरान पुनर्प्राप्त किया गया है। (बुल्कआईडी=क्लाइंटआईडी)

HTTP हेडर = प्राधिकरण:बियरर {पंजीकरण परीक्षण के दौरान ग्राहक एक्सेस टोकन पुनः प्राप्त करें}

प्रतिक्रिया = HTTP स्थिति कोड 202 (यह एक अतुल्यकालिक अनुरोध है जहां डेटा तैयार होने पर सूचना URL पर प्रतिक्रिया पोस्ट की जाएगी)। एक बार डेटा तैयार हो जाने के बाद, हम आपके द्वारा प्रदान किए गए अधिसूचना यूआरआई को यूआरएल के पेलोड के साथ एक अधिसूचना पोस्ट करेंगे, जो आपके आवेदन को प्री-पैकेज प्राप्त करने के लिए वापस आ सकता है। नमूना पोस्ट अधिसूचना नीचे दी गई है

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?सहसंबंधID={correlationID}

 

डेटा प्राप्त करने के लिए क्लाइंट एक्सेस टोकन के साथ उपरोक्त URL पर GET करें।

संदर्भ के लिए: नीचे दिया गया पदानुक्रमित आरेख PG&E ग्राहक डेटा मॉडलिंग में ESPI डेटा तत्वों के लिए संबंध पदानुक्रम दिखाता है।

अंत में आप दैनिक सदस्यता मॉडल का उपयोग करके दैनिक आधार पर नवीनतम ग्राहक जानकारी प्राप्त कर सकते हैं (यानी, पंजीकरण के दौरान "मुझे सूचित करें क्योंकि डेटा तैयार है (दैनिक)" चेकबॉक्स का चयन करके)।

दैनिक सदस्यता मॉडल का समर्थन करने के लिए, आपके आवेदन को पोस्ट अधिसूचनाओं का समर्थन करने की आवश्यकता होगी जो हम आपको भेजेंगे (पंजीकरण के दौरान आपके द्वारा प्रदान की गई अधिसूचना URL के अनुसार)।

एक बार डेटा तैयार हो जाने के बाद, हम आपके द्वारा प्रदान किए गए अधिसूचना यूआरआई को यूआरएल के पेलोड के साथ एक अधिसूचना पोस्ट करेंगे, जो आपके आवेदन को प्री-पैकेज प्राप्त करने के लिए वापस आ सकता है। नमूना पोस्ट अधिसूचना नीचे दी गई है:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?सहसंबंधID={correlationID}

डेटा प्राप्त करने के लिए क्लाइंट एक्सेस टोकन के साथ उपरोक्त URL पर GET करें।

संदर्भ के लिए, नीचे दिया गया पदानुक्रमित आरेख PG&E ग्राहक डेटा मॉडलिंग में ESPI डेटा तत्वों के लिए संबंध पदानुक्रम को दर्शाता है।

यदि आप ग्राहक द्वारा "उपयोग जानकारी" और / या "बिलिंग जानकारी" प्राप्त करने के लिए अधिकृत हैं, तो आप सदस्यता एपीआई के माध्यम से इस डेटा का अनुरोध कर सकते हैं जिसके लिए डेटा ऊपर दिए गए स्कीमा, espiDerived.xsd के अनुरूप है।

समकालिक Ad Hoc अनुरोध (मानक और EEF तृतीय पक्ष)

ऐतिहासिक डेटा (अंतराल उपयोग डेटा और बिल डेटा दोनों के लिए) का अनुरोध करने के लिए, एक दृष्टिकोण ज़ुलु समय में उचित शुरुआत और अंत तिथि अनुरोध मापदंडों को शामिल करने के साथ सिंक्रोनस एपीआई का उपयोग करना है।

उदाहरण सिंक्रोनस अनुरोध URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?प्रकाशित-मिनट={startDate} और प्रकाशित-अधिकतम={endDate}

प्रकाशित मिनट = प्रारंभ तिथि जो डेटा खींचने के लिए इस अनुरोध पर लागू होगी। तारीख yyyy-MM-ddTHH:mm:sZ (IETC RFC 3339 प्रारूप) के ज़ुलू समय में है

प्रकाशित अधिकतम = समाप्ति तिथि जो डेटा खींचने के इस अनुरोध पर लागू होगी। तारीख yyyy-MM-ddTHH:mm:sZ (IETC RFC 3339 प्रारूप) के ज़ुलू समय में है

नोट: एपीआई अनुरोधों के लिए जो प्रकाशित-अधिकतम और प्रकाशित-मिनट-डेट मापदंडों को स्वीकार करते हैं, डिफ़ॉल्ट T-1 (अनुरोध की तिथि -1 दिन) है। उपयोग सारांश अनुरोधों के लिए (जैसे, .../espi/1_1/संसाधन/सदस्यता/{SubscriptionID}/UsagePoint/{UsagePoint}/UsageSumary), हम यह सुनिश्चित करने के लिए 30 दिनों या उससे अधिक की सीमा प्रदान करने का सुझाव देते हैं कि उस अवधि के साथ ओवरलैप होने वाला बिल उपलब्ध है, अन्यथा कोई डेटा वापस नहीं किया जाएगा।

सदस्यता ID = सदस्यता ID जिसे आपने एक्सेस टोकन प्राप्त करने के लिए OAuth प्राधिकरण अनुक्रम के अंत में प्राप्त किया था। सदस्यता आईडी टोकन प्रतिक्रिया में संसाधन यूआरआई पैरामीटर का हिस्सा है। (सदस्यता ID=रिटेलकस्टोमरआईडी)

उपरोक्त सदस्यता आईडी के तहत उपयोग बिंदु = उपयोग बिंदु। आप नीचे दिए गए API URL को कॉल करके और प्राधिकरण हेडर में उस सदस्यता के लिए एक्सेस टोकन की आपूर्ति करके किसी दी गई सदस्यता के लिए सभी उपयोग बिंदु प्राप्त कर सकते हैं: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/उपयोग बिंदु

HTTP हेडर = प्राधिकरण:Bearer {इस सदस्यता के लिए टोकन एक्सेस}

प्रतिक्रिया = आपको अनुरोधित अवधि के लिए उस उपयोग बिंदु के लिए डेटा सिंक्रोनस रूप से वापस मिल जाएगा। इसमें अंतराल उपयोग डेटा () और बिल डेटा () दोनों होंगे।

सिंक्रोनस उपयोग APIs (जैसा कि यूआरएल निर्माण द्वारा इंगित किया गया है जो उपयोग बिंदु आईडी के साथ समाप्त होता है) व्यक्तिगत उपयोग बिंदु स्तर (यानी, सेवा अनुबंध स्तर) पर हैं, इसलिए एक आवेदन किसी दिए गए ग्राहक प्राधिकरण (यानी, सदस्यता) से संबंधित प्रत्येक उपयोग बिंदु आईडी के माध्यम से अनुरोधों को चक्रित करेगा।

सिंक्रोनस अनुरोधों की प्रतिक्रिया अनुरोधित तिथि सीमा से जुड़े अंतराल डेटा (अंडर) दोनों के साथ-साथ किसी भी मासिक उपयोग योग और बिलों को लौटाती है जो अनुरोधित तिथि सीमा (अंडर) के साथ ओवरलैप होती है।

  • इंटरवल रीडिंग में अंतराल (15-मिनट / प्रति घंटा) बिजली का उपयोग और अंतराल (दैनिक) गैस उपयोग डेटा होता है
  • उपयोग सारांश में मासिक उपयोग योग और बिल विवरण शामिल हैं (यदि अधिकृत हो)

प्रतिक्रिया के भीतर आपको हमारी ESPI डेटा तत्व मैपिंग तालिका के अनुरूप डेटा तत्व मिलेंगे

संदर्भ के लिए, नीचे दिया गया पदानुक्रमित आरेख PG&E ग्राहक डेटा मॉडलिंग में ESPI डेटा तत्वों के लिए संबंध पदानुक्रम दर्शाता है।

इन डेटा तत्वों पर कुछ प्रमुख स्पष्टीकरण निम्नलिखित हैं:

  • इंटरवलब्लॉक 1 दिन के लिए है
  • इंटरवल रीडिंग (अंतर्वल ब्लॉक के नीचे) में वास्तविक 15 मिनट / घंटे के बिजली के उपयोग मूल्य और दैनिक गैस उपयोग मूल्य शामिल हैं
  • ऑन-साइट पीढ़ी (जैसे सौर) वाले विद्युत ग्राहकों के लिए, प्रवाहनिर्देश तत्व वितरित (आपूर्ति) और प्राप्त (पीढ़ी) उपयोग डेटा को इंगित करता है। केवल शुद्ध उपयोग (यानी साइट पर कोई पीढ़ी नहीं) पढ़ने के लिए कॉन्फ़िगर किए गए मीटर वाले ग्राहकों के लिए, प्रवाहनिर्देश तत्व इंगित करता है कि उपयोग एक शुद्ध राशि है (प्राप्त शून्य से वितरित अंतर):
    • 1 की प्रवाह दिशा = वितरित (ग्राहक को आपूर्ति की गई ऊर्जा)
    • 19 की प्रवाह दिशा = प्राप्त (शुद्ध पीढ़ी PG&E ग्रिड पर वापस बह रही है)। (ध्यान दें, मान निरपेक्ष हैं)
    • 4 की प्रवाह दिशा = नेट (प्राप्त माइनस - प्राप्त किया गया)
  • दस गुणक और माप की इकाई (uom) की शक्ति पर विशेष ध्यान दें ताकि सही उपयोग पढ़ने को सुनिश्चित किया जा सके

बैच सदस्यता (मानक और EEF तृतीय पक्ष)

आप उपयोग/बिलिंग डेटा (यानी सदस्यता) के लिए एकल ग्राहक प्राधिकरण से संबंधित सभी उपयोग बिंदुओं के लिए एसिंक्रोनस एपीआई के माध्यम से उपयोग डेटा का अनुरोध भी कर सकते हैं।

Ad Hoc Asynchronous अनुरोधों का समर्थन करने के लिए (यानी, एक समय में एक से अधिक उपयोग बिंदु के लिए), आपके आवेदन को पोस्ट अधिसूचनाओं का समर्थन करने की आवश्यकता होगी जो हम आपको भेजेंगे (पंजीकरण के दौरान आपके द्वारा प्रदान की गई अधिसूचना URL के अनुसार)

उदाहरण एसिंक्रोनस अनुरोध URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?प्रकाशित-मिनट={startDate} और प्रकाशित-अधिकतम={endDate}

सदस्यता ID = सदस्यता ID जिसे आपने एक्सेस टोकन प्राप्त करने के लिए OAuth अनुक्रम के अंत में प्राप्त किया था। सदस्यता आईडी टोकन प्रतिक्रिया में संसाधन यूआरआई पैरामीटर का हिस्सा है

प्रकाशित मिनट = प्रारंभ तिथि जो डेटा खींचने के लिए इस अनुरोध पर लागू होगी। (RFC 3339 प्रारूप जूलू समय. yyyy-MM-ddTHH:mm:sZ)

प्रकाशित-अधिकतम = समाप्ति तिथि जो डेटा खींचने के लिए इस अनुरोध पर लागू होगी। (RFC 3339 प्रारूप जूलू समय. yyyy-MM-ddTHH:mm:sZ)

HTTP हेडर = प्राधिकरण:Bearer {इस सदस्यता के लिए टोकन एक्सेस}

प्रतिक्रिया = HTTP स्थिति कोड 202 (यह एक अतुल्यकालिक अनुरोध है जहां डेटा तैयार होने पर सूचना URL पर प्रतिक्रिया पोस्ट की जाएगी)

एक बार डेटा तैयार हो जाने के बाद, हम आपके द्वारा प्रदान किए गए अधिसूचना यूआरआई को यूआरएल के पेलोड के साथ एक अधिसूचना पोस्ट करेंगे जो आपका आवेदन पूर्व-पैकेज प्राप्त करने के लिए वापस आ सकता है। नमूना पोस्ट अधिसूचना नीचे दी गई है:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?सहसंबंधID={correlationID}

डेटा प्राप्त करने के लिए एक्सेस टोकन के साथ उपरोक्त URL पर GET करें। इसमें अनुरोधित अवधि के लिए अंतराल उपयोग डेटा () के साथ-साथ बिल जानकारी () दोनों शामिल होंगे।

बैच सदस्यता (मानक और EEF तृतीय पक्ष)
आप उपयोग/बिलिंग डेटा (यानी सदस्यता) के लिए अपने सभी ग्राहक प्राधिकरणों के लिए बैच बल्क एसिंक्रोनस एपीआई के माध्यम से उपयोग और बिलिंग जानकारी का अनुरोध भी कर सकते हैं।

उदाहरण बैच बल्क अनुरोध URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?प्रकाशित-मिनट={startDate} औरप्रकाशितअधिकतम={endDate}

बल्कआईडी = बल्कआईडी पंजीकरण परीक्षण के दौरान पुनर्प्राप्त किए गए अनुप्रयोग सूचना संसाधन में प्रदान की गई है। (बुल्कआईडी=क्लाइंटआईडी)

प्रकाशित मिनट = प्रारंभ तिथि जो डेटा खींचने के लिए इस अनुरोध पर लागू होगी। (RFC 3339 प्रारूप जूलू समय. yyyy-MM-ddTHH:mm:sZ)

प्रकाशित-अधिकतम = समाप्ति तिथि जो डेटा खींचने के लिए इस अनुरोध पर लागू होगी। (RFC 3339 प्रारूप जूलू समय. yyyy-MM-ddTHH:mm:sZ)

HTTP हेडर = प्राधिकरण:Bearer {ग्राहक एक्सेस टोकन}

प्रतिक्रिया = HTTP स्थिति कोड 202 (यह एक अतुल्यकालिक अनुरोध है जहां डेटा तैयार होने पर सूचना URL पर प्रतिक्रिया पोस्ट की जाएगी)

एक बार डेटा तैयार हो जाने के बाद, हम आपके द्वारा प्रदान किए गए अधिसूचना यूआरआई को यूआरएल के पेलोड के साथ एक अधिसूचना पोस्ट करेंगे जो आपका आवेदन पूर्व-पैकेज प्राप्त करने के लिए वापस आ सकता है। नमूना पोस्ट अधिसूचना नीचे दी गई है:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?सहसंबंधID={correlationID}

डेटा प्राप्त करने के लिए एक्सेस टोकन के साथ उपरोक्त URL पर GET करें। इसमें अनुरोधित अवधि के लिए अंतराल उपयोग डेटा () के साथ-साथ बिल जानकारी () दोनों शामिल होंगे।

अंत में आप दैनिक सदस्यता मॉडल का उपयोग करके दैनिक आधार पर ग्राहक प्राधिकरण अवधि के भीतर पिछली तिथियों के लिए सुधार सहित नवीनतम उपयोग और बिलिंग जानकारी प्राप्त कर सकते हैं (यानी, "मुझे सूचित करें क्योंकि डेटा तैयार है (दैनिक)" पंजीकरण के दौरान चेकबॉक्स का चयन करके)।

दैनिक सदस्यता मॉडल का समर्थन करने के लिए, आपके आवेदन को पोस्ट अधिसूचनाओं का समर्थन करने की आवश्यकता होगी जो हम आपको भेजेंगे (पंजीकरण के दौरान आपके द्वारा प्रदान की गई अधिसूचना URL के अनुसार)।

एक बार डेटा तैयार हो जाने के बाद, हम आपके द्वारा प्रदान किए गए अधिसूचना यूआरआई को यूआरएल के पेलोड के साथ एक अधिसूचना पोस्ट करेंगे जो आपका आवेदन पूर्व-पैकेज प्राप्त करने के लिए वापस आ सकता है। नमूना पोस्ट अधिसूचना नीचे दी गई है:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?सहसंबंधID={correlationID}

डेटा प्राप्त करने के लिए एक्सेस टोकन के साथ उपरोक्त URL पर GET करें। इसमें अनुरोधित अवधि के लिए अंतराल उपयोग डेटा () के साथ-साथ बिल जानकारी () दोनों शामिल होंगे।

डेवलपर संसाधन

सॉफ्टवेयर विकास किट (SDKs)

 

मेरा डेटा साझा करें प्लेटफॉर्म से कनेक्ट करने के लिए सॉफ़्टवेयर के विकास में सहायता करने के लिए, प्रकाशित एपीआई के समापन बिंदुओं पर प्रत्येक कॉल में शामिल विस्तृत तंत्र को देखना उपयोगी है। इसके लिए, PG&E के पास कुछ नमूना SDK हैं जो इसे अतीत में जावास्क्रिप्ट और पायथन दोनों के लिए विकसित किया गया है ताकि साझा मेरा डेटा प्लेटफ़ॉर्म से जुड़ने के प्रमुख पहलुओं को स्पष्ट किया जा सके। ये SDK विकास की प्रक्रिया के माध्यम से आपको मार्गदर्शन करने में मदद करने के लिए कोड नमूने प्रदान करते हैं, लेकिन उत्पादन कोड प्रदान करने का इरादा नहीं है। जावास्क्रिप्ट के लिए, आपको NodeJS इंस्टॉल करना होगा, और प्रासंगिक NodeJS लाइब्रेरी मॉड्यूल को अपडेट करने के लिए "npm इंस्टॉल - सेव ..." सुनिश्चित करना होगा। कोड स्टैंडअलोन नहीं है, लेकिन स्निपेट प्रदान करता है जो बताता है कि तीसरे पक्ष के डेटा क्लाइंट कोड और PG&E की साझा मेरा डेटा एपीआई सेवाओं के बीच बातचीत कैसे होती है।

 

Share My Data प्लेटफॉर्म के कार्यान्वयन में सहायता करने के लिए, PG&E ने जावास्क्रिप्ट और पायथन दोनों में SDK विकसित किए। ये SDK विकास की प्रक्रिया के माध्यम से आपको मार्गदर्शन करने में मदद करने के लिए नमूने प्रदान करते हैं, लेकिन कार्य कोड प्रदान करने का इरादा नहीं है। 

समर्थित APIs (PDF) डाउनलोड करें

समर्थित APIs दस्तावेज़ PG&E द्वारा Share My Data के कार्यान्वयन के साथ-साथ PG&E विशिष्ट API URL द्वारा समर्थित API को दर्शाता है।

 

समर्थित फंक्शन ब्लॉक स्कोप स्ट्रिंग मैपिंग (PDF) डाउनलोड करें

समर्थित फंक्शन ब्लॉक स्कोप स्ट्रिंग मैपिंग दस्तावेज़ उस स्कोप स्ट्रिंग पर विवरण कैप्चर करता है जो प्राधिकरण कोड अनुरोध, एक्सेस टोकन अनुरोध, साथ ही प्राधिकरण एपीआई के जवाबों के हिस्से के रूप में लौटाया जाता है जैसा कि प्राधिकरण विवरण अवलोकन में वर्णित है। स्कोप पैरामीटर ग्राहक प्राधिकरण के अंतिम दायरे को संप्रेषित करने की अनुमति देता है। इसके अलावा, यह दस्तावेज़ सूचीबद्ध करता है कि PG&E के Share My Data कार्यान्वयन को ESPI मानक फ़ंक्शन ब्लॉक करता है।

 

समर्थित संबंधपरक डेटा मॉडल (ESPI का PG&E कार्यान्वयन) (PDF) डाउनलोड करें

समर्थित डेटा तत्व दस्तावेज़ के साथ संयोजन में, समर्थित रिलेशनल डेटा मॉडल दिखाता है कि विभिन्न PG&E डेटा तत्वों के बीच संबंध ESPI मानक द्वारा कैसे कैप्चर किया जाता है।

 

समर्थित डेटा तत्व (PDF) डाउनलोड करें

समर्थित डेटा तत्व दस्तावेज़ ESPI मानक डेटा तत्वों और PG&E के डेटा तत्वों के बीच एक मैपिंग प्रदान करता है।

PG&E का कार्यान्वयन ESPI द्वारा GitHub पर दी गई स्कीमा परिभाषाओं के अनुकूल है। विशेष रूप से, हमारा वर्तमान कार्यान्वयन निम्नलिखित स्कीमा संस्करणों का उपयोग करता है:

XSDs (ZIP) डाउनलोड करें
गिथब पर जाएँ

 

कृपया प्रत्येक एपीआई अनुरोध के लिए हस्ताक्षर कैसे पूरा करें और जीबीसी के एपीआई सैंडबॉक्स के खिलाफ एपीआई कॉल का परीक्षण करने के लिए निम्नलिखित स्रोतों का संदर्भ लें:

ग्रीन बटन दस्तावेज़ लाइब्रेरी पर जाएं
ग्रीन बटन एपीआई पर जाएं

मेरा डेटा साझा करें कार्यान्वयन राष्ट्रीय ऊर्जा सेवा प्रदाता इंटरफेस (ESPI) मानक का पालन करता है। मानक को ग्रीन बटन कनेक्ट माई डेटा पहल (GBCMD) के रूप में भी ब्रांडेड किया गया है, जिसे व्हाइट हाउस के मुख्य प्रौद्योगिकी अधिकारी और राष्ट्रपति नवाचार फैलो द्वारा बढ़ावा दिया गया है। ESPI मानक ग्राहक प्राधिकरण, डेटा विनिमय और आदान-प्रदान किए जाने वाले अधिकृत डेटा के प्रारूप के आसपास कार्यक्षमता प्रदान करने के लिए तकनीकी ढांचे को रेखांकित करता है। ये विवरण ESPI मानक और GBCMD प्रलेखन में शामिल हैं। ग्रीन बटन डेटा पर दस्तावेज़ खोजें

 

Share My Data का उपयोग करने के लिए, तृतीय पक्षों को पहले अपने API कनेक्शन सर्वर पर किसी विश्वसनीय प्रमाणपत्र प्राधिकरण से X.509 डिजिटल प्रमाणपत्र प्राप्त करना और प्रदान करना होगा। तीसरे पक्ष तब तीसरे पक्ष पंजीकरण साइट पर PG&E के साथ पंजीकरण पूरा कर सकते हैं, वहां अपना प्रमाण पत्र भी अपलोड कर सकते हैं, PG&E से क्रेडेंशियल प्राप्त कर सकते हैं जो उन्हें अपने कनेक्शन का परीक्षण करने में सक्षम बनाते हैं, और बाद में हमारे डेटा संरक्षक प्राधिकरण टोकन एंडपॉइंट्स के माध्यम से वाहक टोकन प्राप्त करते हैं। ये वाहक टोकन OAuth2 मानक में वर्णित हैं और तीसरे पक्ष के सॉफ्टवेयर को PG&E के डेटा एक्सेस APIs को सुरक्षित रूप से कनेक्ट करने में सक्षम बनाते हैं। एसडीके स्क्रिप्ट कोड में टोकन प्राप्त करने के तरीके के बारे में बातचीत विवरण प्रदान करता है।

 

ग्राहक पहुंच वाहक टोकन और ग्राहक डेटा पहुंच वाहक टोकन अलग-अलग प्राप्त किए जाते हैं और क्रमशः ग्राहक पहुंच टोकन और पहुंच टोकन कहा जाता है। एक्सेस टोकन व्यक्तिगत PG&E ग्राहक प्राधिकरण के अनुसार प्राप्त किए जाते हैं। एक विशिष्ट वर्कफ़्लो वह है जो OAuth2, प्रति मानक (IETF 6749) प्राधिकरण तंत्र का पालन करता है, जहां एक ग्राहक तीसरे पक्ष की साइट पर शुरू होता है, और वह साइट प्रमाणीकरण के लिए पहले ग्राहक को https://sharemydata.pge.com/#MyAuthorization/ पर पुनर्निर्देशित करती है। वहां, ग्राहक PG&E के साथ प्रमाणित होता है और तीसरे पक्ष ("क्लिक-थ्रू" प्रक्रिया) के लिए उनके डेटा एक्सेस के प्राधिकरण को परिभाषित करने वाले दायरे से गुजरता है। पूरा होने पर, PG&E HTTP 302 प्रतिक्रिया के साथ तीसरे पक्ष को पुनर्निर्देशित करता है, जिसके बाद तीसरा पक्ष वाहक टोकन (एक्सेस टोकन) प्राप्त करने के लिए तैयार है। प्रक्रिया के विस्तृत प्रवाह (पीडीएफ, 463 केबी) की समीक्षा करें।

 

तृतीय पक्ष डेटा क्लाइंट सर्वर आपसी TLS 1.2 कनेक्शन द्वारा PG&E के डेटा एक्सेस API एंडपॉइंट्स से जुड़ता है। वाहक टोकन द्वारा नियंत्रित व्यक्तिगत एपीआई एंडपॉइंट एक्सेस; एक बार अनुरोध स्वीकार और संसाधित होने के बाद, डेटा को एक सिंक्रोनस प्रतिक्रिया या तीसरे पक्ष निर्दिष्ट URL को अधिसूचना के आधार पर एक अतुल्यकालिक प्रतिक्रिया में लौटा दिया जाता है।

 

डेटा उपरोक्त ESPI स्कीमा का अनुसरण करता है। समर्थित तत्वों (पीडीएफ, 283 केबी) के विवरण की समीक्षा करें।

 

PG&E तृतीय पक्ष प्रकार और ग्राहक प्राधिकरण के लिए अनुमत दायरे के अनुसार डेटा जारी करता है।

 

दायरे (XLSX) की परिभाषा की समीक्षा करें, और ग्रीन बटन स्कोप परिभाषाओं का भी पालन करें।

 

मेरा डेटा साझा करें का उपयोग करने के लिए पंजीकरण करने से पहले, हम अत्यधिक अनुशंसा करते हैं कि आप और आपका संगठन निम्नलिखित संसाधनों से खुद को परिचित करें:

 

ग्रीन बटन डेटा SDK पर जाएं
ग्रीन बटन डेटा फ़ाइलों को बनाने, परीक्षण करने और प्रदर्शित करने के लिए उपकरण। PG&E द्वारा विकसित SDKs का पता लगाएं: जावास्क्रिप्ट (ZIP, 1.7 MB)| पायथन (ZIP, 5 KB)

 

ग्रीन बटन एपीआई सैंडबॉक्स पर जाएं
यह एपीआई सैंडबॉक्स डेवलपर्स को ग्रीन बटन प्रारूप में, नए ग्रीन बटन अनुप्रयोगों को विकसित करने के उद्देश्य से ऊर्जा उपयोग जानकारी तक पूर्ण पहुंच की अनुमति देता है।

परिमित सिस्टम संसाधनों के साथ-साथ PG&E को परिचालन जोखिमों को कम करने की अनुमति देने के कारण, हमारे उपयोगकर्ताओं के लिए चल रही प्लेटफ़ॉर्म स्थिरता सुनिश्चित करने के लिए निम्नलिखित एपीआई सीमाएँ मौजूद हैं।

  • सभी विक्रेता ग्राहक आईडी में प्रति सेकंड एक अनुरोध
  • प्रति ग्राहक आईडी प्रति घंटे 2,000 एपीआई कॉल
  • 20,000 एपीआई कॉल प्रति ग्राहक आईडी प्रति 24 घंटे की अवधि। दैनिक सीमा शाम 5 बजे रीसेट होती है। पीटी

कृपया ध्यान रखें कि हमारी स्वीकार्य उपयोग शर्तें परिवर्तन के अधीन हैं। साझा मेरा डेटा टीम लगातार तीसरे पक्ष के अनुरोधों का समर्थन करने की हमारी क्षमता का मूल्यांकन कर रही है क्योंकि प्लेटफ़ॉर्म बढ़ता है और अधिक उपयोगकर्ता सिस्टम के साथ एकीकृत होते हैं। हालांकि, हम कार्यान्वयन से पहले इस तरह के किसी भी बदलाव के बारे में सूचित करना सुनिश्चित करेंगे।

कृपया मेरे डेटा को साझा करने के लिए हमारे द्वारा किए गए सुधारों और परिवर्तनों के लिए निम्नलिखित रिलीज़ नोट्स देखें। यदि आपको मेरे डेटा को साझा करें के साथ कोई समस्या आती है या सेवा में सुधार के लिए कोई सुझाव है, तो हमसे संपर्क करेंShareMyData@pge.com.

20 जून, 2024

 

तृतीय-पक्ष सेवा प्रदाताओं के साथ ग्राहक-प्राधिकृत डेटा साझा करने के लिए PG&E के साझा मेरा डेटा प्लेटफ़ॉर्म (SMD) ने हमारे मीटर आईडी संवर्धन का चरण 2 जारी किया, जिससे इलेक्ट्रिक अंतराल मीटर डेटा से जुड़ी व्यक्तिगत मीटर आईडी की पहचान की अनुमति मिली।  

यह वृद्धि उपयोगकर्ता परिदृश्यों के लिए विशेष रूप से उपयोगी है जहां कई मीटर एक सेवा समझौते से जुड़े होते हैं।

 

चरण 1:  मार्च 2023 को जारी किया गया - प्रभावित APIs को टैग के तहत लौटाई गई प्रतिक्रिया में मान के साथ मान जोड़ना शुरू करने के लिए संशोधित किया। क्रम संख्या मान और utcNumber मान के बीच एक-से-एक पत्राचार है।

यह जानकारी इन एपीआई का उपयोग करने वाले विक्रेताओं को चरण 2 वृद्धि जारी होने से पहले अपने ग्राहक आधार के लिए दिए गए मीटर से जुड़े सीरियलनंबर मूल्य के साथ ककम्बर के साथ रिकॉर्ड का एक स्टोर बनाने की अनुमति देती है।

 

चरण 2: 20 जून, 2024 को जारी किया गया - मीटर वर्णनात्मक मानों के वर्तमान एन्कोड64 प्रारूप से मीटर रीडिंग ID मानों को utcNumber के साथ प्रतिस्थापित करता है। एक बार जब ये परिवर्तन पूरी तरह से लागू हो जाते हैं, तो मेरे डेटा उपयोगकर्ताओं को विशिष्ट मीटर अंतराल उपयोग से जोड़ने की बेहतर क्षमता होगी, ऐसे मामलों में जहां एक ही वस्तु के कई मीटर आधार पर एक सेवा समझौते से जुड़े होते हैं, विशिष्ट मीटर आईडी जो उपयोग उत्पन्न करता है। 

 

निम्नलिखित एपीआई चरण 2 परिवर्तनों से प्रभावित होते हैं

प्रभावित API:

.../एएसपीई/1_1/संसाधन/सदस्यता/{सदस्यताआईडी}/उपयोग बिंदु/{उपयोग बिंदुआईडी}/मीटर रीडिंग

.../espi/1_1/संसाधन/सदस्यता/{SubscriptionID}/उपयोग बिंदु/{UsagePointID}/मीटर रीडिंग/{MeterReadingID}

.../एस्पी/1_1/संसाधन/सदस्यता/{सदस्यताID}/उपयोग बिंदु/{उपयोग बिंदुID}/मीटर रीडिंग/{मीटर रीडिंगID}/इंटरवलब्लॉक

.../एस्पी/1_1/संसाधन/सदस्यता/{सदस्यताID}/उपयोग बिंदु/{उपयोग बिंदुID}/मीटर रीडिंग/{मीटर रीडिंगID}/इंटरवलब्लॉक/{इंटरवलब्लॉकआईडी}

अंतराल के साथ अन्य सभी एपीआई अपरिवर्तित हैं और दोनों प्रवाह दिशाओं में और सेवा समझौते के तहत सभी मीटर के साथ मीटर अंतराल के एसयूएम का प्रतिनिधित्व करते हैं।

रिलीज़ से पहले मीटररीडिंगआईडी फ़ील्ड बेस Base64 एन्कोड किया गया था और मूल्य लौटाया गया निम्नानुसार दिखाता है:

मीटररीडिंग ID= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

Base64 प्रारूप से इस प्रकार डिकोड किया गया:  NzI6bnVsbDozNjAwOjE =:1:1

यह रीडिंग टाइपआईडी: rownum:count, और रीडिंग टाइपआईडी मान Base64 से फिर से डीकोड किया गया है:

72:null:3600:1 जहां मान uom हैं:चरण:अंतर्वल लंबाई:प्रवाहदिर

UOM = 72, चरण = शून्य, अंतराललंबाई = 3600, और प्रवाहदिर = 1 (वितरित)

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

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

Base64 से एक बार डिकोड किया गया:  NzI6bnVsbDozNjAwOjE =:1:1:4411310546, 

इससे पता चलता है कि meter_UUID 4411310546 है, और यह मान टैग के तहत RetailCustomer API में उपलब्ध मान से मेल खाना चाहिए।

"NzI6bnVsbDozNjAwjE =: 1: 1:" का मूल्य रीडिंग टाइपिड: rownum:count, यानी पंक्ति संख्या 1 है और गिनती PG&E के आंतरिक डेटाबेस रिकॉर्ड से संबंधित 1 है। रीडिंगटाइपआईडी को फिर से डीकोड किया गया है:

72:null:3600:1, जहां मूल्य uom हैं:चरण:अंतर्वल लंबाई:प्रवाहदिर

UOM = 72, चरण = शून्य, अंतराललंबाई = 3600, और प्रवाहदिर = 1 (वितरित)

 

यह परिवर्तन उपयोगकर्ताओं को अंतराल पढ़ने में भौतिक मीटर और ब्याज की प्रवाह दिशा निर्दिष्ट करने की अनुमति देता है। ध्यान दें कि सभी XML फ़ाइलें अब नए मीटररीडिंग आईडी मान ले जाएंगी और एन्कोडिंग के नए चरण 2 फॉर्म को लागू करेंगी. मेरा डेटा साझा करें उन सभी विक्रेताओं को सलाह देता है जो MeterReadingID का उपयोग करके किसी भी API कॉल का उपयोग करते हैं, नई MeterReadingID प्राप्त करने के लिए निम्नलिखित API कॉल करें: .../espi/1_1/संसाधन/सदस्यता/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

20 मार्च, 2023

 

नया क्या है:

 

  1. सिंक्रोनस और एसिंक्रोनस एपीआई कॉल दोनों के लिए एक नया एपीआई HTTP प्रतिक्रिया कोड (204) जारी करना यह इंगित करने के लिए कि अनुरोधित सीमा के लिए कोई डेटा उपलब्ध नहीं है।
  2. अनुरोधित फ़ाइल तैयार होने पर एक सहसंबंध आईडी के साथ इस मान को वापस करके विशिष्ट एसिंक्रोनस एपीआई कॉल के लिए PG&E की प्रतिक्रिया को जोड़ने की क्षमता का समर्थन करने वाले एक्स-ट्रांजैक्शन हेडर लेबल का समर्थन करना।
  3. एकल सेवा अनुबंध परिदृश्यों के लिए कई मीटरों के लिए विद्युत अंतराल डेटा प्रदान करके उपयोग बिंदु/मीटर रीडिंग आईडी एपीआई के लिए अतिरिक्त डेटा ग्रैन्युलैरिटी में सुधार किया गया।
  4. उस अंतराल के लिए उपयोग किए गए अनुमान के प्रकार का वर्णन करने के लिए अनुमानित अंतराल डेटा के लिए गुणवत्ता संकेतक मूल्यों को पढ़ने के लिए अतिरिक्त स्पष्टता प्रदान की गई। आकलन तर्क को इंगित करने वाले नए मान नीचे दिए गए हैं:

  5. RQI मान और विवरण

    0 - मान्य: डेटा जो सभी आवश्यक सत्यापन जांच से गुजर चुका है और या तो उन सभी को पारित कर दिया गया है या सत्यापित किया गया है

    7 - मैन्युअल रूप से संपादित: एक मानव द्वारा प्रतिस्थापित या अनुमोदित

    8 - संदर्भ दिवस का उपयोग करके अनुमानित: डेटा मान को उसी प्रकार के माप का उपयोग करके ऐतिहासिक डेटा के विश्लेषण के आधार पर मशीन गणना मूल्य द्वारा प्रतिस्थापित किया गया था

    9 - रैखिक प्रक्षेप का उपयोग करके अनुमानित: डेटा मान की गणना इसके पहले और बाद में रीडिंग के आधार पर रैखिक प्रक्षेप का उपयोग करके की गई थी

    10 - संदिग्ध: डेटा जो एक या अधिक चेक में विफल रहा है

    11 - व्युत्पन्न: डेटा जिसकी गणना की गई है (लॉजिक या गणितीय संचालन का उपयोग करके), जरूरी नहीं कि सीधे मापा जाए

    अनुमानित (पूर्वानुमान): डेटा जिसे भविष्य के रीडिंग के प्रक्षेपण या पूर्वानुमान के रूप में गणना की गई है

    13 - मिश्रित: इंगित करता है कि इस पढ़ने की गुणवत्ता में मिश्रित विशेषताएं हैं

    रॉ: डेटा जो सत्यापन, संपादन और अनुमान प्रक्रिया से नहीं गुजरा है। नोट MV90 मीटर RQI संकेतक अंतिम RQ स्थिति के रूप में 14 में रहेगा

    मौसम के लिए सामान्यीकृत: मूल्यों को मौसम के लिए खाते में समायोजित किया गया है, विभिन्न जलवायु में उपयोग की तुलना करने के लिए

    16 - अन्य: निर्दिष्ट करता है कि एक विशेषता उन परिभाषित के अलावा अन्य लागू होती है

    17 - मान्य: वह डेटा जिसे मान्य किया गया है और संभवतः अनुमोदित प्रक्रियाओं के अनुसार संपादित और/या अनुमानित किया गया है

    18 - सत्यापित: डेटा जो आवश्यक सत्यापन जांचों में से कम से कम एक में विफल रहा लेकिन वास्तविक उपयोग का प्रतिनिधित्व करने के लिए निर्धारित किया गया था

    19 - राजस्व गुणवत्ता: बिलिंग उद्देश्यों के लिए वैध और स्वीकार्य [ESPI मानक के लिए संभावित विस्तार, और मूल ESPI का हिस्सा नहीं]

     

  6. विक्रेता एपीआई उपयोग मैट्रिक्स को साझा मेरा डेटा तृतीय पक्ष विक्रेता पोर्टल में जारी करना।

15 नवंबर, 2018

 

क्या नया है:

 

  1. ग्राहक वर्ग संकेतक जोड़ा गया है। अधिकृत किए गए प्रत्येक SAID की पहचान RES, AGR, COM/IND या अन्य के रूप में की जाएगी।
  2. बिलिंग और उपयोग एपीआई को अपडेट-अधिकतम और अपडेट-मिनट क्वेरी मापदंडों (प्रकाशित-मिनट और प्रकाशित-अधिकतम के विकल्प के रूप में) को स्वीकार करने के लिए अपडेट किया जाएगा। लौटाया गया डेटा सभी परिवर्तन होंगे जो अपडेट-अधिकतम और अपडेट-माइन मापदंडों के भीतर हुए हैं।
  3. ऑनलाइन प्राधिकरण प्रवाह के लिए तीसरे पक्ष की क्लाइंट आईडी के साथ तीसरे पक्ष की 5-अंकीय बल्क आईडी के उपयोग को बदलना।
  4. ऑनलाइन प्राधिकरण प्रवाह के हिस्से के रूप में ग्राहकों को PG&E के खाता लॉगिन या अतिथि एक्सेस टैब पर रीडायरेक्ट करने का विकल्प प्रदान करना।
  5. PG&E के मेरे डेटा को साझा करें ग्राहक डैशबोर्ड में सुधार करना ताकि ग्राहकों के लिए तृतीय पक्षों के साथ अपने सभी मौजूदा डेटा साझाकरण प्राधिकरणों को देखना आसान हो सके।

27 सितंबर, 2018

 

क्या नया है:

 

PG&E ने PG&E की विस्तारित डेटा सेट (EDS) परियोजना के हिस्से के रूप में नियम 24 डेटा सेट में नए डेटा तत्वों को जोड़ा, और नियम 25 डेटा सेट में इसी नए डेटा तत्वों को पेश किया गया। PG&E के विस्तारित नियम 25 डेटा सेट वाले विशिष्ट डेटा तत्वों को पदनाम EDS के साथ नीचे निर्धारित किया गया है:

 

नियम 25 डेटा तत्व

 

नोट्स
खाता तत्व
खाते का नाम
खाता पता
खाता आईडी
ईडीएस: आउटेज ब्लॉक
सेवा के तत्व
PG&E UUID
सेवा आईडी
सेवा की स्थिति में भविष्य के परिवर्तन
SA स्थिति
सेवा आरंभ तिथि
सेवा पता
वर्तमान सेवा टैरिफ
ऐतिहासिक बिल सेवा टैरिफ
टैरिफ विकल्प (मेडिकल बेसलाइन, CARE, FERA, TBS, CCA_TBS, सौर विकल्प
वर्तमान सेवा वोल्टेज और कमोडिटी ऐतिहासिक बिल की गई सेवा वोल्टेज
सेवा मीटर संख्या
सेवा मीटरों की संख्या
मीटर प्रकार
वर्तमान मीटर रीड चक्र
ऐतिहासिक बिल्ड मीटर रीड चक्र
वर्तमान स्टैंडबाय दर विकल्प यदि ऑन-साइट जनरेशन संकेतक
ऐतिहासिक बिल्ड स्टैंडबाय दर विकल्प
ईडीएस: ग्राहक वर्ग संकेतक
ऐतिहासिक बिलिंग तत्व
बिल शुरू होने की तारीख
बिल समाप्त होने की तारीख
बिल कुल प्रभार($)
बिल कुल kWh
ईडीएस: सेवा प्रदाता का नाम
ऐतिहासिक बिल टियर ब्रेकडाउन (यदि कोई हो)
ईडीएस: लाइन आइटम बिल अवधि
ईडीएस: नाम (बेसलाइन 1% -30% से अधिक)
ईडीएस: वॉल्यूम (1234.2)
ईडीएस: दर ($ 0.032 / kWh)
ईडीएस: लागत ($ 100.23)
ऐतिहासिक बिल TOU kWh टूटना (ABS-TX बिल को छोड़कर)
ईडीएस: लाइन आइटम बिल अवधि (टाऊ ब्रेकडाउन के लिए)
EDS: नाम (TOU चार्ज का)
ईडीएस: वॉल्यूम (1234.2)
ईडीएस: दर ($ 0.032 / kWh)
ईडीएस: लागत ($ 100.23)
ऐतिहासिक बिल की मांग टूटी
ईडीएस: लाइन आइटम बिल अवधि (मांग टूटने के लिए)
ईडीएस: नाम
ईडीएस: वॉल्यूम (1234.2)
ईडीएस: दर ($ 0.032 / kWh)
ईडीएस: लागत ($ 100.23)
ऐतिहासिक बिल लाइन आइटम
ईडीएस: लाइन आइटम बिल अवधि
ईडीएस: चार्ज नाम (डीडब्ल्यूआर बॉन्ड चार्ज)
ईडीएस: वॉल्यूम (1234.2)
ईडीएस: यूनिट (kWh)
ईडीएस: दर ($ 0.032 / kWh)
ईडीएस: लागत ($ 100.23)
ऐतिहासिक उपयोग अंतराल
अंतराल उपयोग प्रारंभ
डिफ़ॉल्ट अंतराल अवधि (सेकंड में)
अंतराल उपयोग वॉल्यूम (1234.2)
यूनिट (kWh/थर्म्स)
उपयोगिता मांग प्रतिक्रिया कार्यक्रम
(DR) प्रोग्राम का नाम
वित्तीय दायित्व के बिना सबसे जल्दी समाप्ति तिथि
वित्तीय दायित्व की परवाह किए बिना सबसे पहले समाप्ति तिथि
DR प्रोग्राम स्थिति
DR कार्यक्रम नामांकन तिथि
DR कार्यक्रम के नामांकन-मुक्त करने की तारीख
डेटा तत्व
कमोडिटी
स्थानीय समय पैरामीटर (DST विवरण)
डिफ़ॉल्ट डेटा गुणवत्ता
ऊर्जा दिशा
दस गुणक की शक्ति (अंतराल उपयोग मूल्यों के लिए)
दस गुणक की शक्ति (बिल की गई मांग के लिए)
दस गुणक की शक्ति (बिल किए गए कुल उपयोग के लिए)
अंतराल की लंबाई (उपयोग पढ़ने का)
बिल की कुल लागत की मुद्रा
इलेक्ट्रिक इंटरवल TOU संकेतक

28 जून, 2018

 

क्लिक-थ्रू परियोजना के हिस्से के रूप में और मेरे डेटा प्लेटफ़ॉर्म को साझा करें में निरंतर सुधार के रूप में, PG&E ने 28 जून, 2018 को चरण 2 के माध्यम से क्लिक-थ्रू लॉन्च किया।

 

क्या नया है:

 

तृतीय पक्षों को प्रभावित करने वाले सबसे महत्वपूर्ण परिवर्तन OAuth 2.0 प्रोटोकॉल के अनुरूप परिवर्तन हैं (PG&E ने पुनर्निर्देशों की प्रारंभिक श्रृंखला को समाप्त कर दिया है)। नीचे विवरण प्राप्त करें।

 

महत्वपूर्ण: तृतीय पक्ष अपने मौजूदा OAuth कार्यान्वयन में बदलाव करने के लिए आवश्यक हैं। PG&E के चरण 2 के माध्यम से परिवर्तन पीछे की ओर संगत नहीं हैं, इसलिए तृतीय पक्षों के लिए PG&E के कार्यान्वयन के साथ समवर्ती परिवर्तनों को लागू करना आवश्यक है। कार्यान्वयन के बिना, वर्तमान ग्राहक प्राधिकरण प्रक्रिया 29 जून, 2018 की कट-ऑफ तारीख पर काम करना बंद कर देगी। हालांकि, मौजूदा प्राधिकरण अप्रभावित हैं।

  1. OAuth 2.0 प्रोटोकॉल के अनुरूप, PG&E ने प्राधिकरण के लिए पुनर्निर्देशित चरणों की संख्या कम कर दी है। ग्राहकों के लिए लॉग इन करने और प्राधिकरण प्रस्तुत करने के लिए PG&E को प्रारंभिक पुनर्निर्देश को प्राधिकरण कोड अनुरोध के साथ जोड़ा गया है:
    • जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है, तीसरे पक्ष के प्राधिकरण कोड अनुरोधों में अब ग्राहक के ब्राउज़र का PG&E के नए authorizationServerAuthorizationEndpoint अनुरोध मापदंडों के साथ:
      https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri= को प्राप्त करें{redirect_uri}&response_type=code&state={optionalState}
    • निम्नलिखित समापन बिंदु सेवानिवृत्त हो गया है: https://api.pge.com/datacustodian/oauth/v2/authorize...
  2. अनुपलब्ध या अमान्य स्कोप मापदंडों के साथ प्राधिकरण कोड अनुरोधों के लिए नए त्रुटि हैंडलिंग संदेश निम्नानुसार हैं:
    • यदि आवश्यक क्लाइंट_id या redirect_uri पैरामीटर गायब या अमान्य हैं, तो व्याख्यात्मक संदेश के साथ एक (http 400) त्रुटि ग्राहक को दिखाई जाती है
    • यदि आवश्यक प्रतिक्रिया_प्रकार पैरामीटर गायब या अमान्य है, तो ग्राहक को तीसरे पक्ष के पुनर्निर्देशित_uri को "अमान्य_request" त्रुटि पैरामीटर (Redirect_uri को संलग्न) के साथ पुनर्निर्देशित किया जाएगा
  3. मौजूदा ऑनलाइन प्राधिकरण वाले ग्राहकों के लिए, एक नए प्राधिकरण के हिस्से के रूप में एक नए एक्सेस_token/refresh_token जोड़ी का अनुरोध करने की क्षमता जो मौजूदा एक को प्रतिस्थापित करती है (यानी, उसी तीसरे पक्ष और ग्राहक संयोजन का ऑनलाइन प्राधिकरण)। यह कार्यक्षमता तीसरे पक्ष के परिदृश्यों को संबोधित करती है जो एक एक्सेस_token / refresh_token जोड़ी खो देते हैं या अन्यथा प्रति ग्राहक अनुमोदन मूल प्राधिकरण के दायरे को बदलने की आवश्यकता होती है।
    • पुन: प्राधिकरण अनुरोधों के लिए, ग्राहक "प्रबंधन प्राधिकरण" पृष्ठ के बजाय नए प्राधिकरण पृष्ठ को देखता है जब प्राधिकरण के लिए PG&E को किसी तीसरे पक्ष द्वारा पुनर्निर्देशित किया जाता है
    • ग्राहक प्राधिकरण पर, तीसरे पक्ष को उनके पंजीकृत अधिसूचना URL पर एक अधिसूचना प्राप्त होती है कि पुरानी सदस्यता आईडी रद्द कर दी गई है (अधिसूचना में पुरानी सदस्यता आईडी के लिए प्राधिकरण एपीआई यूआरएल एंडपॉइंट शामिल है)
  4. ग्राहक के प्रमाणीकरण पृष्ठ या प्राधिकरण पृष्ठ पर "रद्द" बटन के माध्यम से बाहर निकलने की क्षमता को तीसरे पक्ष के पुनर्निर्देशित_uri पर "एक्सेस_डेनिड" त्रुटि पैरामीटर (Redirect_uri पर संलग्न) के साथ पुनर्निर्देशित किया जाता है
  5. तीसरे पक्ष के लिए जो "दृश्यता" सेटिंग के साथ पंजीकरण करते हैं और इसलिए पंजीकृत तीसरे पक्ष की सूची में शामिल होते हैं, ग्राहक देखेंगे कि वे अपने PG&E ऑनलाइन खाते में कब जाते हैं और मेरे डेटा को साझा करें लैंडिंग पृष्ठ पर नेविगेट करते हैं:
    • उन ग्राहकों के लिए जो अपने PG&E ऑनलाइन खाते में लॉग इन करते हैं और मेरे डेटा को साझा करें लैंडिंग पृष्ठ पर नेविगेट करते हैं और फिर पंजीकृत तीसरे पक्ष की सूची से तीसरे पक्ष का चयन करने पर तीसरे पक्ष के पंजीकृत "तृतीय पक्ष पोर्टल URI" पर पुनर्निर्देशित होते हैं। उस बिंदु पर, ग्राहक तीसरे पक्ष द्वारा शुरू की गई OAuth प्रक्रिया के साथ आगे बढ़ सकते हैं। इस मार्ग से गुजरते समय, ग्राहकों को अब तीसरे पक्ष की ड्रॉपडाउन सूची से तीसरे पक्ष का चयन करने पर प्राधिकरण पृष्ठ नहीं दिखाया जाएगा, बल्कि इसके बजाय तीसरे पक्ष के पंजीकृत "तृतीय पक्ष पोर्टल यूआरआई" पर पुनर्निर्देशित किया जाएगा जहां वे तीसरे पक्ष द्वारा शुरू की गई ओऑथ प्रक्रिया शुरू कर सकते हैं।
    • नोट: कुछ तृतीय पक्षों ने इस उपयोग के मामले (यानी, PG&E की साइट पर शुरू किए गए प्राधिकरण) के लिए ग्राहक अनुभव को कारगर बनाने के तरीके के बारे में पूछताछ की है ताकि ग्राहक को ऐसा लगे कि ड्रॉपडाउन से किसी तीसरे पक्ष का चयन करने पर उन्हें सीधे प्राधिकरण पृष्ठ पर ले जाया जाता है। इस तरह के ग्राहक अनुभव को सुविधाजनक बनाने के लिए, तीसरे पक्ष अपने "तृतीय पक्ष पोर्टल यूआरआई" (साझा मेरा डेटा प्रबंधन पंजीकरण पृष्ठ के माध्यम से) को एक एंडपॉइंट पर सेट करने का विकल्प चुन सकते हैं जो स्वचालित रूप से ग्राहक को प्राधिकरण कोड अनुरोध के हिस्से के रूप में PG&E को वापस भेज देता है। स्वचालित रूप से PG&E के authorizationServerAuthorizationEndpoint, ग्राहक ग्राहक लॉगिन पृष्ठ को छोड़ देगा (जैसा कि वे पहले से लॉग इन हैं) और सीधे प्राधिकरण पृष्ठ पर जाएगा। कुछ तृतीय पक्षों के लिए जिन्होंने मेरा डेटा साझा करें क्लिक थ्रू 2.0 रिलीज़ से पहले पंजीकरण किया है, यह केवल तृतीय पक्ष पोर्टल यूआरआई को परिभाषित करके पूरा किया जा सकता है ताकि अब "तृतीय पक्ष स्कोप चयन स्क्रीन"यूआरआई (भविष्य की रिलीज़ में सेवानिवृत्त होने के लिए पुराना एसएमडी पंजीकरण क्षेत्र) के बराबर न हो।
      इसके विपरीत, कुछ तृतीय पक्ष इसके बजाय पहले ग्राहकों को अपनी तरफ से संलग्न करना और स्क्रीन करना चाह सकते हैं जब ग्राहकों को प्राधिकरण कोड का अनुरोध करने से पहले उनके 'थर्ड पार्टी पोर्टल' यूआरआई पर पुनर्निर्देशित किया जाता है, इसलिए उपरोक्त दृष्टिकोण केवल एक सुझाव है।
  6. SMD अब प्राधिकरण कोड अनुरोध, एक्सेस टोकन अनुरोध और प्राधिकरण API के उत्तरों के भाग के रूप में उन्नत स्कोप पैरामीटर विवरण प्रदान करेगा। बढ़ाया गया दायरा पैरामीटर ग्राहक प्राधिकरण के अंतिम दायरे को संप्रेषित करने की अनुमति देता है। विशेष रूप से, दायरे के पैरामीटर में एक "अतिरिक्त स्केलोप" मूल्य शामिल है जो डेटा समूहों के PG&E के समर्थित ग्राहक प्राधिकरण चयनों को मैप करता है (उदाहरण के लिए "उपयोग", "बिलिंग", "बुनियादी", "खाता", "कार्यक्रम नामांकन")। दायरे पैरामीटर मानों को निम्नलिखित दस्तावेज़ों के अनुसार आगे कैप्चर किया गया है: समर्थित कार्य ब्लॉक स्कोप स्ट्रिंग मैपिंग डाउनलोड करें क्लिक थ्रू 2.0 (पीडीएफ)

    नीचे एक उदाहरण टोकन प्रतिक्रिया कुछ संभावित दायरे पैरामीटर मूल्यों को दर्शाती है।
    • उदाहरण टोकन प्रतिक्रिया:
      <प्रतिक्रिया xmlns="https://api.pge.com/datacustodian/oauth/v2/token">
      774ff105-7ad5-40c8-a6ec-f60675dc0e41</ Access_token>
      3600
      998c6654-5b3b-4385-af4f-4e5c46c1bb04
      scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=90_360;Buld=Dult=Dinin__Tiii____Cin__Cinint__Culii____Cula_Cin_Cin_13000_Cin__Cin_Culd=Cululd=Cin,30_Cin__Cin_Cin_Cin_
      संसाधनURI:{ResourceURI} जैसे: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
      प्राधिकरणURI:{AuthorizationURI} जैसे: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
      ग्राहकसंसाधन:{ग्राहकसंसाधन} जैसे:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
      Bearer


  7. तीसरे पक्ष अब नए "कार्यक्रम नामांकन" डेटा समूह के माध्यम से अधिकृत कार्यक्रम नामांकन जानकारी प्राप्त करने के लिए पंजीकरण कर सकते हैं। अंतराल मीटर और गैर-अंतर्वर्ती मीटर वाले दोनों ग्राहक एसएमडी क्लिक-थ्रू चरण 2 के लिए डेटा साझा करने को अधिकृत करने के पात्र होंगे। कार्यक्रम नामांकन डेटा समूह द्वारा प्रदान किए गए नए उपलब्ध डेटा तत्वों का एक उच्च-स्तरीय सारांश इस प्रकार है:
    • कार्यक्रम नामांकन (PG&E डिमांड रिस्पांस प्रोग्राम का नाम/स्थिति और CAISO जानकारी):
    • (बिलिंग) खाता पता
    • सेवा अनुबंध स्थिति
    • (वर्तमान) सेवा शुल्क
    • (वर्तमान) सर्विस वोल्टेज (केवल विद्युत)
    • सर्विस मीटर नंबर (यदि कोई हो)
    • मीटर प्रकार
    • (वर्तमान) मीटर रीड चक्र
    • (वर्तमान) यदि ऑन-साइट जनरेशन संकेतक है तो स्टैंडबाय दर विकल्प
    • (डिफ़ॉल्ट अंतराल उपयोग) अवधि (सेकंड में लंबाई)
    • (नामांकित PG&E डिमांड रिस्पांस) कार्यक्रम का नाम (यदि लागू हो)
    • वित्तीय दायित्व के बिना PG&E नामांकित मांग प्रतिक्रिया (DR) कार्यक्रम से सबसे पहले समाप्ति की तारीख
    • वित्तीय बाध्यता की परवाह किए बिना PG&E नामांकित मांग प्रतिक्रिया (DR) कार्यक्रम से सबसे पहले समाप्ति तिथि
    • PG&E डिमांड रिस्पांस (DR) प्रोग्राम (नामांकन) स्थिति
    • PG&E डिमांड रिस्पांस (DR) कार्यक्रम नामांकन तिथि
    • PG&E डिमांड रिस्पांस (DR) प्रोग्राम डी-नामांकन तिथि
    • इन नए डेटा तत्वों के लिए एटम XML XSD (XML स्कीमा परिभाषा) मैपिंग को निम्नलिखित प्रलेखन के अनुसार कैप्चर किया गया है:
      समर्थित डेटा तत्व (PDF) डाउनलोड करें
    • संबद्ध संबंधपरक डेटा पदानुक्रम मॉडल को निम्नलिखित के अनुसार रेखांकित किया गया है:
      PGE ESPI डेटा मॉडल (PDF) डाउनलोड करें
    • उपयोग बिंदु (उर्फ SA UUID)
      • सर्विसडिलीवरीपॉइंट\टैरिफप्रोफाइल (वर्तमान सेवा शुल्क AKA दर अनुसूची जिसमें स्टैंडबाय रेट विकल्प शामिल है यदि लागू हो)
      • चक्र पढ़ें (वर्तमान मीटर पढ़ें चक्र)उपयोग सारांश
      • ReadCycle (बिलिंग सेवा चक्र)
      • कमोडिटी (बिजली के लिए बिल्ड वोल्टेज स्तर शामिल है)
      • टैरिफप्रोफाइल (यदि लागू हो तो स्टैंडबाय रेट विकल्प सहित बिल्ड सेवा टैरिफ
    • पढ़ने का प्रकार
      • कमोडिटी (जहां लागू हो, स्टैंडबाय रेट विकल्प के लिए इलेक्ट्रिक और उपसर्ग के लिए वर्तमान वोल्टेज स्तर शामिल है)
    • ग्राहक खाता
      • (बिलिंग पता प्राप्त करें):
      • मुख्यपता/सड़कविवरण...
      • मुख्यपता/शहरविवरण...
      • मुख्य पता/पोस्टलकोड...
    • ग्राहक अनुबंध
      • स्थिति\मान (SA स्थिति
    • मांग प्रतिक्रिया कार्यक्रम
      • प्रोग्रामनाम
      • नामांकनस्थिति
      • प्रोग्राम दिनांक/प्रोग्राम दिनांक
      • प्रोग्राम दिनांक/कार्यक्रम दिनांकविवरण
    • मीटर
      • क्रम संख्या (मीटर आईडी)
      • प्रकार (मीटर प्रकार)
      • (वर्तमान) अंतराललंबाई
    • इन नए डेटा तत्व के लिए उपयोग की जाने वाली नवीनतम ESPI xml स्कीमा परिभाषाएं (XSDs) निम्नलिखित के अनुसार उल्लिखित हैं:
      XSDs (ZIP) डाउनलोड करें
      नोट: XSDs पीछे की ओर संगत हैं।
    • तीसरे पक्ष के पास अपने पंजीकरण को बदलने की क्षमता होगी ताकि ग्राहक पंजीकरण का प्रबंधन >संपादित करें > अनुभाग के तहत तीसरे पक्ष के पोर्टल के माध्यम से प्राधिकरण के समय के दौरान इस डेटा समूह का चयन कर सकें: आपको जो ग्राहक जानकारी चाहिए उसे इंगित करें", प्रोग्राम नामांकन चेक बॉक्स का चयन करें।
    • नोट: यह केवल नए ग्राहक प्राधिकरणों पर लागू होगा।
    • DR नामांकन जानकारी प्राप्त करने के लिए नए APIs बल्क 3rd पक्ष स्तर पर और साथ ही व्यक्तिगत ग्राहक प्राधिकरण स्तर (RetailCustomerID स्तर) पर उपलब्ध हैं, जो निम्नलिखित के अनुसार उल्लिखित हैं:
      नए PGE समर्थित APIs (PDF) डाउनलोड करें
    • तृतीय पक्ष को सभी प्राधिकरणों के लिए DR नामांकन जानकारी का अनुरोध करने के लिए एसिंक्रोनस एपीआई
      • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
    • व्यक्तिगत ग्राहक प्राधिकरण स्तर पर DR नामांकन जानकारी का अनुरोध करने के लिए सिंक्रोनस एपीआई
      • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

 

कृपया ध्यान दें: ग्राहक प्राधिकरण प्रक्रिया में परिवर्तनों के अलावा, अन्य परिवर्तन भी पीछे की ओर संगत हैं और स्वैच्छिक संवर्द्धन हैं जो तीसरे पक्ष समर्थन करने के लिए चुन सकते हैं।

 

यदि आपके कोई प्रश्न हैं या अतिरिक्त सहायता की आवश्यकता है, तो ईमेल पर स्वतंत्र महसूस करेंsharemydata@pge.com

नया क्या है:

 

  1. ग्राहक अब सुव्यवस्थित क्लिक-थ्रू प्राधिकरण प्रक्रिया से लाभ उठा सकते हैं।
    • हमने इस बारे में विवरण अपडेट किए हैं कि ग्राहक अब आपकी कंपनी के साथ डेटा कैसे साझा कर सकता है।
      जानें कि ग्राहक किसी कंपनी के साथ डेटा कैसे साझा करते हैं

      नोट:
      ये परिवर्तन, विशेष रूप से हमारे प्राधिकरण UI में सुधार, मोबाइल उपकरणों (जैसे, फोन या टैबलेट) के लिए अनुकूलित किए गए हैं।
    • ग्राहकों के लिए उनके PG&E ऑनलाइन खाते के माध्यम से सुलभ प्राधिकरण प्रक्रिया के प्रबंधन में परिवर्तन किए गए हैं:
      • कोई ग्राहक अभी भी किसी मौजूदा प्राधिकरण से SAIDs को हटा सकता है, प्राधिकरण की समाप्ति तिथि बढ़ा सकता है और/या किसी भी समय प्राधिकरण को रद्द कर सकता है। हालांकि, अतिरिक्त SAIDs जोड़ने और/या अधिकृत डेटा तत्वों को बदलने के लिए मौजूदा प्राधिकरण को रद्द करने की आवश्यकता है और एक नया प्राधिकरण बनाने की आवश्यकता है।
  2. यदि वांछित हो, तो तृतीय पक्ष अब DELETE ऑपरेशन के माध्यम से अपने तृतीय पक्ष क्लाइंट एक्सेस टोकन (प्रारंभिक SMD तृतीय पक्ष पंजीकरण प्रक्रिया के दौरान प्रदान की गई) का उपयोग करके व्यक्तिगत ग्राहक प्राधिकरणों को रद्द करने के लिए इस API का उपयोग कर सकते हैं: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}

    नोट 1: PG&E के कार्यान्वयन के लिए, प्राधिकरण ID पैरामीटर सदस्यता ID के समान ही मान है।

    नोट 2: नया एपीआई तीसरे पक्ष को प्राधिकरण को रद्द करने (रद्द करने) की क्षमता प्रदान करता है। हालांकि, केवल ग्राहक स्वयं SA ID को हटा सकते हैं और/या हमारे SMD प्रबंधन प्राधिकरण पृष्ठों के माध्यम से प्राधिकरण की समाप्ति तिथि को अपडेट कर सकते हैं।

    अनुस्मारक:सभी एपीआई डेटा अनुरोधों के साथ, तीसरे पक्ष को पहले अपने नवीनतम ताज़ा टोकन का उपयोग करके एक नई टोकन जोड़ी (क्लाइंट एक्सेस + ताज़ा टोकन) का अनुरोध करना चाहिए।

    टोकन समाप्ति अवधियों की याद दिलाएं:
    • एक्सेस टोकन:1घंटे
    • ग्राहक एक्सेस टोकन: 5 मिनट
    • ताज़ा टोकनों के अनुरूप: 1Yr
  3. तृतीय पक्ष अब जरूरत पड़ने पर एक ही कंपनी के नाम और कर आईडी का उपयोग करके कई शेयर मेरा डेटा (SMD) पंजीकरण बना सकते हैं। हालांकि, डिस्प्ले का नाम (जो ग्राहक अधिकृत करते समय देखते हैं) अभी भी अद्वितीय होना चाहिए।

    नोट: उपरोक्त सभी परिवर्तन पीछे की ओर संगत हैं और स्वैच्छिक संवर्द्धन हैं जो तीसरे पक्ष समर्थन करने के लिए चुन सकते हैं। इस रिलीज़ के लिए सहायक दस्तावेज़ डाउनलोड करें:

    SUPPORTD_APIS.SMD_CLICK-THRU_1.0 (PDF)

    समर्थित_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)

    PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)

    समर्थित_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)

    ESPI_XSDS (ZIP)

20 दिसंबर, 2015

 

आवश्यक परिवर्तन: निम्नलिखित SMD 2.0 अपडेट को तीसरे पक्ष की ओर से परिवर्तनों की आवश्यकता होती है।

  1. केवल PG&E के अलावा कई उपयोगिताओं पर GBCMD (ग्रीन बटन कनेक्ट मेरा डेटा) कार्यान्वयन के साथ तीसरे पक्ष के विचार में, हम OAuth प्राधिकरण अनुक्रम के दौरान तीसरे पक्ष को पुनर्निर्देशित करने के लिए डेटा संरक्षक (यानी, डेटा संरक्षक आईडी = PGE) को वापस भेज देंगे।
  2. एपीआई अनुरोध जो दिनांक मापदंडों (जैसे, बैच अनुरोध) को स्वीकार करते हैं, उन्हें Zulu डेटा मापदंडों (जैसे, प्रकाशित-अधिकतम / प्रकाशित-मिनट) का उपयोग करना चाहिए। एपीआई अनुरोधों में तिथि मापदंडों के लिए अन्य तिथि प्रारूप समर्थित नहीं होंगे।
    • एपीआई जो तारीख मापदंडों को स्वीकार करते हैं, संलग्न, समर्थन किए गए एपीआई.xlsx के अनुसार प्रलेखित हैं
  3. अंतराल TOU संकेतकों में अंतराल मीटर वाले विद्युत उपयोग डेटा शामिल हैं (जैसा कि लागू हो, इस बात का संकेतक कि प्रत्येक अंतराल किस TOU अवधि से मेल खाता है)
    • कृपया स्थैतिक प्रोग्राम आईडी मैपिंग का संदर्भ दें जिसमें यह विवरण हो कि प्रत्येक अंतराल TOU गणना किस से मेल खाती है (उदाहरण के लिए, 1 = समर पीक आदि)। (देखें संलग्न,समर्थित डेटा तत्व.xlsx )
  4. ग्राहक_id जैसा कि डेटा में पाया गया हैग्राहकScopeSelectionScreenURI (जिसे तीसरे पक्ष द्वारा शुरू किया गया OAuth के लिए उपयोग किया जाता है) और आवेदन सूचना संसाधन में प्रदान किया गया है, पंजीकरण परीक्षण के दौरान तीसरे पक्ष के अनुरोध को 5 अंकों में अपडेट किया जा रहा है यदि यह पहले से नहीं है (उदाहरण के लिए, अग्रणी शून्य जोड़ना आदि)। इसके अलावा, यूआरएल में अंत में '&verified=true' शामिल नहीं है। तीसरे पक्ष को तदनुसार अपने URL अपडेट करने की आवश्यकता होगी।
    • विस्तृत करने के लिए, डेटासंरक्षकScopeSelectionScreenURI निम्नानुसार दिखता है: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX क्लाइंटआईडी है)
    • तो 123 का एक वर्तमान क्लाइंटआईडी 00123 की तरह कुछ में बदल जाएगा जिसका अर्थ है कि उनका नया डेटा संरक्षकScopeSelectionScreenURI निम्नानुसार होगा:
      https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (पुराना यूआरएल इस प्रकार है: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
  5. "ईएसपी" या "ऊर्जा सेवा प्रदाता" के रूप में पंजीकृत तृतीय पक्ष मानक उपयोगकर्ता प्रकार में बदल रहे हैं। कार्यात्मक रूप से कोई परिवर्तन नहीं हैं, केवल उपयोगकर्ता प्रकार शीर्षक में। ईएसपी उपयोगकर्ता प्रकार (मानक उपयोगकर्ता प्रकार से) को अलग करना एक गैर-जरूरी भेदभाव है, जिससे पंजीकरण प्रक्रिया के दौरान कोई विभेदित कार्यक्षमता प्रदान किए बिना भ्रम पैदा होता है, इसलिए इसे सेवानिवृत्त किया जा रहा है।

वैकल्पिक वृद्धि: निम्नलिखित परिवर्तन पीछे की ओर संगत हैं, और स्वैच्छिक संवर्द्धन हैं जो तीसरे पक्ष समर्थन करने के लिए चुन सकते हैं।

  1. तृतीय पक्षों के पास अपने SSL प्रमाणपत्रों को स्वचालित रूप से बदलने/अपडेट करने की क्षमता होगी जो उन्होंने मूल रूप से पंजीकरण के दौरान प्रदान किए थे (उदाहरण के लिए, जब प्रमाणन समाप्ति के निकट होता है) पंजीकरण का प्रबंधन करने के तहत तृतीय पक्ष पोर्टल के माध्यम से >संपादित करें > नया अनुभाग: SSL प्रमाणपत्र जानकारी (अपडेट विकल्प)।
  2. तृतीय पक्ष अधिकृत बुनियादी बिलिंग जानकारी, ग्राहक जानकारी और गैस डेटा प्राप्त करने के लिए पंजीकरण कर सकते हैं।  अंतराल मीटर और गैर-अंतर्स्थ मीटर वाले दोनों ग्राहक एसएमडी 2.0 के लिए डेटा साझा करने को अधिकृत करने के पात्र होंगे। नए उपलब्ध डेटा तत्वों का एक उच्च स्तरीय सारांश इस प्रकार है:
    • बिलिंग की जानकारी: (अंतर्काल और गैर-अंतर्कालीन मीटर वाले SAs दोनों के लिए)
      • दर अनुसूची, बिलिंग $ योग, श्रेणीबद्ध उपयोग (जैसा लागू हो), मांग (जैसा लागू हो), TOU योग (जैसा लागू हो)
      • नोट: अधिकृत गैर-अंतर्वाल मीटर वाले ग्राहकों के लिए, तृतीय पक्ष केवल बिलिंग उपयोग योग (यानी, उपयोग सारांश में) प्राप्त करेंगे और कोई अंतराल उपयोग नहीं पढ़ता है (जैसे, प्रति घंटा/दैनिक पढ़ता है क्योंकि वे उपलब्ध नहीं हैं)
    • ग्राहक की जानकारी: (अंतर और गैर-अंतर्वाल मीटरेड SAs दोनों के लिए)
      • ग्राहक का नाम, सेवा पता, खाता ID, सेवा अनुबंध ID, सेवा अनुबंध सेवा प्रारंभ तिथि,
    • अंतराल गैस उपयोग डेटा: (केवल अंतराल मीटर गैस SAs)
      • अंतराल (यानी, दैनिक) गैस पढ़ता है
    • नए डेटा तत्वों को संलग्न, समर्थित डेटा तत्वों.xlsx के अनुसार आरेखित किया जाता है
    • संबद्ध संबंधपरक डेटा पदानुक्रम संलग्न, PGE ESPI डेटा मॉडल.xlsx में उल्लिखित है
    • इन नए डेटा तत्वों के लिए उपयोग की जाने वाली नवीनतम ESPI xml स्कीमा परिभाषाएं (XSDs) संलग्न XSDs के अनुसार हैं। नोट: XSDs पीछे की ओर संगत हैं:
      • espiDerived.xsd (अंतर्स्थ उपयोग और बिलिंग जानकारी)
      • खुदराग्राहक.xsd (ग्राहक की जानकारी)

यदि आपके कोई प्रश्न हैं या अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमसे ShareMyData@pge.com पर बेझिझक संपर्क करें।

18 दिसंबर, 2015
 

आवश्यक परिवर्तन: निम्नलिखित एसएमडी 2.0 अपडेट उन उपयोगकर्ताओं की ओर से परिवर्तनों की आवश्यकता है जो अपने स्वयं के डेटा तक पहुंच रहे हैं:

  1. एपीआई अनुरोध जो दिनांक मापदंडों (जैसे, बैच अनुरोध) को स्वीकार करते हैं, उन्हें Zulu डेटा मापदंडों (जैसे, प्रकाशित-अधिकतम / प्रकाशित-मिनट) का उपयोग करना चाहिए। एपीआई अनुरोधों में तिथि मापदंडों के लिए अन्य तिथि प्रारूप समर्थित नहीं होंगे।
    • एपीआई जो तारीख मापदंडों को स्वीकार करते हैं, संलग्न, समर्थन किए गए एपीआई.xlsx के अनुसार प्रलेखित हैं
  2. इंटरवल मीटरेड इलेक्ट्रिक उपयोग डेटा (जैसा लागू हो, इस बात का संकेतक कि प्रत्येक अंतराल किस TOU अवधि से मेल खाता है) के साथ इंटरवल समय का उपयोग (TOU) संकेतक शामिल है
    • कृपया स्थैतिक प्रोग्राम आईडी मैपिंग का संदर्भ दें जिसमें यह विवरण हो कि प्रत्येक अंतराल TOU गणना किस से मेल खाती है (उदाहरण के लिए, 1 = समर पीक आदि)। (देखें संलग्न,समर्थित डेटा तत्व.xlsx )

वैकल्पिक वृद्धि: निम्नलिखित परिवर्तन पीछे की ओर संगत हैं, और स्वैच्छिक संवर्द्धन हैं जो तीसरे पक्ष समर्थन करने के लिए चुन सकते हैं।

  1. स्व-पहुंच उपयोगकर्ताओं के पास अपने एसएसएल प्रमाणपत्रों को स्वचालित रूप से बदलने / अपडेट करने की क्षमता होगी जो उन्होंने मूल रूप से पंजीकरण के दौरान प्रदान की थी (उदाहरण के लिए, जब सर्ट समाप्ति के करीब होता है) तीसरे पक्ष के पोर्टल के माध्यम से पंजीकरण का प्रबंधन करें > संपादित करें > नया अनुभाग: एसएसएल प्रमाणपत्र जानकारी (अपडेट विकल्प)
  2. अधिकृत बुनियादी बिलिंग जानकारी, ग्राहक जानकारी और गैस डेटा को शामिल करने के लिए स्व एक्सेस उपयोगकर्ता पंजीकरण को अपडेट किया जाएगा। गैर-अंतर्स्थ मीटर सेवा समझौतों के रूप में दोनों अंतराल मीटर वाले एस्वेल SMD 2.0 के लिए (स्वयं) प्राधिकरण के लिए पात्र होंगे नए उपलब्ध डेटा तत्वों का एक उच्च स्तरीय सारांश निम्नानुसार है:
    • बिलिंग की जानकारी: (अंतर्काल और गैर-अंतर्कालीन मीटर वाले SAs दोनों के लिए)
      • दर अनुसूची, बिलिंग $ योग, श्रेणीबद्ध उपयोग (जैसा लागू हो), मांग (जैसा लागू हो), TOU योग (जैसा लागू हो)
      • नोट: अधिकृत गैर-अंतर्वाल मीटर वाले ग्राहकों के लिए, तृतीय पक्ष केवल बिलिंग उपयोग योग (यानी, उपयोग सारांश में) प्राप्त करेंगे और कोई अंतराल उपयोग नहीं पढ़ता है (जैसे, प्रति घंटा/दैनिक पढ़ता है क्योंकि वे उपलब्ध नहीं हैं)
    • ग्राहक की जानकारी: (अंतर और गैर-अंतर्वाल मीटरेड SAs दोनों के लिए)
      • ग्राहक का नाम, सेवा पता, खाता ID, सेवा अनुबंध ID, सेवा अनुबंध सेवा प्रारंभ तिथि,
    • अंतराल गैस उपयोग डेटा: (केवल अंतराल मीटर गैस SAs)
      • अंतराल (यानी, दैनिक) गैस पढ़ता है
    • नए डेटा तत्वों को संलग्न, समर्थित डेटा तत्वों.xlsx के अनुसार आरेखित किया जाता है
    • संबद्ध संबंधपरक डेटा पदानुक्रम संलग्न, PGE ESPI डेटा मॉडल.xlsx में उल्लिखित है
    • इन नए डेटा तत्वों के लिए उपयोग की जाने वाली नवीनतम ESPI xml स्कीमा परिभाषाएं (XSDs) संलग्न XSDs के अनुसार हैं। नोट: XSDs पीछे की ओर संगत हैं:
      • espiDerived.xsd (अंतर्स्थ उपयोग और बिलिंग जानकारी)
      • खुदराग्राहक.xsd (ग्राहक की जानकारी)

यदि आपके कोई प्रश्न हैं या अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमसे ShareMyData@pge.com पर बेझिझक संपर्क करें।

18 दिसंबर, 2015
 

आवश्यक परिवर्तन: निम्नलिखित एसएमडी 2.0 अपडेट सीसीए कार्यान्वयन की ओर से परिवर्तनों की आवश्यकता है।

  1. तदर्थ अनुरोध (जैसे, ऐतिहासिक डेटा के लिए), Zulu समय तिथि मापदंडों का उपयोग करके किया जाना चाहिए। एपीआई अनुरोधों में तिथि मापदंडों के लिए अन्य तिथि प्रारूप समर्थित नहीं होंगे।
  2. दैनिक थोक उपयोग फ़ीड में बुनियादी बिलिंग जानकारी शामिल करना शुरू हो जाएगी जबकि दैनिक थोक ग्राहक फ़ीड में अतिरिक्त ग्राहक जानकारी शामिल होगी। यह नया डेटा अंतराल मीटर वाले ग्राहकों के लिए दोनों प्रदान किया जाएगा जो उन्हें वर्तमान में डेटा प्राप्त करते हैं, साथ ही साथ उनके क्षेत्र में गैर-अंतर्वाल मीटर वाले ग्राहकों के लिए जिनके लिए उन्हें वर्तमान में डेटा प्राप्त नहीं होता है। अंत में, दैनिक थोक उपयोग फ़ीड में प्रदान किए गए अंतराल उपयोग मूल्यों में अंतराल TOU संकेतक शामिल होंगे जहां लागू हो। नए डेटा तत्वों का उच्च स्तरीय सारांश इस प्रकार है:
    • बिलिंग की जानकारी: (अंतर्काल और गैर-अंतर्कालीन मीटर वाले SAs दोनों के लिए)
      • दर अनुसूची, बिलिंग $ योग, श्रेणीबद्ध उपयोग (जैसा लागू हो), मांग (जैसा लागू हो), TOU योग (जैसा लागू हो)
    • (अतिरिक्त) ग्राहक जानकारी: (अंतराल और गैर-अंतरीय मीटर वाले SAs दोनों के लिए)
      • ग्राहक का नाम, सेवा पता, सेवा अनुबंध सेवा प्रारंभ तिथि, खाता आईडी
    • अंतराल TOU संकेतकों में अंतराल मीटर वाले विद्युत उपयोग डेटा शामिल हैं (जैसा कि लागू हो, इस बात का संकेतक कि प्रत्येक अंतराल किस TOU अवधि से मेल खाता है)
      • कृपया स्थैतिक प्रोग्राम आईडी मैपिंग का संदर्भ दें जिसमें यह विवरण हो कि प्रत्येक अंतराल TOU गणना किस से मेल खाती है (उदाहरण के लिए, 1 = समर पीक आदि)। (देखें संलग्न,समर्थित डेटा तत्व.xlsx )
    • इन नए डेटा तत्वों के लिए उपयोग की जाने वाली नवीनतम ESPI xml स्कीमा परिभाषाएं (XSDs) संलग्न XSDs के अनुसार हैं। ध्यान दें, XSD पीछे की ओर संगत हैं:
      • espiDerived.xsd (अंतर्स्थ उपयोग और बिलिंग जानकारी)
      • खुदरा ग्राहक.xsd (ग्राहक जानकारी)
    • नए डेटा तत्वों को संलग्न, समर्थित डेटा तत्वों.xlsx के अनुसार आरेखित किया जाता है
    • संबद्ध संबंधपरक डेटा पदानुक्रम संलग्न, PGE ESPI डेटा मॉडल.xlsx में उल्लिखित है

वैकल्पिक वृद्धि: निम्नलिखित परिवर्तन पीछे की ओर संगत हैं, और स्वैच्छिक संवर्द्धन हैं जो तीसरे पक्ष समर्थन करने के लिए चुन सकते हैं।

  1. CCA ग्राहक जानकारी के लिए तदर्थ अनुरोध कर सकता है: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (अनुरोध के समय ग्राहक जानकारी का नवीनतम स्नैपशॉट लौटाता है), दैनिक अधिसूचना के अलावा।
  2. CCA के पास अपने SSL सर्ट को स्वचालित रूप से बदलने की क्षमता होगी जो उन्होंने मूल रूप से पंजीकरण के दौरान प्रदान की थी (उदाहरण के लिए, जब सर्ट समाप्ति के करीब होता है) तीसरे पक्ष के पोर्टल के माध्यम से, पंजीकरण का प्रबंधन करें > संपादित करें > नया अनुभाग: एसएसएल प्रमाणपत्र जानकारी (अपडेट विकल्प)

यदि आपके कोई प्रश्न हैं या अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमसे ShareMyData@pge.com पर बेझिझक संपर्क करें।

21 अगस्त, 2015
 

नया क्या है:

  1. राज्य पराक्रम और संसाधन यूआरआई ऑथ प्रतिक्रियाओं में परिवर्तन करता है
    • OAuth प्राधिकरण कोड अनुरोध के हिस्से के रूप में, तीसरे पक्ष के पास एक राज्य पैरामीटर में भेजने का विकल्प है जो PG&E तीसरे पक्ष को वापस भेज देगा। PG&E प्राधिकरण के सफल समापन पर प्राधिकरण कोड भी भेजेगा। इस वैकल्पिक राज्य पैराम का उपयोग तीसरे पक्ष को यह पहचानने में मदद करने के लिए किया जा सकता है कि अनुरोध कहां शुरू किया गया था, और अनुरोध को उनके द्वारा शुरू किए गए प्राधिकरणों पर वापस टाई करने के लिए।
    • टोकन अनुरोध के सफल समापन के हिस्से के रूप में, हम टोकन जानकारी से अलग संसाधनURI और प्राधिकरणURI साझा करते हैं। वर्तमान में इन यूआरआई को फ़्लिप कर दिया गया है और इस रिलीज के हिस्से के रूप में हम इसे सही करेंगे।

निश्चित दोष:

  1. डिफ़ॉल्ट तिथियां अधिकतम और प्रकाशित मिनट
    वर्तमान में PG&E यह अनिवार्य करता है कि तृतीय पक्ष PG&E को डेटा का अनुरोध करने की अवधि बताने के लिए प्रत्येक डेटा अनुरोध के लिए युग-सेकंड में प्रकाशित-मिन और प्रकाशित-अधिकतम पैरामीटर भेजता है। हम निम्नलिखित परिदृश्यों के लिए अनुरोधों को संभालने के लिए एक बदलाव लागू कर रहे हैं:
    • प्रकाशित-मिनट और प्रकाशित-अधिकतम मूल्य गायब हैं
    • प्रकाशित-माइन और प्रकाशित-अधिकतम मूल्य यूटीसी में हैं
    • प्रकाशित-मिन और प्रकाशित-अधिकतम मूल्य युग के सेकंड में हैं
    यदि पैरामीटर गायब हैं, तो PG&E डिफ़ॉल्ट तिथियों को वापस कर देगा, जैसा कि त्रुटि संदेशों के विपरीत है जैसा कि इस परिवर्तन से पहले लौटाया गया है। डिफ़ॉल्ट, हमारे मामले में, तारीख T-2 के लिए एक दिन का डेटा है। यदि पैरामीटर मौजूद हैं और सही ढंग से स्वरूपित हैं, तो हम मापदंडों का सम्मान करना जारी रखेंगे।
  2. प्राधिकरण xml में तारीखों के लिए तय करें
    वर्तमान में प्राधिकरण xml में हमने प्रकाशित तिथि और प्राधिकरण तिथि साझा की है। ये तिथियां मिलीसेकंड में सेकंड के विपरीत हैं जो मानक है। हम इसे मिलीसेकंड के बजाय युग सेकंड में वापस भेजने के लिए ठीक कर रहे हैं।
  3. गलत XML/संसाधन/सदस्यता/{id}/उपयोग बिंदु/{id}/मीटर रीडिंग/{id}/इंटरवलब्लॉक के लिए लौटा दिया गया
    वर्तमान में हम उपरोक्त संसाधन स्तर GET के लिए गलत प्रतिक्रिया वापस कर रहे हैं जहां XML की संरचना गलत है और हम 24 घंटे की अवधि के लिए एक एकल अंतराल ब्लॉक बनाने के बजाय प्रत्येक अंतराल के लिए प्रविष्टियों को दोहरा रहे हैं।

    यह तय किया जा रहा है और 24 अंतराल ब्लॉक के लिए केवल एक अंतराल ब्लॉक वापस किया जाएगा।

सवाल या चिंताएं? कृपया ShareMyData@pge.com से संपर्क करें।

अक्सर पूछे जाने वाले प्रश्न

  • ग्राहक-अधिकृत डेटा तक पहुंचने में रुचि रखने वाला कोई भी योग्य तृतीय पक्ष मेरा डेटा साझा करें का उपयोग कर सकता है।
  • अपने स्वयं के डेटा तक पहुंचने के लिए RESTful APIs (एप्लिकेशन प्रोग्राम इंटरफेस) का उपयोग करने के लिए तकनीकी ज्ञान वाले ग्राहक उपकरण का भी उपयोग कर सकते हैं।
  • यदि आप मांग प्रतिक्रिया कार्यक्रम की पेशकश करने के लिए PG&E के नियम 24 कार्यक्रम के तहत भाग लेने वाले तृतीय-पक्ष डिमांड रिस्पांस प्रदाता (DRP) हैं और मेरा डेटा साझा करें का उपयोग करना चाहते हैं, तो कृपया अधिक जानकारी के लिए DRP वेबपेज पर जाएं

  • ग्राहक-अधिकृत डेटा तक पहुंचने में रुचि रखने वाला कोई भी योग्य तृतीय पक्ष मेरा डेटा साझा करें का उपयोग कर सकता है।
  • अपने स्वयं के डेटा तक पहुंचने के लिए RESTful APIs (एप्लिकेशन प्रोग्राम इंटरफेस) का उपयोग करने के लिए तकनीकी ज्ञान वाले ग्राहक उपकरण का भी उपयोग कर सकते हैं।
  • यदि आप मांग प्रतिक्रिया कार्यक्रम की पेशकश करने के लिए PG&E के नियम 24 कार्यक्रम के तहत भाग लेने वाले तृतीय-पक्ष डिमांड रिस्पांस प्रदाता (DRP) हैं और मेरा डेटा साझा करें का उपयोग करना चाहते हैं, तो कृपया अधिक जानकारी के लिए DRP वेबपेज पर जाएं

  • एक मानकीकृत प्रारूप में उपलब्ध विस्तृत ऊर्जा उपयोग जानकारी बनाना नए ग्राहक-केंद्रित अनुप्रयोगों के लिए तीसरे पक्ष के बीच ऊर्जा उपयोग के साथ-साथ नवाचार के बारे में जागरूकता को प्रोत्साहित करता है। आशा है कि ऊर्जा ऐप डेवलपर्स कल्पना करेंगे और ग्राहकों को अपने ऊर्जा उपयोग से संबंधित, प्रबंधन और अंततः कम करने के लिए अभिनव, प्रेरक नए तरीके बनाएंगे। यह समाधान ग्राहक ऊर्जा डेटा तक मानकीकृत, आसान पहुंच प्रदान करने के राष्ट्रीय प्रयास में अगला कदम है जो अगली पीढ़ी के संरक्षण समाधानों को अनलॉक करेगा। मेरा डेटा साझा करें ऊर्जा सेवा प्रदाता इंटरफेस (ESPI) मानक का पालन करते हुए डेटा प्रदान करता है।
  • PG&E का लक्ष्य ग्राहकों और उनके अधिकृत तृतीय-पक्ष सेवा प्रदाताओं को अधिकृत, आवर्ती, मशीन-टू-मशीन, प्रोग्रामेटिक डेटा एक्सेस उपलब्ध कराना है।

  • ऊर्जा संरक्षण कैलिफोर्निया में ऊर्जा ग्रिड को अधिक विश्वसनीय बनाने में मदद करता है।
  • संरक्षण हमारे ग्राहकों की भी मदद करता है क्योंकि कम ऊर्जा का उपयोग करने से उन्हें पैसे बचा सकते हैं।
  • PG&E अधिक ऊर्जा बेचकर अधिक लाभ नहीं कमाता है, जो PG&E और कैलिफ़ोर्निया में अन्य निवेशक-स्वामित्व वाली उपयोगिताओं को अधिकांश कंपनियों से अलग बनाता है जो किसी दिए गए कमोडिटी को बेचकर लाभ कमाती हैं। एक तरीका PG&E पैसा बनाता है, हमारे नियामक, कैलिफोर्निया पब्लिक यूटिलिटीज कमीशन द्वारा निर्धारित ऊर्जा दक्षता लक्ष्यों को प्राप्त करके अर्जित प्रोत्साहनों के माध्यम से।
  • जब हमारे ग्राहक ऊर्जा का संरक्षण करते हैं तो यह उनके लिए अच्छा होता है और यह हमारे व्यवसाय के लिए अच्छा होता है।

PG&E की बिजली दरों के बारे में अधिक जानें

  • मेरा डेटा साझा करने के लिए कोई लागत नहीं है।

  • ग्रीन बटन डाउनलोड मेरा डेटा टूल के माध्यम से, ग्राहक अपने व्यक्तिगत उपयोग डेटा को डाउनलोड कर सकते हैं और यदि वे चुनते हैं, तो फ़ाइल को किसी भी तीसरे पक्ष को भेजें।
  • यह उपकरण उपलब्ध रहेगा।

  • ग्राहकों को अपने डेटा को साझा मेरा डेटा का उपयोग करके तीसरे पक्ष को जारी करने या ग्रीन बटन के माध्यम से अपने डेटा डाउनलोड करने के लिए अधिकृत करना होगा मेरा डेटा फ़ाइल अपने कंप्यूटर पर डाउनलोड करें और फिर फ़ाइल को तीसरे पक्ष के सेवा प्रदाताओं को भेजें।

  • हाँ। नीचे दिए गए वेबपेज पर जाएं, अन्य उपयोगिताओं की एक सूची देखने के लिए जो समान कार्यक्रमों को लागू कर रहे हैं।

greenbuttondata.org पर जाएं

  • इस उपकरण के लिए, CPUC अंतिम शासी प्राधिकरण है जो अधिकृत ग्राहक डेटा प्राप्त करने के लिए पात्र नहीं है। 
  • CPUC ग्राहक डेटा के दुरुपयोग की रिपोर्ट की समीक्षा करता है और अंतिम निर्धारण करता है कि क्या टैरिफ और / या ग्राहक डेटा गोपनीयता और संरक्षण नियमों की शर्तों का उल्लंघन किया गया है।
  • आयोग के पास उन कंपनियों या व्यक्तियों के पंजीकरण को तुरंत रद्द करने और समाप्त करने के लिए उपयोगिताओं को आदेश देने का अधिकार है जो उल्लंघन में हैं और उन्हें भविष्य की भागीदारी से रोकते हैं। अधिक जानकारी के लिए, नीचे दिए गए लिंक का चयन करें:
    इलेक्ट्रिक नियम संख्या 27 (पीडीएफ, 1.6 एमबी)

  • ESPI मानक के बारे में अधिक जानकारी के लिए, greenbuttondata.org पर जाएं।

कृपया मेरा डेटा साझा करें के साथ पंजीकरण करने से पहले निम्नलिखित जानकारी की समीक्षा करें और एकत्र करें।

मेरा डेटा साझा करें के साथ शुरू होने वाली मुलाकात
पंजीकरण करने के लिए, मेरा डेटा साझा करें पर जाएं

  • हम उन कंपनियों के पंजीकरण को सुविधाजनक बनाने के लिए Share My Data प्लेटफ़ॉर्म का संचालन और रखरखाव करते हैं जो Share My Data प्रोग्राम में भाग लेना चाहते हैं।
  • हम आवेदकों को यह सत्यापित करने के लिए स्क्रीन करते हैं कि वे CPUC के साथ अच्छी स्थिति में वैध व्यावसायिक संस्थाएं हैं, वे नियमों और शर्तों और ग्राहक डेटा एक्सेस टैरिफ का पालन करने के लिए सहमत हैं और उनके पास साझा मेरा डेटा प्लेटफ़ॉर्म का उपयोग करने की तकनीकी क्षमता है।
  • हम दृढ़ता से अनुशंसा करते हैं कि ग्राहक जांच करें कि जिन कंपनियों के साथ वे व्यवसाय करना चुनते हैं, वे अपने डेटा का प्रबंधन और सुरक्षा कैसे करेंगे।

  • PG&E विभिन्न पंजीकरणों के लिए एक कंपनी के नाम और कर आईडी का समर्थन करेगा। इसका मतलब है कि एक एकल कंपनी के पास विभिन्न डिस्प्ले नामों के साथ कई पंजीकरण हो सकते हैं।
  • आपको अपने विभिन्न पंजीकरण में आपके द्वारा प्रदान किए गए कंपनी के नाम और / या प्रदर्शन नाम को अधिकृत करने के लिए अपने ग्राहकों के साथ समझ स्थापित करने की आवश्यकता होगी।

  • आपकी संघीय कर आईडी को आपके लिए एक आम, अद्वितीय पहचानकर्ता के साथ कैलिफोर्निया निवेशक स्वामित्व वाली उपयोगिताओं (प्रशांत गैस और इलेक्ट्रिक, दक्षिणी कैलिफोर्निया एडिसन और सैन डिएगो गैस एंड इलेक्ट्रिक) और कैलिफोर्निया सार्वजनिक उपयोगिता आयोग (सीपीयूसी) प्रदान करने की आवश्यकता है।

  • एक बार जब आप एक ईमेल प्राप्त करते हैं जो आपके पंजीकरण को स्वीकार कर लिया गया है, तो आप अपने ग्राहक क्रेडेंशियल्स को पुनः प्राप्त करने के लिए अपने साझा मेरा डेटा खाते में लॉग इन कर पाएंगे। पंजीकरण प्रबंधित करें चुनें और आपका और स्वीकृत स्थिति के तहत पंजीकरण Milestone तालिका में प्रदर्शित किया जाएगा।>

मेरा डेटा साझा करने के लिए लॉगिन करें

  • एक बार जब आप एक ईमेल प्राप्त करते हैं जो आपके पंजीकरण को स्वीकार कर लिया गया है, तो आपके पास पंजीकरण परीक्षण पूरा करने के लिए 90 दिन हैं।
  • यदि आप 90 दिनों के भीतर पंजीकरण परीक्षण पूरा करने में असमर्थ हैं, तो आपका पंजीकरण समाप्त हो जाएगा और आपको फिर से पंजीकरण करने की आवश्यकता होगी।

हां, पंजीकरण समाप्त हो जाएगा। एक बार जब आपका पंजीकरण परीक्षण के लिए स्वीकार कर लिया जाता है, तो आपको परीक्षण पूरा करना होगा और 90 दिनों के भीतर PG&E के सिस्टम से जुड़ने की अपने संगठन की क्षमता की पुष्टि करनी होगी। यदि आपने परीक्षण आवश्यकताओं को सफलतापूर्वक पूरा कर लिया है और Share My Data प्लेटफ़ॉर्म पर एक अनुमोदित तृतीय पक्ष बन गए हैं, तो आपका पंजीकरण समाप्त नहीं होगा।

  • यदि आप अपने सुरक्षा प्रश्न का उत्तर नहीं जानते हैं तो हम पासवर्ड रीसेट करने में सक्षम नहीं हैं।

  • यदि आप अपने सुरक्षा प्रश्न का उत्तर नहीं जानते हैं तो हम पासवर्ड रीसेट करने में सक्षम नहीं हैं।

  • आप पंजीकरण प्रबंधित करें का चयन करके अपनी प्रोफ़ाइल जानकारी अपडेट करने के लिए किसी भी समय अपने खाते में लॉग इन कर सकते हैं।

मेरा डेटा साझा करने के लिए लॉगिन करें

  • एक बार जब आपको एक ईमेल प्राप्त हो जाता है जो दर्शाता है कि आपका पंजीकरण स्वीकार कर लिया गया है, तो आप अपने को पुनः प्राप्त करने के लिए अपने खाते में लॉग इन कर पाएंगे। "पंजीकरण प्रबंधित करें" का चयन करें और आपका <पंजीकरण_एक्सेस_टोकन> स्वीकृत स्थिति के तहत पंजीकरण Milestone तालिका में प्रदर्शित किया जाएगा।

  • यदि आप अब मेरा डेटा साझा करें प्लेटफॉर्म पर ग्राहक-अधिकृत डेटा तक पहुँच प्राप्त नहीं करना चाहते हैं, तो कृपया अपना पंजीकरण समाप्त करने के लिए हमेंShareMyData@pge.com पर ईमेल करें। कृपया समाप्ति के लिए दो व्यावसायिक दिनों तक की अनुमति दें।

  • ग्राहक आपको My Energy, उनके PG&E ऑनलाइन खाते के माध्यम से अपने डेटा तक पहुंचने के लिए अधिकृत करते हैं। इस बारे में विस्तृत अवलोकन के लिए कि ग्राहक तृतीय पक्षों या अन्य संस्थाओं को अपने डेटा तक पहुंचने के लिए कैसे अधिकृत कर सकते हैं, कृपया मेरा डेटा साझा करें तृतीय-पक्ष अवलोकन देखें।

प्राधिकरण विवरण पर जाएं

  • वर्तमान में इसकी कोई सीमा नहीं है।

  • ग्राहक या तो एक निर्दिष्ट समय चुन सकते हैं जिसके लिए आप उनके डेटा तक पहुंच सकते हैं, या वे प्राधिकरण अवधि को खुला छोड़ सकते हैं।
  • आपका आवेदन प्राधिकरण संसाधन APIs (जैसे, .../espi/1_1/संसाधन/प्राधिकरण और/या.../espi/1_1/संसाधन/प्राधिकरण/{AuthorizationID}) को कॉल करके अन्य प्राधिकरण विवरण के साथ ग्राहक प्राधिकरण की समाप्ति तिथि की जांच कर सकता है।
  • वैकल्पिक रूप से, आप अपने खाते में लॉग इन करके और प्राधिकरणों का प्रबंधन करके मैन्युअल रूप से प्राधिकरण समाप्ति तिथियों की जांच कर सकते हैं।

  • यदि कोई ग्राहक प्राधिकरण की परिभाषित अवधि चुनता है, तो उस समय अवधि के अंत में उनका प्राधिकरण समाप्त हो जाता है। यदि वे प्राधिकरण को रद्द करते हैं, तो उनका प्राधिकरण प्राधिकरण रद्द करने के बाद दिन समाप्त हो जाता है।
  • यदि कोई ग्राहक अपनी प्राधिकरण अवधि के रूप में अनिश्चित चुनता है, तो उनका प्राधिकरण समाप्त नहीं होता है। ध्यान दें, नियम 24 डिमांड रिस्पांस प्रदाताओं और मेरे डेटा को साझा करने का उपयोग करने वाले अन्य कार्यक्रमों के विचार में, पहले से अधिकृत तिथि सीमाओं के लिए तथ्य-बाद सुधार प्राधिकरण की समाप्ति के बाद तीन साल तक तीसरे पक्ष को प्रदान किए जा सकते हैं।
  • देखें "डेटा सुधार कैसे संभाले जाएंगे?" सुधार प्राप्त करने के बारे में अधिक जानकारी के लिए।

  • गैस या इलेक्ट्रिक सेवा के लिए वर्तमान में सक्रिय सर्विस आईडी वाला कोई भी PG&E ग्राहक आपको नए Share My Data टूल का उपयोग करके अपने डेटा तक पहुंचने के लिए अधिकृत कर सकता है।

  • मेरा डेटा साझा करें कार्यक्रम के माध्यम से अपना डेटा साझा करने में भाग लेने में रुचि रखने वाले ग्राहकों को मेरी ऊर्जा खाते के लिए पंजीकरण करने के लिए अत्यधिक प्रोत्साहित किया जाता है। यह पूरी प्रक्रिया को और अधिक कुशल बना देगा और उन्हें अपने प्राधिकरणों को ऑनलाइन प्रबंधित करने की क्षमता भी देगा।
  • ग्राहक प्राधिकरण प्रक्रिया के दौरान My Energy खाते के लिए साइन अप कर सकते हैं।
  • ग्राहकों को ऑनलाइन मेरा डेटा साझा करें प्राधिकरण फॉर्म प्राप्त करने और ईमेल के माध्यम से पूरा किया गया फॉर्म जमा करने के लिए एक मैनुअल प्रक्रिया उपलब्ध है।
  • मैनुअल प्रक्रिया के बारे में अधिक जानकारी के लिए, कृपया हमसे ShareMyData@pge.com पर संपर्क करें।

  • ग्राहकों को अपने PG&E ऑनलाइन खाते के माध्यम से अपने स्वयं के प्राधिकरण ऑनलाइन बनाने की आवश्यकता है। हालांकि, यदि वे मेरे डेटा को साझा करें प्राधिकरण फॉर्म को पूरा करते हैं और हस्ताक्षर करते हैं, तो आप इसे उनकी ओर से PG&E को जमा कर सकते हैं।

मेरा डेटा ग्राहक प्राधिकरण साझा करें या प्राधिकरण फॉर्म को रद्द करें (PDF, 308 KB) डाउनलोड करें

  • आप अपने खाते में लॉग इन करके, पंजीकरण प्रबंधित करने के लिए नेविगेट करके और OAuth 2.0 सूचना अनुभाग के तहत फ़ील्ड अपडेट करके अपने OAuth URIs को अपडेट कर सकते हैं।

  • आप अपने खाते में लॉग इन करके, पंजीकरण प्रबंधित करने के लिए नेविगेट करके और डेटा एक्सेस जानकारी अनुभाग के तहत फ़ील्ड अपडेट करके अपनी अधिसूचना URI को अपडेट कर सकते हैं।

  • आप अपने खाते में लॉग इन करके अपने SSL प्रमाणपत्र को अपडेट कर सकते हैं, पंजीकरण प्रबंधित करें > संपादित करें > पर नेविगेट कर सकते हैं और SSL प्रमाणपत्र सूचना अनुभाग में "अपडेट करें" का चयन कर सकते हैं। ध्यान दें कि नए प्रमाणपत्र अपलोड के लिए, नए प्रमाणपत्र के साथ PG&E सिस्टम को अपडेट करने में कई दिन लग सकते हैं।  
  • नया प्रमाणपत्र लागू होने पर Share My Data Support टीम से एक पुष्टिकरण ईमेल भेजा जाएगा।

  • एक बार जब आप एक ईमेल प्राप्त करते हैं जो आपके पंजीकरण को स्वीकार कर लिया गया है, तो आप अपने साझा मेरा डेटा खाते में लॉग इन कर पाएंगे और डाउनलोड PG&E SSL प्रमाणपत्र पृष्ठ के माध्यम से हमारा SSL प्रमाणपत्र डाउनलोड कर पाएंगे।

मेरा डेटा साझा करने के लिए लॉगिन करें

  • मेरा डेटा साझा करें ग्रीन बटन कनेक्ट मेरा डेटा कार्यान्वयन समझौतों का पालन करता है। मेरा डेटा साझा करें प्राधिकरण के लिए OAuth 2.0, ट्रांसपोर्ट लेयर सिक्योरिटी (TLS) 1.2 और NIST (नेशनल इंस्टीट्यूट ऑफ स्टैंडर्ड्स एंड टेक्नोलॉजी) द्वारा अनुमोदित साइबर सुरक्षा प्रोटोकॉल के न्यूनतम सूट को भी नियोजित करता है ताकि स्पष्ट रूप से कोई जानकारी का आदान-प्रदान न हो।

  • PG&E के लिए ग्राहक जानकारी की सुरक्षा करना सर्वोच्च प्राथमिकता है। PG&E अपने ग्राहकों के बारे में जानकारी—व्यक्तिगत जानकारी सहित—को गोपनीय, सभी कानूनी और नियामक आवश्यकताओं के अनुरूप मानता है, जिसमें कैलिफोर्निया सार्वजनिक उपयोगिता आयोग और अन्य द्वारा स्थापित जानकारी भी शामिल है।  
  • दो दशकों से अधिक समय से, कैलिफ़ोर्निया में PG&E और अन्य निवेशक-स्वामित्व वाली उपयोगिताएं बहुत सख्त CPUC नियमों के अधीन हैं जो उन्हें ग्राहक की सहमति के बिना तीसरे पक्ष को ग्राहक-विशिष्ट जानकारी, जैसे बिलिंग डेटा, का खुलासा करने से रोकती हैं।  
  • एक बार जब कोई ग्राहक डेटा जारी करने के लिए अधिकृत हो जाता है, तो उस डेटा की सुरक्षा करना ग्राहक और तीसरे पक्ष की जिम्मेदारी होती है।
  • ग्राहक किसी भी समय अपने PG&E ऑनलाइन खाते में लॉग इन करके और अपने प्राधिकरण को रद्द करके किसी तीसरे पक्ष के साथ डेटा साझा करना बंद करने का चुनाव कर सकता है। PG&E की संपूर्ण गोपनीयता नीति और ऊर्जा उपयोग जानकारी तक पहुँचने, एकत्र करने, भंडारण करने, उपयोग करने और प्रकट करने की सूचना pge.com/privacy पर उपलब्ध है।

  • मेरा डेटा साझा करें कार्यक्रम के दायरे के भीतर, तृतीय पक्ष मेरे डेटा प्लेटफ़ॉर्म के साझा करें नियमों और शर्तों और ग्राहक डेटा एक्सेस टैरिफ में शामिल आवश्यकताओं में निर्दिष्ट ग्राहक डेटा गोपनीयता और सुरक्षा नियमों के अधीन हैं।
  • तृतीय पक्ष भी ग्राहक की गोपनीयता की सुरक्षा से संबंधित अन्य सभी लागू कानूनों और विनियमों के अधीन हैं, जिनमें सीपीयूसी द्वारा निर्णय 11-07-056 (इलेक्ट्रिक) के अनुलग्नक डी के रूप में अपनाए गए ऊर्जा उपयोग डेटा के लिए गोपनीयता और सुरक्षा संरक्षण के संबंध में नियम शामिल हैं, लेकिन इन्हीं तक सीमित नहीं हैं।
  • अधिक जानकारी के लिए, कृपया नीचे दिए गए लिंक चुनें:
    मेरे डेटा नियम और शर्तें साझा करें (PDF, 190 KB)
    इलेक्ट्रिक नियम संख्या 27 (PDF, 1.6 MB)
    निर्णय 11-07-056 (पीडीएफ) के साथ संलग्नक डी
    अधिक जानकारी प्राप्त करें:कैलिफोर्निया नागरिक संहिता धारा 1798.80 - 1798.84

  • समर्थित डेटा तत्वों की विस्तृत सूची के लिए कृपया नीचे दिए गए लिंक को देखें।

डेटा एक्सेस के बारे में अधिक जानकारी प्राप्त करें

  • कभी-कभी, अंतराल उपयोग डेटा गायब हो जाता है क्योंकि हमारी अपस्ट्रीम डेटा सत्यापन प्रक्रियाओं को पता चलता है कि गायब या गलत डेटा पढ़ता है जिसके लिए आगे प्रसंस्करण (संपादन और या अनुमान) की आवश्यकता हो सकती है।
  • अंतराल बिल वाले ग्राहकों के लिए (उदाहरण के लिए, समय-समय पर बिलिंग विचारों वाले ग्राहक), इन उदाहरणों को उनके आगामी मासिक बिल पर सटीक बिल गणना सुनिश्चित करने के लिए समय पर सही किया जाता है।

  • यदि आप डेटा सुधार प्राप्त करना चाहते हैं, तो कृपया सुनिश्चित करें कि आप पंजीकरण के दौरान या अपने ऑनलाइन खाते में लॉग इन करके और प्रोफ़ाइल संपादित करें के तहत इस चेकबॉक्स का चयन करके मुझे सूचित करें क्योंकि डेटा तैयार है चेकबॉक्स की जांच करें। फिर हम उन डेटा सुधारों को शामिल करेंगे जिन्हें आपके द्वारा एक्सेस करने के लिए अधिकृत किसी भी डेटा के लिए दैनिक उपयोग फ़ीड के हिस्से के रूप में पिछले 24 घंटों के दौरान हमारे सिस्टम द्वारा कैप्चर किया गया है।
  • डेटा सुधार अधिकृत अवधि के लिए किसी भी परिवर्तन को कवर करेंगे, अधिकतम तीन साल तक।

नोट: नियम 24 डिमांड रिस्पांस प्रदाताओं और मेरे डेटा को साझा करने का उपयोग करने वाले अन्य कार्यक्रमों के विचार में, पहले से अधिकृत तिथि सीमाओं के लिए बाद-तथ्य सुधार प्राधिकरण की समाप्ति के बाद तीन साल तक तीसरे पक्षों को प्रदान किए जा सकते हैं।

  • यदि लागू हो, तो PG&E पंजीकरण के दौरान प्रदान किए गए आपके अधिसूचना URL पर सूचनाएं भेजेगा। सूचनाओं में पहले से पैक किए गए डेटा के अनुरूप यूआरएल शामिल होते हैं जो आपके लिए वापस आने और प्रदान किए गए यूआरएल पर अनुरोध करने के लिए तैयार होते हैं। डेटा को प्रीपैक किया जाता है और निम्नलिखित दो परिदृश्यों में सूचनाएं भेजी जाती हैं: (1) आपने अपनी पंजीकरण प्रोफ़ाइल में "मुझे डेटा के रूप में सूचित करें तैयार है" का चयन किया है, इस स्थिति में हम पिछले तिथियों के लिए किसी भी सुधार के साथ नवीनतम दैनिक डेटा को पैकेज करेंगे, या (2) आपने पहले एक तदर्थ अतुल्यकालिक अनुरोध किया है जिसके लिए अनुरोध किया गया डेटा अब तैयार है। परिदृश्य 1 को "डेटा एक्सेस: डेटा एक्सेस पेज और परिदृश्य 2 पर डेटा एक्सेस विधि आरेखों का दैनिक उपस्कर" अनुभाग "डेटा एक्सेस: AD HOC अनुरोध (ASYNCHRONOUS)" एक ही आरेख का अनुभाग डेटा एक्सेस पृष्ठ पर भी है।

ऊपर डेटा एक्सेस पर जाएं

  • Share My Data द्वारा प्रदान किया गया विद्युत उपयोग डेटा, निपटान गुणवत्ता मीटर डेटा (SQMD) नहीं है जैसा कि कैलिफोर्निया इंडिपेंडेंट सिस्टम ऑपरेटर (CAISO) द्वारा निर्दिष्ट किया गया है। SQMD को उस अंतराल के लिए उस ग्राहक के वोल्टेज स्तर पर लागू वितरण हानि कारक (DLF) द्वारा राजस्व गुणवत्ता मीटर डेटा (RQMD) को गुणा करके उत्पन्न किया जाता है, मीटर अंतराल को CAISO द्वारा आवश्यक अंतराल अवधि में परिवर्तित किया जाता है और फिर प्रत्येक अंतराल के लिए परिणामों को CAISO द्वारा आवश्यक कुल स्तर तक सारांशित किया जाता है।
  • PG&E ESPI मानक द्वारा प्रदान किए गए "QualityOfReading" (QOR) प्रकार के झंडे को लागू कर रहा है ताकि यह बताया जा सके कि डेटा राजस्व गुणवत्ता है या नहीं। क्यूओआर प्रकार उपयोग डेटा के लिए विभिन्न संभावित गुणवत्ता मूल्यों को कैप्चर करता है, जिसमें "राजस्व गुणवत्ता मीटर डेटा" या "आरक्यूएमडी" के लिए एक स्पष्ट मूल्य शामिल है। PG&E अपने डेटा ट्रांसमिटल में इस QOR प्रकार का उपयोग निम्नानुसार करेगा:
    • PG&E प्रदान किए गए ESPI "उपयोग सारांश" वर्ग का समर्थन करता है, जिसका उपयोग उन तिथियों की पहचान करने के लिए किया जाएगा जिनके लिए सेवा समझौते का बिल भेजा जाता है, बिल की गई उपयोग राशि और अनुरोध के समय उपयोग डेटा की गुणवत्ता। अनुरोधित डेटा के लिए बिल उपलब्ध होने के बाद उपयोग सारांश को आबाद किया जाएगा और इसमें QOR प्रकार के दो झंडे (तत्व) शामिल होंगे:
      • उपयोग सारांश.पाठ तत्व की गुणवत्ता (उपयोग सारांश स्तर पर) नवीनतम प्रदान किए गए अंतराल उपयोग मूल्यों के अनुरोध के समय गुणवत्ता और उपयोग सारांश.बिलिंग अवधि तिथियों के अनुरूप सुधार का संकेत देती है।
      • कुल मिलाकर के लिए डिफ़ॉल्ट गुणवत्ता तत्वउपभोक्ताअंतिमअवधि (उपयोग सारांश के हिस्से के रूप में। कुल मिलाकरखरीदअंतिमअवधि.पढ़नाटाइपरिफ) कुल बिल किए गए उपयोग की गुणवत्ता को दर्शाता है।
    • PG&E इंटरवल रीडिंग का उपयोग करके अनुरोध के समय अंतराल स्तर पर उपयोग डेटा की गुणवत्ता के बारे में भी सूचित करेगा।गुणवत्ता को पढ़ना।गुणवत्ता तत्व।

  • पंजीकरण के दौरान आप चुन सकते हैं कि आपको कितने ऐतिहासिक डेटा की आवश्यकता है, या तो 24, 36, या 48 महीने "कितने ऐतिहासिक डेटा का अनुरोध किया जाता है" ड्रॉपडाउन के तहत।
  • ग्राहक के प्राधिकरण के हिस्से के रूप में आपको उनके डेटा तक पहुंचने की अनुमति देने के लिए, प्राधिकरण के लिए ऐतिहासिक अवधि प्राधिकरण में शामिल सेवा आईडी (उपयोग बिंदु) के लिए आपके पंजीकरण चयन के लिए डिफ़ॉल्ट होगी।
  • आप अपने अनुरोधित ऐतिहासिक डेटा को अपडेट कर सकते हैं, अपने खाते में लॉग इन करके, पंजीकरण प्रबंधित करें> संपादित करें> पर नेविगेट करके और "कितने ऐतिहासिक डेटा का अनुरोध किया गया है" लेबल वाले ड्रॉपडाउन से चयन करके।
  • कृपया ध्यान दें कि ऐतिहासिक अनुरोध में प्रदान किया गया डेटा उस तारीख से शुरू होगा जब ग्राहक प्राधिकरण बनाता है, जैसा कि आपके द्वारा एपीआई से अनुरोध करने की तारीख के विपरीत है।

नोट: आपके अनुरोधित ऐतिहासिक डेटा में परिवर्तन केवल नए ग्राहक प्राधिकरणों को प्रभावित करते हैं, जबकि पिछले ग्राहक प्राधिकरण प्राधिकरण प्राधिकरण के समय आपके चयन को प्रतिबिंबित करेंगे।

  • ESPI मानक के अनुसार, प्रतिक्रिया एटम प्रकाशन मानक का उपयोग करती है। कृपया उपलब्ध डेटा तत्वों के साथ समर्थित एपीआई की पूरी सूची देखने के लिए नीचे दिए गए लिंक का चयन करें।

डेटा एक्सेस के बारे में अधिक जानकारी प्राप्त करें

  • PG&E द्वारा स्थापित और पढ़े गए सक्रिय इलेक्ट्रिक और गैस सेवा आईडी मेरे डेटा साझा करें प्लेटफॉर्म के माध्यम से प्राधिकरण के लिए पात्र हैं।
  • यदि प्राधिकरण से जुड़ी सेवा आईडी निम्नलिखित कारणों में से किसी एक के कारण बदलती है, तो प्राधिकरण नई सेवा आईडी में संक्रमण करेगा और ऐतिहासिक अंतराल उपयोग डेटा तक पहुंच जारी रहेगी:
    • भुगतान न होने के कारण अस्थायी बंद
    • अंतराल बिलिंग पर जाएं
    • मीटर का आदान-प्रदान
    • दर परिवर्तन
  • अन्य परिदृश्य जिनके परिणामस्वरूप सेवा आईडी में परिवर्तन होता है जैसे कि चलती स्थान या कंपनी का परिवर्तन पहुंच को समाप्त कर देगा। इसके अलावा, यदि कोई खाता आपके My Energy खाते से अनलिंक किया गया है, तो इसके परिणामस्वरूप मेरे डेटा को साझा करें के माध्यम से अधिकृत सभी अंतर्निहित सेवा आईडी अनधिकृत होंगी।

  • अधिकृत अंतराल डेटा की दानेदारता को निर्धारित करने के लिए, कृपया ESPI मानक द्वारा प्रदान किए गए अंतराल लंबाई तत्व का संदर्भ लें।
  • PG&E बिलिंग उद्देश्यों के लिए एकत्र किए गए समान दानेदारता पर अंतराल उपयोग डेटा प्रदान कर रहा है, जो आमतौर पर बिजली के डेटा के लिए प्रति घंटा या 15 मिनट के आधार पर और अंतराल मीटर वाले उन ग्राहकों के लिए गैस डेटा के लिए दैनिक होता है। जबकि यह ग्राहक द्वारा भिन्न हो सकता है, इलेक्ट्रिक अंतराल मीटर का उपयोग आमतौर पर अधिकांश आवासीय ग्राहकों के लिए प्रति घंटा स्तर पर और अधिकांश वाणिज्यिक ग्राहकों के लिए 15 मिनट के अंतराल स्तर पर उपलब्ध होता है, और गैस अंतराल मीटर का उपयोग आमतौर पर अधिकांश ग्राहकों के लिए दैनिक स्तर पर उपलब्ध होता है।
  • गैर-अंतरीय मीटरों के लिए, उपलब्ध होने पर डेटा प्रदान किया जाएगा।

  • स्मार्ट मीटर स्थापित करने वाले अधिकांश PG&E ग्राहकों के लिए, बिजली और गैस अंतराल उपयोग डेटा अगले दिन के अंत तक Share My Data प्लेटफ़ॉर्म के माध्यम से उपलब्ध है।
  • बिजली लाइन वाहक आधारित MV90 मीटर स्थापित के साथ PG&E इलेक्ट्रिक ग्राहकों के छोटे हिस्से को डेटा उपलब्ध होने के लिए अतिरिक्त समय की आवश्यकता हो सकती है।

  • हालांकि हम आपके एपीआई के सेटअप का सीधे समर्थन नहीं कर सकते हैं, हमारे पास विकास प्रक्रिया में आपके आईटी और तकनीकी संसाधनों की सहायता के लिए कई संसाधन उपलब्ध हैं। अधिक जानने के लिए कृपया हमारे एपीआई प्रलेखन पृष्ठ का संदर्भ लें। कृपया किसी भी अतिरिक्त प्रश्न के साथShareMyData@pge.com से संपर्क करने में संकोच न करें।

अधिक जानकारी के लिए, एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस (API) पर जाएं

SmartMeter पर अधिक

हमसे संपर्क करें

यदि आपके कोई प्रश्न या टिप्पणियां हैं, तो कृपया हमारी टीम कोShareMyData@pge.com पर ईमेल करें।

उपकरण विक्रेता

होम एरिया नेटवर्क (HAN) डिवाइस विक्रेताओं के लिए जानकारी।

SmartMeter को पढ़ना

स्मार्टमीटर डिस्प्ले एक तीर दिखाता है जो इंगित करता है कि आप ऊर्जा का उपयोग कर रहे हैं या निर्यात कर रहे हैं।