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

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

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

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

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

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

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

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

• अनिवार्य अनुरोध पैरामीटर:
  • क्लाइंट_id = आपके शेयर मेरा डेटा पंजीकरण मील के पत्थर (यानी, क्लाइंट_id/क्लाइंट_secret जोड़ी) से क्लाइंट आईडी।
  • रीडायरेक्ट_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रजिस्‍कृत ऐतिहासिक लंबाई}};AcCocountCollection={तततततततत}=BRit_Tit_Pitit_Pit_Pitit_Pit_Pit=Pit_Pit_Pit_Pit_Pin_Pin_Pin_Pululddddddd=200000000000000000000_

नोट: प्राधिकरण कोड अल्पकालिक है (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 पर लागू किया जाए।

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

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

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

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

<प्रतिक्रिया xmlns="://एपीआई.पेज.com/datacustodian/oth/v2/token">
774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
98c665444b-445-f4
444_ff____13330__fccc____1330__1330__1330_ff_1300__fff_1330_fff_1300__1300_feccc__1_1__13scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_470AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;अंतराल अवधि=900_3600;ब्लॉकड्यूरेशन = दैनिक;इतिहासलंबाई={3P पंजीकृत ऐतिहासिक लंबाई};खाता संग्रह ={अधिकृत SAs की संख्या};BR={ThirdPartyID};डेटाग्राहक आईडी=PGE
संसाधनयूआरआई:{संसाधनURI} जैसे: https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Subscription/{सब्सक्रिप्शनआईडी}
प्राधिकरणयूआरआई:{प्राधिकरणURI} जैसे: https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
ग्राहकसंसाधन:{ग्राहकसंसाधनURI} जैसे:https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/}
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= रीफ्रेश_टोकन और रिफ्रेश_टोकन={current_reresh_token}

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

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

एक सफल प्रतिक्रिया इस तरह दिखाई देगी:
{
"एक्सेस_टोकन": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"token_type": "बियरर",
"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_
ProgramEnrollment;अंतराल अवधि=900_3600;ब्लॉकड्यूरेशन = दैनिक;इतिहासलंबाई={3P पंजीकृत ऐतिहासिक लंबाई};खाता संग्रह ={अधिकृत SAs की संख्या};BR={ThirdPartyID};डेटासंरक्षक आईडी=पीजीई",
"संसाधनURI": https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test”,
"प्राधिकरणURI": https://एपीआई.पेज.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 ऑपरेशन) को कॉल कर सकते हैं।
• वैकल्पिक रूप से, आप तृतीय पक्ष पोर्टल के माध्यम से अपने साझा मेरा डेटा खाते में लॉग इन करके और उस प्राधिकरण के लिए सदस्यता आईडी दर्ज करके एक प्राधिकरण को मैन्युअल रूप से रद्द कर सकते हैं जिसे आप रद्द करना चाहते हैं।

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

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

कृपया एक्सेस टोकन, क्लाइंट एक्सेस टोकन और डेटा अनुरोधों में उपयोग किए जाने वाले उनके संबंधित ताज़ा टोकन के टोकन जीवनकाल को ध्यान में रखें। सर्वोत्तम अभ्यास के अनुसार, एक्सेस टोकन एक अल्पकालिक टोकन (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}

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

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

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

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

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

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/{सदस्यताID}?सहसंबंधID={सहसंबंधID}

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

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

उदाहरण बैच बल्क अनुरोध 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 करें। इसमें अनुरोधित अवधि के लिए अंतराल उपयोग डेटा () के साथ-साथ बिल जानकारी () दोनों शामिल होंगे।

20 मार्च, 2023

नया क्या है:

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

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

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

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

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

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

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

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

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

   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 के Share My Data ग्राहक डैशबोर्ड में सुधार करना ताकि ग्राहकों के लिए तृतीय पक्षों के साथ अपने सभी मौजूदा डेटा साझाकरण प्राधिकरणों को देखना आसान हो सके।

27 सितंबर, 2018

क्या नया है:

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

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

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

गुणवत्ता
ऊर्जा शक्ति
को कम
करें

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="://एपीआई.पेज.com/datacustodian/oth/v2/token">
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     98c665444b-445-f4
     444_ff____13330__fccc____1330__1330__1330_ff_1300__fff_1330_fff_1300__1300_feccc__1_1__13scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_470AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;अंतराल अवधि=900_3600;ब्लॉकड्यूरेशन = दैनिक;इतिहासलंबाई={3P पंजीकृत ऐतिहासिक लंबाई};खाता संग्रह ={अधिकृत SAs की संख्या};BR={ThirdPartyID};डेटाग्राहक आईडी=PGE
     संसाधनयूआरआई:{संसाधनURI} जैसे: https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Subscription/{सब्सक्रिप्शनआईडी}
     प्राधिकरणयूआरआई:{प्राधिकरणURI} जैसे: https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     ग्राहकसंसाधन:{ग्राहकसंसाधनURI} जैसे:https://एपीआई.पेज.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/}
     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, 49 KB)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. API अनुरोध जो दिनांक पैरामीटर (जैसे, बैच अनुरोध) को स्वीकार करते हैं, उन्हें Zulu डेटा पैरामीटर (जैसे, प्रकाशित-अधिकतम/प्रकाशित-मिनट) का उपयोग करना चाहिए। एपीआई अनुरोधों में तिथि मापदंडों के लिए अन्य तिथि प्रारूप समर्थित नहीं होंगे।
   • दिनांक मापदंडों को स्वीकार करने वाले एपीआई संलग्न, समर्थित एपीआई.xlsx के अनुसार प्रलेखित हैं
3. अंतराल TOU संकेतकों में अंतराल मीटर वाले विद्युत उपयोग डेटा शामिल हैं (जैसा लागू हो, इस बात का संकेतक कि प्रत्येक अंतराल किस TOU अवधि से मेल खाता है)
   • कृपया स्थैतिक प्रोग्राम आईडी मैपिंग का संदर्भ दें जिसमें बताया गया हो कि प्रत्येक अंतराल TOU गणना किस से मेल खाती है (उदाहरण के लिए, 1 = समर पीक आदि)। (देखें संलग्न,समर्थित डेटा तत्व.xlsx)
4. क्लाइंट_id जैसा कि डेटा में पाया गया हैग्राहकScopeSelectionScreenURI (जिसे तीसरे पक्ष ने ओएथ शुरू किया) और आवेदन सूचना संसाधन में प्रदान किया है, पंजीकरण परीक्षण के दौरान तीसरे पक्ष के अनुरोध को 5 अंकों में अपडेट किया जा रहा है यदि यह पहले से नहीं है (उदाहरण के लिए, अग्रणी शून्य जोड़ना आदि)। इसके अलावा, यूआरएल में अंत में '&verified=true' शामिल नहीं है। तीसरे पक्ष को तदनुसार अपने URL अपडेट करने की आवश्यकता होगी।
   • विस्तृत करने के लिए, डेटा अभिरक्षकस्कोप चयनस्क्रीनयूआरआई निम्नानुसार दिखता है: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX क्लाइंटआईडी है)
   • तो 123 का एक वर्तमान क्लाइंटआईडी 00123 की तरह कुछ में बदल जाएगा जिसका अर्थ है कि उनका नया डेटा संरक्षकScopeSelectionScreenURI निम्नानुसार होगा:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (पुराना URL निम्नानुसार है: 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 के अनुसार हैं। नोट: XSD पीछे की ओर संगत हैं:
     • espiDerived.xsd (अंतर्स्थ उपयोग और बिलिंग जानकारी)
     • खुदरा ग्राहक.xsd (ग्राहक की जानकारी)

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

18 दिसंबर, 2015

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

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

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

1. स्व-पहुंच उपयोगकर्ताओं के पास अपने एसएसएल प्रमाणपत्रों को स्वचालित रूप से बदलने / अपडेट करने की क्षमता होगी जो उन्होंने मूल रूप से पंजीकरण के दौरान प्रदान किए थे (जैसे, जब प्रमाणन समाप्ति के करीब होता है) पंजीकरण का प्रबंधन > संपादन > नया अनुभाग: SSL प्रमाणपत्र जानकारी (अपडेट विकल्प)
2. अधिकृत बुनियादी बिलिंग जानकारी, ग्राहक जानकारी और गैस डेटा को शामिल करने के लिए स्व एक्सेस उपयोगकर्ता पंजीकरण को अपडेट किया जाएगा। गैर-अंतर्स्थ मीटर सेवा समझौतों के रूप में दोनों अंतराल मीटर वाले एस्वेल SMD 2.0 के लिए (स्वयं) प्राधिकरण के लिए पात्र होंगे नए उपलब्ध डेटा तत्वों का एक उच्च स्तरीय सारांश निम्नानुसार है:
   • बिलिंग जानकारी: (अंतर्कालीन और गैर-अंतर्कालीन मीटर वाले SAs दोनों के लिए)
     • दर अनुसूची, बिलिंग $ योग, श्रेणीबद्ध उपयोग (जैसा लागू हो), मांग (जैसा लागू हो), TOU योग (जैसा लागू हो)
     • नोट: अधिकृत गैर-अंतर्स्थ मीटर वाले ग्राहकों के लिए, तृतीय पक्ष केवल बिलिंग उपयोग योग (यानी, उपयोग सारांश में) प्राप्त करेंगे और कोई अंतराल उपयोग नहीं पढ़ता है (जैसे, प्रति घंटा/दैनिक पढ़ता है क्योंकि वे उपलब्ध नहीं हैं)
   • ग्राहक की जानकारी: (अंतर और गैर-अंतरीय मीटर वाले SAs दोनों के लिए)
     • ग्राहक का नाम, सेवा पता, खाता ID, सेवा अनुबंध ID, सेवा अनुबंध सेवा प्रारंभ तिथि,
   • अंतराल गैस उपयोग डेटा: (केवल अंतराल मीटर गैस SAs)
     • अंतराल (यानी, दैनिक) गैस पढ़ता है
   • नए डेटा तत्वों को संलग्न डेटा तत्वों.xlsx के अनुसार आरेखित किया गया है
   • संबद्ध संबंधपरक डेटा पदानुक्रम संलग्न, PGE ESPI डेटा मॉडल.xlsx में उल्लिखित है
   • इन नए डेटा तत्वों के लिए उपयोग की जाने वाली नवीनतम ESPI xml स्कीमा परिभाषाएं (XSDs) संलग्न XSDs के अनुसार हैं। नोट: XSD पीछे की ओर संगत हैं:
     • 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 को उस अवधि के बारे में बताने के लिए भेजता है जिसके लिए वे डेटा का अनुरोध कर रहे हैं। हम निम्नलिखित परिदृश्यों के लिए अनुरोधों को संभालने के लिए एक बदलाव लागू कर रहे हैं:
   • प्रकाशित-माइन और प्रकाशित-अधिकतम मूल्य गायब हैं
   • प्रकाशित-माइन और प्रकाशित-अधिकतम मूल्य UTC में हैं
   • प्रकाशित-मिन और प्रकाशित-अधिकतम मूल्य युग के सेकंड में हैं
   यदि पैरामीटर गायब हैं, तो PG&E डिफ़ॉल्ट तिथियों को वापस कर देगा, जैसा कि त्रुटि संदेशों के विपरीत है जैसा कि इस परिवर्तन से पहले लौटाया गया है। डिफ़ॉल्ट, हमारे मामले में, तारीख T-2 के लिए एक दिन का डेटा है। यदि पैरामीटर मौजूद हैं और सही ढंग से स्वरूपित हैं, तो हम मापदंडों का सम्मान करना जारी रखेंगे।
2. प्राधिकरण xml में तिथियों के लिए तय
   करें वर्तमान में प्राधिकरण xml में हमने प्रकाशित तिथि और प्राधिकरण तिथि साझा की है। ये तिथियां मिलीसेकंड में सेकंड के विपरीत हैं जो मानक है। हम इसे मिलीसेकंड के बजाय युग सेकंड में वापस भेजने के लिए ठीक कर रहे हैं।
3. गलत XML / संसाधन / सदस्यता /{id} / उपयोग बिंदु /{id} / मीटर रीडिंग /{id} / इंटरवलब्लॉक के लिए लौटाया
   गया वर्तमान में हम उपरोक्त संसाधन स्तर GET के लिए गलत प्रतिक्रिया वापस कर रहे हैं जहां XML की संरचना गलत है और हम 24 घंटे की अवधि के लिए एक एकल अंतराल ब्लॉक बनाने के बजाय प्रत्येक अंतराल के लिए प्रविष्टियों को दोहरा रहे हैं।
   
   यह तय किया जा रहा है और 24 अंतराल ब्लॉक के लिए केवल एक अंतराल ब्लॉक वापस किया जाएगा।

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

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

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

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

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

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

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

• मेरा डेटा साझा करें कार्यक्रम के माध्यम से अपना डेटा साझा करने में भाग लेने में रुचि रखने वाले ग्राहकों को मेरी ऊर्जा खाते के लिए पंजीकरण करने के लिए अत्यधिक प्रोत्साहित किया जाता है। यह पूरी प्रक्रिया को और अधिक कुशल बना देगा और उन्हें अपने प्राधिकरणों को ऑनलाइन प्रबंधित करने की क्षमता भी देगा।
• ग्राहक प्राधिकरण प्रक्रिया के दौरान मेरे ऊर्जा खाते के लिए साइन अप कर सकते हैं।
• ग्राहकों को ऑनलाइन मेरा डेटा साझा करें प्राधिकरण फॉर्म प्राप्त करने और ईमेल के माध्यम से पूरा किया गया फॉर्म जमा करने के लिए एक मैनुअल प्रक्रिया उपलब्ध है।
• मैनुअल प्रक्रिया के बारे में अधिक जानकारी के लिए, कृपया हमसे 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 प्रमाणपत्र डाउनलोड कर पाएंगे।

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

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

• 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 (PDF) के अनुलग्नक D
  अधिक जानकारी प्राप्त करें:कैलिफोर्निया सिविल कोड अनुभाग 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) पर जाएँ