Share My Data para sa mga third party

Upang makasunod sa kasalukuyang pamantayan ng North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) para sa awtorisasyon, ipinatupad ng PG&E ang OAuth 2.0 Authorization framework para sa pagpapahintulot sa pag-access ng data. Ang diagram sa ibaba ay naglalarawan kung paano sinisimulan ng mga customer ang pahintulot, pumili ng mga parameter ng saklaw at pagkatapos ay isumite ang kanilang awtorisasyon.

Karagdagang sangguniang materyal na lampas sa impormasyon sa ibaba:

I-download ang ESPI OAuth 2.0 Sequence Diagram (PDF, 193 KB)
Tingnan ang Green Button data SDK sa Github

Tandaan: Para sa Community Choice Aggregators, ang client_access_token lang ang kailangan para humiling ng data (sa pamamagitan ng 2-Legged OAuth) at hindi nalalapat ang sumusunod.

Authorizations na sinimulan sa third party site

Upang magsimula ng awtorisasyon mula sa isang third party na site tulad ng inilalarawan sa unang diagram sa itaas, ang isang kahilingan sa authorization code ay ginawa sa pamamagitan ng pag-redirect ng browser ng customer mula sa iyong third party na site patungo sa AuthorizationServer Authorization Endpoint URL ng PG&E na may naaangkop na mga parameter ng kahilingan tulad ng halimbawa sa ibaba. Sa pag-redirect, ipapakita sa customer ang isang PG&E log-in page para sa authentication, na sinusundan ng authorization page para sa pagpapahintulot sa pag-access ng data sa iyong third party:

authorizationServerAuthorizationEndpoint URI (na may mga parameter ng kahilingan)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• Mandatory Request Parameter:
  • client_id = Client ID mula sa iyong mga milestone sa pagpaparehistro ng Share My Data (ibig sabihin, client_id/client_secret pares).
  • redirect_uri = redirect URL na iyong tinukoy sa iyong Share My Data registration (dapat tumugma ang mga URL).
    Tandaan: Inirerekomenda namin ang pag-encode ng URL na ilapat sa redirect_uri gaya ng bawat halimbawa sa ibaba.
  • response_type = code (static na halaga)
• (Mga) Opsyonal na Parameter ng Kahilingan:
  • state = opsyonal na opaque na parameter ng estado gaya ng pinapayagan ng OAuth 2.0 standard na ibinalik kasama ang authorization code upang makatulong na mapanatili ang estado. Halimbawa, ang parameter ng estado ay maaaring gamitin ng isang third party upang natatanging tukuyin ang pinagmulan ng customer at upang maiwasan ang cross-site na pamemeke.
  • login={guest} Magbigay ng opsyon para sa isang third party na i-redirect ang mga customer sa alinman sa PG&E's My Energy log‐in o sa tab na Guest Access bilang bahagi ng online na daloy ng awtorisasyon.

HALIMBAWA: Kahilingan ng auth code

GET: https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri=https%3A%2F%2Fthirdparty.com%2FredirectUrl&response_type=code&state=pge12advertisement

Tandaan: ang halimbawang redirect_uri na parameter sa itaas ay may URL encoding na inilapat (ibig sabihin, URL encoding ng https://thirdparty.com/redirectUrl)

Kung gumawa ka ng wastong kahilingan tulad ng nasa itaas, at matagumpay na na-authenticate at pinahihintulutan ng customer, pagkatapos ay ire-redirect ang customer sa iyong redirect_uri kasama ang authorization code, (awtorisadong) parameter ng saklaw, at opsyonal na parameter ng estado (kung ibinigay bilang bahagi ng kahilingan sa awtorisasyon ) gaya ng halimbawa sa ibaba:

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_39_ 30_6_37_ 38_1_4 AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Araw-araw;HistoryLength={3P Registered historical length};AccountCollection ={count of authorizedSAs};BR={ThirdPartyID};dataCustodianId=PGE &state=pge12advertisement

Tandaan: Ang Authorization Code ay panandalian (mag-e-expire sa loob ng 600 segundo), at dapat na pagkatapos ay palitan para sa isang access token/refresh token pares upang makumpleto ang awtorisasyon at bigyang-daan ang on-going data access. Tingnan ang susunod na seksyon (Seksyon 2) para sa mga detalye sa kahilingan ng Access Token/ Refresh Token.

Ang (awtorisadong) parameter ng saklaw na halimbawa sa itaas ay ibinalik bilang bahagi ng mga tugon sa Kahilingan ng Authorization Code, ang Access Token Request, pati na rin ang Authorization API. Nagbibigay-daan ang parameter ng saklaw na ito para sa pakikipag-ugnayan sa panghuling saklaw ng awtorisasyon ng customer. Sa partikular, ang parameter ng saklaw ay may kasamang value na "AdditionalScope" na nagmamapa sa mga pinili ng PG&E na sinusuportahan ng awtorisasyon ng customer ng mga pangkat ng data (hal., "Paggamit", "Pagsingil", "Basic", "Account", "Pagpapatala ng Programa"). Ang mga value ng parameter ng saklaw ay higit pang kinukunan ayon sa sumusunod na reference na dokumentasyon: Download Supported Function Block Scope String Mapping Click Thru 2.0 (PDF, 222 KB) .

Error Scenario

: Kung ang mga kinakailangang parameter ng kahilingan ng client_id o redirect_uri ay hindi wasto o nawawala kapag humiling ng authorization code, ipapakita sa customer ang isang paliwanag na mensahe kasama ang karaniwang HTTP 400 series na error. Sa katulad na paraan, kung nawawala o hindi wasto ang kinakailangang parameter ng kahilingan ng response_type, ire-redirect ang customer pabalik sa iyong redirect_uri na may tinukoy na parameter ng error na "invalid_request" ng OAuth 2.0 pati na rin ang opsyonal na parameter ng estado kung unang ibinigay bilang bahagi ng orihinal na awtorisasyon kahilingan sa code.

na Customer na Tinatanggihan na Magpapahintulot: Sa pagre-redirect ng isang third party sa isang customer na pahintulutan sa PG&E, ang isang customer ay may opsyon na tanggihan sa pamamagitan ng isang "kanselahin" na button sa parehong pahina ng pag-log-in at pahina ng awtorisasyon. Sa ganitong mga pagkakataon, ire-redirect ang customer pabalik sa iyong redirect_uri na may tinukoy na parameter ng error na "access_denied" ng OAuth 2.0 na nakadugtong upang isaad na tinanggihan ng customer na pahintulutan. Bilang karagdagan, ang opsyonal na parameter ng estado ay ibabalik kung unang ibinigay bilang bahagi ng orihinal na kahilingan sa authorization code.

Mga Awtorisasyon na Pinasimulan sa PG&E

Kapag nagsimula ang mga customer sa web portal ng customer ng PG&E, "Your Account," at pagkatapos ay mag-navigate sa landing page ng Share My Data, bibigyan sila ng dropdown ng mga nakarehistro at nakikitang third party. Gaya ng inilalarawan sa ikalawang diagram sa itaas, kapag ang isang customer ay pumili ng isang third party mula sa listahan ng mga nakarehistrong third party at piliin ang "Next," ang customer ay ire-redirect sa third party na nakarehistrong "Third Party Portal URI," kung saan ang mga customer maaaring magpatuloy sa pinasimulan ng third-party na proseso ng OAuth na inilarawan sa naunang seksyon.

Tandaan: Ang ilang mga third party ay nagtanong tungkol sa kung paano i-streamline ang karanasan ng customer para sa kaso ng paggamit na ito (ibig sabihin, mga awtorisasyon na sinimulan sa site ng PG&E) upang ang customer ay lumilitaw na sila ay direktang dinadala sa isang pahina ng pahintulot sa pagpili ng isang third party mula sa ang dropdown. Upang mapadali ang ganoong karanasan ng customer, maaaring piliin ng mga third party na itakda ang kanilang "Third Party Portal URI" (sa pamamagitan ng pahina ng pagpaparehistro ng Pamahalaan ang Share My Data) sa isang endpoint na awtomatikong nagre-redirect sa customer pabalik sa PG&E bilang bahagi ng kahilingan sa authorization code. Sa awtomatikong pag-redirect pabalik sa Endpoint ng Awtorisasyon ng Server ng awtorisasyon ng PG&E, lalaktawan ng customer ang pahina ng pag-login ng customer (dahil naka-log in na sila) at direktang pupunta sa pahina ng awtorisasyon. Para sa ilang mga third party na nagparehistro bago ang Ibahagi ang Aking Data Click Thru 2.0 na release noong huling bahagi ng Hunyo ng 2018, ito ay maaaring magawa sa pamamagitan lamang ng pagtukoy sa Third Party Portal URI na katumbas ng hindi na ginagamit na "Third Party Scope Selection Screen" na URI (patlang na ireretiro sa hinaharap na release).

Sa kabaligtaran, maaaring gusto ng ilang third party na makipag-ugnayan muna at mag-screen ng mga customer sa kanilang panig kapag ang mga customer ay na-redirect sa kanilang "Third Party Portal" URI bago humiling ng authorization code, kaya ang diskarte sa itaas ay isang mungkahi lamang.

Upang makakuha ng Access Token, gamitin ang Authorization Code na natanggap at tawagan ang endpoint sa ibaba na may mga parameter ng kahilingan tulad ng inilarawan sa ibaba. Gaya ng inilarawan sa itaas, ang Authorization Code ay maikli ang buhay, na mag-e-expire pagkalipas ng 10 minuto (600 segundo), kaya pakitiyak na ang Access Token ay agad na hinihiling sa pagtanggap ng Authorization Code.

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

• Mandatory Request Parameter:
  • grant_type = authorization_code (static na halaga)
  • code = authorization code na natanggap bilang tugon sa authorization code request
  • redirect_uri = redirect URL na iyong tinukoy sa iyong Share My Data registration (dapat tumugma ang mga URL).
    Tandaan: Tulad ng kahilingan sa authorization code, inirerekomenda namin ang pag-encode ng URL na ilapat sa redirect_uri.

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

Magdagdag ng pangunahing parameter ng Authorization header na may Base64 encoding na inilapat na "clientID:clientSecret"

Tandaan: Ang mga value ng clientId:clientSecret ay tumutugma sa mga value ng clientID na ibinigay sa iyong mga milestone sa pagpaparehistro ng Share My Data.
Ang parameter ng header ay nasa sumusunod na format:
Param name : Authorization
Param value : Basic "base64encoded string"

Ang isang matagumpay na tugon ay magiging ganito:

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_4_5_1_4; Saklaw=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Araw-araw;HistoryLength={3P Nakarehistrong haba ng kasaysayan};AccountCollection ={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} hal: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{ subscriptionID}
authorizationURI:{AuthorizationURI} hal: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerResourceURI:{customerResourceURI} hal:https://api.pge.com /GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Tandaan: Ang Access Token ay mag-e-expire sa loob ng 3600 segundo (1 oras), habang ang kaukulang Refresh Token ay mag-e-expire sa loob ng 1 taon. Tingnan ang susunod na seksyon 3 para sa mga detalye sa pagkuha ng bagong Access Token/Refresh Token na pares.

I-save ang access at i-refresh ang pares ng token.
Upang humiling ng paunang makasaysayang data at patuloy na pang-araw-araw na data, bisitahin ang data access .

Ayon sa pinakamahusay na kasanayan, ang Access Token ay isang panandaliang token (1 oras) habang ang katumbas na Refresh Token ay isang pangmatagalang token (1 taon) na magagamit mo upang makakuha ng bagong Access Token/Refresh Token na pares kapag ang Mag-e-expire ang Access Token. Upang makakuha ng bagong Access Token at Refresh Token na pares para sa mga kasalukuyang hindi nag-expire na awtorisasyon, gamitin ang "kasalukuyang Refresh Token" at tawagan ang endpoint sa ibaba na may mga parameter tulad ng inilarawan sa ibaba.

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

EXAMPLE: Refresh Token request
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Magdagdag ng pangunahing parameter ng Authorization header na may Base64 encoding na inilapat na "clientID:clientSecret"

Tandaan: Ang mga value ng clientId:clientSecret ay tumutugma sa mga value ng clientID na ibinigay sa iyong mga milestone sa pagpaparehistro ng Share My Data.
Ang parameter ng header ay nasa sumusunod na format:
Param name : Authorization
Param value : Basic "base64encoded string"

Ang isang matagumpay na tugon ay magiging ganito:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"token_type": "bearer",
"expires_in": 3600,
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"scope": "scope = fb = 1_3_8_13_14_18_19_31_32_35_37 10_15_16_46_47; karagdaganScope = paggamit_billing_basic_account_
programenrollment; intervalduration = 900_3600 ;BlockDuration=Araw-araw;HistoryLength={3P Registered historical length};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
"resourceURI": "https://api.pge.com/ GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
"authorizationURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

Tandaan: Katulad nito, ang Client Access Token ay isang panandaliang token (1 oras) habang ang katumbas nitong Refresh Token ay isang long-lived token (1 taon) na maaari mong gamitin upang makakuha ng bagong pares ng Client Access Token/Refresh Token kapag nag-expire ang Client Access Token. Upang makakuha ng bagong pares ng Client Access Token/Refresh Token, sumangguni sa parehong mga hakbang na inilarawan sa itaas.

Customer ang kanilang mga pahintulot sa pamamagitan ng paggawa ng sumusunod:

• Pag-alis ng mga ID ng Serbisyo mula sa kanilang mga pahintulot
• Pagpapalawig ng petsa ng pagtatapos ng panahon ng awtorisasyon
• Pagkansela ng awtorisasyon

Tandaan: Ang mga customer ay makakagawa lamang ng mga pagbabago sa kanilang mga pahintulot sa pamamagitan ng pag-log in sa kanilang online na PG&E account at pagsunod sa mga kinakailangang hakbang. Kung isasagawa ang alinman sa mga aksyong ito, aabisuhan ka namin sa pamamagitan ng Notification URI na ibinigay mo sa panahon ng pagpaparehistro.

May mga opsyon para sa pamamahala at pagtingin sa mga detalye ng iyong mga awtorisasyon sa customer:

• Maaari mong tawagan ang authorization API (http GET operation) gamit ang iyong client_access_token alinman sa third party level (para sa mga detalye sa lahat ng pahintulot) sa https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization o sa ang antas ng awtorisasyon ng indibidwal na customer sa https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Hiwalay, maaari mo ring tingnan ang mga detalye ng indibidwal na awtorisasyon nang manu-mano sa pamamagitan ng pag-log in sa iyong Share My Data account sa pamamagitan ng third party portal at paglalagay ng Subscription ID para sa awtorisasyon na iyong hinahanap.

Kung hindi mo na gustong i-access ang data na nauugnay sa isang awtorisasyon, may mga opsyonal na paraan upang kanselahin ang isang awtorisasyon:

• Maaari mong tawagan ang authorization revocation API (http DELETE operation) gamit ang iyong client_access_token sa https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Bilang kahalili, maaari mong manu-manong kanselahin ang isang awtorisasyon sa pamamagitan ng pag-log in sa iyong Share My Data account sa pamamagitan ng third party portal at paglalagay ng Subscription ID para sa awtorisasyon na gusto mong kanselahin.

Tandaan: Aabisuhan ang customer na pinili mong kanselahin ang kanilang awtorisasyon. Bilang karagdagan, kapag nakansela ang isang awtorisasyon, hindi na mababaligtad ang aksyon.

• PG&E ng mga notification sa iyong notification URI na ibinigay sa panahon ng pagpaparehistro. Notifications ay binubuo ng mga URI na tumutugma sa naka-prepack na data na handa para sa iyo na bumalik at humiling sa mga ibinigay na URL. Data at ipinapadala ang mga notification sa sumusunod na dalawang senaryo: (1) pinili mo ang "Abisuhan ako bilang handa na ang data" sa iyong profile sa pagpaparehistro, kung saan ipapakete namin ang pinakabagong pang-araw-araw na data ng anumang mga pagwawasto para sa nakaraan petsa, o (2) gumawa ka ng mas naunang ad hoc asynchronous na kahilingan kung saan handa na ang hiniling na data.
• Scenario 1 ay inilalarawan sa ilalim ng "DATA ACCESS: PANG-ARAW-ARAW NA SUBSCRIPTION" na seksyon ng mga diagram ng Data Access Methods sa ibaba at ang Scenario 2 ay inilalarawan sa ilalim ng "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" na seksyon ng parehong mga diagram sa ibaba.

Pakitandaan ang haba ng buhay ng token ng Access Token, Client Access Token, at ang kanilang mga katumbas na Refresh Token na ginamit sa mga kahilingan sa data. Ayon sa pinakamahusay na kasanayan, ang Access Token ay isang panandaliang token (1 oras) habang ang refresh token ay isang pangmatagalang token (1 taon) na magagamit mo upang makakuha ng bagong Access Token/Refresh Token na pares kapag ang Access Mag-e-expire ang token. Sa katulad na paraan, ang Client Access Token ay isang panandaliang token (1 oras) habang ang katumbas nitong Refresh Token ay isang long-lived token (1 taon) na magagamit mo upang makakuha ng bagong Client Access Token/Refresh Token na pares kapag ang Client Mag-e-expire ang Access Token. Para sa higit pang mga detalye sa pagkuha ng bagong pares ng token, sumangguni sa Hakbang 3, Paghiling ng bagong access token, sa aming tab na mga detalye ng pahintulot.  Pumunta sa mga detalye ng awtorisasyon

Kung ikaw ay pinahintulutan ng customer na makatanggap ng alinman sa "Account Information" (Account ID, Service Agreement ID at mga petsa ng pagsisimula ng serbisyo) at/o "Basic Information" (ibig sabihin, pangalan ng customer at address ng serbisyo), maaari kang humiling ng naturang impormasyon ng customer sa pamamagitan ng tinukoy ng ESPI na mga RetailCustomer API kung saan ang data ay sumusunod sa schema, retailCustomer.xsd, na ibinigay sa itaas.

Synchronous (Standard at EEF third party)

Isang paraan upang humiling ng data ng customer ay ang paggamit ng kasabay na API para sa paghiling ng impormasyon ng customer para sa isang awtorisasyon ng customer para sa data ng customer (ibig sabihin, Retail Customer):

na Kasabay na URL ng Kahilingan: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID na natanggap mo sa dulo ng OAuth authorization sequence para makakuha ng access token. Ang RetailCustomerID ay bahagi ng parameter ng path ng customerResourceUri sa tugon ng token. (RetailCustomerID=SubscriptionID)

HTTP Header = Authorization:Bearer {access token for this authorization}

Response = babalik ka ng data nang sabay-sabay para sa RetailCustomerID na iyon. Ang data ay umaayon sa retailCustomer.xsd

Tandaan: Ang synchronous na Retail Customer API ay nasa indibidwal na antas ng Retail Customer na tumutugma sa isang awtorisasyon ng customer.

Para sa sanggunian: ipinapakita ng hierarchical diagram sa ibaba ang hierarchy ng relasyon para sa mga elemento ng data ng ESPI sa pagmomodelo ng data ng customer ng PG&E.

Maaari ka ring humiling ng data ng customer sa pamamagitan ng asynchronous na API para sa paghiling ng impormasyon ng customer para sa lahat ng iyong mga awtorisasyon ng customer para sa data ng customer (ibig sabihin, Mga Retail Customer).

Upang suportahan ang mga Asynchronous na kahilingan, kakailanganin ng iyong aplikasyon na suportahan ang Mga Post Notification na ipapadala namin sa iyo (ayon sa Notification URL na iyong ibinigay sa panahon ng pagpaparehistro).

na URL ng Asynchronous na Kahilingan:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID na ibinigay sa ApplicationInformation Resource na nakuha sa panahon ng pagsubok sa pagpaparehistro. (BulkID=ClientID)

HTTP Header = Authorization:Bearer {client access token retrieve during registration testing}

Response = HTTP status code 202 (Isa itong asynchronous na kahilingan kung saan ipo-post ang tugon sa notification URL kapag handa na ang data). Kapag handa na ang data, magpo-POST kami ng notification sa iyong ibinigay na notification URI na may payload ng mga URL na maaaring ibalik ng iyong application para makuha ang pre-packaged. Sample post notification ay makikita sa ibaba

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID={correlationID}

Magsagawa ng GET sa URL sa itaas gamit ang Client Access token para makuha ang data.

Para sa sanggunian: ipinapakita ng hierarchical diagram sa ibaba ang hierarchy ng relasyon para sa mga elemento ng data ng ESPI sa pagmomodelo ng data ng customer ng PG&E.

Panghuli maaari mong makuha ang pinakabagong impormasyon ng customer araw-araw gamit ang pang-araw-araw na modelo ng subscription (ibig sabihin, sa pamamagitan ng pagpili sa checkbox na "Abisuhan ako bilang handa na ang data (araw-araw)" sa panahon ng pagpaparehistro).

Upang suportahan ang pang-araw-araw na modelo ng subscription, kakailanganin ng iyong aplikasyon na suportahan ang Mga Post Notification na ipapadala namin sa iyo (ayon sa URL ng Notification na iyong ibinigay sa panahon ng pagpaparehistro).

Kapag handa na ang data, mag-POST kami ng notification sa iyong ibinigay na URI ng notification na may payload ng mga URL na maaaring ibalik ng iyong application para makuha ang pre-packaged. Sample post notification ay ganito ang hitsura sa ibaba:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID={correlationID}

Magsagawa ng GET sa URL sa itaas gamit ang Client Access token para makuha ang data.

Para sa sanggunian, ipinapakita ng hierarchical diagram sa ibaba ang hierarchy ng relasyon para sa mga elemento ng data ng ESPI sa pagmomodelo ng data ng customer ng PG&E.

Kung pinahintulutan ka ng customer na makatanggap ng alinman sa "Impormasyon sa Paggamit" at/o "Impormasyon sa Pagsingil", maaari mong hilingin ang data na ito sa pamamagitan ng mga subscription API kung saan ang data ay sumusunod sa schema, espiDerived.xsd, na ibinigay sa itaas.

Kasabay na Mga Kahilingan sa Ad Hoc (Standard at EEF third party)

Upang humiling ng makasaysayang data (para sa data ng paggamit ng pagitan at data ng pagsingil), ang isang diskarte ay ang paggamit ng mga synchronous na API na may kasamang tamang mga parameter ng kahilingan sa petsa ng pagsisimula at pagtatapos sa oras ng Zulu.

na Kasabay na URL ng Kahilingan:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max= {endDate}

published-min = petsa ng pagsisimula na ilalapat sa kahilingang ito para sa pagkuha ng data. Ang petsa ay nasa oras ng Zulu ng yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 format)

published-max = petsa ng pagtatapos na ilalapat sa kahilingang ito para sa pagkuha ng data. Ang petsa ay nasa oras ng Zulu ng yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 format)

Tandaan: Para sa mga kahilingan sa API na tumatanggap ng mga parameter ng published-max at published-min-date, ang default ay T-1 (petsa ng kahilingan na binawasan ng 1 araw). Para sa mga kahilingan sa buod ng paggamit (hal., .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary) , iminumungkahi namin ang pagbibigay ng hanay ng 30 araw o higit pa para matiyak na mayroong available na bill na magkakapatong sa panahong iyon, kung hindi, walang ibabalik na data.

Subscription ID = SubscriptionID na natanggap mo sa dulo ng OAuth authorization sequence para makakuha ng access token. Ang subscription ID ay bahagi ng resourceURI parameter sa token response. (SubscriptionID=RetailCustomerID)

UsagePointID = UsagePoint sa ilalim ng subscription ID sa itaas. Makukuha mo ang lahat ng punto ng paggamit para sa isang partikular na Subscription sa pamamagitan ng pagtawag sa URL ng API sa ibaba at pagbibigay ng access token para sa subscription na iyon sa header ng awtorisasyon: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription /{SubscriptionID}/UsagePoint

HTTP Header = Authorization:Bearer {access token for this Subscription}

Response = babalik ka ng data nang sabay-sabay para sa punto ng paggamit na iyon para sa hiniling na panahon. Magkakaroon ito ng data ng paggamit ng pagitan () at data ng singil ().

Synchronous na usage API (tulad ng ipinahiwatig ng pagbuo ng URL na nagtatapos sa Usage Point ID) ay nasa indibidwal na antas ng Usage Point (ibig sabihin, antas ng Kasunduan sa Serbisyo), kaya iikot ng application ang mga kahilingan sa bawat isa sa mga Usage Point ID na kabilang sa isang binigyan ng pahintulot ng customer (ibig sabihin, subscription).

Ang tugon sa mga kasabay na kahilingan ay nagbabalik ng parehong data ng pagitan (sa ilalim) na nauugnay sa hanay ng petsa na hiniling pati na rin ang anumang buwanang mga kabuuan ng paggamit at mga singil na nag-overlap sa hiniling na hanay ng petsa (sa ilalim ng ).

• IntervalReading ay naglalaman ng interval (15-min/hourly) electric usage at interval (araw-araw) na data ng paggamit ng gas
• ay naglalaman ng mga buwanang kabuuan ng paggamit at mga detalye ng singil (kung pinahintulutan)

Sa loob ng tugon ay makikita mo ang mga elemento ng data na tumutugma sa aming talahanayan ng pagmamapa ng elemento ng data ng ESPI

Para sa sanggunian, ipinapakita ng hierarchical diagram sa ibaba ang hierarchy ng relasyon para sa mga elemento ng data ng ESPI sa pagmomodelo ng data ng customer ng PG&E.

Ang mga sumusunod ay ilang mahahalagang paglilinaw sa mga elemento ng data na ito:

• Intervalblock ay para sa 1 araw
• IntervalReading (sa ilalim ng Interval Block) ay naglalaman ng aktwal na 15-min/oras-oras na halaga ng paggamit ng kuryente at pang-araw-araw na halaga ng paggamit ng gas
• Para sa mga electric customer na may on-site generation (hal. Solar), ang flowDirection element ay nagpapahiwatig ng inihatid (supply) at natanggap (generation) na data ng paggamit. Para sa mga customer na may mga metrong naka-configure na basahin lamang ang net na paggamit (ibig sabihin, walang henerasyon sa site), ang elemento ng flowDirection ay nagpapahiwatig na ang paggamit ay isang netong halaga (pagkakaiba ng naihatid na bawas na natanggap):
  • Direksyon ng daloy ng 1 = naihatid (enerhiya na ibinibigay sa customer)
  • Direksyon ng daloy ng 19 = natanggap (net generation na dumadaloy pabalik sa PG&E grid). (Tandaan, ang mga halaga ay ganap)
  • Direksyon ng daloy ng 4 = net (naihatid minus – natanggap)
• Bigyang-pansin ang Power of ten multiplier at Unit of Measure (uom) upang matiyak ang tamang pagbabasa ng paggamit

Batch Subscription (Standard at EEF third party)

Maaari ka ring humiling ng data ng paggamit sa pamamagitan ng asynchronous na API para sa lahat ng Mga Puntos sa Paggamit na kabilang sa isang awtorisasyon ng customer para sa data ng paggamit/pagsingil (ibig sabihin, Subscription).

Upang suportahan ang mga kahilingan ng Ad Hoc Asynchronous (ibig sabihin, para sa higit sa isang Punto ng Paggamit sa isang pagkakataon), kakailanganin ng iyong aplikasyon na suportahan ang Mga Post Notification na ipapadala namin sa iyo (ayon sa URL ng Notification na iyong ibinigay sa panahon ng pagpaparehistro)

na URL ng Asynchronous na Kahilingan
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

Subscription ID = SubscriptionID na natanggap mo sa dulo ng OAuth sequence para makakuha ng access token. Ang subscription ID ay bahagi ng resourceURI parameter sa tugon ng token

published-min = petsa ng pagsisimula na ilalapat sa kahilingang ito para sa pagkuha ng data. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

published-max = petsa ng pagtatapos na ilalapat sa kahilingang ito para sa pagkuha ng data. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Authorization:Bearer {access token for this Subscription}

Response = HTTP status code 202 (ito ay isang asynchronous na kahilingan kung saan ipo-post ang tugon sa notification URL kapag handa na ang data)

Kapag handa na ang data, mag-POST kami ng notification sa iyong ibinigay na notification URI na may payload ng mga URL na maaaring ibalik ng iyong aplikasyon para makuha ang pre-packaged. Sample post notification ay makikita sa ibaba:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?correlationID={correlationID}

Magsagawa ng GET sa URL sa itaas na may Access token para makuha ang data. Maglalaman ito ng parehong data sa paggamit ng pagitan () gayundin ang impormasyon sa pagsingil () para sa hiniling na panahon.

Batch Subscription (Standard at EEF third party)
Maaari ka ring humiling ng impormasyon sa paggamit at pagsingil sa pamamagitan ng batch bulk asynchronous na API para sa lahat ng iyong mga awtorisasyon ng customer para sa data ng paggamit/pagsingil (ibig sabihin, Mga Subscription).

Halimbawa Batch Bulk Request URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate}

BulkID = BulkID na ibinigay sa ApplicationInformation Resource na nakuha sa panahon ng pagsubok sa pagpaparehistro. (BulkID=ClientID)

published-min = petsa ng pagsisimula na ilalapat sa kahilingang ito para sa pagkuha ng data. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

published-max = petsa ng pagtatapos na ilalapat sa kahilingang ito para sa pagkuha ng data. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Awtorisasyon: Tagadala {client access token}

Response = HTTP status code 202 (ito ay isang asynchronous na kahilingan kung saan ipo-post ang tugon sa notification URL kapag handa na ang data)

Kapag handa na ang data, magpo-POST kami ng notification sa iyong ibinigay na notification URI na may payload ng mga URL na maaaring ibalik ng iyong application para makuha ang pre-packaged. Sample post notification ay makikita sa ibaba:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID={correlationID}

Magsagawa ng GET sa URL sa itaas na may Access token para makuha ang data. Maglalaman ito ng parehong data ng paggamit ng pagitan () gayundin ang impormasyon sa pagsingil () para sa hiniling na panahon.

Panghuli makakakuha ka ng pinakabagong impormasyon sa paggamit at pagsingil kabilang ang mga pagwawasto para sa mga nakaraang petsa sa loob ng mga panahon ng awtorisasyon ng customer araw-araw gamit ang pang-araw-araw na modelo ng subscription (ibig sabihin, sa pamamagitan ng pagpili sa checkbox na "Abisuhan ako bilang handa na ang data (araw-araw)" sa panahon ng pagpaparehistro) .

Upang suportahan ang pang-araw-araw na modelo ng subscription, kakailanganin ng iyong aplikasyon na suportahan ang Mga Post Notification na ipapadala namin sa iyo (ayon sa URL ng Notification na iyong ibinigay sa panahon ng pagpaparehistro).

Kapag handa na ang data, magpo-POST kami ng notification sa iyong ibinigay na notification URI na may payload ng mga URL na maaaring ibalik ng iyong application para makuha ang pre-packaged. Sample post notification ay makikita sa ibaba:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID={correlationID}

Magsagawa ng GET sa itaas na URL na may Access token para makuha ang data. Maglalaman ito ng parehong data ng paggamit ng pagitan () gayundin ang impormasyon ng bill () para sa hiniling na panahon.

Marso 20, 2023

Ano ang bago:

1. Paglabas ng bagong API HTTP response code (204) para sa parehong mga synchronous at asynchronous na mga tawag sa API upang isaad kung walang available na data para sa hiniling na hanay.
2. Pagsuporta sa isang x-transaction header label na sumusuporta sa kakayahang i-link ang tugon ng PG&E sa mga partikular na Asynchronous API na tawag sa pamamagitan ng pagbabalik ng value na ito kasama ng isang Correlation ID kapag handa na ang hiniling na file.
3. Pinahusay na karagdagang granularity ng data sa UsagePoint/MeterReadingID API sa pamamagitan ng pagbibigay ng data ng electric interval para sa maraming metro sa iisang sitwasyon ng Kasunduan sa Serbisyo.
4. Nagbigay ng karagdagang kalinawan sa mga value ng Reading Quality Indicator para sa ESTIMATED interval data upang ilarawan ang uri ng pagtatantya na ginamit para sa agwat na iyon. Ang mga bagong halaga na nagsasaad ng lohika ng pagtatantya ay inilapat ay nasa ibaba:
   
   

5. RQI na halaga at paglalarawan

   0 - Wasto: data na dumaan sa lahat ng kinakailangang pagsusuri sa pagpapatunay at naipasa silang lahat o na-verify na

   7 - Manu-manong na-edit: pinalitan o inaprubahan ng isang tao

   8 - Tinantya gamit ang reference na araw: ang halaga ng data ay pinalitan ng isang machine computed value batay sa pagsusuri ng dating data gamit ang parehong uri ng pagsukat

   9 - Tinantya gamit ang linear interpolation: ang halaga ng data ay nakalkula gamit ang linear interpolation batay sa mga pagbabasa bago at pagkatapos nito

   10 - Kaduda-dudang: data na nabigo sa isa o higit pang pagsusuri

   11 - Hinango: data na nakalkula (gamit ang logic o mathematical operations), hindi kinakailangang direktang sinusukat

   12 - Projected (forecast): data na nakalkula bilang projection o forecast ng mga pagbabasa sa hinaharap

   13 - Mixed: nagsasaad na ang kalidad ng pagbasang ito ay may magkahalong katangian

   14 - Raw: data na hindi dumaan sa validation, editing at estimation process. NOTE MV90 Metro RQI indicator ay mananatili sa 14 bilang panghuling katayuan ng RQ

   15 - Na-normalize para sa lagay ng panahon: ang mga halaga ay na-adjust para sa pagsasaalang-alang ng lagay ng panahon, upang ihambing ang paggamit sa iba't ibang klima

   16 - Iba pa: tumutukoy na ang isang katangian ay nalalapat maliban sa mga tinukoy

   17 - Na-validate: data na napatunayan at posibleng na-edit at/o natantiya alinsunod sa mga naaprubahang pamamaraan

   18 - Na-verify: data na nabigo sa hindi bababa sa isa sa mga kinakailangang pagsusuri sa pagpapatunay ngunit natukoy na kumakatawan sa aktwal na paggamit

   19 - Kalidad ng kita: wasto at katanggap-tanggap para sa mga layunin ng pagsingil [posibleng extension para sa pamantayan ng ESPI, at hindi bahagi ng orihinal na ESPI]

    

6. Paglabas ng mga sukatan ng paggamit ng API ng vendor sa portal ng vendor ng Share My Data Third Party.

Nobyembre 15, 2018

Ano ang bago:

1. Customer Class Indicator ay naidagdag. Bawat SAID na pinahintulutan ay makikilala bilang alinman sa RES, AGR, COM/IND o Iba pa.
2. Billing and Usage API ay ia-update para tanggapin ang updated-max at updated-min na mga parameter ng query (bilang alternatibo sa published-min at published-max). Ang ibinalik na data ay ang lahat ng mga pagbabagong naganap sa loob ng updated-max at updated-min na mga parameter.
3. Pagpapalit sa paggamit ng 5-digit na Bulk ID ng third party ng Client ID ng third party para sa online na daloy ng awtorisasyon.
4. Pagbibigay ng opsyon para sa isang third party na i-redirect ang mga customer sa alinman sa pag-login sa account ng PG&E o sa tab na Guest Access bilang bahagi ng online na daloy ng awtorisasyon.
5. Pagpapahusay sa dashboard ng customer ng Share My Data ng PG&E upang gawing mas madali para sa mga customer na tingnan ang lahat ng kanilang umiiral na mga awtorisasyon sa pagbabahagi ng data sa mga third party.

Setyembre 27, 2018

Ano ang bago:

PG&E ng mga bagong elemento ng data sa set ng data ng Rule 24 bilang bahagi ng proyekto ng Expanded Data Set (EDS) ng PG&E, at ang mga kaukulang bagong elemento ng data ay ipinakilala sa set ng data ng Rule 25. Ang mga partikular na elemento ng data na binubuo ng pinalawak na Rule 25 set ng data ng PG&E ay nakalagay sa ibaba na may pagtatalagang EDS:

Panuntunan 25 Mga Elemento ng Data

Mga Tala
Mga Elemento ng Account
Pangalan ng Account
Address ng Account
Account ID
EDS: Outage Block
Mga Elemento ng Serbisyo
PG&E UUID
Service ID
Mga Pagbabago sa Hinaharap sa Katayuan ng Serbisyo
SA Katayuan
Petsa ng Pagsisimula ng Serbisyo
Address ng Serbisyo
Kasalukuyang Taripa ng Serbisyo
Makasaysayang Sinisingil na Taripa ng Serbisyo
Mga Opsyon sa Taripa (Medical Baseline, CARE, FERA, TBS , CCA_TBS, Solar Choice
Current Service Voltage at Commodity Historical Billed Service Voltage
Service Meter Number
Bilang ng Service Meter
Meter Type
Current Meter Read Cycle
Historical Billed Meter Read Cycle
Current Standby Rate Option kung On-site Generation Indicator
Opsyon sa Makasaysayang Sisingilin na Standby Rate
EDS: Tagapagpahiwatig ng Klase ng Customer
Mga Elemento ng Makasaysayang Pagsingil
Petsa ng pagsisimula ng bill
Petsa ng pagtatapos ng bill
Kabuuang singil($)
Bill total kWh
EDS: Pangalan ng Service Provider
Historical Bill Tier Breakdown (kung mayroon)
EDS: Line Item Bill Period
EDS: Pangalan (Over Baseline 1%-30%)
EDS: Volume (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Cost ($100.23)
Historical Bill TOU kWh breakdown ( maliban sa ABS-TX na sinisingil)
EDS: Line Item Bill Period (para sa TOU breakdown)
EDS: Pangalan (ng TOU charge)
EDS: Volume (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23 )
Historical Bill Demand Breakdown
EDS: Line Item Bill Period (para sa Demand breakdown)
EDS: Pangalan
EDS: Volume (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Historical Bill Line Items
EDS: Line Item Bill Period
EDS: Pangalan ng charge (DWR Bond Charge)
EDS: Volume (1234.2)
EDS: Unit (kWh)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Makasaysayang Paggamit Mga Interval
Pagsisimula ng Interval ng Paggamit
Default na Tagal ng Interval (sa mga segundo)
Interval na paggamit Dami (1234.2)
Unit (kWh/Therms)
Utility Demand Response Programs
(DR) Pangalan ng Programa
Pinakamaagang Petsa ng Pagwawakas nang walang Pinansyal na Obligasyon
Pinakamaagang Pagwawakas of Financial Obligation
DR Program Status
DR Program Enrollment Date
DR Program De-Enrollment Date
Data Elements
Commodity
Local Time Parameters (DST details)
Default na Kalidad ng Data
Energy Direction
Power of Ten Multiplier (para sa mga halaga ng paggamit ng interval)
Kapangyarihan ng Sampung Multiplier (para sa Sinisingil na Demand)
Kapangyarihan ng Sampung Multiplier (Para sa Kabuuang paggamit ng Sinisingil)
Haba ng Pagitan(ng Pagbasa ng Paggamit)
Currency ng kabuuang halaga ng bill
Electric Interval TOU Indicators

Hunyo 28, 2018

Bilang bahagi ng Click-Through na proyekto at ang patuloy na pagpapahusay sa Share My Data Platform, inilunsad ng PG&E ang Click-Through Phase 2 noong Hunyo 28, 2018.

Ano ang bago:

Ang pinakamahalagang pagbabago na nakakaapekto sa mga third party ay ang mga pagbabagong umaayon sa OAuth 2.0 protocol (tinanggal ng PG&E ang unang serye ng mga pag-redirect) .  Hanapin ang mga detalye sa ibaba.

MAHALAGA: Third party ay KINAKAILANGAN upang gumawa ng mga pagbabago sa kanilang umiiral na pagpapatupad ng OAuth. PG&E ay HINDI pabalik na tugma, kaya kinakailangan para sa mga ikatlong partido na magpatupad ng mga pagbabago kasabay ng pagpapatupad ng PG&E. Kung walang pagpapatupad, ang kasalukuyang proseso ng awtorisasyon ng customer ay titigil sa paggana sa cut-off date ng Hunyo 29, 2018 .  Ang mga kasalukuyang awtorisasyon, gayunpaman, ay hindi naaapektuhan.

1. Upang sumunod sa protocol ng OAuth 2.0, binawasan ng PG&E ang bilang ng mga hakbang sa pag-redirect para sa awtorisasyon. Ang unang pag-redirect sa PG&E para sa mga customer na mag-log in at magsumite ng awtorisasyon ay pinagsama sa kahilingan ng authorization code gaya ng sumusunod:
   • Gaya ng ipinapakita sa halimbawa sa ibaba, ang mga kahilingan ng third-party na Authorization code ay binubuo na ngayon ng pag-redirect ng browser ng customer sa bagong authorizationServerAuthorizationEndpoint URI ng PG&E, kasama ang mga naaangkop na parameter ng kahilingan:
     GET https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={optionalState}
   • Ang sumusunod na endpoint ay itinigil na: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. Bagong error sa paghawak ng mga mensahe para sa mga kahilingan sa authorization code na may nawawala o di-wastong mga parameter ng saklaw tulad ng sumusunod:
   • Kung ang kinakailangang client_id o redirect_uri na mga parameter ay nawawala o hindi wasto, isang (http 400) error na may paliwanag na mensahe ay ipinapakita sa customer
   • Kung ang kinakailangang response_type na parameter ay nawawala o hindi wasto, ang customer ay ire-redirect pabalik sa redirect_uri ng third party na may "invalid_request" na parameter ng error (idinagdag sa redirect_uri)
     
3. Para sa mga customer na may umiiral nang online na awtorisasyon, ang kakayahan para sa isang third party na humiling ng bagong access_token/refresh_token na pares bilang bahagi ng isang bagong awtorisasyon na pumapalit sa dati (ibig sabihin, online na awtorisasyon ng parehong third party at kumbinasyon ng customer). Tinutugunan ng functionality na ito ang mga sitwasyon ng mga third party na nawalan ng access_token/refresh_token pares o kung hindi man ay nangangailangang baguhin ang saklaw ng orihinal na awtorisasyon sa bawat pag-apruba ng customer.
   • Para sa mga kahilingan sa muling pagpapahintulot, makikita ng customer ang bagong pahina ng awtorisasyon sa halip na ang pahina ng "pamahalaan ang pahintulot" kapag na-redirect ng isang third party sa PG&E para sa awtorisasyon
   • Sa pahintulot ng customer, ang mga third party ay makakatanggap ng notification sa kanilang nakarehistrong notification URL na ang lumang subscription ID ay kinansela (notification ay binubuo ng authorization API URL endpoint para sa lumang subscription ID)
     
4. Ang kakayahan para sa isang customer na lumabas sa pamamagitan ng isang "cancel" na buton sa alinman sa pahina ng pagpapatunay o pahina ng awtorisasyon na may pag-redirect pabalik sa redirect_uri ng ikatlong partido na may "access_denied" na parameter ng error (idinagdag sa redirect_uri)
5. Para sa mga third party na nagparehistro gamit ang setting ng "visibility" at samakatuwid ay kasama sa listahan ng mga rehistradong third party na makikita ng mga customer kapag pumunta sila sa kanilang PG&E online na account at nag-navigate sa Share My Data landing page:
   • Para sa mga customer na nag-log in sa kanilang PG&E online na account at nag-navigate sa landing page ng Share My Data at pagkatapos ay ire-redirect sa nakarehistrong "Third Party Portal URI" ng third party sa pagpili ng third party mula sa listahan ng mga nakarehistrong third party. Sa puntong iyon, maaaring magpatuloy ang mga customer sa proseso ng OAuth na pinasimulan ng third party. Kapag dumaan sa landas na ito, hindi na ipapakita sa mga customer ang pahina ng pahintulot sa pagpili ng isang third party mula sa dropdown na listahan ng mga third party, ngunit sa halip ay ire-redirect sa nakarehistrong "Third Party Portal URI" ng third party kung saan maaari nilang simulan ang ikatlong pinasimulan ng partido ang proseso ng OAuth
   • Tandaan: Ang ilang mga third party ay nagtanong tungkol sa kung paano i-streamline ang karanasan ng customer para sa kaso ng paggamit na ito (ibig sabihin, mga awtorisasyon na sinimulan sa site ng PG&E) upang sa customer ay lumilitaw na sila ay direktang dadalhin sa isang pahina ng pahintulot sa pagpili ng isang third party mula sa dropdown. Upang mapadali ang ganoong karanasan ng customer, maaaring piliin ng mga third party na itakda ang kanilang "Third Party Portal URI" (sa pamamagitan ng pahina ng pagpaparehistro ng Share My Data manage) sa isang endpoint na awtomatikong nagre-redirect sa customer pabalik sa PG&E bilang bahagi ng kahilingan sa authorization code. Sa awtomatikong pag-redirect pabalik sa authorizationServerAuthorizationEndpoint ng PG&E, lalaktawan ng customer ang pahina ng pag-login ng customer (dahil naka-log in na sila) at direktang pupunta sa page ng awtorisasyon. Para sa ilang mga third party na nagparehistro bago ang Ibahagi ang Aking Data Click Thru 2.0 na release, ito ay magagawa sa pamamagitan lamang ng pagtukoy sa Third Party Portal URI na katumbas ng hindi na ginagamit na "Third Party Scope Selection Screen"URI (old SMD Registration field na magretiro sa isang paglabas sa hinaharap).
     Sa kabaligtaran, maaaring gusto ng ilang third party na makipag-ugnayan muna at mag-screen ng mga customer sa kanilang panig kapag ang mga customer ay na-redirect sa kanilang 'Third Party Portal' URI bago humiling ng authorization code, kaya ang diskarte sa itaas ay isang mungkahi lamang.
     
6. SMD ng pinahusay na mga detalye ng parameter ng Saklaw bilang bahagi ng mga tugon sa Kahilingan ng Authorization Code, ang Access Token Request, at ang Authorization API. Ang pinahusay na parameter ng saklaw ay nagbibigay-daan para sa pakikipag-usap sa huling saklaw ng awtorisasyon ng customer. Sa partikular, ang parameter ng saklaw ay may kasamang value na "AdditionalScope" na nagmamapa sa sinusuportahang customer authorization ng PG&E na mga pagpipilian ng mga pangkat ng data (hal. "Paggamit", "Pagsingil", "Basic", "Account", "Pagpapatala ng Programa"). Ang mga value ng parameter ng saklaw ay higit pang kinukunan ayon sa sumusunod na dokumentasyon: Download Supported Function Block Scope String Mapping Click Thru 2.0 (PDF)
   
   Ang isang halimbawang tugon ng Token sa ibaba ay naglalarawan ng ilang posibleng halaga ng parameter ng saklaw.
   • Halimbawang Token Response:
     
     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_4_5_1_4; Saklaw=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Araw-araw;HistoryLength={3P Nakarehistrong haba ng kasaysayan};AccountCollection ={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} hal: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{ subscriptionID}
     authorizationURI:{AuthorizationURI} hal: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} hal:https://api.pge.com /GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Third party ay maaari na ngayong magparehistro para makatanggap ng awtorisadong Program Enrollment information sa pamamagitan ng bagong "Program Enrollment" data group. Parehong may interval metered pati na rin ang non-interval metered na mga customer ay magiging karapat-dapat na pahintulutan ang pagbabahagi ng data para sa SMD Click-Through Phase 2. Ang isang mataas na antas na buod ng mga bagong available na elemento ng data na ibinigay ng pangkat ng data ng Program Enrollment ay ang sumusunod:
   • Program Enrollment (PG&E Demand Response program name/status at impormasyon ng CAISO):
   • (Pagsingil) Address ng account
   • Katayuan ng Kasunduan sa Serbisyo
   • (Kasalukuyang) taripa ng serbisyo
   • (Kasalukuyan) Boltahe ng serbisyo (electric lang)
   • Numero ng metro ng serbisyo (kung mayroon man)
   • metro
   • (Kasalukuyang) Meter Read Cycle
   • (Kasalukuyan) Standby Rate Option kung On-Site Generation Indicator
   • (default na paggamit ng agwat) Tagal (haba sa mga segundo)
   • (Naka-enroll na PG&E Demand Response) Pangalan ng Programa (kung naaangkop)
   • Pinakamaagang Petsa ng Pagwawakas mula sa PG&E na naka-enroll na Demand Response (DR) Program na walang Obligasyon sa Pinansyal
   • Pinakamaagang Petsa ng Pagwawakas mula sa PG&E na naka-enroll na Demand Response (DR) na Programa anuman ang Pinansyal na Obligasyon
   • PG&E Demand Response (DR) Program (enrollment) Status
   • Petsa ng Pagpapatala ng Programa ng PG&E Demand Response (DR).
   • PG&E Demand Response (DR) Petsa ng De-Enrollment ng Programa
   • Ang pagmamapa ng Atom XML XSD (XML Schema Definition) para sa mga bagong elemento ng data na ito ay kinukuha ayon sa sumusunod na dokumentasyon:
     I-download ang Mga Suportadong Elemento ng Data (PDF)
   • Associated relational data hierarchy model ay nakabalangkas ayon sa sumusunod:
     I-download ang PGE ESPI Data Model (PDF)
   • UsagePoint (aka SA UUID)
     • ServiceDeliveryPoint\tariffProfile(kasalukuyang service tariff AKA rate schedule kasama ang Standby Rate Option kung naaangkop)
     • readCycle (kasalukuyang Meter Read Cycle)Buod ng Paggamit
     • readCycle (cycle ng serbisyo sa pagsingil)
     • Commodity (kasama ang antas ng boltahe na sinisingil para sa kuryente)
     • taripaProfile (sinisingil na taripa ng serbisyo kasama ang opsyon sa Standby Rate kung naaangkop
   • Uri ng Pagbasa
     • Commodity (kasama ang kasalukuyang antas ng boltahe para sa electric at prefix para sa Standby Rate Option kung saan naaangkop)
   • Customer Account
     • (Acct Billing Address):
     • pangunahingAddress/Detalye ng kalye...
     • pangunahingAddress/bayanDetalye...
     • pangunahingAddress/postalCode...
   • Kasunduan ng Customer
     • status\value (SA Status
   • Demand Response Program
     • Pangalan ng programa
     • enrollmentStatus
     • programDate/programDate
     • programDate/programDateDescription
   • Metro
     • serialNumber (meter id)
     • (uri ng metro)
     • (kasalukuyang) intervalLength
   • Pinakabagong ESPI xml schema definitions (XSDs) na ginamit para sa mga bagong elemento ng data na ito ay nakabalangkas ayon sa sumusunod:
     I-download ang mga XSD (ZIP, 49 KB)ZIP. Magbubukas sa bagong Window.
     Tandaan: ang mga XSD ay backward compatible.
   • Ang mga third party ay magkakaroon ng kakayahang baguhin ang kanilang pagpaparehistro upang payagan ang mga customer na piliin ang pangkat ng data na ito sa panahon ng pahintulot sa pamamagitan ng portal ng third party sa ilalim ng seksyong pamahalaan ang pagpaparehistro >I-edit >: Ipahiwatig ang impormasyon ng customer na kailangan mo", piliin ang check box ng Program Enrollment.
   • Tandaan: malalapat lang ito sa mga bagong awtorisasyon ng customer.
     
   • na Bagong API para kunin ang impormasyon sa Pagpapatala ng DR ay available sa Bulk 3rd party na antas gayundin sa indibidwal na antas ng awtorisasyon ng customer (Antas ng RetailCustomerID), na nakabalangkas ayon sa sumusunod:
     Mag-download ng mga bagong PGE Supported APIs (PDF)
   • Asynchronous API para sa paghiling ng impormasyon sa DR Enrollment para sa lahat ng pahintulot sa isang third party
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • Synchronous API para sa paghiling ng impormasyon sa pagpapatala ng DR sa antas ng awtorisasyon ng indibidwal na customer
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

Pakitandaan: Bukod sa mga pagbabago sa proseso ng awtorisasyon ng customer, ang iba pang mga pagbabago ay pabalik-balik ding tugma at mga boluntaryong pagpapahusay na maaaring piliin ng mga third party na suportahan.

Kung mayroon kang anumang mga tanong o kailangan ng karagdagang suporta, huwag mag-atubiling mag-email sa sharemydata@pge.com .

Ano ang bago:

1. Customers ay maaari na ngayong makinabang mula sa streamlined Click-Through authorization process.
   • Na-update namin ang mga detalye tungkol sa kung paano makakapagbahagi ng data ang isang customer sa iyong kumpanya.
     Alamin kung paano nagbabahagi ng data ang mga customer sa isang kumpanya
     
     Tandaan: Ang mga pagbabagong ito, partikular na ang mga pagpapahusay sa aming authorization UI, ay na-optimize para sa mga mobile device (hal., mga telepono o tablet).
   • Ang mga pagbabago ay ginawa sa proseso ng pamamahala ng awtorisasyon na naa-access ng mga customer sa pamamagitan ng kanilang PG&E online na account:
     • Maaari pa ring tanggalin ng isang customer ang mga SAID mula sa isang umiiral nang awtorisasyon, pahabain ang petsa ng pagtatapos ng awtorisasyon at/o kanselahin ang awtorisasyon anumang oras. Gayunpaman, upang magdagdag ng mga karagdagang SAID at/o baguhin ang mga awtorisadong elemento ng data, kailangang kanselahin ang kasalukuyang awtorisasyon at kailangang gumawa ng bagong awtorisasyon.
2. Kung ninanais, magagamit na ngayon ng mga third party ang API na ito para sa pagbawi ng mga indibidwal na awtorisasyon ng customer gamit ang kanilang third party na Client Access Token (ibinigay sa panahon ng paunang proseso ng pagpaparehistro ng third party ng SMD) sa pamamagitan ng isang DELETE operation: https://api.pge.com/GreenButtonConnect/ espi/1_1/resource/Authorization/{AuthorizationID}
   
   Tandaan 1: Para sa pagpapatupad ng PG&E, ang parameter ng AuthorizationID ay kapareho ng halaga ng SubscriptionID.
   
   Tandaan 2: Ang bagong API ay nagbibigay ng kakayahan sa mga third party na bawiin (kanselahin) ang isang awtorisasyon. Gayunpaman, ang mga customer lang mismo ang maaaring mag-alis ng mga SA ID at/o mag-update ng petsa ng pagtatapos ng awtorisasyon sa pamamagitan ng aming SMD na pamahalaan ang mga pahina ng pahintulot.
   
   Paalala: Tulad ng lahat ng kahilingan sa data ng API, ang mga third party ay dapat munang humiling ng bagong Token Pair (Client Access + Refresh Token) gamit ang kanilang pinakabagong Refresh Token.
   
   Paalala ng mga Panahon ng Pag-expire ng Token:
   • Access Token:1hr
   • Client Access Token: 5 min
   • Kaukulang Refresh Token: 1Yr
3. Ang mga third party ay maaari na ngayong lumikha ng maramihang pagrerehistro ng Share My Data (SMD) gamit ang parehong pangalan ng kumpanya at Tax ID kung kinakailangan. Gayunpaman, ang display name (na nakikita ng mga customer kapag pinahihintulutan) ay kailangan pa ring natatangi.
   
   Tandaan: Ang lahat ng mga pagbabago sa itaas ay pabalik na katugma at mga boluntaryong pagpapahusay na maaaring piliin ng mga third party na suportahan. Mag-download ng mga sumusuportang dokumento para sa release na ito:
   
   SUPPORTED_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORTED_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORTED_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

Disyembre 20, 2015

Mga kinakailangang pagbabago: ang mga sumusunod na update sa SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga third party.

1. Bilang pagsasaalang-alang sa mga third party na may mga pagpapatupad ng GBCMD (Green Button Connect My Data) sa maraming utility bukod sa PG&E lang, ibabalik namin ang dataCustodianID (ibig sabihin, dataCustodianID=PGE) sa pag-redirect sa thirdPartyScopeSelectionScreenURI sa panahon ng OAuth authorization sequence.
2. API na tumatanggap ng mga parameter ng petsa (hal., kahilingan sa batch), ay dapat gumamit ng mga parameter ng data ng Zulu (hal., published-max/publish-min). Ang iba pang mga format ng petsa para sa mga parameter ng petsa sa mga kahilingan sa API ay hindi susuportahan.
   • API na tumatanggap ng mga parameter ng petsa ay nakadokumento ayon sa naka-attach, Supported APIs.xlsx
3. Interval TOU indicator na kasama sa Interval metered electric usage data (kung naaangkop, indicator kung anong panahon ng TOU ang tumutugma sa bawat interval)
   • Mangyaring sumangguni sa static na Program ID Mappings na nagdedetalye kung ano ang katumbas ng bawat pagitan ng TOU enumeration (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Supported Data Elements.xlsx )
4. Ang client_id na makikita sa dataCustodianScopeSelectionScreenURI (ginamit para sa third party na pinasimulan OAuth) at ibinigay sa Application Information Resource na kahilingan ng mga third party sa panahon ng Registration Testing ay ina-update sa 5 digit kung hindi pa ito (hal., pagdaragdag ng mga nangungunang zero atbp). Bilang karagdagan, hindi na kasama sa URL ang '&verified=true' sa dulo. na mga third party na i-update ang kanilang mga URL nang naaayon.
   • Upang ipaliwanag, ang dataCustodianScopeSelectionScreenURI ay ganito ang hitsura: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX ang clientID)
   • Kaya ang kasalukuyang clientID ng 123 ay magbabago sa isang bagay na tulad ng 00123 ibig sabihin ang kanilang bagong dataCustodianScopeSelectionScreenURI ay magiging tulad ng sumusunod:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (ang lumang URL ay ang sumusunod: https:// sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. Ang mga third party na nakarehistro bilang "ESP" o "Energy Service Provider" ay nagbabago sa Karaniwang Uri ng User. Walang mga pagbabago sa pagganap, tanging sa pamagat ng uri ng gumagamit. Ang pagkilala sa uri ng user ng ESP (mula sa Standard User type) ay isang hindi kinakailangang pagkakaiba, na nagdudulot ng kalituhan sa panahon ng proseso ng pagpaparehistro nang hindi nagbibigay ng anumang pagkakaiba-iba ng functionality, kaya ito ay itinitigil na.

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay pabalik na katugma, at mga boluntaryong pagpapahusay na maaaring piliin ng mga third party na suportahan.

1. Third party ay magkakaroon ng kakayahang awtomatikong baguhin/i-update ang kanilang mga SSL certs na orihinal nilang ibinigay sa panahon ng pagpaparehistro (hal., kapag malapit nang mag-expire ang cert) sa pamamagitan ng third party na portal sa ilalim ng pamamahala ng pagpaparehistro >I-edit > bagong seksyon: SSL Certificate Information (Pagpipilian sa pag-update).
2. Ang mga third party ay maaaring magparehistro upang makatanggap ng awtorisadong pangunahing impormasyon sa pagsingil, impormasyon ng customer, at data ng gas.  Parehong may interval metered pati na rin ang non-interval metered na mga customer ay magiging karapat-dapat na pahintulutan ang pagbabahagi ng data para sa SMD 2.0. Ang isang mataas na antas ng buod ng mga bagong available na elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa parehong Interval at non-interval metered SA)
     • Rate schedule, billing $ totals, Tiered usage (as applicable), Demand (as applicable), TOU totals (as applicable)
     • Tandaan: Para sa mga awtorisadong non-interval metered na customer, ang mga third party ay makakatanggap lamang ng mga kabuuan ng paggamit ng pagsingil (ibig sabihin, sa Buod ng Paggamit) at walang agwat sa paggamit ng reads (hal., oras-oras/araw-araw na pagbabasa dahil hindi sila available)
   • Customer Info: (para sa parehong interval at non-interval metered SA)
     • Pangalan ng Customer, Address ng Serbisyo, Account ID, ID ng Kasunduan sa Serbisyo, Petsa ng Pagsisimula ng Serbisyo ng Kasunduan sa Serbisyo,
   • Interval Gas usage data: (interval metered gas SAs lang)
     • Interval (ibig sabihin, araw-araw) na pagbabasa ng gas
   • Ang mga bagong elemento ng data ay naka-diagram ayon sa nakalakip, Supported Data Elements.xlsx
   • Ang nauugnay na relational data hierarchy ay nakabalangkas sa nakalakip, PGE ESPI Data Model.xlsx
   • Pinakabagong ESPI xml schema definitions (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay ayon sa mga naka-attach na XSD. Tandaan: ang mga XSD ay backward compatible:
     • espiDerived.xsd (Interval na Paggamit at Impormasyon sa Pagsingil)
     • retailcustomer.xsd (impormasyon ng customer)

Kung mayroon kang anumang mga katanungan o kailangan para sa karagdagang suporta, mangyaring huwag mag-atubiling makipag-ugnay sa amin sa ShareMyData@pge.com .

Disyembre 18, 2015

Mga kinakailangang pagbabago: ang mga sumusunod na update sa SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga user na iyon na nag-a-access ng kanilang sariling data:

1. API na tumatanggap ng mga parameter ng petsa (hal., kahilingan sa batch), ay dapat gumamit ng mga parameter ng data ng Zulu (hal., published-max/published-min). Iba pang mga format ng petsa para sa mga parameter ng petsa sa mga kahilingan sa API ay hindi susuportahan.
   • API na tumatanggap ng mga parameter ng petsa ay nakadokumento ayon sa naka-attach, Supported APIs.xlsx
2. Interval Time of Use (TOU) indicators na kasama sa Interval metered electric usage data (kung naaangkop, indicator kung anong panahon ng TOU ang tumutugma sa bawat interval)
   • Mangyaring sumangguni sa static na Program ID Mappings na nagdedetalye kung ano ang katumbas ng bawat pagitan ng TOU enumeration (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Supported Data Elements.xlsx )

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay pabalik na katugma, at mga boluntaryong pagpapahusay na maaaring piliin ng mga third party na suportahan.

1. Self Access ay magkakaroon ng kakayahang awtomatikong baguhin/i-update ang kanilang mga SSL certs na orihinal nilang ibinigay sa panahon ng pagpaparehistro (hal., kapag malapit nang mag-expire ang cert) sa pamamagitan ng third party na portal sa ilalim ng pamamahala ng pagpaparehistro > I-edit > bagong seksyon: SSL Certificate Information (Pagpipilian sa pag-update)
2. Self Access ay ia-update upang isama ang awtorisadong pangunahing impormasyon sa pagsingil, impormasyon ng customer, at data ng gas. Ang parehong interval na sinusukat bilang well bilang non-interval metered Mga Kasunduan sa Serbisyo ay magiging karapat-dapat para sa (sariling) awtorisasyon para sa SMD 2.0 Ang isang mataas na antas ng buod ng mga bagong available na elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa Interval at non-interval metered SAs)
     • Iskedyul ng rate, mga kabuuang $ sa pagsingil, Tiered na paggamit (kung naaangkop), Demand (kung naaangkop), mga kabuuan ng TOU (kung naaangkop)
     • Tandaan: Para sa mga awtorisadong non-interval metered na customer, ang mga third party ay makakatanggap lamang ng mga kabuuan ng paggamit sa pagsingil (ibig sabihin, sa Buod ng Paggamit) at walang agwat sa paggamit ng reads (hal., oras-oras/araw-araw na pagbabasa dahil hindi sila available)
   • Customer Info: (para sa parehong interval at non-interval metered SA)
     • , Address ng Serbisyo, Account ID, ID ng Kasunduan sa Serbisyo, Petsa ng Pagsisimula ng Serbisyo ng Kasunduan sa Serbisyo,
   • Interval Gas usage data: (interval metered gas SAs lang)
     • Interval (ibig sabihin, araw-araw) na pagbabasa ng gas
   • Ang mga bagong elemento ng data ay naka-diagram ayon sa nakalakip, Supported Data Elements.xlsx
   • Ang nauugnay na relational data hierarchy ay nakabalangkas sa nakalakip, PGE ESPI Data Model.xlsx
   • Pinakabagong ESPI xml schema definitions (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay ayon sa mga naka-attach na XSD. Tandaan: ang mga XSD ay backward compatible:
     • espiDerived.xsd (Interval na Paggamit at Impormasyon sa Pagsingil)
     • retailcustomer.xsd (impormasyon ng customer)

Kung mayroon kang anumang mga katanungan o kailangan para sa karagdagang suporta, mangyaring huwag mag-atubiling makipag-ugnay sa amin sa ShareMyData@pge.com .

Disyembre 18, 2015

Mga kinakailangang pagbabago: ang mga sumusunod na update sa SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga pagpapatupad ng CCA.

1. ad hoc na kahilingan (hal., para sa makasaysayang data), ay dapat gawin gamit ang mga parameter ng petsa ng oras ng Zulu. Ang iba pang mga format ng petsa para sa mga parameter ng petsa sa mga kahilingan sa API ay hindi susuportahan.
2. Ang pang-araw-araw na maramihang paggamit ng feed ay magsisimulang magsama ng pangunahing impormasyon sa pagsingil habang ang pang-araw-araw na maramihang feed ng customer ay magsasama ng karagdagang impormasyon ng customer. Ibibigay ang bagong data na ito para sa mga customer na may interval metered kung saan sila nakatanggap ng data para sa kasalukuyan, pati na rin para sa mga customer na hindi nasusukat sa pagitan sa kanilang teritoryo kung saan hindi sila nakakatanggap ng data sa kasalukuyan. Panghuli, ang mga halaga ng paggamit ng pagitan na ibinigay sa pang-araw-araw na feed ng maramihang paggamit ay magsasama ng mga tagapagpahiwatig ng interval TOU kung saan naaangkop. Ang mataas na antas ng buod ng mga bagong elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa Interval at non-interval metered SAs)
     • Rate schedule, billing $ totals, Tiered usage (as applicable), Demand (as applicable), TOU totals (as applicable)
   • (Karagdagang) Impormasyon ng Customer: (para sa parehong interval at non-interval metered SA)
     • Pangalan ng Customer, Address ng Serbisyo, Petsa ng Pagsisimula ng Serbisyo ng Kasunduan sa Serbisyo, Account ID
   • Interval TOU indicator na kasama sa Interval metered electric usage data (kung naaangkop, indicator kung anong panahon ng TOU ang tumutugma sa bawat interval)
     • Mangyaring sumangguni sa static na Program ID Mappings na nagdedetalye kung ano ang katumbas ng bawat pagitan ng TOU enumeration (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Supported Data Elements.xlsx )
   • Pinakabagong ESPI xml schema definitions (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay ayon sa mga naka-attach na XSD. Tandaan, ang mga XSD ay pabalik na katugma:
     • espiDerived.xsd (Interval na Paggamit at Impormasyon sa Pagsingil)
     • retailcustomer.xsd (Impormasyon ng Customer)
   • Ang mga bagong elemento ng data ay naka-diagram ayon sa nakalakip, Supported Data Elements.xlsx
   • Ang nauugnay na relational data hierarchy ay nakabalangkas sa nakalakip, PGE ESPI Data Model.xlsx

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay pabalik na katugma, at mga boluntaryong pagpapahusay na maaaring piliin ng mga third party na suportahan.

1. CCA para sa impormasyon ng customer sa: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (ibinabalik ang pinakabagong snapshot ng impormasyon ng customer sa oras ng kahilingan), bilang karagdagan sa araw-araw na abiso na natanggap.
2. CCA's ay magkakaroon ng kakayahang awtomatikong baguhin ang kanilang SSL cert na orihinal nilang ibinigay sa panahon ng pagpaparehistro (hal., kapag malapit nang mag-expire ang cert) sa pamamagitan ng third party na portal, sa ilalim ng pamamahala ng pagpaparehistro > I-edit > bagong seksyon: SSL Certificate Information (Pagpipilian sa pag-update)

Kung mayroon kang anumang mga katanungan o kailangan para sa karagdagang suporta, mangyaring huwag mag-atubiling makipag-ugnayan sa amin sa ShareMyData@pge.com .

Agosto 21, 2015

Ano ang bago:

1. Mga pagbabago sa param at mapagkukunang URI ng estado sa mga tugon ng Oauth
   • Bilang bahagi ng kahilingan sa OAuth authorization code, ang ikatlong partido ay may opsyon na magpadala sa isang parameter ng estado na ipapadala ng PG&E pabalik sa ikatlong partido. PG&E ang authorization code sa matagumpay na pagkumpleto ng authorization. Ang opsyonal na param ng estado na ito ay maaaring gamitin upang matulungan ang ikatlong partido na matukoy kung saan sinimulan ang kahilingan, at itali ang kahilingan pabalik sa mga pahintulot na kanilang pinasimulan.
   • Bilang bahagi ng matagumpay na pagkumpleto ng kahilingan sa token, ibinabahagi namin ang back resourceURI at authorizationURI nang hiwalay sa impormasyon ng token. Sa kasalukuyan ang mga URI na ito ay binaligtad at bilang bahagi ng paglabas na ito ay itatama namin iyon.

Mga naayos na depekto:

1. Default na mga petsa na na-publish-max at na-publish na-min
   Kasalukuyang ipinag-uutos ng PG&E ang third party na magpadala ng mga parameter na naka-publish na min at naka-publish na max sa mga segundo para sa bawat kahilingan ng data na sabihin sa PG&E ang tagal kung kailan sila humihiling ng data. Nagpapatupad kami ng pagbabago para pangasiwaan ang mga kahilingan para sa mga sumusunod na sitwasyon:
   • published-min at published-max values
   • published-min at published-max values
   • published-min at published-max values ay nasa mga epoch na segundo
   Kung sakaling nawawala ang mga parameter, ibabalik ng PG&E ang mga default na petsa, kumpara sa mga mensahe ng error na ibinalik bago ang pagbabagong ito. Default, sa aming kaso, ay isang araw na data para sa petsang T-2. Kung ang mga parameter ay naroroon at nai-format nang tama, patuloy naming igagalang ang mga parameter.
2. Ayusin para sa mga petsa sa authorization xml
   Sa kasalukuyan sa authorization xml ibinahagi namin ang nai-publish na petsa at petsa ng awtorisasyon. Ang mga petsang ito ay nasa millisecond kumpara sa mga segundo na siyang pamantayan. Inaayos namin ito upang maibalik sa loob ng ilang segundo sa halip na mga millisecond.
3. Maling XML na ibinalik para sa /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Sa kasalukuyan ay nagbabalik kami ng maling tugon para sa antas ng mapagkukunan sa itaas na GET kung saan ang istraktura ng XML ay hindi tama at inuulit namin ang mga entry para sa bawat pagitan sa halip na lumikha ng isang solong bloke ng pagitan para sa isang 24 na oras na tagal.
   
   Ito ay inaayos at isang solong interval block lang ang ibabalik para sa 24 interval block.

Mga tanong o alalahanin? Mangyaring makipag-ugnayan sa ShareMyData@pge.com .

• na Customer na i-access ang kanilang data sa pamamagitan ng My Energy, ang kanilang online na account sa PG&E. Para sa isang detalyadong pangkalahatang-ideya kung paano maaaring pahintulutan ng mga customer ang mga third party o iba pang entity na i-access ang kanilang data, pakitingnan ang Share My Data Third-Party Overview.

Pumunta sa mga detalye ng awtorisasyon

• Sa kasalukuyan, walang limitasyon.

• Ang mga customer ay maaaring pumili ng isang tiyak na tagal ng oras kung saan maaari mong ma-access ang kanilang data, o maaari nilang iwanang bukas ang panahon ng pahintulot.
• Maaaring suriin ng iyong aplikasyon ang petsa ng pagtatapos ng awtorisasyon ng customer kasama ng iba pang mga detalye ng awtorisasyon sa pamamagitan ng pagtawag sa mga authorization resource API (hal., .../espi/1_1/resource/Authorization at/o.../espi/1_1/resource/ Awtorisasyon/{AuthorizationID}).
• Bilang kahalili, maaari mong manu-manong suriin ang mga petsa ng pagtatapos ng awtorisasyon sa pamamagitan ng pag-log in sa iyong account at pagpili sa Pamahalaan ang Mga Awtorisasyon.

• Kung pipili ang isang customer ng isang tinukoy na panahon ng awtorisasyon, pagkatapos ay mag-e-expire ang kanilang awtorisasyon sa pagtatapos ng yugto ng panahon na iyon. Kung kinansela nila ang awtorisasyon, mag-e-expire ang kanilang awtorisasyon sa araw pagkatapos nilang kanselahin ang awtorisasyon.
• Kung pipiliin ng isang customer ang Indefinite bilang kanilang tagal ng pahintulot, hindi mag-e-expire ang kanilang awtorisasyon. Tandaan, bilang pagsasaalang-alang sa Rule 24 Demand Response Provider at iba pang mga programa gamit ang Share My Data, ang mga after-the-fact na pagwawasto para sa mga dating awtorisadong hanay ng petsa ay maaaring ibigay sa mga ikatlong partido hanggang sa tatlong taon pagkatapos ng pag-expire ng awtorisasyon.
• Tingnan ang "Paano haharapin ang mga pagwawasto ng data?" para sa karagdagang detalye sa pagtanggap ng mga pagwawasto.

• Maaaring pahintulutan ka ng sinumang customer ng PG&E na may kasalukuyang aktibong Service ID para sa serbisyo ng gas o kuryente na i-access ang kanilang data gamit ang bagong tool na Share My Data.

• Customer na interesadong makilahok sa pagbabahagi ng kanilang data sa pamamagitan ng Share My Data program ay lubos na hinihikayat na magparehistro para sa My Energy account. Gagawin nitong mas mahusay ang buong proseso at bibigyan din sila ng kakayahan na pamahalaan ang kanilang mga pahintulot online.
• Customers para sa My Energy account sa panahon ng proseso ng awtorisasyon.
• Mayroong manu-manong proseso na available sa mga customer para makakuha ng Share My Data Authorization Form online at isumite ang nakumpletong form sa pamamagitan ng email.
• Para sa karagdagang impormasyon tungkol sa manu-manong proseso, mangyaring makipag-ugnayan sa amin sa ShareMyData@pge.com .

• Customer ay kinakailangang gumawa ng kanilang sariling mga awtorisasyon online sa pamamagitan ng kanilang PG&E online na account. Gayunpaman, kung kinumpleto at nilagdaan nila ang form ng Awtorisasyon sa Ibahagi ang Aking Data, maaari mo itong isumite sa PG&E sa ngalan nila.

I-download ang Share My Data Customer Authorization o Revocation of Authorization form (PDF, 308 KB)

• Maaari mong i-update ang iyong mga OAuth URI sa pamamagitan ng pag-log in sa iyong account, pag-navigate sa Manage Registration > Edit > at pag-update ng mga field sa ilalim ng seksyong Impormasyon ng OAuth 2.0.

• Maaari mong i-update ang iyong Notification URI sa pamamagitan ng pag-log in sa iyong account, pag-navigate sa Manage Registration > Edit > at pag-update ng mga field sa ilalim ng seksyong Impormasyon sa Pag-access ng Data.

• Maaari mong i-update ang iyong SSL certificate sa pamamagitan ng pag-log in sa iyong account, pag-navigate sa Manage Registration > Edit > at pagpili sa "Update" sa seksyong SSL Certificate Information. Tandaan na para sa mga bagong pag-upload ng certificate, maaaring tumagal ng ilang araw upang i-update ang mga PG&E system gamit ang bagong certificate.  
• Magpapadala ng confirmation email mula sa Share My Data Support team kapag nailapat na ang bagong certificate.

• Kapag nakatanggap ka ng email na nagsasaad na tinanggap ang iyong pagpaparehistro, magagawa mong mag-log in sa iyong Share My Data account at i-download ang aming SSL Certificate sa pamamagitan ng Download PG&E SSL Certificate page.

Mag-login para Ibahagi ang Aking Data

• Share My Data ay sumusunod sa mga kasunduan sa pagpapatupad ng Green Button Connect My Data. Share My Data ang OAuth 2.0 para sa awtorisasyon, Transport Layer Security (TLS) 1.2 at ang minimum na hanay ng mga cyber security protocol na inaprubahan ng NIST (National Institute of Standards and Technology) upang walang impormasyong ipinagpapalit nang malinaw.

• Ang pagprotekta sa impormasyon ng customer ay isang pangunahing priyoridad para sa PG&E. Itinuturing ng PG&E ang impormasyon tungkol sa kanilang mga customer—kabilang ang personal na impormasyon—bilang kumpidensyal, naaayon sa lahat ng legal at regulasyong kinakailangan, kabilang ang mga itinatag ng California Public Utilities Commission at iba pa.  
• Sa loob ng higit sa dalawang dekada, ang PG&E at iba pang mga utility na pagmamay-ari ng mamumuhunan sa California ay napapailalim sa napakahigpit na mga regulasyon ng CPUC na nagbabawal sa kanila sa pagsisiwalat ng impormasyong partikular sa customer, gaya ng data ng pagsingil, sa mga ikatlong partido nang walang hayagang pahintulot ng customer.  
• Kapag pinahintulutan ng customer ang paglabas ng data, responsibilidad ng customer at third party na protektahan ang data na iyon.
• Maaaring piliin ng isang customer na ihinto ang pagbabahagi ng data sa isang third party anumang oras sa pamamagitan ng pag-log in sa kanilang PG&E online na account at pagkansela sa kanilang awtorisasyon. PG&E at Abiso ng Pag-access, Pagkolekta, Pag-iimbak, Paggamit at Pagbubunyag ng Impormasyon sa Paggamit ng Enerhiya ay makukuha sa pge.com/privacy .

• Sa loob ng saklaw ng programang Ibahagi ang Aking Data, ang mga ikatlong partido ay napapailalim sa Mga Panuntunan sa Privacy at Proteksyon ng Data ng Customer na tinukoy sa mga tuntunin at kundisyon ng platform ng Share My Data at sa mga kinakailangan na kasama sa Taripa sa Pag-access sa Data ng Customer.
• Ang mga third party ay napapailalim din sa lahat ng iba pang naaangkop na batas at regulasyon na nauugnay sa proteksyon ng privacy ng customer, kabilang ang, ngunit hindi limitado sa, Mga Panuntunan Tungkol sa Privacy at Mga Proteksyon sa Seguridad para sa Data sa Paggamit ng Enerhiya na pinagtibay ng CPUC bilang Attachment D sa Desisyon 11- 07-056 (Electric), na buod din sa PG&E's Electric Rule No. 27, at California Civil Code Section 1798.80 – 1798.84.
• Para sa karagdagang impormasyon, mangyaring piliin ang mga link, sa ibaba:
  Share My Data terms and conditions (PDF, 190 KB)
  Electric Rule No. 27 (PDF, 1.6 MB)
  Attachment D sa Desisyon 11-07-056 (PDF)
  Maghanap ng higit pang impormasyon: Kodigo Sibil ng California Seksyon 1798.80 – 1798.84

• Mangyaring sumangguni sa link, sa ibaba, para sa isang detalyadong listahan ng mga elemento ng data na sinusuportahan.

Kumuha ng higit pang impormasyon tungkol sa pag-access ng data

• Kung minsan, nawawala ang data sa paggamit ng agwat dahil nalaman ng aming mga proseso sa pagpapatunay ng upstream na data na mayroong nawawala o maling nabasang data na maaaring mangailangan ng karagdagang pagproseso (pag-edit at o pagtatantya).
• Para sa mga customer na may pagitan na sinisingil (hal., mga customer na may mga pagsasaalang-alang sa Time-of-Use na pagsingil), ang mga pagkakataong ito ay itinatama sa oras upang matiyak ang tumpak na pagkalkula ng singil sa kanilang paparating na buwanang singil.

• Kung gusto mong makatanggap ng mga pagwawasto ng data, pakitiyak na lagyan mo ng check ang Notify Me as Data is Ready checkbox habang nagpaparehistro o sa pamamagitan ng pag-log in sa iyong online na account at pagpili sa checkbox na ito sa ilalim ng Edit Profile. Pagkatapos, isasama namin ang mga pagwawasto ng data na nakuha ng aming system sa nakaraang 24 na oras, bilang bahagi ng pang-araw-araw na feed ng paggamit, para sa anumang data na pinahintulutan kang i-access.
• Data corrections ang anumang mga pagbabago para sa awtorisadong panahon, hanggang sa maximum na tatlong taon.

Tandaan: Bilang pagsasaalang-alang sa Rule 24 Demand Response Provider at iba pang mga programa gamit ang Share My Data, ang mga after-the-fact na pagwawasto para sa mga dating awtorisadong hanay ng petsa ay maaaring ibigay sa mga 3rd party hanggang sa tatlong taon pagkatapos ng pag-expire ng awtorisasyon.

• Kung naaangkop, magpapadala ang PG&E ng mga notification sa iyong URL ng notification na ibinigay sa panahon ng pagpaparehistro. Notifications ay binubuo ng mga URL na tumutugma sa naka-pre-packaged na data na handa para sa iyo na bumalik at humiling sa mga ibinigay na URL. Data at ipinapadala ang mga notification sa sumusunod na dalawang senaryo: (1) pinili mo ang "Abisuhan ako bilang handa na ang data" sa iyong profile sa pagpaparehistro, kung saan ipapakete namin ang pinakabagong pang-araw-araw na data na may anumang mga pagwawasto para sa nakaraan petsa, o (2) gumawa ka ng mas naunang ad hoc asynchronous na kahilingan kung saan handa na ang hiniling na data. Scenario 1 ay inilalarawan sa ilalim ng "DATA ACCESS: DAILY SUBSCRIPTION" na seksyon ng mga diagram ng Data Access Methods sa Data Access Page at ang sitwasyon 2 ay inilalarawan sa ilalim ng "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" na seksyon ng parehong mga diagram din sa Data Access Page.

Bisitahin ang data access sa itaas

• Ang data ng paggamit ng kuryente na ibinigay ng Share My Data ay hindi Settlement Quality Meter Data (SQMD) gaya ng tinukoy ng California Independent System Operator (CAISO). SQMD sa pamamagitan ng pag-multiply ng Revenue Quality Meter Data (RQMD) sa Distribution Loss Factor (DLF) na naaangkop sa antas ng boltahe ng customer para sa interval na iyon, pag-convert ng mga metered interval sa interval period na kinakailangan ng CAISO at pagkatapos ay pagbubuod ng mga resulta para sa bawat pagitan sa pinagsama-samang antas na kinakailangan ng CAISO.
  
• PG&E ay nagpapatupad ng mga flag ng Uri ng "QualityOfReading" (QOR) na ibinigay ng pamantayan ng ESPI upang ipaalam kung ang data ay Kalidad ng Kita. Ang Uri ng QOR ay kumukuha ng iba't ibang posibleng halaga ng kalidad para sa data ng paggamit, kabilang ang isang tahasang halaga para sa "Data ng Meter ng Kalidad ng Kita" o "RQMD." PG&E itong QOR Type sa data transmittal nito gaya ng sumusunod:
  • PG&E ang klase ng "UsageSummary" na ibinigay ng ESPI, na gagamitin upang tukuyin ang mga petsa kung kailan sinisingil ang isang kasunduan sa serbisyo, ang halaga ng paggamit na sinisingil, at ang kalidad ng data ng paggamit sa oras ng kahilingan. Mapupunan ang UsageSummary kapag available na ang bill para sa hiniling na data at magsasama ng dalawang flag (mga elemento) ng Uri ng QOR:
    • Ang elemento ng UsageSummary.QualityOfReading (sa antas ng UsageSummary) na nagsasaad ng kalidad sa oras ng kahilingan ng pinakabagong ibinigay na mga halaga ng paggamit ng agwat at mga pagwawasto na tumutugma sa mga petsa ng UsageSummary.billingPeriod.
    • Ang DefaultQuality element para sa OverallConsumptionLastPeriod (bilang bahagi ng UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) na nagsasaad ng kalidad ng kabuuang nasingil na paggamit.
  • PG&E ang kalidad ng data ng paggamit sa antas ng pagitan sa oras ng kahilingan gamit ang IntervalReading.ReadingQuality.Quality element.

• Sa panahon ng pagpaparehistro maaari mong piliin kung gaano karaming makasaysayang data ang kailangan mo, alinman sa 24, 36, o 48 na buwan sa ilalim ng dropdown na "Gaano karaming makasaysayang data ang hinihiling."
• Bilang bahagi ng awtorisasyon ng customer na nagbibigay-daan sa iyong ma-access ang kanilang data, ang makasaysayang panahon para sa awtorisasyon ay made-default sa iyong seleksyon sa pagpaparehistro para sa Mga ID ng Serbisyo (mga punto ng paggamit) na kasama sa awtorisasyon.
• Maaari mong i-update ang iyong hiniling na makasaysayang data, sa pamamagitan ng pag-log in sa iyong account, pag-navigate sa Manage Registration > Edit > at pagpili mula sa dropdown na may label na "Gaano karaming historical data ang hinihiling."
• Pakitandaan na ang data na ibinigay sa makasaysayang kahilingan ay magsisimula sa petsa kung kailan ginawa ng customer ang awtorisasyon, kumpara sa petsa na ginawa mo ang kahilingan sa API.

Tandaan: Ang mga pagbabago sa iyong hiniling na makasaysayang data ay makakaapekto lamang sa mga bagong awtorisasyon ng customer, habang ang mga nakaraang awtorisasyon ng customer ay magpapakita ng iyong pagpili sa oras ng pahintulot.

• Alinsunod sa pamantayan ng ESPI, ang tugon ay gumagamit ng Atom Publishing Standard. Mangyaring piliin ang link, sa ibaba, upang makakita ng kumpletong listahan ng mga API na sinusuportahan, kasama ng mga available na elemento ng data.

Kumuha ng higit pang impormasyon tungkol sa pag-access ng data

• Active electric at gas Service ID na naka-install at nabasa ng PG&E ay kwalipikado para sa awtorisasyon sa pamamagitan ng Share My Data platform.
• Kung ang ID ng Serbisyo na nauugnay sa isang awtorisasyon ay nagbago dahil sa isa sa mga sumusunod na dahilan, ang awtorisasyon ay lilipat sa bagong ID ng Serbisyo at ang pag-access sa dating data ng paggamit ng pagitan ay magpapatuloy:
  • Pansamantalang pagsasara dahil sa hindi pagbabayad
  • Ilipat sa Interval Billing
  • Palitan ng metro
  • Pagbabago ng rate
• Iba pang mga sitwasyon na nagreresulta sa pagbabago sa ID ng Serbisyo tulad ng paglipat ng mga lokasyon o pagbabago ng isang kumpanya ay magwawakas sa pag-access. Bilang karagdagan, kung ang isang account ay na-unlink mula sa iyong My Energy account, ang lahat ng napapailalim na ID ng Serbisyo na pinahintulutan sa pamamagitan ng Ibahagi ang Aking Data ay hindi awtorisado bilang resulta.

• Upang matukoy ang granularity ng awtorisadong data ng pagitan, mangyaring sumangguni sa elemento ng Interval Length gaya ng ibinigay ng pamantayan ng ESPI.
• PG&E ay nagbibigay ng data sa paggamit ng interval sa parehong granularity tulad ng nakolekta para sa mga layunin ng pagsingil, na karaniwang sa isang oras-oras o 15 minutong batayan para sa electric data at araw-araw para sa data ng gas para sa mga customer na may interval meter. Bagama't maaari itong mag-iba ayon sa customer, ang paggamit ng electric interval meter ay karaniwang magagamit sa oras-oras na antas para sa karamihan ng mga residential na customer at sa 15 minutong antas ng interval para sa karamihan ng mga komersyal na customer, at ang paggamit ng gas interval meter ay karaniwang magagamit sa pang-araw-araw na antas para sa karamihan. mga customer.
• Para sa mga non-interval meter, ibibigay ang data kapag available.

• Para sa karamihan ng mga customer ng PG&E na may naka-install na Smart Meter, available ang data ng paggamit ng electric at gas interval sa pagtatapos ng susunod na araw sa pamamagitan ng platform ng Share My Data.
• Ang maliit na bahagi ng PG&E electric customer na may naka-install na power line carrier based MV90 meters ay maaaring mangailangan ng karagdagang oras para maging available ang data.

• Bagama't hindi namin direktang suportahan ang pag-setup ng iyong mga API, mayroon kaming ilang mapagkukunang magagamit upang tulungan ang iyong IT at mga teknikal na mapagkukunan sa proseso ng pagbuo. Mangyaring sumangguni sa aming pahina ng Dokumentasyon ng API upang matuto nang higit pa. Mangyaring huwag mag-atubiling makipag-ugnayan sa ShareMyData@pge.com para sa anumang karagdagang mga katanungan.

Para sa karagdagang impormasyon, bisitahin ang application programming interface (API)