Ibahagi ang Aking Data para sa mga third party

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

Karagdagang reference na materyal na lampas sa impormasyon sa ibaba:

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

Tandaan: Para sa mga Community Choice Aggregators, ang client_access_token lamang ang kailangan upang humiling ng data (sa pamamagitan ng 2 Legged OAuth) at ang mga sumusunod ay hindi nalalapat.

Mga awtorisasyon na sinimulan sa site ng third party

Upang simulan ang isang awtorisasyon mula sa isang third party na site tulad ng nakalarawan sa unang diagram sa itaas, ang isang kahilingan sa code ng awtorisasyon ay ginawa sa pamamagitan ng pag redirect ng browser ng customer mula sa iyong site ng third party sa PG&E's AuthorizationServer Authorization Endpoint URL na may naaangkop na mga parameter ng kahilingan tulad ng halimbawa sa ibaba. Sa pag redirect, ang customer ay ipapakita ng isang pahina ng pag log in ng PG &E para sa pagpapatunay, na sinusundan ng isang pahina ng awtorisasyon para sa pag awtorisa ng pag access ng data sa iyong third party:

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

• Mga Mandatory Request Parameter:
  • client_id = Client ID mula sa iyong mga milestone sa pagpaparehistro ng Share My Data (i.e., client_id/client_secret pares).
  • redirect_uri = redirect URL na tinukoy mo sa iyong Ibahagi ang Aking Data pagpaparehistro (URL ay dapat tumugma).
    Tandaan: Inirerekumenda namin ang pag encode ng URL na ilapat sa redirect_uri tulad ng bawat halimbawa sa ibaba.
  • response_type = code (static na halaga)
• (Mga) Opsyonal na Parameter ng Kahilingan:
  • estado = opsyonal na opaque estado parameter ayon sa pinapayagan ng OAuth 2.0 standard na ibinalik pabalik sa authorization code upang makatulong na mapanatili ang estado. Halimbawa, ang parameter ng estado ay maaaring gamitin ng isang third party upang natatangi na matukoy ang pinagmulan ng customer at upang maiwasan ang cross site na pagpapahuwad.
  • login={guest} Magbigay ng pagpipilian para sa isang third party na i-redirect ang mga customer sa My Energy log ng PG&E o sa tab na Guest Access bilang bahagi ng online authorization flow.

HALIMBAWA: Auth code request

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

Tandaan: halimbawa redirect_uri parameter sa itaas ay may URL encoding inilapat (ie URL encoding ng https://thirdparty.com/redirectUrl)

Kung gumawa ka ng isang wastong kahilingan tulad ng sa itaas, at matagumpay na pinatutunayan at pinahintulutan ng customer, ang customer ay kasunod na mai redirect sa iyong redirect_uri gamit ang code ng awtorisasyon, (awtorisadong) parameter ng saklaw, at opsyonal na parameter ng estado (kung ibinigay bilang bahagi ng kahilingan sa awtorisasyon) tulad 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_37_ 38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; BlockDuration=Araw-araw; HistoryLength={3P Rehistradong haba ng kasaysayan}; AccountCollection={count of authorizedSAs};BR={ThirdPartyID}; dataCustodianId=PGE &state=pge12advertisement

Tandaan: Ang Authorization Code ay panandalian (mag-eexpire sa loob ng 600 segundo), at dapat itong ipagpalit sa susunod para sa isang access token/refresh token pair upang makumpleto ang awtorisasyon at payagan ang pag-access sa data na patuloy. Tingnan ang susunod na seksyon (Section 2) para sa mga detalye sa kahilingan ng Access Token/ Refresh Token.

Ang (awtorisadong) parameter ng saklaw na halimbawa sa itaas ay ibinabalik bilang bahagi ng mga tugon sa Kahilingan sa Code ng Awtorisasyon, ang Kahilingan sa Access Token, pati na rin ang API ng Awtorisasyon. Ang saklaw na parameter na ito ay nagbibigay daan para sa pakikipag usap sa pangwakas na saklaw ng awtorisasyon ng customer. Sa partikular, ang saklaw ng parameter ay may kasamang isang "AdditionalScope" na halaga na mapa sa suportado ng PG &E na mga pagpipilian sa awtorisasyon ng customer ng mga grupo ng data (hal., "Paggamit", "Billing", "Basic", "Account", "Program Enrollment"). Ang mga halaga ng parameter ng saklaw ay higit pang nakunan sa bawat sumusunod na dokumentasyon ng sanggunian: Download Suportadong Function Block Scope String Mapping Click Thru 2.0 (PDF, 222 KB).

Mga Scenario ng Error

Mga Error sa Pagpapatupad ng Third Party: Kung ang kinakailangang mga parameter ng kahilingan ng client_id o redirect_uri ay hindi wasto o nawawala sa paghiling ng isang code ng awtorisasyon, ang customer ay ipapakita ng isang paliwanag na mensahe kasama ang standard na error sa serye ng HTTP 400. Katulad nito, kung ang kinakailangang parameter ng kahilingan ng response_type ay nawawala o hindi wasto, ang customer ay mai redirect pabalik sa iyong redirect_uri na may OAuth 2.0 na tinukoy na "invalid_request" error parameter pati na rin ang opsyonal na parameter ng estado kung unang ibinigay bilang bahagi ng orihinal na kahilingan sa code ng awtorisasyon.

Mga Customer na Tumanggi sa Awtorisasyon: Sa isang third party na nag redirect ng isang customer upang pahintulutan sa PG &E, ang isang customer ay may pagpipilian na tanggihan sa pamamagitan ng isang pindutan ng "kanselahin" sa parehong pahina ng pag log in at pahina ng awtorisasyon. Sa gayong mga pagkakataon, ang customer ay mai redirect pabalik sa iyong redirect_uri na may OAuth 2.0 na tinukoy na "access_denied" error parameter na nakalakip upang ipahiwatig ang customer na tumanggi na pahintulutan. Bilang karagdagan, ang opsyonal na parameter ng estado ay ibabalik kung unang ibinigay bilang bahagi ng orihinal na kahilingan sa code ng awtorisasyon.

Mga Awtorisasyon na Sinimulan sa PG&E

Kapag nagsimula ang mga customer sa web portal ng customer ng PG&E, "Ang Iyong Account," at pagkatapos ay mag navigate sa share my data landing page, ipinakita sa kanila ang isang dropdown ng mga rehistradong at nakikitang mga third party. Tulad ng nakalarawan sa ikalawang diagram sa itaas, sa isang customer na pumili ng isang third party mula sa listahan ng mga rehistradong third party at piliin ang "Susunod," ang customer ay mai redirect sa rehistradong "Third Party Portal URI" ng third party, kung saan ang mga customer ay maaaring magpatuloy sa ikatlong partido na sinimulan 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 kasong ito ng paggamit (ibig sabihin, mga awtorisasyon na sinimulan sa site ng PG &E) tulad na sa customer ay lumilitaw na sila ay dadalhin nang direkta sa isang pahina ng awtorisasyon sa pagpili ng isang third party mula sa dropdown. Upang mapadali ang naturang karanasan sa customer, ang mga third party ay maaaring maghalal upang itakda ang kanilang "Third Party Portal URI" (sa pamamagitan ng pahina ng pamamahala ng pagpaparehistro ng Share My Data) sa isang endpoint na awtomatikong nag redirect ng customer pabalik sa PG &E bilang bahagi ng isang kahilingan sa code ng awtorisasyon. Sa awtomatikong pag redirect pabalik sa awtorisasyon ng Server Authorization Endpoint ng PG&E, lalampasan 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 nakarehistro bago ang Share My Data Click Thru 2.0 release sa huling bahagi ng Hunyo ng 2018, ito ay maaaring maisakatuparan sa pamamagitan lamang ng pagtukoy sa Third Party Portal URI upang pantay ang hindi na ginagamit na "Third Party Scope Selection Screen" URI (field na magreretiro sa isang hinaharap na release).

Sa kabilang banda, ang ilang mga third party ay maaaring nais na unang makisali at i screen ang mga customer sa kanilang panig kapag ang mga customer ay nai redirect sa kanilang "Third Party Portal" URI bago humiling ng isang code ng awtorisasyon, kaya ang diskarte sa itaas ay isang mungkahi lamang.

Upang makakuha ng Access Token, gamitin ang Authorization Code na natanggap at tawagan ang below endpoint na may mga parameter ng kahilingan tulad ng inilarawan sa ibaba. Tulad ng inilarawan sa itaas, ang Code ng Awtorisasyon ay maikli ang buhay, na nag eexpire pagkatapos ng 10 minuto (600 segundo), kaya mangyaring tiyakin na ang Access Token ay agad na hiniling sa pagtanggap ng isang Code ng Awtorisasyon.

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

• Mga Mandatory Request Parameter:
  • grant_type = authorization_code (static na halaga)
  • code = authorization code na natanggap bilang tugon sa kahilingan ng authorization code
  • redirect_uri = redirect URL na tinukoy mo sa iyong Ibahagi ang Aking Data pagpaparehistro (URL ay dapat tumugma).
    Tandaan: Tulad ng kahilingan sa code ng awtorisasyon, inirerekumenda namin ang pag encode ng URL na ilapat sa redirect_uri.

HALIMBAWA: 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 header ng Awtorisasyon na may Base64 na pag encode na inilapat "clientID: clientSecret"

Tandaan: Ang clientId:clientSecret values ay tumutugma sa mga halaga ng clientID na ibinigay sa iyong Share My Data registration milestones.
Ang header parameter ay magiging sa sumusunod na format:
Param name : Awtorisasyon
Halaga ng param : Basic "base64encoded string"

Ang isang matagumpay na tugon ay ganito ang hitsura:

774ff105-7AD5-40C8-A6EC-F60675Dc0E41
3600
998C6654-5b3b-4385-AF4F-4E5C46C1BB04
scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; BlockDuration=Araw-araw; HistoryLength={3P Rehistradong 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} e.g:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Tandaan: Ang isang Access Token ay nag expire sa 3600 secs (1 oras), habang ang kaukulang Refresh Token ay nag expire sa 1 taon. Tingnan ang susunod na bahagi 3 para sa mga detalye sa pagkuha ng isang bagong pares ng Access Token / Refresh Token.

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.

Tulad ng bawat pinakamahusay na kasanayan, ang Access Token ay isang panandaliang token (1 oras) habang ang kaukulang Refresh Token ay isang pangmatagalang token (1 taon) na maaari mong gamitin upang makakuha ng isang bagong pares ng Access Token / Refresh Token kapag ang Access Token ay nag expire. Upang makakuha ng bagong pares ng Access Token at Refresh Token para sa umiiral na mga awtorisasyon na hindi nag expire, gamitin ang "kasalukuyang Refresh Token" at tawagan ang below endpoint 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}

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

Magdagdag ng pangunahing parameter ng header ng Awtorisasyon na may Base64 na pag encode na inilapat "clientID: clientSecret"

Tandaan: Ang clientId:clientSecret values ay tumutugma sa mga halaga ng clientID na ibinigay sa iyong Share My Data registration milestones.
Ang header parameter ay magiging sa sumusunod na format:
Param name : Awtorisasyon
Halaga ng param : Basic "base64encoded string"

Ang isang matagumpay na tugon ay ganito ang hitsura:

{ "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_38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_
Pagpapatala ng Programa; IntervalDuration=900_3600; BlockDuration=Araw-araw; HistoryLength={3P Rehistradong haba ng kasaysayan}; 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 kaukulang Refresh Token nito ay isang pangmatagalang token (1 taon) na maaari mong gamitin upang makakuha ng isang bagong pares ng Token ng Token ng Client Access / Refresh Token kapag ang Token ng Client Access ay nag expire. Upang makakuha ng bagong pares ng Token / Refresh Token ng Client Access , sumangguni sa parehong mga hakbang na inilarawan sa itaas.

Ang mga customer ay magagawang i update ang kanilang mga awtorisasyon sa pamamagitan ng paggawa ng mga sumusunod:

• Pagtanggal ng mga Service ID mula sa kanilang mga awtorisasyon
• Pagpapalawig ng petsa ng pagtatapos ng panahon ng awtorisasyon
• Pagkansela ng awtorisasyon

Tandaan: Ang mga customer ay magagawang gumawa lamang ng mga pagbabago sa kanilang mga awtorisasyon sa pamamagitan ng pag log in sa kanilang online PG&E account at pagsunod sa mga kinakailangang hakbang. Kung gagawin ang alinman sa mga aksyong ito, ipapaalam namin sa iyo sa pamamagitan ng Notification URI na ibinigay mo sa panahon ng pagpaparehistro.

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

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

Kung hindi mo na nais na ma access ang data na nauugnay sa isang awtorisasyon, may mga opsyonal na pamamaraan upang kanselahin ang isang awtorisasyon:

• Maaari mong tawagan ang awtorisasyon pagpapawalang bisa API (http DELETE operasyon) 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 pagpasok ng Subscription ID para sa awtorisasyon na nais mong kanselahin.

Tandaan: Ang customer ay aabisuhan na ikaw ay inihalal upang kanselahin ang kanilang awtorisasyon. Bilang karagdagan, sa sandaling kanselahin ang isang awtorisasyon, ang pagkilos ay hindi maaaring baligtarin.

• Ang PG&E ay magpapadala ng mga abiso sa iyong notification URI na ibinigay sa panahon ng pagpaparehistro. Ang mga abiso ay binubuo ng mga URI na tumutugma sa naka prepackaged na data na handa para sa iyo na bumalik at humiling sa mga ibinigay na URL. Ang data ay prepackaged at ang mga notification ay ipinadala sa sumusunod na dalawang sitwasyon: (1) pinili mo ang "Ipaalam sa akin habang handa na ang data" sa iyong profile sa pagpaparehistro, kung saan ipapake namin ang pinakabagong data araw araw na may anumang mga pagwawasto para sa mga nakaraang petsa, o (2) gumawa ka ng isang mas naunang ad hoc asynchronous na kahilingan kung saan ang hiniling na data ay handa na ngayon.
• Ang Scenario 1 ay inilalarawan sa ilalim ng "DATA ACCESS: DAILY SUBSCRIPTION" na seksyon ng mga diagram ng Mga Paraan ng Pag access ng Data sa ibaba at ang Scenario 2 ay inilalarawan sa ilalim ng "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" seksyon ng parehong mga diagram sa ibaba.

Mangyaring tandaan ang token lifetime ng Access Tokens, Client Access Token, at ang kanilang kaukulang Refresh Tokens na ginamit sa mga kahilingan ng data. Tulad ng bawat pinakamahusay na kasanayan, ang Access Token ay isang panandaliang token (1 oras) habang ang refresh token ay isang pangmatagalang token (1 taon) na maaari mong gamitin upang makakuha ng isang bagong pares ng Access Token / Refresh Token kapag ang Access Token ay nag expire. Katulad nito, ang Client Access Token ay isang panandaliang token (1 oras) habang ang kaukulang Refresh Token nito ay isang pangmatagalang token (1 taon) na maaari mong gamitin upang makakuha ng isang bagong pares ng Token ng Token ng Client Access / Refresh Token kapag nag expire ang Token ng Client Access Token. Para sa higit pang mga detalye sa pagkuha ng isang bagong pares ng token, sumangguni sa Hakbang 3, Humihingi ng isang bagong access token, sa aming mga detalye ng awtorisasyon tab. Pumunta sa mga detalye ng awtorisasyon

Kung ikaw ay awtorisado ng customer na makatanggap ng alinman sa "Impormasyon sa Account" (Account ID, ID ng Kasunduan sa Serbisyo 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 ESPI na tinukoy na RetailCustomer APIs kung saan ang data ay umaayon sa schema, retailCustomer.xsd, na ibinigay sa itaas.

Synchronous (Standard at EEF third party)

Ang isang diskarte upang humiling ng data ng customer ay ang paggamit ng synchronous API para sa paghiling ng impormasyon ng customer para sa isang solong awtorisasyon ng customer para sa data ng customer (ibig sabihin, Retail Customer):

Halimbawa ng Synchronous Request URL: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID na natanggap mo sa dulo ng pagkakasunod sunod ng awtorisasyon ng OAuth upang makakuha ng isang access token. Ang RetailCustomerID ay bahagi ng customerResourceUri path parameter sa tugon ng token. (RetailCustomerID=SubscriptionID)

HTTP Header = Awtorisasyon:Bearer {access token para sa awtorisasyon na ito}

Response = makakakuha ka ng back data synchronously para sa na RetailCustomerID. Ang data ay umaayon sa retailCustomer.xsd

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

Para sa sanggunian: ang hierarchical diagram sa ibaba ay nagpapakita ng 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 API para sa paghiling ng impormasyon ng customer para sa lahat ng iyong mga awtorisasyon ng customer para sa data ng customer (i.e. Retail Customers).

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

Halimbawa Asynchronous Request URL:
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 = Awtorisasyon:Bearer {client access token makuha sa panahon ng pagsubok sa pagpaparehistro}

Tugon = HTTP status code 202 (Ito ay isang asynchronous na kahilingan kung saan ang tugon ay mai post sa URL ng notification kapag handa na ang data). Kapag handa na ang data, kami ay POST ng isang abiso sa iyong ibinigay na notification URI na may isang payload ng mga URL ang iyong application ay maaaring bumalik upang makuha ang paunang naka package. Ang sample post notification ay mukhang sa ibaba

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

Magsagawa ng GET sa itaas na URL na may token ng Client Access upang makuha ang data.

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

Huling maaari mong makuha ang pinakabagong impormasyon ng customer sa isang pang araw araw na batayan gamit ang pang araw araw na modelo ng subscription (ibig sabihin, sa pamamagitan ng pagpili ng "Ipaalam sa akin bilang data ay handa na (araw araw)" checkbox sa panahon ng pagpaparehistro).

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

Kapag handa na ang data, kami ay POST ng isang abiso sa iyong ibinigay na notification URI na may isang payload ng mga URL ang iyong application ay maaaring bumalik upang makuha ang paunang naka package. Ang sample post notification ay mukhang nasa ibaba:

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

Magsagawa ng GET sa itaas na URL na may token ng Client Access upang makuha ang data.

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

Kung ikaw ay pinahintulutan 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 umaayon sa schema, espiDerived.xsd, na ibinigay sa itaas.

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

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

Halimbawa ng Synchronous Request URL:
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 kahilingan na ito para sa paghila ng data. Ang petsa ay nasa Zulu oras ng yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 format)

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

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

Subscription ID = SubscriptionID na natanggap mo sa dulo ng pagkakasunod sunod ng awtorisasyon ng OAuth upang makakuha ng isang access token. Ang subscription ID ay bahagi ng parameter ng resourceURI sa tugon ng token. (SubscriptionID = RetailCustomerID)

UsagePointID = UsagePoint sa ilalim ng ID ng subscription sa itaas. Maaari mong makuha ang lahat ng mga puntos ng paggamit para sa isang naibigay na Subscription sa pamamagitan ng pagtawag sa ibaba ng URL ng API 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 = Awtorisasyon:Bearer {access token para sa Subscription na ito}

Response = makakakuha ka ng back data synchronously para sa na paggamit point para sa hiniling na panahon. Magkakaroon ito ng parehong interval usage data () at bill data ().

Ang mga synchronous na paggamit ng mga API (tulad ng ipinahiwatig ng konstruksiyon ng URL na nagtatapos sa Usage Point ID) ay nasa indibidwal na antas ng Point ng Paggamit (ibig sabihin, antas ng Kasunduan sa Serbisyo), kaya ang isang application ay mag cycle ng mga kahilingan sa pamamagitan ng bawat isa sa mga ID ng Usage Point na kabilang sa isang ibinigay na awtorisasyon ng customer (ibig sabihin, subscription).

Ang tugon sa mga synchronous na kahilingan ay nagbabalik ng parehong agwat ng data (sa ilalim) na nauugnay sa hanay ng petsa na hiniling pati na rin ang anumang buwanang kabuuan ng paggamit at mga bayarin na napapatong sa hiniling na hanay ng petsa (sa ilalim ).

• Ang IntervalReading ay naglalaman ng interval (15 min/hourly) electric usage at interval (araw araw) data ng paggamit ng gas
• Ang Buod ng Paggamit ay naglalaman ng buwanang kabuuan ng paggamit at mga detalye ng bill (kung awtorisado)

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

Para sa sanggunian, ang hierarchical diagram sa ibaba ay nagpapakita ng 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 elementong ito ng datos:

• Intervalblock ay para sa 1 araw
• Ang IntervalReading (sa ilalim ng Interval Block) ay naglalaman ng aktwal na 15 min/hourly electric usage values at daily gas usage values
• Para sa mga electric customer na may on site generation (hal. Solar), ang flowDirection element ay nagpapahiwatig ng naihatid (supply) at natanggap (generation) na data ng paggamit. Para sa mga customer na may mga metro na naka configure upang basahin lamang ang net paggamit (ibig sabihin walang henerasyon sa site), ang flowDirection elemento ay nagpapahiwatig ng paggamit ay isang net halaga (pagkakaiba ng naihatid minus natanggap):
  • Direksyon ng daloy ng 1 = naihatid (enerhiya na ibinigay 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)
• Bigyan ng partikular na pansin ang Power of ten multiplier at Unit of Measure (uom) upang matiyak ang tamang pagbasa ng paggamit

Subscription ng Batch (Standard at EEF third party)

Maaari ka ring humiling ng data ng paggamit sa pamamagitan ng asynchronous API para sa lahat ng Mga Punto ng Paggamit na kabilang sa isang solong awtorisasyon ng customer para sa data ng paggamit / pagsingil (ie Subscription).

Upang suportahan ang mga kahilingan sa Ad Hoc Asynchronous (ibig sabihin, para sa higit sa isang solong Point ng Paggamit sa isang pagkakataon), ang iyong application ay kailangang suportahan ang Mga Abiso sa Post na ipapadala namin sa iyo (tulad ng bawat URL ng Abiso na ibinigay mo sa panahon ng pagpaparehistro)

Halimbawa Asynchronous Request URL
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 pagkakasunud sunod ng OAuth upang makakuha ng isang access token. Ang subscription ID ay bahagi ng parameter ng resourceURI sa tugon ng token

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

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

HTTP Header = Awtorisasyon:Bearer {access token para sa Subscription na ito}

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

Kapag handa na ang data, kami ay POST ng isang abiso sa iyong ibinigay na notification URI na may isang payload ng mga URL ang iyong application ay maaaring bumalik upang makuha ang paunang naka package. Ang sample post notification ay mukhang nasa ibaba:

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

Magsagawa ng GET sa itaas na URL na may Access token upang makuha ang data. Ito ay maglalaman ng parehong interval usage data () pati na rin ang impormasyon ng bill () para sa hiniling na panahon.

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

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 kahilingan na ito para sa paghila ng data. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

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

HTTP Header = Awtorisasyon:Bearer {client access token}

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

Kapag handa na ang data, kami ay POST ng isang abiso sa iyong ibinigay na notification URI na may isang payload ng mga URL ang iyong application ay maaaring bumalik upang makuha ang paunang naka package. Ang sample post notification ay mukhang nasa 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 upang makuha ang data. Ito ay maglalaman ng parehong interval usage data () pati na rin ang impormasyon ng bill () para sa hiniling na panahon.

Huling maaari mong makuha ang pinakabagong impormasyon sa paggamit at pagsingil kabilang ang mga pagwawasto para sa mga nakaraang petsa sa loob ng mga panahon ng awtorisasyon ng customer sa isang pang araw araw na batayan gamit ang pang araw araw na modelo ng subscription (ibig sabihin, sa pamamagitan ng pagpili ng "Ipaalam sa akin bilang data ay handa na (araw araw)" checkbox sa panahon ng pagpaparehistro).

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

Kapag handa na ang data, kami ay POST ng isang abiso sa iyong ibinigay na notification URI na may isang payload ng mga URL ang iyong application ay maaaring bumalik upang makuha ang paunang naka package. Ang sample post notification ay mukhang nasa 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 upang makuha ang data. Ito ay maglalaman ng parehong interval usage data () pati na rin ang impormasyon ng bill () para sa hiniling na panahon.

Hunyo 20, 2024

Ang Share My Data Platform (SMD) ng PG&E para sa Pagbabahagi ng Data na Pinahintulutan ng Customer sa mga Third party Service Provider ay naglabas ng Phase 2 ng aming Meter ID Enhancement, na nagpapahintulot sa pagkakakilanlan ng indibidwal na Meter ID na nauugnay sa electric interval meter data.  

Ang pagpapahusay na ito ay partikular na kapaki pakinabang para sa mga senaryo ng gumagamit kung saan ang maraming metro ay nauugnay sa isang kasunduan sa serbisyo.

Phase 1:  Inilabas Marso 2023 - Binago ang mga naapektuhan na API upang simulan ang pagdaragdag ng isang halaga kasama ang halaga sa tugon na ibinalik, sa ilalim ng tag. May isang isa sa isang sulat sa pagitan ng serialNumber value at utcNumber value.

Ang impormasyong ito ay nagbibigay daan sa mga vendor na gumagamit ng mga API na ito upang bumuo ng isang tindahan ng mga talaan sa utcNumber kasama ang serialNumber halaga na nauugnay sa isang ibinigay na metro para sa kanilang customer base bago ang Phase 2 enhancement ay inilabas.

Phase 2: Inilabas Hunyo 20, 2024 - Pinapalitan ang mga halaga ng MeterReadingID mula sa kasalukuyang encode64 format ng mga halaga ng deskriptibong metro sa utcNumber. Sa sandaling ang mga pagbabagong ito ay ganap na ipinatupad, Ibahagi ang Aking Data ang mga gumagamit ay magkakaroon ng isang pinabuting kakayahan upang i link sa mga tiyak na metro agwat ng paggamit, sa mga kaso kung saan may mga maramihang mga metro ng parehong kalakal na naka link sa isang solong kasunduan sa serbisyo sa premise, sa mga tiyak na meter ID na nabuo ang paggamit. 

Ang mga sumusunod na API ay naapektuhan ng mga pagbabago sa Phase 2

Epekto ng API:

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock/{IntervalBlockID}

Ang lahat ng iba pang mga API's na may mga pagbabasa ng agwat ay hindi nagbabago at kumakatawan sa SUM ng mga agwat ng metro sa parehong mga direksyon ng daloy at sa lahat ng mga metro sa ilalim ng isang kasunduan sa serbisyo.

Bago ang release ang MeterReadingID field ay Base64 naka encode at ang halaga ibinalik ay nagpapakita ng mga sumusunod:

MeterReadingID= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

Decoded mula sa Base64 format bilang:  NzI6bnVsbDozNjAwOjE=:1:1

Ipinapakita nito ang pagbabasaTypeID:rownum:count, at pagbabasaTypeID halaga ay decoded mula sa Base64 muli bilang:

72:null:3600:1 kung saan ang mga halaga ay uom:phase:intervalLength:flowDir

UOM = 72, phase = null, intervalLength = 3600, at flowDir = 1 (delivered)

Sa Phase 2, ang patlang ng MeterReadingID ay idinagdag na may karagdagang mga character at pagkatapos dumaan sa isang paunang pag decode ay ibabalik ang mga sumusunod na resulta ng halimbawa

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

Decoded mula sa Base64 nang isang beses:  NzI6bnVsbDozNjAwOjE=:1:1:4411310546, 

Ipinapakita nito meter_UUID ay 4411310546, at ang halaga na ito ay dapat tumugma sa halaga na magagamit sa RetailCustomer API sa ilalim ng tag.

Ang halaga ng "NzI6bnVsbDozNjAwOjE=:1:1:" ay ang pagbasaTypeID:rownum:count, i.e. ang row number ay 1 at count ay 1 related sa internal database records ng PG&E. Ang pagbabasaTypeID ay decoded muli bilang:

72:null:3600:1, kung saan ang mga halaga ay uom:phase:intervalLength:flowDir

UOM = 72, phase = null, intervalLength = 3600, at flowDir = 1 (delivered)

Ang pagbabagong ito ay nagbibigay daan sa mga gumagamit upang tukuyin ang pisikal na metro at daloy ng direksyon ng interes sa agwat reads. Tandaan na ang lahat ng mga XML file ay magdadala na ngayon ng mga bagong halaga ng MeterReadingID at inilalapat ang bagong form ng pag encode ng Phase 2. Ipinapayo ng Share My Data sa lahat ng vendor na gumagamit ng anumang tawag sa API gamit ang MeterReadingID, gawin ang sumusunod na tawag sa API para makuha ang bagong MeterReadingID: .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

Marso 20, 2023

Ano ang bago:

1. Paglabas ng isang bagong code ng tugon ng API HTTP (204) para sa parehong mga synchronous at asynchronous na tawag sa API upang ipahiwatig kapag walang data na magagamit para sa hiniling na saklaw.
2. Pagsuporta sa isang label ng header ng x transaksyon na sumusuporta sa kakayahang i link ang tugon ng PG &E sa mga tiyak na tawag sa Asynchronous API sa pamamagitan ng pagbabalik ng halaga na ito kasama ang isang Correlation ID kapag handa na ang hiniling na file.
3. Pinahusay na karagdagang data granularity sa UsagePoint / MeterReadingID API sa pamamagitan ng pagbibigay ng electric interval data para sa maraming metro sa solong sitwasyon ng Kasunduan sa Serbisyo.
4. Nagbigay ng karagdagang kalinawan sa mga halaga 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 nagpapahiwatig ng pagtatantya ng lohika ay inilapat ay nasa ibaba:
   
   

5. Halaga at paglalarawan ng RQI

   0 - Valid: data na dumaan sa lahat ng kinakailangang validation check at alinman sa pumasa sa lahat ng ito o na-verify

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

   8 - Tinatayang gamit ang reference day: halaga ng data ay pinalitan ng isang machine computed halaga batay sa pagsusuri ng makasaysayang data gamit ang parehong uri ng pagsukat

   9 - Tinantya gamit ang linear interpolation: ang halaga ng datos ay nakompyuted gamit ang linear interpolation batay sa mga babasahin bago at pagkatapos nito

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

   11 - Derived: data na kinakalkula (gamit ang lohika o matematikal na operasyon), hindi kinakailangang sinusukat nang direkta

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

   13 - Halo: nagpapahiwatig na ang kalidad ng pagbasa na ito ay may halong katangian

   14 - Raw: data na hindi dumaan sa proseso ng pagpapatunay, pag-edit at pagtatantya. NOTE MV90 Meters RQI indicator ay mananatili sa 14 bilang isang pangwakas na RQ status

   15 - Normalized para sa panahon: ang mga halaga ay naiakma sa account para sa 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 - Validated: data na na validated at posibleng na-edit at / o tinatayang alinsunod sa inaprubahan pamamaraan

   18 - Napatunayan: data na nabigo ng hindi bababa sa isa sa mga kinakailangang tseke sa pagpapatunay ngunit natukoy na kumatawan sa aktwal na paggamit

   19 - Kalidad ng kita: balido 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 vendor API sa Share My Data Third Party vendor portal.

Nobyembre 15, 2018

Ano ang bago:

1. Ang Customer Class Indicator ay idinagdag. Ang bawat SAID na awtorisado ay makikilala bilang RES, AGR, COM/IND o Other.
2. Ang mga API sa pagsingil at Paggamit ay ma-update upang tanggapin ang mga parameter ng query na na-update at na-update na min (bilang alternatibo sa na-publish na min at na-publish-max). Ang data na ibinalik ay magiging lahat ng mga pagbabago na naganap sa loob ng mga parameter na na-update at na-update-min.
3. Pagpapalit ng paggamit ng 5 digit Bulk ID ng isang third party sa Client ID ng third party para sa online authorization flow.
4. Pagbibigay ng pagpipilian para sa isang third party upang i redirect ang mga customer sa alinman sa pag login ng account ng PG &E o sa tab ng Guest Access bilang bahagi ng online na daloy ng awtorisasyon.
5. Pagpapabuti ng 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:

Nagdagdag ang PG&E ng mga bagong elemento ng data sa Rule 24 data set bilang bahagi ng proyekto ng Expanded Data Set (EDS) ng PG&E, at ang kaukulang mga bagong elemento ng data ay ipinakilala sa Rule 25 data set. Ang mga tiyak na elemento ng data na binubuo ng pinalawak na hanay ng data ng Rule 25 ng PG &E ay nakatakda sa ibaba na may pagtatalaga ng 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
ID ng
Serbisyo Mga Pagbabago sa Hinaharap sa Katayuan ng Serbisyo
Katayuan ng SA
Petsa
ng Simula ng Serbisyo Address ng
Serbisyo Kasalukuyang Tariff
ng Serbisyo Tariff
sa Serbisyo na Sinisingil sa Kasaysayan Mga Pagpipilian sa Tariff (Medical Baseline, CARE, FERA, TBS, CCA_TBS, Solar Choice
Kasalukuyang Serbisyo Boltahe at Kalakal Makasaysayang Billed Serbisyo Boltahe
Numero ng
Meter ng Serbisyo Bilang ng mga Meter
ng Serbisyo Uri ng Meter
Kasalukuyang Meter Read Cycle
Historical Billed Meter Read Cycle
Kasalukuyang Standby Rate Option kung Tagapagpahiwatig
ng Henerasyon sa site Opsyon
sa Historical Billed Standby Rate EDS: Tagapagpahiwatig
ng Klase ng Customer Mga Elemento
ng Pagsingil sa Kasaysayan Petsa
ng pagsisimula ng bill Petsa
ng pagtatapos ng bill Bill kabuuang singil($)
Bill total kWh
EDS: Pangalan ng Service Provider
Makasaysayang Bill Tier Breakdown (kung mayroon man)
EDS: Panahon ng Bill
ng Line Item EDS: Pangalan (Higit sa Baseline 1%-30%)
EDS: Tomo (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Historical Bill TOU kWh breakdown (maliban sa ABS TX na sinisingil)
EDS: Line Item Bill Period (para sa pagkasira ng TOU)
EDS: Pangalan (ng TOU charge)
EDS: Tomo (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Makasaysayang Bill Demand Breakdown
EDS: Line Item Bill Period (para sa Demand breakdown)
EDS: Pangalan
EDS: Tomo (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Mga Item
sa Linya ng Bill ng Kasaysayan EDS: Panahon ng Bill
ng Line Item EDS: Pangalan ng singil (DWR Bond Charge)
EDS: Tomo (1234.2)
EDS: Unit (kWh)
EDS: Rate ($0.032/kWh)
EDS: Gastos ($100.23)
Mga Interval ng
Paggamit sa Kasaysayan Simula
ng Paggamit ng Interval Default na Interval Duration (sa ilang segundo)
Dami ng agwat ng paggamit (1234.2)
Unit (kWh / Therms)
Mga Programa
sa Pagtugon sa Demand ng Utility (DR) Pangalan ng Programa
Pinakamaagang Petsa ng Pagwawakas nang Walang Obligasyong Pinansyal
Pinakamaagang Petsa ng Pagwawakas anuman ang Obligasyong
Pinansyal Katayuan
ng Programa ng DR Petsa ng
Pagpapatala ng DR Program DR Program Petsa
ng Pag alis ng Enrollment Mga Elemento ng
Data Kalakal
Mga Parameter ng Lokal na Oras (mga detalye ng DST)
Default na Kalidad ng
Data Direksyon ng Enerhiya
Kapangyarihan ng Sampung Multiplier (para sa mga halaga ng paggamit ng agwat)
Kapangyarihan ng Sampung Multiplier (para sa Billed Demand)
Kapangyarihan ng Sampung Multiplier (Para sa Billed kabuuang paggamit)
Haba ng Pagitan(ng Pagbasa ng Paggamit)
Pera ng bill kabuuang gastos
Electric Interval TOU Mga tagapagpahiwatig

Hunyo 28, 2018

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

Ano ang bago:

Ang pinaka kritikal na mga pagbabago na nakakaapekto sa mga third party ay mga pagbabago upang umayon sa OAuth 2.0 protocol (PG&E tinanggal ang paunang serye ng mga pag redirect). Hanapin ang mga detalye sa ibaba.

MAHALAGA: Ang mga third party ay REQUIRED na gumawa ng mga pagbabago sa kanilang umiiral na OAuth implementation. Ang mga pagbabago sa Click-Through Phase 2 ng PG&E ay HINDI paurong na tugma, kaya kinakailangan para sa mga third party na ipatupad ang mga pagbabago kasabay ng pagpapatupad ng PG&E. Nang walang pagpapatupad, ang kasalukuyang proseso ng awtorisasyon ng customer ay titigil sa pagtatrabaho sa petsa ng pagputol ng Hunyo 29, 2018. Gayunpaman, ang mga umiiral na awtorisasyon ay hindi naapektuhan.

1. Upang umayon sa protocol ng OAuth 2.0, ang PG&E ay nabawasan ang bilang ng mga hakbang sa pag redirect para sa awtorisasyon. Ang paunang redirect sa PG&E para sa mga customer na mag log in at magsumite ng isang awtorisasyon ay pinagsama sa kahilingan ng authorization code tulad ng sumusunod:
   • Tulad ng ipinapakita sa halimbawa sa ibaba, ang mga kahilingan sa code ng awtorisasyon ng third party ay bumubuo ngayon ng isang redirect ng browser ng customer sa bagong awtorisasyon ng PG &E ServerAuthorizationEndpoint URI, 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 nagretiro: 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 hindi wastong mga parameter ng saklaw tulad ng sumusunod:
   • Kung ang kinakailangang client_id o redirect_uri mga parameter ay nawawala o hindi wasto, ang isang (http 400) error na may paliwanag na mensahe ay ipinapakita sa customer
   • Kung ang kinakailangang parameter ng response_type ay nawawala o hindi wasto, ang customer ay ire redirect pabalik sa redirect_uri ng third party na may isang "invalid_request" error parameter (nakalakip sa redirect_uri)
     
3. Para sa mga customer na may umiiral na online na awtorisasyon, ang kakayahan para sa isang third party na humiling ng isang bagong access_token / refresh_token pares bilang bahagi ng isang bagong awtorisasyon na pumapalit sa umiiral na isa (ibig sabihin, online na awtorisasyon ng parehong third party at kumbinasyon ng customer). Ang pag andar na ito ay tumatalakay sa mga sitwasyon ng mga third party na nawawalan ng isang pares ng access_token / refresh_token o kung hindi man ay kailangang baguhin ang saklaw ng orihinal na awtorisasyon bawat pag apruba ng customer.
   • Para sa mga kahilingan sa muling pagpapahintulot, nakikita ng customer ang bagong pahina ng awtorisasyon sa halip na ang pahina ng "pamahalaan ang awtorisasyon" kapag na redirect ng isang third party sa PG&E para sa awtorisasyon
   • Sa pahintulot ng customer, ang mga third party ay tumatanggap ng isang abiso sa kanilang rehistradong URL ng notification na ang lumang subscription ID ay kinansela (ang notification ay binubuo ng awtorisasyon API URL endpoint para sa lumang ID ng subscription)
     
4. Ang kakayahan para sa isang customer na lumabas sa pamamagitan ng isang pindutan ng "kanselahin" sa alinman sa pahina ng pagpapatunay o pahina ng awtorisasyon na may redirect pabalik sa redirect_uri ng third party na may isang "access_denied" error parameter (nakalakip sa redirect_uri)
5. Para sa mga third party na magparehistro sa setting na "visibility" sa at samakatuwid ay kasama sa listahan ng mga rehistradong third party na makikita ng mga customer kapag pumunta sila sa kanilang PG&E online account at mag navigate sa Share My Data landing page:
   • Para sa mga customer na nag log in sa kanilang PG&E online account at nag navigate sa Share My Data landing page at pagkatapos ay na redirect sa rehistradong "Third Party Portal URI" ng third party sa pagpili ng isang third party mula sa listahan ng mga rehistradong third party. Sa puntong iyon, ang mga customer ay maaaring magpatuloy sa third party na sinimulan na proseso ng OAuth. Kapag dumadaan sa landas na ito, ang mga customer ay hindi na ipapakita ang pahina ng pahintulot sa pagpili ng isang third party mula sa listahan ng dropdown ng mga third party, ngunit sa halip ay mai redirect sa rehistradong "Third Party Portal URI" ng third party kung saan maaari nilang simulan ang ikatlong partido na sinimulan ang proseso ng OAuth
   • Tandaan: Ang ilang mga third party ay nagtanong tungkol sa kung paano i streamline ang karanasan ng customer para sa kasong ito ng paggamit (ibig sabihin, mga awtorisasyon na sinimulan sa site ng PG &E) tulad na sa customer lumilitaw na sila ay dadalhin nang direkta sa isang pahina ng awtorisasyon sa pagpili ng isang third party mula sa dropdown. Upang mapadali ang naturang karanasan sa customer, ang mga third party ay maaaring maghalal upang itakda ang kanilang "Third Party Portal URI" (sa pamamagitan ng pahina ng pamamahala ng pagpaparehistro ng Share My Data) sa isang endpoint na awtomatikong nag redirect ng customer pabalik sa PG &E bilang bahagi ng isang kahilingan sa code ng awtorisasyon. Sa awtomatikong pag redirect pabalik sa awtorisasyon ng PG&E ServerAuthorizationEndpoint, lalampasan 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 nakarehistro bago ang Ibahagi ang Aking Data Click Thru 2.0 release, ito ay maaaring maisakatuparan sa pamamagitan lamang ng pagtukoy sa Third Party Portal URI upang pantay ang hindi na ginagamit na "Third Party Scope Selection Screen"URI (lumang SMD Registration field na retirado sa isang hinaharap na release).
     Sa kabilang banda, ang ilang mga third party ay maaaring nais na sa halip ay unang makisali at i screen ang mga customer sa kanilang panig kapag ang mga customer ay nai redirect sa kanilang 'Third Party Portal' URI bago humiling ng isang code ng awtorisasyon, kaya ang diskarte sa itaas ay isang mungkahi lamang.
     
6. Ang SMD ay magbibigay ngayon ng pinahusay na mga detalye ng parameter ng Saklaw bilang bahagi ng mga tugon sa Kahilingan sa Code ng Awtorisasyon, ang Kahilingan sa Access Token, at ang API ng Awtorisasyon. Ang pinahusay na saklaw parameter ay nagbibigay daan para sa pakikipag usap ang pangwakas na saklaw ng awtorisasyon ng customer. Sa partikular, ang saklaw ng parameter ay may kasamang isang "AdditionalScope" na halaga na mapa sa suportado ng PG &E na mga pagpipilian sa awtorisasyon ng customer ng mga grupo ng data (hal. "Paggamit", "Billing", "Basic", "Account", "Program Enrollment"). Ang mga halaga ng parameter ng saklaw ay higit pang nakunan bawat sumusunod na dokumentasyon: Download Suportadong Function Block Saklaw String Mapping Click Thru 2.0 (PDF)
   
   Ang isang halimbawa ng tugon ng Token sa ibaba ay naglalarawan ng ilang posibleng mga halaga ng parameter ng saklaw.
   • Halimbawa ng Tugon ng Token:
     
     774ff105-7AD5-40C8-A6EC-F60675Dc0E41
     3600
     998C6654-5b3b-4385-AF4F-4E5C46C1BB04
     scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; BlockDuration=Araw-araw; HistoryLength={3P Rehistradong haba ng kasaysayan}; AccountCollection={count of authorized SAs};BR={ThirdPartyID}; dataCustodianId=PGE
     resourceURI:{ResourceURI} e.g: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} e.g: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} e.g:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Maaari na ngayong magparehistro ang mga third party upang makatanggap ng awtorisadong impormasyon sa Pagpapatala ng Programa sa pamamagitan ng bagong grupo ng data ng "Program Enrollment". Ang parehong interval metered pati na rin ang mga customer na hindi interval metered ay magiging karapat dapat na pahintulutan ang pagbabahagi ng data para sa SMD Click-Through Phase 2. Ang isang mataas na antas ng buod ng mga bagong magagamit na mga elemento ng data na ibinigay ng grupo ng data ng Pagpapatala ng Programa ay ang mga sumusunod:
   • Pagpapatala ng Programa (pangalan/katayuan ng programa ng PG&E Demand Response at impormasyon ng CAISO):
   • (Pagsingil) Address ng account
   • Katayuan ng Kasunduan sa Serbisyo
   • (Kasalukuyan) Taripa ng serbisyo
   • (Kasalukuyan) Boltahe ng serbisyo (electric lamang)
   • Numero ng metro ng serbisyo (kung mayroon man)
   • Uri ng metro
   • (Kasalukuyan) Ikot ng Pagbasa ng Meter
   • (Kasalukuyan) Standby Rate Pagpipilian kung on site na henerasyon tagapagpahiwatig
   • (default na paggamit ng agwat) Tagal (haba sa mga segundo)
   • (Tugon sa Enrolled PG&E Demand) Pangalan ng Programa (kung naaangkop)
   • Pinakamaagang Petsa ng Pagwawakas mula sa PG&E enrolled Demand Response (DR) Program nang walang Financial Obligation
   • Pinakamaagang Petsa ng Pagwawakas mula sa PG&E enrolled Demand Response (DR) Program anuman ang Obligasyon sa Pananalapi
   • PG&E Demand Response (DR) Program (pagpapatala) Katayuan
   • Petsa ng Pagpapatala ng Programa ng PG&E Demand Response (DR)
   • Petsa ng Pagpapatala ng Programa ng PG&E Demand Response (DR)
   • Ang Atom XML XSD (XML Schema Definition) pagmamapa para sa mga bagong elemento ng data na ito ay nakuha bilang bawat sumusunod na dokumentasyon:
     I-download ang Mga Suportadong Elemento ng Data (PDF)
   • Ang kaugnay na relasyonal na data hierarchy model ay nakabalangkas sa bawat sumusunod:
     Download Modelo ng Data ng PGE ESPI (PDF)
   • UsagePoint (aka SA UUID)
     • ServiceDeliveryPoint\tariffProfile(kasalukuyang service tariff AKA rate schedule kabilang ang Standby Rate Option kung naaangkop)
     • readCycle (kasalukuyang Meter Read Cycle)PaggamitBuod
     • readCycle (siklo ng serbisyo sa pagsingil)
     • Commodity (kasama ang billed boltahe antas para sa electric)
     • tariffProfile (sinisingil na taripa ng serbisyo kabilang ang Standby Rate pagpipilian 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):
     • mainAddress/kalyeDetalye...
     • mainAddress/bayanDetalye...
     • mainAddress / postalCode...
   • Kasunduan ng Customer
     • status\value (Katayuan ng SA
   • Programa ng Pagtugon sa Demand
     • pangalan ng programa
     • enrollmentStatus
     • programaPetsa/programaPetsa
     • programaPetsa/programaPetsaPaglalarawan
   • Metro
     • serialNumber (meter id)
     • uri (uri ng metro)
     • (kasalukuyan) intervalHaba
   • Pinakabagong mga kahulugan ng ESPI xml schema (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay nakabalangkas sa bawat sumusunod:
     Mag download ng mga XSD (ZIP)
     Tandaan: ang mga XSD ay paurong na tugma.
   • Ang mga third party ay magkakaroon ng kakayahang baguhin ang kanilang pagpaparehistro upang payagan ang mga customer na piliin ang grupong ito ng data sa panahon ng awtorisasyon sa pamamagitan ng third party portal sa ilalim ng pamahalaan ang pagpaparehistro >Baguhin > seksyon: Ipahiwatig ang impormasyon ng customer na kailangan mo", piliin ang check box ng Check ng Pagpapatala ng Programa.
   • Tandaan: ito ay ilalapat lamang sa mga bagong awtorisasyon ng customer.
     
   • Ang mga bagong API upang makuha ang impormasyon sa Pagpapatala ng DR ay magagamit sa Bulk 3rd party level pati na rin sa indibidwal na antas ng awtorisasyon ng customer (RetailCustomerID level), na nakabalangkas sa bawat sumusunod:
     Mag download ng mga bagong PGE Suportadong API (PDF)
   • Asynchronous API para sa paghiling ng impormasyon ng DR Enrollment para sa lahat ng mga awtorisasyon 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 indibidwal na antas ng awtorisasyon ng 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 paurong din na katugma at kusang loob na pagpapahusay ang mga third party ay maaaring maghalal upang suportahan.

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

Ano ang bago:

1. Maaari na ngayong makinabang ang mga customer mula sa streamlined na proseso ng pahintulot ng Click-through.
   • Na update namin ang mga detalye tungkol sa kung paano ngayon maaaring magbahagi ng data ang isang customer sa iyong kumpanya.
     Alamin kung paano nagbabahagi ang mga customer ng data sa isang kumpanya
     
     Tandaan: Ang mga pagbabagong ito, lalo na ang mga pagpapabuti sa aming awtorisasyon UI, ay na optimize para sa mga mobile device (hal., mga telepono o tablet).
   • Ang mga pagbabago ay ginawa sa pamahalaan ang proseso ng awtorisasyon na naa access sa mga customer sa pamamagitan ng kanilang PG&E online account:
     • Maaari pa ring alisin ng isang customer ang mga SAID mula sa isang umiiral na awtorisasyon, palawigin ang petsa ng pagtatapos ng awtorisasyon at / o kanselahin ang awtorisasyon sa anumang oras. Gayunpaman, upang magdagdag ng karagdagang mga SAID at / o baguhin ang mga awtorisadong elemento ng data ang umiiral na awtorisasyon ay kailangang kanselahin at isang bagong awtorisasyon ay kailangang lumikha.
2. Kung nais, maaari na ngayong gamitin 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 (na ibinigay sa panahon ng paunang proseso ng pagpaparehistro ng third party ng SMD) sa pamamagitan ng isang operasyon ng DELETE: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   Tandaan 1: Para sa pagpapatupad ng PG&E, ang parameter ng AuthorizationID ay ang parehong halaga ng SubscriptionID.
   
   Tandaan 2: Ang bagong API ay nagbibigay ng mga third party ng kakayahang bawiin (kanselahin) ang isang awtorisasyon. Gayunpaman, tanging ang mga customer mismo ang maaaring alisin ang mga ID ng SA at / o i update ang petsa ng pagtatapos ng awtorisasyon sa pamamagitan ng aming SMD pamahalaan ang mga pahina ng awtorisasyon.
   
   Paalala: Tulad ng lahat ng mga kahilingan sa data ng API, ang mga third party ay dapat munang humiling ng isang bagong Token Pair (Client Access + Refresh Token) gamit ang kanilang pinakabagong Refresh Tokens.
   
   Paalala ng Mga Panahon ng Pag expire ng Token:
   • Access Token:1hr
   • Token ng Access ng Kliyente: 5 min
   • Mga Kaukulang Token ng Refresh: 1Yr
3. Ang mga third party ay maaari na ngayong lumikha ng maraming mga pagpaparehistro ng Share My Data (SMD) gamit ang parehong pangalan ng kumpanya at Tax ID kung kinakailangan. Gayunpaman, ang pangalan ng display (na nakikita ng mga customer kapag nagpapahintulot) ay kailangan pa ring maging natatangi.
   
   Tandaan: Ang lahat ng mga pagbabago sa itaas ay paurong na katugma at kusang loob na pagpapahusay ng mga third party ay maaaring maghalal upang suportahan. I-download ang mga suportang 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 ng SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga third party.

1. Sa pagsasaalang alang ng mga third party na may GBCMD (Green Button Connect My Data) pagpapatupad sa maraming mga utility bukod sa lamang PG &E, kami ay pagpasa pabalik ang dataCustodianID (ie, dataCustodianID = PGE) sa redirect sa thirdPartyScopeSelectionScreenURI sa panahon ng OAuth awtorisasyon pagkakasunod sunod.
2. Ang mga kahilingan sa API na tumatanggap ng mga parameter ng petsa (hal., batch request), ay dapat gumamit ng mga parameter ng data ng Zulu (hal., nalathala-max/ nai-publish-min). Ang iba pang mga format ng petsa para sa mga parameter ng petsa sa mga kahilingan sa API ay hindi susuportahan.
   • Ang mga API na tumatanggap ng mga parameter ng petsa ay dokumentado sa bawat nakalakip, Suportadong APIs.xlsx
3. Interval TOU indicators kasama sa Interval metered electric paggamit ng data (kung naaangkop, tagapagpahiwatig ng kung ano ang TOU panahon bawat agwat ay tumutugma sa)
   • Mangyaring sumangguni sa mga static na Program ID Mappings na nagdedetalye kung ano ang bawat agwat TOU enumeration tumutugma sa (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Suportadong Data Elements.xlsx)
4. Ang client_id tulad ng matatagpuan sa dataCustodianScopeSelectionScreenURI (ginagamit para sa third party na sinimulan OAuth) at ibinigay sa kahilingan ng Application Information Resource third party sa panahon ng Pagsubok sa Pagpaparehistro ay na update sa 5 digit kung hindi pa ito (hal., pagdaragdag ng mga nangungunang zero atbp). Bilang karagdagan, ang URL ay hindi na kasama ang '&verified = true' sa dulo. Kakailanganin ng mga third party na i update ang kanilang mga URL nang naaayon.
   • Upang i elaborate, ang dataCustodianScopeSelectionScreenURI ay mukhang sumusunod: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX ang clientID)
   • Kaya ang isang kasalukuyang clientID ng 123 ay magbabago sa isang bagay tulad ng 00123 na nangangahulugang ang kanilang bagong dataCustodianScopeSelectionScreenURI ay magiging tulad ng sumusunod:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (old URL being as follows: 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 Standard User Type. Walang mga pagbabago functionally, lamang sa user type pamagat. Ang pagkilala sa uri ng gumagamit ng ESP (mula sa Standard User type) ay isang hindi kinakailangang pagkakaiba, na nagiging sanhi ng pagkalito sa panahon ng proseso ng pagpaparehistro nang hindi nagbibigay ng anumang naiiba na pag andar, samakatuwid ito ay nagretiro.

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay paurong na katugma, at ang mga boluntaryong pagpapahusay ng mga third party ay maaaring maghalal upang suportahan.

1. Ang mga third party ay magkakaroon ng kakayahang awtomatikong baguhin / i update ang kanilang mga sertipika ng SSL na orihinal nilang ibinigay sa panahon ng pagpaparehistro (hal., kapag malapit nang mag expire ang cert) sa pamamagitan ng third party portal sa ilalim ng pamahalaan ang pagpaparehistro >Baguhin > bagong seksyon: Impormasyon sa SSL Certificate (Pagpipilian sa pag update).
2. Ang mga third party ay maaaring magrehistro upang makatanggap ng awtorisadong pangunahing info sa pagsingil, impormasyon ng customer, at data ng gas.  Ang parehong interval metered pati na rin ang mga customer na hindi interval metered 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 magagamit na mga elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa parehong Interval at di interval metered SAs)
     • Iskedyul ng rate, kabuuang halaga ng pagsingil ng $, paggamit ng Tiered (kung naaangkop), Demand (kung naaangkop), kabuuang TOU (kung naaangkop)
     • Tandaan: Para sa mga awtorisadong customer na hindi interval metered, ang mga third party ay makakatanggap lamang ng mga kabuuan ng paggamit ng pagsingil (ibig sabihin, sa Usage Summary) at walang interval na paggamit ng mga babasahin (hal., oras oras / araw araw na pagbabasa dahil hindi magagamit ang mga ito)
   • Info ng Customer: (para sa parehong agwat at hindi agwat metered SAs)
     • Pangalan ng Customer, Address ng Serbisyo, ID ng Account, ID ng Kasunduan sa Serbisyo, Kasunduan sa Serbisyo ng Serbisyo Petsa ng Pagsisimula,
   • Data ng paggamit ng Interval Gas: (interval metered gas SAs lamang)
     • Interval (i.e., araw araw) gas reads
   • Ang mga bagong elemento ng data ay diagramed bilang bawat naka attach, Suportadong Data Elements.xlsx
   • Ang kaugnay na relational data hierarchy ay nakabalangkas sa naka attach, PGE ESPI Data Model.xlsx
   • Pinakabagong mga kahulugan ng ESPI xml schema (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay per ang nakalakip na XSDs. Tandaan: ang mga XSD ay paurong na katugma:
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (impormasyon ng customer)

Dapat kang magkaroon ng 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 ng SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga gumagamit na iyon na nag access sa kanilang sariling data:

1. Ang mga kahilingan sa API na tumatanggap ng mga parameter ng petsa (hal., batch request), ay dapat gumamit ng mga parameter ng data ng Zulu (hal., nalathala-max/ nai-publish-min). Ang iba pang mga format ng petsa para sa mga parameter ng petsa sa mga kahilingan sa API ay hindi susuportahan.
   • Ang mga API na tumatanggap ng mga parameter ng petsa ay dokumentado sa bawat nakalakip, Suportadong APIs.xlsx
2. Mga tagapagpahiwatig ng Interval Time of Use (TOU) na kasama sa Interval metered electric paggamit ng data (kung naaangkop, tagapagpahiwatig ng kung ano ang TOU period bawat agwat ay tumutugma sa)
   • Mangyaring sumangguni sa mga static na Program ID Mappings na nagdedetalye kung ano ang bawat agwat TOU enumeration tumutugma sa (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Suportadong Data Elements.xlsx)

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay paurong na katugma, at ang mga boluntaryong pagpapahusay ng mga third party ay maaaring maghalal upang suportahan.

1. Ang mga gumagamit ng Self Access ay magkakaroon ng kakayahang awtomatikong baguhin / i update ang kanilang mga sertipika ng SSL na orihinal nilang ibinigay sa panahon ng pagpaparehistro (hal., kapag malapit nang mag expire ang cert) sa pamamagitan ng third party portal sa ilalim ng pamahalaan ang pagpaparehistro > I edit > bagong seksyon: Impormasyon sa SSL Certificate (Opsyon sa pag update)
2. Ang mga pagpaparehistro ng gumagamit ng Self Access ay maa update upang isama ang awtorisadong pangunahing info sa pagsingil, impormasyon ng customer, at data ng gas. Ang parehong interval metered pati na rin ang mga di interval metered Service Agreement ay magiging karapat dapat para sa (sariling) awtorisasyon para sa SMD 2.0 Ang isang mataas na antas ng buod ng mga bagong magagamit na elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa parehong Interval at di interval metered SAs)
     • Iskedyul ng rate, kabuuang halaga ng pagsingil ng $, paggamit ng Tiered (kung naaangkop), Demand (kung naaangkop), kabuuang TOU (kung naaangkop)
     • Tandaan: Para sa mga awtorisadong customer na hindi interval metered, ang mga third party ay makakatanggap lamang ng mga kabuuan ng paggamit ng pagsingil (ibig sabihin, sa Usage Summary) at walang interval na paggamit ng mga babasahin (hal., oras oras / araw araw na pagbabasa dahil hindi magagamit ang mga ito)
   • Info ng Customer: (para sa parehong agwat at hindi agwat metered SAs)
     • Pangalan ng Customer, Address ng Serbisyo, ID ng Account, ID ng Kasunduan sa Serbisyo, Kasunduan sa Serbisyo ng Serbisyo Petsa ng Pagsisimula,
   • Data ng paggamit ng Interval Gas: (interval metered gas SAs lamang)
     • Interval (i.e., araw araw) gas reads
   • Ang mga bagong elemento ng data ay diagramed bilang bawat naka attach, Suportadong Data Elements.xlsx
   • Ang kaugnay na relational data hierarchy ay nakabalangkas sa naka attach, PGE ESPI Data Model.xlsx
   • Pinakabagong mga kahulugan ng ESPI xml schema (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay per ang nakalakip na XSDs. Tandaan: ang mga XSD ay paurong na katugma:
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (impormasyon ng customer)

Dapat kang magkaroon ng 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 ng SMD 2.0 ay nangangailangan ng mga pagbabago sa bahagi ng mga pagpapatupad ng CCA.

1. Ang mga kahilingan sa ad hoc (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 bulk paggamit feed ay magsisimulang isama ang pangunahing impormasyon sa pagsingil habang ang pang araw araw na bulk customer feed ay magsasama ng karagdagang impormasyon ng customer. Ang bagong data na ito ay ibibigay kapwa para sa mga interval metered na customer na tumatanggap sila ng data para sa kasalukuyan, pati na rin para sa mga customer na hindi interval metered sa kanilang teritoryo kung saan hindi sila tumatanggap ng data sa kasalukuyan. Huling, ang mga halaga ng paggamit ng agwat na ibinigay sa pang araw araw na bulk paggamit feed ay magsasama ng mga interval TOU indicator kung saan naaangkop. Mataas na antas ng buod ng mga bagong elemento ng data ay ang mga sumusunod:
   • Billing Info: (para sa parehong Interval at di interval metered SAs)
     • Iskedyul ng rate, kabuuang halaga ng pagsingil ng $, paggamit ng Tiered (kung naaangkop), Demand (kung naaangkop), kabuuang TOU (kung naaangkop)
   • (Dagdag pa) Info ng Customer: (para sa parehong agwat at hindi agwat metered SAs)
     • Pangalan ng Customer, Address ng Serbisyo, Kasunduan sa Serbisyo ng Serbisyo Petsa ng Pagsisimula, Account ID
   • Interval TOU indicators kasama sa Interval metered electric paggamit ng data (kung naaangkop, tagapagpahiwatig ng kung ano ang TOU panahon bawat agwat ay tumutugma sa)
     • Mangyaring sumangguni sa mga static na Program ID Mappings na nagdedetalye kung ano ang bawat agwat TOU enumeration tumutugma sa (hal., 1 = Summer Peak atbp.). (Tingnan ang nakalakip, Suportadong Data Elements.xlsx)
   • Pinakabagong mga kahulugan ng ESPI xml schema (XSDs) na ginagamit para sa mga bagong elemento ng data na ito ay per ang nakalakip na XSDs. Tandaan, ang mga XSD ay paurong na katugma:
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (Info ng Customer)
   • Ang mga bagong elemento ng data ay diagramed bilang bawat naka attach, Suportadong Data Elements.xlsx
   • Ang kaugnay na relational data hierarchy ay nakabalangkas sa naka attach, PGE ESPI Data Model.xlsx

Mga Opsyonal na Pagpapahusay: Ang mga sumusunod na pagbabago ay paurong na katugma, at ang mga boluntaryong pagpapahusay ng mga third party ay maaaring maghalal upang suportahan.

1. Ang CCA's ay maaaring gumawa ng mga kahilingan sa ad hoc para sa impormasyon ng customer sa: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (nagbabalik ng pinakabagong snapshot ng impormasyon ng customer sa oras ng kahilingan), bilang karagdagan sa pang araw araw na abiso na natanggap.
2. Ang 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 portal, sa ilalim ng pamahalaan ang pagpaparehistro > I edit > bagong seksyon: Impormasyon sa SSL Certificate (Opsyon sa pag update)

Dapat kang magkaroon ng anumang mga katanungan o kailangan para sa karagdagang suporta, mangyaring huwag mag atubiling makipag ugnay sa amin sa ShareMyData@pge.com.

Agosto 21, 2015
 

Ano ang bago:

1. Param ng estado at resource URI pagbabago sa mga tugon ng Oauth
   • Bilang bahagi ng kahilingan ng OAuth authorization code, ang third party ay may pagpipilian na magpadala sa isang parameter ng estado na ipapadala pabalik ng PG&E sa third party. Ipapadala rin ng PG&E ang authorization code sa matagumpay na pagkumpleto ng awtorisasyon. Ang opsyonal na param ng estado na ito ay maaaring magamit upang matulungan ang ikatlong partido na matukoy kung saan sinimulan ang kahilingan, at upang itali ang kahilingan pabalik sa mga awtorisasyon na kanilang pinasimulan.
   • Bilang bahagi ng matagumpay na pagkumpleto ng kahilingan ng token, ibinabahagi namin ang back resourceURI at awtorisasyonURI nang hiwalay mula sa impormasyon ng token. Sa kasalukuyan ang mga URI na ito ay flipped at bilang bahagi ng release na ito ay kami ay pagwawasto na.

Naayos na mga depekto:

1. Default na mga petsa na nai publish-max at inilathala-min
   Sa kasalukuyan ang PG&E ay nag uutos sa third party na nagpapadala ng mga na publish na min at nai publish max na mga parameter sa epoch segundo para sa bawat kahilingan ng data na sabihin sa PG&E ang tagal kung saan sila ay humihingi ng data. Kami ay nagpapatupad ng pagbabago upang mahawakan ang mga kahilingan para sa mga sumusunod na sitwasyon:
   • Nawala ang mga halaga ng Published-Min at Published-Max
   • nai publish min at published-max halaga ay sa UTC
   • Ang mga halaga ng Published-Min at Published-Max ay nasa mga segundo ng Epoch
   Sa kaganapan na ang mga parameter ay nawawala, ang PG &E ay magbabalik ng mga default na petsa, kumpara sa mga mensahe ng error bilang ibinalik bago ang pagbabagong ito. Ang default, sa aming kaso, ay isang araw na data para sa petsang T-2. Kung ang mga parameter ay naroroon at naka format nang tama ay patuloy naming igalang ang mga parameter.
2. Ayusin para sa mga petsa sa awtorisasyon xml
   Sa kasalukuyan sa xml ng awtorisasyon ay ibinahagi namin ang nai publish na petsa at petsa ng awtorisasyon. Ang mga petsang ito ay nasa milliseconds kumpara sa mga segundo na kung saan ay ang pamantayan. Inaayos namin ito upang maipadala pabalik sa mga segundo ng epoch sa halip na milliseconds.
3. Maling XML ang ibinalik para sa /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Sa kasalukuyan ay nagbabalik kami ng maling tugon para sa itaas na antas ng mapagkukunan GET kung saan ang istraktura ng XML ay mali at inuulit namin ang mga entry para sa bawat agwat sa halip na lumikha ng isang solong agwat ng block para sa isang 24 oras na tagal.
   
   Ito ay inaayos at isang solong interval block lamang ang ibabalik para sa isang 24 interval block.

Mga tanong o alalahanin? Makipag ugnayan lamang sa ShareMyData@pge.com.

• Pinahihintulutan ka ng mga customer na ma access ang kanilang data sa pamamagitan ng My Energy, ang kanilang PG&E online account. Para sa isang detalyadong buod kung paano maaaring pahintulutan ng mga customer ang mga third party o iba pang mga entity na ma access ang kanilang data, mangyaring tingnan ang Ibahagi ang Aking Data Buod ng Ikatlong Partido.

Pumunta sa mga detalye ng awtorisasyon

• Sa kasalukuyan, walang limitasyon.

• Ang mga customer ay maaaring pumili ng isang tinukoy na halaga ng oras kung saan maaari mong ma access ang kanilang data, o maaari nilang iwanan ang panahon ng pahintulot na bukas.
• Maaaring suriin ng iyong application ang petsa ng pagtatapos ng awtorisasyon ng isang customer kasama ang iba pang mga detalye ng awtorisasyon sa pamamagitan ng pagtawag sa mga API ng mapagkukunan ng awtorisasyon (hal., .../espi/1_1/resource/Authorization and/o.../espi/1_1/resource/Authorization/{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 Pamahalaan ang Mga Awtorisasyon.

• Kung ang isang customer ay pumili ng isang tinukoy na panahon ng awtorisasyon, pagkatapos ay ang kanilang awtorisasyon ay mawawalan ng bisa sa pagtatapos ng panahong iyon. Kung kanselahin nila ang awtorisasyon, pagkatapos ay ang kanilang awtorisasyon ay mawawalan ng bisa sa araw pagkatapos nilang kanselahin ang awtorisasyon.
• Kung pipiliin ng isang customer ang Indefinite bilang kanilang authorization period, kung gayon ang kanilang awtorisasyon ay hindi mawawalan ng bisa. Tandaan, sa pagsasaalang alang ng Rule 24 Demand Response Providers at iba pang mga programa gamit ang Share My Data, ang mga pagwawasto pagkatapos ng katotohanan para sa mga dati nang awtorisadong hanay ng petsa ay maaaring ibigay sa mga third party hanggang sa tatlong taon pagkatapos ng pag expire ng awtorisasyon.
• Tingnan sa "Paano hahawakan ang mga pagwawasto ng data?" para sa karagdagang detalye sa pagtanggap ng mga pagwawasto.

• Ang sinumang customer ng PG&E na may kasalukuyang aktibong Service ID para sa gas o electric service ay maaaring pahintulutan kang ma access ang kanilang data gamit ang bagong tool na Share My Data.

• Ang mga customer na interesado sa pakikilahok sa pagbabahagi ng kanilang data sa pamamagitan ng programa ng Share My Data ay lubos na hinihikayat na magrehistro para sa isang My Energy account. Ito ay gagawing mas mahusay ang buong proseso at nagbibigay din sa kanila ng kakayahan upang pamahalaan ang kanilang mga awtorisasyon online.
• Ang mga customer ay maaaring mag sign up para sa isang My Energy account sa panahon ng proseso ng awtorisasyon.
• Mayroong isang manu manong proseso na magagamit sa mga customer upang makakuha ng isang 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 ugnay sa amin sa ShareMyData@pge.com.

• Ang mga customer ay kinakailangang gumawa ng kanilang sariling mga awtorisasyon online sa pamamagitan ng kanilang PG&E online account. Gayunpaman, kung nakumpleto at nilagdaan nila ang form ng Awtorisasyon ng Share My Data, pagkatapos ay maaari mong isumite ito sa PG &E sa kanilang ngalan.

Download Share My Data Awtorisasyon ng customer o pagbawi ng form ng awtorisasyon (PDF, 308 KB)

• Maaari mong i update ang iyong OAuth URIs sa pamamagitan ng pag log in sa iyong account, pag navigate sa Pamahalaan ang Pagpaparehistro > I edit ang > at i update ang mga patlang sa ilalim ng seksyon ng OAuth 2.0 Information.

• Maaari mong i update ang iyong Notification URI sa pamamagitan ng pag log in sa iyong account, pag navigate sa Pamahalaan ang Pagpaparehistro > I edit > at i update ang mga patlang sa ilalim ng Data Access Information seksyon.

• Maaari mong i update ang iyong SSL certificate sa pamamagitan ng pag log in sa iyong account, pag navigate sa Pamahalaan ang Pagpaparehistro > I edit > at piliin ang "Update" sa seksyon ng SSL Certificate Information. Tandaan na para sa mga bagong pag upload ng sertipiko, maaaring tumagal ng ilang araw upang i update ang mga sistema ng PG&E sa bagong sertipiko.  
• Ang isang email ng kumpirmasyon mula sa koponan ng Share My Data Support ay ipapadala kapag nailalapat na ang bagong sertipiko.

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

Mag login upang Ibahagi ang Aking Data

• Ang Share My Data ay sumusunod sa mga kasunduan sa pagpapatupad ng Green Button Connect My Data. Ang Share My Data ay gumagamit din ng OAuth 2.0 para sa awtorisasyon, Transport Layer Security (TLS) 1.2 at ang minimum na suite ng mga protocol ng seguridad sa cyber na inaprubahan ng NIST (National Institute of Standards and Technology) tulad na walang impormasyon na ipinagpapalit sa malinaw.

• Ang pagprotekta sa impormasyon ng customer ay isang pangunahing prayoridad para sa PG&E. Ang PG&e ay itinuturing ang impormasyon tungkol sa kanilang mga customer—kabilang ang personal na impormasyon—bilang kumpidensyal, naaayon sa lahat ng legal at regulasyon na kinakailangan, kabilang ang mga itinatag ng California Public Utilities Commission at iba pa.  
• Sa loob ng mahigit dalawang dekada, ang PG&E at iba pang mga utility na pag aari ng mamumuhunan sa California ay napapailalim sa napakahigpit na mga regulasyon ng CPUC na nagbabawal sa kanila na ibunyag ang impormasyong partikular sa customer, tulad ng data ng pagsingil, sa mga third party nang walang malinaw na pahintulot ng customer.  
• Kapag pinahintulutan ng isang customer ang paglabas ng data, responsibilidad ng customer at third party na protektahan ang data na iyon.
• Ang isang customer ay maaaring maghalal upang ihinto ang pagbabahagi ng data sa isang third party anumang oras sa pamamagitan ng pag log in sa kanilang PG&E online account at pagkansela ng kanilang awtorisasyon. Ang kumpletong patakaran sa privacy ng PG &E at Abiso ng Pag access, Pagkolekta, Pag iimbak, Paggamit at Pagsisiwalat ng Impormasyon sa Paggamit ng Enerhiya ay magagamit sa pge.com/privacy.

• Sa loob ng saklaw ng programang Share My Data, ang mga Third party ay napapailalim sa Customer Data Privacy and Protection Rules na tinukoy sa mga tuntunin at kundisyon ng platform ng Share My Data at sa mga kinakailangan na kasama sa Customer Data Access Tariff.
• Ang mga third party ay napapailalim din sa lahat ng iba pang mga naaangkop na batas at regulasyon na may kaugnayan sa proteksyon ng privacy ng customer, kabilang ang, ngunit hindi limitado sa, ang Mga Tuntunin Tungkol sa Privacy at Mga Proteksyon sa Seguridad para sa Data ng Paggamit ng Enerhiya na pinagtibay ng CPUC bilang Attachment D sa Desisyon 11-07 056 (Electric), na ibinuod din sa 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 to Decision 11-07 056 (PDF)
  Maghanap ng karagdagang impormasyon: California Civil Code Section 1798.80 – 1798.84

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

Kumuha ng karagdagang impormasyon tungkol sa pag access sa data

• Sa okasyon, ang interval data ng paggamit ay nawawala dahil ang aming upstream data validation proseso mahanap may mga nawawala o hindi tamang data nababasa na maaaring mangailangan ng karagdagang pagproseso (pag edit at o pagtatantya).
• Para sa mga interbal na sinisingil na customer (hal., mga customer na may mga konsiderasyon sa pagsingil sa Oras ng Paggamit), ang mga pagkakataong ito ay naitama sa oras upang matiyak ang tumpak na pagkalkula ng bill sa kanilang paparating na buwanang bill.

• Kung nais mong makatanggap ng mga pagwawasto ng data, mangyaring tiyakin na suriin mo ang Ipaalam sa Akin bilang Data ay Handa na checkbox sa panahon ng pagpaparehistro o sa pamamagitan ng pag log in sa iyong online account at pagpili ng checkbox na ito sa ilalim ng Edit Profile. Pagkatapos ay isasama namin ang mga pagwawasto ng data na nakuha ng aming system sa nakaraang 24 na oras, bilang bahagi ng pang araw araw na paggamit ng feed, para sa anumang data na pinahintulutan kang ma access.
• Ang mga pagwawasto ng data ay sasakop sa anumang mga pagbabago para sa awtorisadong panahon, hanggang sa isang maximum na tatlong taon.

Tandaan: Sa pagsasaalang alang ng Rule 24 Demand Response Providers at iba pang mga programa gamit ang Share My Data, ang mga pagwawasto pagkatapos ng katotohanan para sa mga naunang 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 abiso sa URL ng iyong notification na ibinigay sa panahon ng pagpaparehistro. Ang mga notification ay binubuo ng mga URL na tumutugma sa nai package na data na handa para sa iyo na bumalik at humiling sa ibinigay na mga URL. Ang data ay prepackaged at ang mga notification ay ipinadala sa sumusunod na dalawang sitwasyon: (1) pinili mo ang "Ipaalam sa akin habang handa na ang data" sa iyong profile sa pagpaparehistro, kung saan ipapake namin ang pinakabagong data araw araw na may anumang mga pagwawasto para sa mga nakaraang petsa, o (2) gumawa ka ng isang mas naunang ad hoc asynchronous na kahilingan kung saan ang hiniling na data ay handa na ngayon. Ang Scenario 1 ay inilalarawan sa ilalim ng "DATA ACCESS: DAILY SUBSCRIPTION" na seksyon ng mga diagram ng Mga Paraan ng Pag access ng Data sa Pahina ng Pag access ng Data at sitwasyon 2 ay inilalarawan sa ilalim ng "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" seksyon ng parehong mga diagram din sa Pahina ng Pag access ng Data.

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) tulad ng tinukoy ng California Independent System Operator (CAISO). Ang SQMD ay nabuo sa pamamagitan ng pagpaparami ng Revenue Quality Meter Data (RQMD) sa pamamagitan ng Distribution Loss Factor (DLF) na naaangkop sa antas ng boltahe ng customer na iyon para sa agwat na iyon, na convert ang mga metered interval sa interval period na kinakailangan ng CAISO at pagkatapos ay pagbubuod ng mga resulta para sa bawat agwat sa pinagsama samang antas na kinakailangan ng CAISO.
  
• Ang PG&E ay nagpapatupad ng mga bandila ng "QualityOfReading" (QOR) Type na ibinigay ng pamantayan ng ESPI upang maipaalam kung ang data ay Revenue Quality. Ang QOR Type ay nakukuha ang iba't ibang posibleng mga halaga ng kalidad para sa data ng paggamit, kabilang ang isang malinaw na halaga para sa "Data ng Kalidad ng Kalidad ng Kita" o "RQMD." Gagamitin ng PG&E ang QOR Type na ito sa data transmittal nito tulad ng sumusunod:
  • Sinusuportahan ng PG&E ang ESPI na ibinigay na "UsageSummary" na klase, na gagamitin upang matukoy ang mga petsa kung saan ang isang kasunduan sa serbisyo ay sinisingil, ang halaga ng sinisingil na paggamit, at ang kalidad ng data ng paggamit sa oras ng kahilingan. Ang UsageSummary ay tatahan sa sandaling ang bill ay magagamit para sa hiniling na data at magsasama ng dalawang bandila (elemento) ng QOR Uri:
    • Ang PaggamitBuod.QualityOfReading elemento (sa PaggamitBuod antas) na nagpapahiwatig ng kalidad sa oras ng kahilingan ng pinakabagong ibinigay na mga halaga ng paggamit ng pagitan plus pagwawasto na tumutugma sa PaggamitBuod.billingPeriod petsa.
    • Ang DefaultKalidad ng elemento para sa OverallConsumptionLastPeriod (bilang bahagi ng PaggamitBuod.OverallConsumptionLastPeriod.ReadingTypeRef) na nagpapahiwatig ng kalidad ng kabuuang singil na paggamit.
  • Ipapahayag din ng 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 magkano ang data ng kasaysayan na kailangan mo, alinman sa 24, 36, o 48 buwan sa ilalim ng "Gaano karaming makasaysayang data ang hiniling" dropdown.
• Bilang bahagi ng awtorisasyon ng isang customer na nagpapahintulot sa iyo na ma access ang kanilang data, ang makasaysayang panahon para sa awtorisasyon ay default sa iyong pagpili ng pagpaparehistro para sa mga ID ng Serbisyo (mga puntos 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 Pamahalaan ang Pagpaparehistro > I edit ang > at pagpili mula sa dropdown na may label na "Gaano karaming makasaysayang data ang hiniling."
• Mangyaring tandaan na ang data na ibinigay sa kahilingan sa kasaysayan ay magsisimula sa petsa na ang customer ay gumagawa ng awtorisasyon, kumpara sa petsa na ginawa mo ang kahilingan sa API.

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

• Tulad ng bawat pamantayan ng ESPI, ang tugon ay gumagamit ng Atom Publishing Standard. Piliin lamang ang link, sa ibaba, upang makita ang isang kumpletong listahan ng mga API na suportado, kasama ang mga magagamit na elemento ng data.

Kumuha ng karagdagang impormasyon tungkol sa pag access sa data

• Ang mga aktibong electric at gas Service ID na naka install at nabasa ng PG&E ay karapat dapat para sa awtorisasyon sa pamamagitan ng platform ng Share My Data.
• Kung ang Service ID na nauugnay sa isang awtorisasyon ay nagbabago dahil sa isa sa mga sumusunod na dahilan, ang awtorisasyon ay lilipat sa bagong Service ID at ang access sa historical interval usage data ay magpapatuloy:
  • Pansamantalang shut off dahil sa hindi pagbabayad
  • Lumipat sa Interval Billing
  • Palitan ng metro
  • Pagbabago ng rate
• Ang iba pang mga sitwasyon na nagreresulta sa pagbabago ng Service ID tulad ng paglipat ng mga lokasyon o ang pagbabago ng isang kumpanya ay magtatapos sa pag access. Bilang karagdagan, kung ang isang account ay hindi naka link mula sa iyong My Energy account, ang lahat ng mga pinagbabatayan na ID ng Serbisyo na pinahintulutan sa pamamagitan ng Share My Data ay hindi awtorisado bilang isang resulta.

• Upang matukoy ang granularity ng awtorisadong data ng agwat, mangyaring sumangguni sa elemento ng Interval Length tulad ng ibinigay ng pamantayan ng ESPI.
• Ang PG &E ay nagbibigay ng interval data ng paggamit sa parehong granularity na 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 mga metro ng agwat. Kung saan 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 customer ng tirahan at sa 15 minutong antas ng pagitan para sa karamihan ng mga komersyal na customer, at ang paggamit ng metro ng agwat ng gas ay karaniwang magagamit sa pang araw araw na antas para sa karamihan ng mga customer.
• Para sa mga hindi pagitan na metro, ang data ay ibibigay kapag magagamit.

• Para sa malaking karamihan ng mga customer ng PG &E na may isang Smart Meter na naka install, ang data ng paggamit ng electric at gas interval ay magagamit 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 power line carrier based MV90 metro na naka install ay maaaring mangailangan ng karagdagang oras para sa data na magagamit.

• Habang hindi namin maaaring direktang suportahan ang pag setup ng iyong mga API, mayroon kaming isang bilang ng mga mapagkukunan na magagamit upang matulungan ang iyong IT at mga teknikal na mapagkukunan sa proseso ng pag unlad. Mangyaring sumangguni sa aming pahina ng Dokumentasyon ng API upang malaman ang higit pa. Mangyaring huwag mag atubiling makipag ugnay sa ShareMyData@pge.com sa anumang karagdagang mga katanungan.

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