Mahalagang Alerto

Ibahagi ang Aking Data para sa mga third party

Payagan ang pag access ng third party sa iyong data ng paggamit ng enerhiya

important notice icon Paalala: Isinalin ng isang computer ang pahinang ito. Kung may mga tanong ka, tawagan ang mga language service sa 1-877-660-6789.

Nag aalok ang mga kumpanya ng third party ng pagsusuri at mga tool upang matulungan kang makatipid ng pera.

Ano ang Share My Data?

 

Ang Share My Data ay ang susunod na henerasyon ng Green Button Connect My Data® tool.

 

Nakarehistro na ba bilang aprubadong Share My Data Vendor?

Mag-sign in

 

Sino po ang pwedeng gumamit ng Share My Data

 

  • Mga komersyal na customer
  • Mga pangresidensiyang mamimili
  • Mga unibersidad at mananaliksik
  • Mga vendor ng software
  • Mga pagsisimula ng enerhiya
  • Mga kumpanya ng solar
  • Mga Aggregator ng Pagpipilian ng Komunidad
  • Tugon sa Demand
  • Mga de koryenteng sasakyan
  • At marami pang iba

Ibahagi ang aking proseso ng data

Ano ang mga benepisyo ng Share My Data

 

Hindi na kailangang mag log in ang mga customer sa kanilang online account upang paulit ulit na i download at ipadala ang mga file ng Green Button. Sa halip, sa sandaling pahintulutan ng isang customer ang iyong kumpanya na ma access ang kanilang data ng account sa PG &E, ang paglipat ay awtomatikong hinahawakan at paulit ulit na gumagamit ng mga pamantayan na nakabatay sa Application Programming Interfaces (APIs). Ang platform ng Share My Data ay nag package up ng data ng customer, inaabisuhan ang iyong system kapag handa na ang data at ligtas na ipinadala ito.

 

Maaasahang pag access sa data

Consistent, maaasahang pag access ng data sa pamamagitan ng mga API. Hindi na kailangang "screen scrape" o mag download ng data.

 

Mga Standard API

Pambansang kinikilalang pamantayan Energy Service Provider Interface API format para sa interoperability sa iba pang mga provider ng enerhiya.

 

Pagsingil at account

Ang mga customer ng PG &E ay maaaring pahintulutan ang pag access sa kanilang impormasyon sa pagsingil at account din.

 

Dami at kalidad ng data

Access ang lahat ng data ng paggamit at pagsingil mula sa isang pinagmulan.

 

Elektrisidad at gas

Kasama sa Share My Data ang data ng pagitan ng customer ng PG&E para sa parehong paggamit ng kuryente at gas.

 

Buksan ang makabagong ideya

Ang mga kaso ng paggamit ay limitado lamang sa pamamagitan ng iyong imahinasyon (at ilang mga termino at kundisyon).

 

Magsimula sa Ibahagi ang Aking Data

Mayroong ilang mga paraan upang ma access ang awtorisadong data ng customer sa pamamagitan ng API. Ang aming pinakabagong mga API ay sumusunod sa kasalukuyang pamantayan ng North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) at nagbibigay ng access sa Impormasyon sa Paggamit ng Enerhiya (EUI) sa pamamagitan ng isang hanay ng mga interface ng RESTful.

 

Ngunit una, kailangan mong magrehistro upang magamit ang platform ng Share My Data bago pahintulutan ka ng mga customer na ma access ang kanilang data. Sundin ang mga hakbang sa ibaba upang makakuha ng access.

Bago mo simulan ang proseso ng pagpaparehistro, siguraduhin na mayroon kang sumusunod na impormasyon sa kamay.

 

  • Tax ID: Ang iyong 9 digit na US Employer Identification Number (EIN)
  • Impormasyon sa Pakikipag ugnay sa Negosyo at Teknikal
  • Uniform Resource Identifiers (URIs): Ang Share My Data Platform ay gumagamit ng OAUth2.0 protocol para sa awtorisasyon. Kung ang Uri ng Gumagamit na iyong pinili ay nangangailangan ng tatlong paa na OAuth upang ma access ang data, kakailanganin mong magbigay ng mga wastong URI bago namin matanggap ang iyong pagpaparehistro.
    Matuto nang higit pa tungkol sa mga detalye ng pagsubok
  • URI: Kakailanganin mong magbigay ng isang Notification URI upang maipaalam sa iyo ng aming mga system kapag handa na ang iyong hiniling na data.
    Matuto nang higit pa tungkol sa notification URL sa tab ng pag access ng data
  • Secure Hypertext Transfer Protocol (HTTPS): Kakailanganin mong makakuha ng isang wastong sertipiko ng TLS1.2 X.509 ng isang kinikilalang SSL provider. Ang mga self signed certificate ay hindi tinatanggap at ang pagsusumite ng isang self signed SSL certificate ay magpapaantala sa pag apruba ng iyong pagpaparehistro.

Ang proseso ng pagpaparehistro ng Share My Data ay nagbibigay-daan sa iyo na makilala ang iyong sarili sa PG&E bilang isang kumpanya—o iba pang entity—na nais na ma-access ang data na awtorisado ng customer at mag-set up ng access sa aming mga API. Mayroong apat na natatanging uri ng gumagamit para sa Share My Data. Piliin ang naaangkop na uri ng gumagamit para sa iyong hiniling na pag access.

 

  • Standard User: Isang karaniwang gumagamit ng third party. Uri ng Pagpaparehistro: Standalone
  • Self-Access User: Isang indibiduwal o kinatawan para sa isang entity na humihingi ng access sa iyong sariling data.
  • Pananalapi sa Kahusayan sa Enerhiya: Isang organisasyon na nagbibigay ng mga serbisyong may kaugnayan sa mga programang pinansyal na may on bill, on-bill finance o residential energy-efficiency finance
  • Community Choice Aggregator: Isang rehistradong Community Choice Aggregator (CCA) sa teritoryo ng serbisyo ng PG&E. Upang suriin ang listahan ng kasalukuyang rehistradong CCAs, bisitahin ang Community Choice Aggregation.

Kapag natipon mo na ang lahat ng kinakailangang elemento, magrehistro sa Share My Data API Portal.

Ang mga kahilingan at tugon ng data ay ginawa gamit ang HTTPS protocol at na authenticate sa pamamagitan ng isang dalawang daan na palitan ng sertipiko sa PG &E. Kakailanganin mong ipatupad ang mga sertipiko ng seguridad para sa mga secure na inbound at outbound na komunikasyon ng API.

Kakailanganin mo ring mapanatili ang mga hindi nag expire, hindi nabawi na mga sertipiko ng RSA na may haba ng pampublikong susi na hindi bababa sa 2048 bits. Ang SSL Certificate ay isang kinakailangan upang makumpleto ang pagsubok, kaya mangyaring tiyakin na ang iyong sertipiko ay handa at magagamit. Ang PG&E ay kasalukuyang sumusuporta lamang sa mga sertipiko ng SHA-2 X.509 na inisyu ng mga kagalang galang na awtoridad ng sertipiko (Ang PG&E ay hindi tumatanggap ng mga sertipiko na nilagdaan ng sarili), kabilang ang AddTrust, Comodo, DigiCert. Ipagkatiwala, GlobalSign, Go Daddy,USERTrust at VeriSign.

Bilang gumagamit ng Share My Data, kailangan mong sumang ayon sa Ibahagi ang Aking Mga Tuntunin at Kundisyon ng Ibahagi ang Data ng PG&E, pati na rin kilalanin ang mga patakaran sa privacy ng California Public Utilities Commission.

Download Share My Data Mga Tuntunin at Kundisyon (PDF, 175 KB)
Download Mga Proteksyon sa Privacy at Seguridad para sa Data ng Paggamit ng Enerhiya (PDF)

 

Kumpirmahin ang email address

Sa pagsusumite ng iyong online registration form, magpapadala kami ng email sa email address ng contact ng negosyo na ibinigay. Ito ay upang kumpirmahin na mayroon kaming iyong tamang impormasyon sa pakikipag ugnay. Piliin lamang ang link na nakapaloob sa email na ito sa loob ng limang araw mula nang matanggap ito. Kung hindi, kailangan mong isumite muli ang online registration form. Kapag nakumpirma mo na ang iyong email address, ipoproseso namin ang iyong pagpaparehistro.

Ang layunin ng pagsubok ay upang i verify na ikaw ay magagawang upang kumonekta sa aming mga system. Kapag narepaso na namin ang iyong impormasyon sa pagpaparehistro, magpapadala kami ng isang email na nagpapaalam sa iyo na maaari mong simulan ang pagsubok. Mayroong tatlong mga bahagi sa pangkalahatang proseso ng pagsubok:

  • Pagsubok sa Koneksyon ng API
  • Pagsusuri sa OAuth
  • Kahilingan sa Sanggunian ng Impormasyon sa Aplikasyon

Magpatuloy sa pagsubok ng mga tagubilin

icon ng mahalagang abisoTandaan: Kailangan mong kumpletuhin ang pagsubok sa loob ng 90 araw mula sa pagtanggap ng abiso.

Kapag kumpleto na ang pagsubok, makakatanggap ka ng isang email ng kumpirmasyon na matagumpay na nakumpleto ang pagsubok. Pagkatapos ng huling pagsusuri, ang katayuan ng iyong pagpaparehistro ay ililipat sa Approved. Sa puntong ito, maaari mong ma access ang data at, kung ang iyong uri ng gumagamit ay nagpapahintulot sa iyo na ma access ang data ng isang customer, ang customer ay magagawang magbigay sa iyo ng awtorisasyon. Dagdag pa, ang mga customer na nagpapahintulot sa paglabas ng kanilang data ay magagawang makita na ang iyong organisasyon ay may access. Kung nais mong huwag paganahin ang kakayahang makita ng customer, maaari mong gawin ito mula sa loob ng portal ng third party.

Upang malaman ang tungkol sa proseso ng awtorisasyon, mangyaring bisitahin ang pahina ng Buod ng Awtorisasyon ng Customer.

Pumunta sa mga detalye ng awtorisasyon

Mga Kinakailangan

Ang mga sumusunod na kinakailangan ay dapat matugunan bago mo ma access ang aming mga API:

 

  1. Kailangan mong magrehistro upang magamit ang platform ng Share My Data bago pahintulutan ka ng mga customer na ma access ang kanilang data. Kung hindi ka pa nakarehistro, mangyaring magparehistro at kumpletuhin ang pagsusuri.
  2. Dapat ay nakatanggap ka ng email na nagpapaalam sa iyo na tinanggap na ang iyong pagpaparehistro. Kung hindi mo pa natanggap ang email na ito, mangyaring mag log in sa iyong Share My Data account at piliin ang "Pamahalaan ang Pagpaparehistro" upang tingnan ang iyong katayuan sa pagpaparehistro.

 

Mahalaga na makumpleto ang pagsubok sa loob ng 90 araw mula sa iyong pagpaparehistro na tinanggap. Kung hindi mo makumpleto ang pagsubok sa loob ng 90 araw, ang iyong pagpaparehistro ay mag e expire at kailangan mong mag reregister.

 

icon ng mahalagang abiso Mahalaga: Maliban sa mga pag redirect ng browser sa panahon ng OAuth 2.0, ang lahat ng iba pang mga kahilingan sa pagitan mo at PG&E ay higit sa mutual SSL at nangangailangan na ilakip mo ang SSL certificate ng iyong kliyente sa iyong kahilingan. (Kailangan ito ang parehong sertipiko na ipinadala mo sa PG&E bago matanggap.)

Ang mga sumusunod na uri ng gumagamit ay kinakailangan upang makumpleto ang API Connectivity Testing:

Standard User, Self Access, Pananalapi ng Kahusayan sa Enerhiya at Aggregator ng Pagpili ng Komunidad

Layunin:

Ang layunin ng API Connectivity Test ay upang matiyak na ikaw ay magagawang upang kumonekta sa Ibahagi ang Aking Data APIs.

Inirerekomenda: Pagkuha ng Token ng Pag access sa Client gamit ang SOAP UI
Mga sample na hakbang para sa pagsasagawa ng unang hakbang ng pagsubok sa pagkakakonekta (pagkuha ng isang Token ng Access ng Client) gamit ang SOAP UI Tool.
Download ang SOAP UI Tool (PDF, 520 KB).

Bilang mga pagpapatupad ay maaaring mag iba, ito ay inilaan lamang bilang isang sanggunian upang makatulong na ilarawan kung paano dapat isagawa ang mga koneksyon sa API sa PG &E sa mutual (2 way) SSL.

Mga Hakbang sa Pagsubok sa Connectivity ng API:

Para makapagsimula, i download ang Entrust SSL Certificate ng PG&E sa pamamagitan ng pag log in sa iyong account. Pagkatapos ay piliin ang "Pamahalaan ang Pagpaparehistro" upang makuha ang iyong

mga milestone sa pagpaparehistro

Gamitin ang mga kredensyal ng kliyente upang makakuha ng isang token ng access ng kliyente:

  • Gumawa ng kahilingan sa POST laban sa awtorisasyon ng TESTServerTokenEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/token
  • Magdagdag ng parameter grant_type = client_credentials.
  • Magdagdag ng pangunahing parameter ng header ng Awtorisasyon sa pamamagitan ng pag encode ng Base64 "client_ID:client_Secret." Ang header parameter ay magiging sa format, sa ibaba:
    Param name : Awtorisasyon
    Halaga ng param : Basic "base64encoded string"
  • Ang tugon ay magbibigay sa iyo ng token ng access ng kliyente at ang oras ng pag expire nito (halimbawa):
         
          C03A9825-16F7-400A-B546-9A206AB995DB
          3600
          3
          Bearer
         

Gamitin ang token ng access ng kliyente upang tawagan ang katayuan ng serbisyo API:

  • Gumawa ng isang kahilingan sa GET laban sa URL na ito:
    https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ReadServiceStatus
  • Ipasa ang token ng pag access ng kliyente sa header ng awtorisasyon sa format, sa ibaba:
    Pangalan ng header param = Awtorisasyon
    Halaga = Tagapagdala
  • Ang tugon ay dapat na ang mga sumusunod:
         
          1
         

Gamitin ang token ng pag access ng kliyente upang hilingin ang sample data:

  • Gumawa ng isang kahilingan sa GET laban sa URL na ito:
    https://api.pge.com/GreenButtonConnect/espi/1_1/resource/DownloadSampleData
  • Ipasa ang token ng pag access ng kliyente sa header ng awtorisasyon sa format, sa ibaba:
    Pangalan ng header param = Awtorisasyon
    Halaga = Tagapagdala
  • Ang tugon ay dapat na ang mga sumusunod:Download Meter Reading Halimbawa (XML, 273 KB)

    Ikaw ay nakumpleto ang API Connectivity Test sa sandaling matagumpay mong natanggap ang sample data at makikita mo ang isang "API Connectivity Test: Completed" milestone sa Registration milestone table tulad ng ipinapakita sa ibaba.

Mga Milestone sa Pagpaparehistro 2

Ang mga sumusunod na gumagamit ay kinakailangan upang makumpleto ang OAuth Testing:

Standard User at Energy Efficiency Finance

Layunin:

Ang layunin ng OAuth Test ay upang matiyak na gumagana nang tama ang iyong pagpapatupad ng OAuth.

icon ng mahalagang abiso Tandaan:

Para sa mga layunin ng pagsusulit na ito, ang iyong application ay kailangang ituro sa mga sumusunod na endpoint upang hilingin ang "test authorization code" at ang "test access token":

  • TEST authorizationServerAuthorizationEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/authorize
  • TEST authorizationServerTokenEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/token

Mga Direksyon sa Pagsubok ng OAuth:

  • Mag-log in sa Portal ng Share My Data Third-Party
  • I-click ang "Go>" sa OAuth Test box
  • Ang OAuth Test ay magbubukas sa isang bagong window. Tandaan na kung hindi ito bubuksan mangyaring tiyakin na naka-off o hindi pinagana ang pop-up blocker.
  • Piliin ang START: Sa pamamagitan ng pagpili ng START ikaw ay pagsisimula ng OAuth Test at tamang pagpapatupad ay susunod sa mga sumusunod na pagkakasunod sunod ng mga redirect.

    ShareMyData OAuth Test:

    Nag isyu ng isang 302 redirect sa OAuth URL (ThirdPartyPortalURI) na ibinigay mo sa panahon ng Pagpaparehistro, na may dummy saklaw parameter:
    Halimbawa: {ThirdPartyPortalURI}?scope=xxx&ThirdPartyID={dataCustodianId}

    Ang iyong Application:

    Opsyonal: Ang iyong Application: Prompts (ang customer) upang mag login sa website ng iyong application

    Ang iyong Application:

    Nag isyu ng isang 302 redirect sa at gumawa ng isang kahilingan sa GET para sa Code ng Awtorisasyon:

    Halimbawa, gamitin ang link na ito para sa TESTING ONLY:

    GET https://api.pge.com/datacustodian/test/oauth/v2/authorize?client_id={clientID value in RegistrationMilestones}&redirect_uri={redirect_uri}&scope={scope}&response_type=code

    Halimbawa, gamitin ang link na ito para sa PRODUCTION ONLY:

    GET https://sharemydata.pge.com/myAuthorization?client_id={clientID value in RegistrationMilestones}&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

    ShareMyData OAuth Test:

    Naglabas ng 302 redirect sa na ibinigay mo sa panahon ng Pagpaparehistro sa dummy Authorization Code:

    Halimbawa: https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219

    Ang iyong Application: Gumawa ng isang POST Request para sa Access Token sa pamamagitan ng paggamit ng Authorization Code na natanggap at pagtawag sa :

    icon ng mahalagang abisoTandaan: para sa kahilingan ng Access Token kailangan mong ilakip ang iyong SSL Certificate.
    Halimbawa:

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

    Magdagdag ng pangunahing parameter ng header ng Awtorisasyon sa pamamagitan ng pag encode ng Base64 "client_ID:client_Secret"

    Ang header parameter ay magiging sa sumusunod na format:

    • Param name : Awtorisasyon
    • Halaga ng param : Basic "base64encoded string"

    ShareMyData OAuth Test: Tumutugon sa isang test Access Token:

    Ang isang matagumpay na tugon ay ganito ang hitsura:
    "access_token":" 774ff105-7ad5-40c8-a6ec-f60675dc0e41"
    "expires_in":"3600"
    "refresh_token":998C6654-5B3B-4385-AF4F-4E5C46C1BB04
    "saklaw":"{ScopeString}"
    "resourceURI":"{ResourceURI}"
    "authorizationURI":"{AuthorizationURI}"
    "token_type":"bearer"

Sa puntong ito, matagumpay mong nakumpleto ang OAuth Test at makikita mo ang isang "OAuth Test: Completed" milestone sa Registration milestone table tulad ng ipinapakita sa ibaba:

mga milestone sa pagpaparehistro

icon ng mahalagang abisoMahalaga: Sa pagkumpleto ng pagsubok, kailangan mong i repoint ang iyong application sa Production Endpoints para sa Authorization Code at Access Token Request upang pahintulutan ka ng mga customer na ma access ang kanilang data. Ang mga endpoint na ito ay ibibigay sa iyo sa Resource ng Impormasyon sa Aplikasyon.

Ang mga sumusunod na uri ng gumagamit ay kinakailangan upang gawin ang Kahilingan sa Sanggunian ng Impormasyon ng Application:

Standard User at Energy Efficiency Finance

Layunin:

Ang layunin ng Kahilingan sa Mapagkukunan ng Impormasyon ng Application ay upang matiyak na natanggap mo ang mga URL ng produksyon para sa awtorisasyonServerEndpoint at awtorisasyonServerTokenEndpoint kasama ang dataCustodianScopeSelectionScreenURI

Mga Hakbang sa Paghingi ng Resource ng Impormasyon sa Application:

Kakailanganin mo ang iyong Token ng Pag access sa Pagpaparehistro at ID ng Impormasyon sa Application upang humiling ng mapagkukunan ng impormasyon ng Application.

Kunin ang Token ng Pag access sa Pag access sa Pagrehistro

Upang makuha ang iyong Token ng Pag access sa Pagpaparehistro mag log in sa iyong Share My Data account at piliin ang "Pamahalaan ang Pagpaparehistro." Ang iyong ay ipapakita sa talahanayan ng Registration Milestone kapag tinanggap ang iyong pagpaparehistro.

mga milestone sa pagpaparehistro

Kunin ang ID ng Impormasyon sa Application

Gamitin ang client access token na nakuha sa panahon ng API Connectivity Test upang tawagan ang Authorization xml:
Gumawa ng isang kahilingan sa GET laban sa URL na ito:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization

Ipasa ang token ng pag access ng kliyente sa header ng awtorisasyon sa format, sa ibaba:
Pangalan ng header param = Awtorisasyon
Value = Bearer
Sa tugon makikita mo ang Application Information ID:

mga milestone sa pagpaparehistro

Humiling ng Resource ng Impormasyon sa Aplikasyon

Tumawag sa endpoint ng Impormasyon ng Application na may GET sa sumusunod na url: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ApplicationInformation/{ApplicationInformationID}.
Palitan ang {ApplicationInformationID} ng ID ng impormasyon ng application na nakuha
mo Magdagdag ng pangunahing parameter ng header ng Awtorisasyon. Ang header parameter ay magiging sa format, sa ibaba:

Param name : Awtorisasyon
Halaga ng param : Tagapagdala
Ang tugon ay magbibigay sa iyo ng mapagkukunan ng impormasyon ng application

icon ng mahalagang abisoMahalaga: Para sa mga tagubilin kung paano makumpleto ang lagda, mangyaring suriin ang Green Button Implementation Agreement.

Ang Application Information Resource ay magsasama ng mga sumusunod na impormasyon:

  • dataCustodianId
  • dataCustodianApplicationStatus
  • thirdPartyApplicationPaglalarawan
  • thirdPartyUri ng AplikasyonUri
  • thirdPartyPhone
  • awtorisasyonServerUri
  • thirdPartyNotifyUri
  • awtorisasyonServerAwtorisasyonEndpoint
  • awtorisasyonServerTokenEndpoint
  • dataCustodianBulkRequestURI
  • dataCustodianResourceEndpoint
  • thirdPartySaklawPagpiliScreenURI
  • thirdPartyUserPortalScreenURI
  • client_secret
  • client_name
  • redirect_uri
  • client_id
  • software_id
  • software_version
  • client_id_issued_at
  • client_secret_expires_at
  • mga contact
  • token_endpoint_auth_method
  • saklaw ng saklaw
  • grant_types
  • grant_types
  • grant_types
  • response_types
  • registration_client_uri
  • registration_access_token
  • dataCustodianScopeSelectionScreenURI

Kung ikaw ay isang Standard User o Energy Efficiency Finance user, ito ang huli sa tatlong mga kinakailangan sa pagsubok, at, pagkatapos ng pagsusuri, ang iyong Pagpaparehistro ay ililipat sa Naaprubahan tulad ng ipinapakita sa ibaba. Sa pamamagitan ng isang Naaprubahan na Pagpaparehistro maaari ka na ngayong pahintulutan ng mga customer na ma access ang kanilang data sa pamamagitan ng kanilang My Energy account, o sa pamamagitan ng pag redirect thru your website gamit ang na ibinigay sa iyo sa Kahilingan sa Mapagkukunan ng Impormasyon sa Application.

icon ng mahalagang abisoMahalaga: Kailangan mong i repoint ang iyong application sa Production Endpoints para sa Authorization Code at Access Token Request upang pahintulutan ka ng mga customer na ma access ang kanilang data. Ang mga endpoint na ito ay ibinigay sa iyo sa Resource ng Impormasyon sa Application.

mga milestone sa pagpaparehistro

Upang malaman ang higit pa tungkol sa kung paano ipinagkakaloob ng mga customer ang mga third party na access sa kanilang mga detalye ng pahintulot sa pagbisita sa data.

Kapag nakatanggap ka na ng awtorisasyon ng customer, maaari mong simulan ang paggamit ng aming mga API upang ma access ang awtorisadong data. Para sa karagdagang impormasyon, bisitahin ang data access.

Mga Kinakailangan

Ang mga sumusunod na kinakailangan ay dapat matugunan bago mo ma access ang aming mga API:

 

  1. Kailangan mong magrehistro upang magamit ang platform ng Share My Data bago pahintulutan ka ng mga customer na ma access ang kanilang data. Kung hindi ka pa nakarehistro, mangyaring magparehistro at kumpletuhin ang pagsusuri.
  2. Dapat ay nakumpleto mo na ang API Connectivity at OAuth Testing. Kung hindi mo pa nakumpleto ang pagsubok, mangyaring tingnan ang mga tagubilin sa pagsubok.
    icon ng mahalagang abiso Tandaan: ang mga hakbang sa pagsubok ng OAuth ay na update sa isang hinaharap na paglabas upang sumalamin sa pinakabagong pag andar ng OAuth 2.0 na inilarawan sa ibaba (ibig sabihin, pag alis ng thirdPartyScopeSelectionScreenURI).
    Bisitahin ang mga detalye ng pagsubok

Proseso ng awtorisasyon

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

icon ng mahalagang abisoTandaan: 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.

Diagram of Authorization process initiated at a third-party site

Diagram of authorizations initated at PG&E

Mga hakbang sa paghingi ng awtorisasyon

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).
      icon ng mahalagang abisoTandaan: 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

icon ng mahalagang abisoTandaan: 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

icon ng mahalagang abisoTandaan: 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.

icon ng mahalagang abisoTandaan: 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).
      icon ng mahalagang abisoTandaan: 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"

icon ng mahalagang abisoTandaan: 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

icon ng mahalagang abisoTandaan: 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"

icon ng mahalagang abisoTandaan: 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"
}

icon ng mahalagang abisoTandaan: 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.

Pag update at pamamahala ng mga awtorisasyon

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

icon ng mahalagang abisoTandaan: 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.

icon ng mahalagang abisoTandaan: 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.

Mga Kinakailangan

Ang mga sumusunod na kinakailangan ay dapat matugunan bago mo ma access ang aming mga API:

  1. Kailangan mong magrehistro upang magamit ang platform ng Share My Data bago pahintulutan ka ng mga customer na ma access ang kanilang data.
  2. Dapat ay nakumpleto mo na ang API Connectivity at OAuth Testing. Kung hindi mo pa nakumpleto ang pagsubok, mangyaring tingnan ang mga tagubilin sa pagsubok.
    Bisitahin ang mga detalye ng pagsubok
  3. Kung ang iyong Uri ng Gumagamit ay nangangailangan ng awtorisasyon ng customer upang ma access ang data, mangyaring tiyakin na ang customer ay nagbigay sa iyo ng awtorisasyon upang ma access ang kanilang data at na ipinagpalit mo ang authorization code para sa isang access token. Kung hindi ka pa nakatanggap ng awtorisasyon ng customer, mangyaring suriin ang proseso ng awtorisasyon ng customer.
    Pumunta sa mga detalye ng awtorisasyon

Pangkalahatang-ideya

Mayroong ilang mga paraan upang ma access ang awtorisadong data ng customer sa pamamagitan ng API. Ang aming pinakabagong mga API ay sumusunod sa kasalukuyang pamantayan ng North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) at nagbibigay ng access sa Impormasyon sa Paggamit ng Enerhiya (EUI) sa pamamagitan ng isang hanay ng mga interface ng RESTful

I-download ang mga suportado na API (PDF, 217 KB)

Ang suportadong mga API ay nagpapakita ng mga API na suportado ng pagpapatupad ng PG&E ng Share My Data, pati na rin ang PG&E specific API URL.

Download suportadong function na bloke saklaw string pagmamapa (PDF, 222 KB)

Ang suportadong Function Block Scope String Mapping ay kumukuha ng mga detalye sa string ng saklaw na ibinabalik bilang bahagi ng mga tugon sa Kahilingan sa Code ng Awtorisasyon, ang Kahilingan sa Access Token, pati na rin ang API ng Awtorisasyon tulad ng inilarawan sa buod ng mga detalye ng awtorisasyon. Ang parameter ng Saklaw ay nagbibigay daan para sa pakikipag usap sa pangwakas na saklaw ng awtorisasyon ng customer. Bilang karagdagan, ang dokumentong ito ay nagtatala kung aling ESPI standard function ang humaharang sa PG&E's Share My Data implementation ay sumusuporta.

Download suportadong modelo ng relational data (PG&E pagpapatupad ng ESPI) (PDF, 482 KB).

Kaugnay ng suportadong Mga Elemento ng Data, ang Suportadong Modelo ng Data ng Relasyon ay naglalarawan kung paano ang relasyon sa pagitan ng iba't ibang mga elemento ng data ng PG &E ay nakuha ng pamantayan ng ESPI.

Mag download ng mga suportadong elemento ng data (PDF, 283 KB)

Ang suportadong Mga Elemento ng Data ay nagbibigay ng isang pagma mapang sa pagitan ng mga elemento ng ESPI standard data at mga elemento ng data ng PG &E.
Ang pagpapatupad ng PG &E ay katugma sa mga kahulugan ng ESPI na ibinigay schema na matatagpuan sa GitHub. Partikular, ang aming kasalukuyang pagpapatupad ay gumagamit ng mga sumusunod na bersyon ng schema:

Mag download ng mga XSD (ZIP, 50 KB)
Bisitahin ang Github

Mangyaring sumangguni sa mga sumusunod na mapagkukunan sa kung paano makumpleto ang lagda para sa bawat kahilingan sa API at upang subukan ang tawag sa API laban sa API Sandbox ng GBC:

Bisitahin ang library
ng dokumento ng Green Button Bisitahin ang Green Button API

Abiso URI

Sa panahon ng pagpaparehistro, kakailanganin mong magbigay ng isang URI ng Abiso upang maipaalam sa iyo ng aming mga system ang anumang mga pagbabago sa iyong mga awtorisasyon (hal., mga pagkansela ng customer), sa kaso ng mga asynchronous na kahilingan sa data (para sa mas malaking mga set ng data lamang), at kapag handa na ang iyong hiniling na data. Hiwalay, kung nais mong makatanggap ng araw araw na mga abiso sa subscription ng pinakahuling magagamit na data plus anumang mga pagwawasto para sa nakaraang data mula sa huling 24 na oras, piliin ang Ipaalam sa akin bilang data ay handa na checkbox sa iyong pagpaparehistro. Prepackage namin ang pinakabagong data ng araw at ipapaalam sa iyo sa iyong Notification URI upang bumalik at makuha ang data.

sagisag ng mahalagang abiso Tandaan: Kung hindi mo balak na makuha ang data sa araw araw na batayan, hinihiling namin sa iyo na huwag suriin ang Ipaalam sa akin bilang data ay handa na pagpipilian upang mabawasan ang halaga ng hindi kinakailangang data na aming pinoproseso. Magagawa mo pa ring gumawa ng mga kahilingan sa ad hoc para sa data.

  • 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.

Mga paraan ng pag access ng data

Data Access: Daily Subscription Model

Mga halimbawa ng kahilingan ng data

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

icon ng mahalagang abisoTandaan: 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)

icon ng mahalagang abisoTandaan: 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.

Mga mapagkukunan ng developer

Mga kit ng pag unlad ng software (SDKs)

 

Upang makatulong sa pagbuo ng software upang kumonekta sa platform ng Share My Data, makatutulong na makita ang detalyadong mekanismo na kasangkot sa bawat tawag sa mga nai publish na mga pagtatapos ng APIs. Sa layuning ito, ang PG &E ay may ilang mga sample SDK na binuo nito sa nakaraan para sa parehong JavaScript at Python upang ilarawan ang mga pangunahing aspeto ng pagkonekta sa platform ng Share My Data. Ang mga SDK na ito ay nagbibigay ng mga sample ng code upang makatulong na gabayan ka sa proseso ng pag unlad, ngunit hindi nilayon upang magbigay ng code ng produksyon. Para sa JavaScript, kailangan mong i-install ang NodeJS, at tiyaking "npm install –save ..." upang i update ang mga kaugnay na NodeJS library module. Ang code ay hindi standalone, ngunit nagbibigay ng mga snippet na naglalarawan kung paano nangyayari ang pakikipag ugnayan sa pagitan ng isang third party na data client code at mga serbisyo ng Share My Data API ng PG&E.

 

Upang makatulong sa pagpapatupad ng platform ng Share My Data, binuo ng PG&E ang mga SDK sa parehong JavasScript at Python. Ang mga SDK na ito ay nagbibigay ng mga sample upang makatulong na gabayan ka sa proseso ng pag unlad, ngunit hindi nilayon upang magbigay ng gumagana na code. 

I-download ang mga suportado na API (PDF)

Ang suportadong mga API ay nagpapakita ng mga API na suportado ng pagpapatupad ng PG&E ng Share My Data, pati na rin ang PG&E specific API URL.

 

I download ang suportadong function na bloke ng saklaw ng string mapping (PDF)

Ang suportadong Function Block Scope String Mapping ay kumukuha ng mga detalye sa string ng saklaw na ibinabalik bilang bahagi ng mga tugon sa Kahilingan sa Code ng Awtorisasyon, ang Kahilingan sa Access Token, pati na rin ang API ng Awtorisasyon tulad ng inilarawan sa Buod ng Mga Detalye ng Awtorisasyon. Ang parameter ng Saklaw ay nagbibigay daan para sa pakikipag usap sa pangwakas na saklaw ng awtorisasyon ng customer. Bilang karagdagan, ang dokumentong ito ay nagtatala kung aling ESPI standard function ang humaharang sa PG&E's Share My Data implementation ay sumusuporta.

 

Download suportadong modelo ng relational data (PG&E pagpapatupad ng ESPI) (PDF)

Kaugnay ng suportadong Mga Elemento ng Data, ang Suportadong Modelo ng Data ng Relasyon ay naglalarawan kung paano ang relasyon sa pagitan ng iba't ibang mga elemento ng data ng PG &E ay nakuha ng pamantayan ng ESPI.

 

I-download ang mga suportadong elemento ng data (PDF)

Ang suportadong Mga Elemento ng Data ay nagbibigay ng isang pagma mapang sa pagitan ng mga elemento ng ESPI standard data at mga elemento ng data ng PG &E.

Ang pagpapatupad ng PG &E ay katugma sa mga kahulugan ng ESPI na ibinigay schema na matatagpuan sa GitHub. Partikular, ang aming kasalukuyang pagpapatupad ay gumagamit ng mga sumusunod na bersyon ng schema:

Mag download ng mga XSD (ZIP)
Bisitahin ang Github

 

Mangyaring sumangguni sa mga sumusunod na mapagkukunan sa kung paano makumpleto ang lagda para sa bawat kahilingan sa API at upang subukan ang tawag sa API laban sa API Sandbox ng GBC:

Bisitahin ang library
ng dokumento ng Green Button Bisitahin ang Green Button API

Ang pagpapatupad ng Share My Data ay sumusunod sa pambansang pamantayan ng Energy Service Provider Interface (ESPI). Ang pamantayan ay din na branded bilang ang Green Button Connect My Data inisyatiba (GBCMD) bilang promote ng White House Chief Technology Officer at Presidential Innovation Fellows. Ang pamantayan ng ESPI ay binabalangkas ang teknikal na balangkas para sa paghahatid ng pag andar sa paligid ng awtorisasyon ng customer, palitan ng data at ang format ng awtorisadong data na ipinagpalit. Ang mga detalyeng ito ay sakop sa pamantayan ng ESPI at dokumentasyon ng GBCMD. Hanapin ang dokumentasyon sa Green Button Data.

 

Upang magamit ang Ibahagi ang Aking Data, ang mga third party ay dapat munang makakuha at magbigay ng isang X.509 digital na sertipiko mula sa isang pinagkakatiwalaang awtoridad ng sertipiko sa kanilang mga server ng koneksyon sa API. Pagkatapos ay makukumpleto ng mga third party ang pagpaparehistro sa PG&E sa site ng pagpaparehistro ng third party, i upload ang kanilang sertipiko doon din, tumanggap ng mga kredensyal mula sa PG&E na nagbibigay daan sa kanila upang subukan ang kanilang koneksyon, at kasunod nito ay makakuha ng mga token ng bearer sa pamamagitan ng aming mga pagtatapos ng data custodian authorization token. Ang mga token ng tagapagdala na ito ay inilarawan sa pamantayan ng OAuth2 at paganahin ang software ng third party na ligtas na kumonekta sa mga API ng pag access ng data ng PG &E. Ang SDK's ay nagbibigay ng mga detalye ng pakikipag ugnayan sa kung paano makuha ang mga token sa code ng script.

 

Ang mga token ng tagapagdala ng pag access ng kliyente at mga token ng customer data access bearer ay nakuha nang hiwalay at tinatawag na Client Access Tokens at Access Token, ayon sa pagkakabanggit. Ang Access Tokens ay nakukuha sa bawat indibidwal na awtorisasyon ng customer ng PG&E. Ang isang tipikal na daloy ng trabaho ay isa na sumusunod sa OAuth2, bawat pamantayan (IETF 6749) mekanismo ng awtorisasyon, kung saan ang isang customer ay nagsisimula sa isang site ng third party, at ang site na iyon ay nag redirect sa customer na https://sharemydata.pge.com/#MyAuthorization/ muna para sa pagpapatunay. Doon, ang customer ay nagpapatunay sa PG &E at dumadaan sa isang saklaw na tumutukoy sa awtorisasyon ng kanilang pag access sa data sa third party ("Click through" na proseso). Sa pagkumpleto, ang PG&E ay nag redirect pabalik sa third party na may tugon sa HTTP 302, kung saan ang third party ay handa na upang makakuha ng mga token ng bearer (access token). Suriin ang isang detalyadong daloy ng proseso (PDF, 463 KB).

 

Ang third party na data client server ay kumokonekta sa mga endpoint ng API ng data access ng PG&E sa pamamagitan ng mutual TLS 1.2 na koneksyon. Ang indibidwal na API endpoint access na kinokontrol ng mga token ng bearer; sa sandaling ang isang kahilingan ay tinanggap at naproseso, ang data ay ibinalik sa isang synchronous na tugon o isang asynchronous na tugon batay sa isang abiso sa isang third party na tinukoy na URL.

 

Ang data ay sumusunod sa nabanggit na ESPI schema. Suriin ang isang paglalarawan ng mga suportadong elemento (PDF, 283 KB).

 

Ang PG&E ay naglalabas ng data ayon sa saklaw na pinapayagan para sa uri ng third party at awtorisasyon ng customer.

 

Repasuhin ang isang kahulugan ng saklaw (XLSX), at sundin din ang mga kahulugan ng saklaw ng Green Button.

 

Bago magparehistro para magamit ang Share My Data, lubos naming inirerekumenda na maging pamilyar kayo at ang inyong organisasyon sa sumusunod na mga sanggunian:

 

Bisitahin ang Data ng Green Button SDK
Mga tool para sa paglikha, pagsubok, at pagpapakita ng mga file ng data ng Green Button. Hanapin ang mga SDK na binuo ng PG&E: JavaScript (ZIP, 1.7 MB) | Python (ZIP, 5 KB)

 

Bisitahin ang Green Button API Sandbox
Pinapayagan ng API sandbox na ito ang mga developer ng buong pag access, sa Green Button Format, sa Impormasyon sa Paggamit ng Enerhiya para sa layunin ng pagbuo ng mga bagong application ng Green Button.

Dahil sa may hangganan na mga mapagkukunan ng system pati na rin upang payagan ang PG &E upang mabawasan ang mga panganib sa pagpapatakbo, ang mga sumusunod na limitasyon ng threshold ng API ay nasa lugar upang matiyak ang patuloy na katatagan ng platform para sa aming mga gumagamit.

  • Isang kahilingan bawat segundo bawat vendor sa buong lahat ng vendor Client ID's
  • 2,000 API tawag bawat oras bawat Client ID
  • 20,000 API tawag bawat 24 oras na panahon bawat ID ng Kliyente. Ang daily threshold limit ay nagre reset sa 5 p.m. PT

Mangyaring magkaroon ng kamalayan na ang aming katanggap tanggap na mga kondisyon ng paggamit ay maaaring magbago. Ang koponan ng Share My Data ay patuloy na sinusuri ang aming kakayahang suportahan ang mga kahilingan ng third party habang lumalaki ang platform at mas maraming mga gumagamit ang nagsasama sa system. Gayunpaman, tiyak nating ipabatid ang anumang naturang pagbabago nang maaga sa pagpapatupad.

Mangyaring tingnan ang sumusunod na mga tala ng paglabas para sa mga pagpapabuti at pagbabago na ginawa namin upang Ibahagi ang Aking Data. Kung nakatagpo ka ng isang isyu sa Ibahagi ang Aking Data o magkaroon ng isang mungkahi para sa pagpapabuti ng serbisyo, makipag ugnay sa amin sa ShareMyData@pge.com.

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.

Mga madalas itanong

  • Ang anumang kwalipikadong third party na interesado sa pag access sa data na awtorisado ng customer ay maaaring gumamit ng Share My Data.
  • Ang mga customer na may teknikal na kaalaman na gumamit ng mga RESTful API (Application Program Interface) upang ma access ang kanilang sariling data ay maaaring gamitin din ang tool.
  • Kung ikaw ay isang Third party Demand Response Provider (DRP) na nakikibahagi sa ilalim ng programang Rule 24 ng PG&E upang mag alok ng isang programa ng pagtugon sa demand at nais na gamitin ang Share My Data, mangyaring bisitahin ang webpage ng DRP para sa karagdagang impormasyon.

  • Ang anumang kwalipikadong third party na interesado sa pag access sa data na awtorisado ng customer ay maaaring gumamit ng Share My Data.
  • Ang mga customer na may teknikal na kaalaman na gumamit ng mga RESTful API (Application Program Interface) upang ma access ang kanilang sariling data ay maaaring gamitin din ang tool.
  • Kung ikaw ay isang Third party Demand Response Provider (DRP) na nakikibahagi sa ilalim ng programang Rule 24 ng PG&E upang mag alok ng isang programa ng pagtugon sa demand at nais na gamitin ang Share My Data, mangyaring bisitahin ang webpage ng DRP para sa karagdagang impormasyon.

  • Ang paggawa ng detalyadong impormasyon sa paggamit ng enerhiya na magagamit sa isang standardized format ay naghihikayat ng kamalayan sa paggamit ng enerhiya pati na rin ang pagbabago sa mga third party para sa mga bagong application na nakatuon sa customer. Ang pag asa ay ang mga developer ng enerhiya app ay mag imagine at lumikha ng makabagong, nagbibigay inspirasyon na mga bagong paraan para sa mga customer na makaugnay sa, pamahalaan at sa huli ay mabawasan ang kanilang paggamit ng enerhiya. Ang solusyon na ito ay ang susunod na hakbang sa isang pambansang pagsisikap upang magbigay ng standardized, madaling access sa data ng enerhiya ng customer na magbubukas sa susunod na henerasyon ng mga solusyon sa konserbasyon. Ang Share My Data ay nagbibigay ng data kasunod ng pamantayan ng Energy Service Provider Interface (ESPI).
  • Ang layunin ng PG &E ay gawing magagamit ang awtorisadong, paulit ulit, machine to machine, programmatic data access sa mga customer at sa kanilang awtorisadong mga third party service provider.

  • Ang konserbasyon ng enerhiya ay tumutulong sa paggawa ng grid ng enerhiya sa California na mas maaasahan.
  • Ang pag iingat ay tumutulong din sa aming mga customer dahil ang paggamit ng mas kaunting enerhiya ay maaaring makatipid sa kanila ng pera.
  • Ang PG &E ay hindi gumagawa ng mas mataas na kita sa pamamagitan ng pagbebenta ng mas maraming enerhiya, na ginagawang PG&E at iba pang mga utility na pag aari ng mamumuhunan sa California ay malinaw na naiiba mula sa karamihan ng mga kumpanya na kumikita sa pamamagitan ng pagbebenta ng higit pa sa isang naibigay na kalakal. Ang isang paraan na kumikita ang PG&E ay sa pamamagitan ng mga insentibo na nakuha sa pamamagitan ng pagkamit ng mga layunin sa kahusayan ng enerhiya na itinakda ng aming regulator, ang California Public Utilities Commission.
  • Kapag ang aming mga customer ay nagtipid ng enerhiya ito ay mabuti para sa kanila at ito ay mabuti para sa aming negosyo.

Matuto nang higit pa tungkol sa mga rate ng kuryente ng PG&E

  • Walang gastos sa paggamit ng Share My Data.

  • Sa pamamagitan ng Green Button Download My Data tool, maaaring i download ng mga customer ang kanilang personal na data ng paggamit at, kung sila ay halal, ipadala ang file sa anumang third party na kanilang pinili.
  • Ang tool na ito ay mananatiling magagamit.

  • Kailangang pahintulutan ng mga customer ang paglabas ng kanilang data sa isang third party gamit ang Share My Data o i download ang kanilang data sa pamamagitan ng Green Button Download My Data file sa kanilang sariling mga computer at pagkatapos ay ipadala ang file sa mga third party service provider.

  • Oo. Bisitahin ang webpage, sa ibaba, upang tingnan ang isang listahan ng iba pang mga utility na nagpapatupad ng mga katulad na programa.

Bisitahin greenbuttondata.org

  • Para sa tool na ito, ang CPUC ay ang pangwakas na namamahala sa awtoridad sa kung sino ang hindi karapat dapat na makatanggap ng awtorisadong data ng customer. 
  • Sinusuri ng CPUC ang mga ulat ng maling paggamit ng data ng customer at gumagawa ng mga pangwakas na pagpapasiya kung ang mga termino ng Tariff at / o Mga Panuntunan sa Privacy at Proteksyon ng Data ng Customer ay nilabag.
  • Ang Komisyon ay may awtoridad na mag order ng mga utility upang agad na bawiin ang pag access at wakasan ang pagpaparehistro ng mga kumpanya o indibidwal na lumalabag at i bar ang mga ito mula sa paglahok sa hinaharap. Para sa karagdagang impormasyon, piliin ang mga link sa ibaba:
    Electric Rule No.27 (PDF, 1.6 MB)

Mangyaring suriin at tipunin ang mga sumusunod na impormasyon bago ang pagpaparehistro sa Ibahagi ang Aking Data.

Bisitahin ang pagsisimula sa Ibahagi ang Aking Data
Upang magrehistro, bisitahin ang Ibahagi ang Aking Data

  • Pinapatakbo namin at pinapanatili ang platform ng Share My Data upang mapadali ang pagpaparehistro ng mga kumpanya na nais lumahok sa programang Share My Data.
  • Sinusuri namin ang mga aplikante upang i verify na sila ay lehitimong mga entity ng negosyo sa mabuting katayuan sa CPUC, na sumasang ayon sila na sumunod sa mga tuntunin at kundisyon at ang Customer Data Access Tariff at mayroon silang teknikal na kakayahan na gamitin ang platform ng Share My Data.
  • Mariin naming inirerekumenda na siyasatin ng mga customer kung paano ang mga kumpanya na pinili nilang gawin ang negosyo ay pamahalaan at protektahan ang kanilang data.

  • Susuportahan ng PG&E ang isang pangalan ng kumpanya at Tax ID para sa iba't ibang pagpaparehistro. Nangangahulugan ito na ang isang solong kumpanya ay maaaring magkaroon ng ilang mga pagpaparehistro na may iba't ibang mga pangalan ng display.
  • Kakailanganin mong itatag ang pag unawa sa iyong mga customer upang pahintulutan ang pangalan ng kumpanya at / o pangalan ng display na ibinigay mo sa iyong iba't ibang pagpaparehistro.

  • Ang iyong Federal Tax ID ay kinakailangan upang magbigay ng California Investor Owned Utilities (Pacific Gas and Electric, Southern California Edison at San Diego Gas & Electric) at ang California Public Utilities Commission (CPUC) na may isang karaniwang, natatanging identifier para sa iyo.

  • 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 upang makuha ang iyong Client Credentials. Piliin ang Pamahalaan ang Pagpaparehistro at ang iyong at ay ipapakita sa talahanayan ng Registration Milestone sa ilalim ng Tinatanggap na katayuan.>

Mag login upang Ibahagi ang Aking Data

  • Kapag nakatanggap ka ng isang email na nagpapahiwatig na ang iyong pagpaparehistro ay tinanggap, mayroon kang 90 araw upang makumpleto ang pagsubok sa pagpaparehistro.
  • Kung hindi mo makumpleto ang pagsubok sa pagpaparehistro sa loob ng 90 araw, ang iyong pagpaparehistro ay mag e expire at kailangan mong magparehistro muli.

Oo, mag eexpire ang registration. Kapag tinanggap na ang iyong pagpaparehistro para sa pagsubok, kailangan mong kumpletuhin ang pagsubok at kumpirmahin ang kakayahan ng iyong organisasyon na kumonekta sa mga sistema ng PG&E sa loob ng 90 araw. Kung matagumpay mong nakumpleto ang mga kinakailangan sa pagsubok at maging isang aprubadong third party sa platform ng Share My Data, ang iyong pagpaparehistro ay hindi mawawalan ng bisa.

  • Hindi namin magagawang i reset ang mga password kung hindi mo alam ang sagot sa iyong tanong sa seguridad.

  • Hindi namin magagawang i reset ang mga password kung hindi mo alam ang sagot sa iyong tanong sa seguridad.

  • Maaari kang mag log in sa iyong account anumang oras upang i update ang iyong impormasyon sa profile sa pamamagitan ng pagpili ng Pamahalaan ang Pagpaparehistro.

Mag login upang Ibahagi ang Aking Data

  • Kapag nakatanggap ka ng isang email na nagpapahiwatig na ang iyong pagpaparehistro ay tinanggap, magagawa mong mag log in sa iyong account upang makuha ang iyong . Piliin ang "Pamahalaan ang Pagpaparehistro" at ang iyong ay ipapakita sa talahanayan ng Registration Milestone sa ilalim ng Tinatanggap na katayuan.

  • Kung hindi mo na nais na ma access ang data na awtorisado ng customer sa platform ng Share My Data, mangyaring mag email sa amin sa ShareMyData@pge.com upang ipawalang bisa ang iyong pagpaparehistro. Mangyaring payagan ang hanggang dalawang araw ng negosyo para sa pagwawakas upang makumpleto.

  • 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.

icon ng mahalagang abisoTandaan: 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.

icon ng mahalagang abisoTandaan: 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)

Higit pang mga sa SmartMeter™

Kontakin kami

Kung mayroon kang mga katanungan o komento, mangyaring mag email sa aming koponan sa ShareMyData@pge.com.

Mga Vendor ng Device

Impormasyon para sa mga vendor ng aparato ng Home Area Network (HAN).

Pagbabasa ng isang SmartMeter™

Ang SmartMeter™ display ay nagpapakita ng isang arrow na nagpapahiwatig kung gumagamit ka o nag export ng enerhiya.