Qhia Kuv Cov Ntaub Ntawv rau cov neeg thib peb

Txhawm rau ua raws li tam sim no North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) tus qauv rau kev tso cai, PG&E tau siv OAuth 2.0 Kev tso cai lub moj khaum rau kev tso cai nkag mus rau cov ntaub ntawv. Daim duab hauv qab no qhia txog yuav ua li cas cov neeg siv khoom pib tso cai, xaiv cov kev txwv tsis pub dhau thiab xa lawv daim ntawv tso cai.

Cov ntaub ntawv siv ntxiv tshaj li cov ntaub ntawv hauv qab no:

Download the ESPI OAuth 2.0 Sequence Diagram (PDF, 193 KB)
Saib cov khawm ntsuab cov ntaub ntawv SDK ntawm Github

Ceeb Toom: Rau Cov Kev Xaiv Hauv Zej Zog, tsuas yog tus neeg siv khoom_access_token tsuas yog xav tau los thov cov ntaub ntawv (ntawm 2-Legged OAuth) thiab cov hauv qab no tsis siv.

Kev tso cai pib ntawm qhov chaw thib peb

Txhawm rau pib kev tso cai los ntawm tus thib peb qhov chaw raws li tau piav qhia hauv thawj daim duab saum toj no, kev tso cai code thov yog ua los ntawm redirecting tus neeg siv lub browser los ntawm koj qhov chaw thib peb mus rau PG&E's AuthorizationServer Authorization Endpoint URL nrog rau cov kev thov uas tsim nyog raws li piv txwv hauv qab no. Raws li kev xa rov qab, tus neeg siv khoom yuav raug nthuav tawm nplooj ntawv PG&E nkag rau hauv kev lees paub, ua raws li nplooj ntawv tso cai rau kev tso cai cov ntaub ntawv nkag mus rau koj tus thib peb:

kev tso caiServerAuthorizationEndpoint URI (nrog kev thov tsis)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• Yuav Tsum Thov Parameters:
  • client_id = Client ID los ntawm koj Qhia Kuv Cov Ntaub Ntawv sau npe tseem ceeb (ie, client_id/client_secret khub).
  • redirect_uri = redirect URL uas koj teev nyob rau hauv koj Qhia Kuv Cov Ntaub Ntawv sau npe (URLs yuav tsum phim).
    Ceeb Toom: Peb pom zoo kom siv URL encoding rau redirect_uri raws li piv txwv hauv qab no.
  • response_type = code (tus nqi zoo li qub)
• Yeem Thov Parameter (s):
  • xeev = kev xaiv opaque xeev parameter raws li kev tso cai los ntawm OAuth 2.0 tus qauv uas tau xa rov qab nrog cov cai tso cai txhawm rau pab tswj lub xeev. Piv txwv li, lub xeev parameter tej zaum yuav raug siv los ntawm ib tug thib peb tog kom paub qhov txawv ntawm cov neeg siv khoom hauv paus ntsiab lus thiab los tiv thaiv kev sib tsoo ntawm qhov chaw.
  • tus ID nkag mus = { qhua } Muab kev xaiv rau ib tus neeg thib peb los hloov cov neeg siv khoom mus rau PG&E's My Energy log-in lossis mus rau Guest Access tab uas yog ib feem ntawm kev tso cai hauv online.

EXAMPLE: Auth code thov

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

Ceeb toom: piv txwv redirect_uri parameter saum toj no muaj URL encoding siv (ie URL encoding ntawm https://thirdparty.com/redirectUrl)

Yog tias koj ua qhov kev thov siv tau raws li saum toj no, thiab tus neeg siv khoom ua tiav kev lees paub thiab tso cai, tus neeg siv khoom yuav tom qab ntawd raug xa mus rau koj tus redirect_uri nrog rau cov cai tso cai, (tso cai) qhov ntsuas qhov ntsuas, thiab xaiv lub xeev parameter (yog tias muab raws li ib feem ntawm kev tso cai thov ) raws li piv txwv hauv qab no:

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

Ceeb Toom: Txoj Cai Tso Cai yog luv luv (sijhawm hauv 600 vib nas this), thiab tom qab ntawd yuav tsum tau hloov pauv rau kev nkag mus rau token / refresh token khub thiaj li ua tiav daim ntawv tso cai thiab tso cai rau cov ntaub ntawv txuas mus ntxiv. Saib tshooj tom ntej (Nqe 2) kom paub meej ntawm Access Token / Refresh Token thov.

Qhov (tso cai) qhov ntsuas qhov piv txwv saum toj no raug xa rov qab los ua ib feem ntawm cov lus teb rau Kev Tso Cai Code Thov, Kev Nkag Mus Rau Token Thov, nrog rau Kev Tso Cai API. Qhov ntsuas qhov ntsuas no tso cai rau kev sib txuas lus qhov kawg ntawm cov neeg siv khoom tso cai. tshwj xeeb tshaj yog, qhov kev txwv tsis pub muaj xws li "AdditionalScope" tus nqi uas qhia txog PG&E cov kev txhawb nqa kev tso cai rau cov neeg siv khoom xaiv ntawm pawg ntaub ntawv (xws li "Siv", "Billing", "Basic", "Account", "Program Enrollment"). Qhov ntsuas qhov ntsuas qhov tseem ceeb tau raug ntes ntxiv raws li cov ntaub ntawv siv hauv qab no: Download Txhawb Kev Ua Haujlwm Block Scope String Mapping Nyem Thru 2.0 (PDF, 222 KB) .

yuam kev Scenarios

Thib Peb Kev Ua Haujlwm yuam kev: Yog tias qhov xav tau qhov kev thov tsis tau ntawm client_id lossis redirect_uri tsis raug lossis ploj lawm thaum thov tus lej tso cai, tus neeg siv khoom yuav raug qhia cov lus piav qhia nrog rau tus qauv HTTP 400 series yuam kev. Ib yam li ntawd, yog tias qhov xav tau qhov kev thov tsis raug ntawm response_type ploj lawm lossis tsis raug, tus neeg siv khoom yuav raug xa rov qab mus rau koj qhov redirect_uri nrog OAuth 2.0 txhais "invalid_request" qhov tsis raug thiab qhov kev xaiv lub xeev parameter yog thawj zaug muab ua ib feem ntawm daim ntawv tso cai qub. code thov.

Cov Neeg Siv Khoom Tsis Txaus Siab Tso Cai: Raws li tus neeg thib peb redirecting ib tus neeg siv khoom tso cai nrog PG&E, tus neeg siv khoom muaj kev xaiv kom tsis kam ntawm "tso tseg" khawm ntawm ob nplooj ntawv nkag thiab nplooj ntawv tso cai. Hauv qhov xwm txheej zoo li no, tus neeg siv khoom yuav raug xa rov qab mus rau koj qhov redirect_uri nrog OAuth 2.0 txhais tias "access_denied" yuam kev parameter ntxiv los qhia tias tus neeg siv khoom tsis kam tso cai. Tsis tas li ntawd, qhov kev xaiv ntawm lub xeev parameter yuav raug xa rov qab yog tias thawj zaug tau muab los ua ib feem ntawm daim ntawv tso cai thawj daim ntawv thov.

Kev tso cai pib ntawm PG&E

Thaum cov neeg siv khoom pib tawm ntawm PG&E tus neeg siv khoom lub vev xaib, "Koj Tus Kheej," thiab tom qab ntawd mus rau nplooj ntawv Qhia Kuv Cov Ntaub Ntawv tsaws, lawv tau nthuav tawm cov ntawv sau npe thiab pom cov neeg thib peb. Raws li tau piav qhia hauv daim duab thib ob saum toj no, thaum tus neeg siv khoom xaiv ib tus neeg thib peb los ntawm cov npe ntawm cov neeg thib peb uas tau sau npe thiab xaiv "Tom ntej", tus neeg siv khoom yuav raug xa mus rau tus neeg thib peb lub npe "Third Party Portal URI," ntawm qhov taw tes cov neeg siv khoom tuaj yeem ua tiav nrog tus thib peb tus neeg pib txheej txheem OAuth tau piav qhia hauv ntu ua ntej.

Ceeb Toom: Qee tus neeg thib peb tau nug txog yuav ua li cas txhawm rau txhim kho cov neeg siv khoom siv rau rooj plaub no (piv txwv li, kev tso cai pib ntawm PG&E's site) xws li rau tus neeg siv khoom nws pom tias lawv raug coj ncaj qha mus rau nplooj ntawv tso cai thaum xaiv tus thib peb los ntawm lub dropdown. Txhawm rau pab txhawb cov neeg siv khoom zoo li no, cov neeg thib peb tuaj yeem xaiv los teeb tsa lawv "Third Party Portal URI" (ntawm Kev Qhia Kuv Cov Ntaub Ntawv tswj xyuas nplooj ntawv sau npe) mus rau qhov kawg uas tau xa cov neeg siv khoom rov qab mus rau PG&E raws li ib feem ntawm kev tso cai code thov. Thaum tsis siv neeg redirect rov qab mus rau PG&E qhov kev tso cai Server Authorization Endpoint, tus neeg siv khoom yuav hla nplooj ntawv nkag mus rau cov neeg siv khoom (raws li lawv tau nkag mus rau hauv) thiab yuav ncaj qha mus rau nplooj ntawv tso cai. Rau qee tus neeg thib peb uas tau sau npe ua ntej Kev Qhia Kuv Cov Ntaub Ntawv Nyem Thru 2.0 tso tawm thaum lub Rau Hli 2018, qhov no tuaj yeem ua tiav los ntawm kev txhais cov Third Party Portal URI kom sib npaug qhov tsis siv "Third Party Scope Selection Screen" URI. ( teb yuav tsum tau so haujlwm nyob rau yav tom ntej tso tawm).

Hauv qhov sib piv, qee tus neeg thib peb yuav xav ua ntej koom thiab tshuaj xyuas cov neeg siv khoom ntawm lawv sab thaum cov neeg siv khoom raug xa mus rau lawv "Third Party Portal" URI ua ntej thov kev tso cai code, yog li cov lus qhia saum toj no tsuas yog cov lus qhia.

Txhawm rau kom tau txais Token Access, siv Txoj Cai Tso Cai tau txais thiab hu rau qhov kawg hauv qab no nrog cov kev thov tsis raws li tau piav qhia hauv qab no. Raws li tau piav qhia saum toj no, Txoj Cai Tso Cai yog luv luv, tas sij hawm tom qab 10 feeb (600 vib nas this), yog li thov xyuas kom lub Access Token tau thov sai li sai tau thaum tau txais Tsab Cai Tso Cai.

tso caiServerAuthorizationEndpoint: https://api.pge.com/datacustodian/oauth/v2/token

• Yam yuav tsum tau thov Parameter:
  • grant_type = authorization_code (tus nqi zoo li qub)
  • code = tso cai code tau txais nyob rau hauv teb rau kev tso cai code thov
  • redirect_uri = redirect URL uas koj teev nyob rau hauv koj Qhia Kuv Cov Ntaub Ntawv sau npe (URLs yuav tsum phim).
    Ceeb Toom: Raws li kev tso cai code thov, peb pom zoo kom URL encoding siv rau redirect_uri.

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

Ntxiv qhov kev tso cai header parameter nrog Base64 encoding siv "clientID:clientSecret"

Ceeb Toom: Tus neeg siv ID: tus neeg siv khoom tsis pub lwm tus paub qhov tseem ceeb sib haum rau tus neeg siv khoom tus nqi uas tau muab rau hauv koj qhov Qhia Kuv Cov Ntaub Ntawv sau npe tseem ceeb.
Lub header parameter yuav ua raws li hauv qab no:
Param npe: Tso Cai
Param tus nqi: Basic "base64encoded hlua"

Cov lus teb ua tiav yuav zoo li no:

774ff105-7ad5-40c8-a6ec-f60675dc0e41
360 >
998c6654-5b3b-4385-af4f-4e5c46c1bb04
scope=FB=1_3_8_13_14_18_19_31_32_35_35_37_40_39_ ionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Txhua Hnub;HistoryLength={3P Registered historical length};AccountCollection ={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} xws li: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{ subscriptionID}
tso caiURI:{AuthorizationURI} xws li: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerResourceURI:{customerResourceURI} xws li:https://api.pge.com /GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Ceeb Toom: Ib qho Access Token tas sij hawm nyob rau hauv 3600 secs (1 teev), thaum qhov sib thooj Refresh Token tas sij hawm hauv 1 xyoo. Saib tshooj 3 tom ntej kom paub meej txog kev tau txais tus tshiab Access Token/Refresh Token khub.

Txuag qhov kev nkag mus thiab rov ua dua tshiab token khub.
Txhawm rau thov cov ntaub ntawv keeb kwm thawj zaug thiab cov ntaub ntawv niaj hnub tsis tu ncua, mus saib cov ntaub ntawv nkag .

Raws li kev coj ua zoo tshaj plaws, Access Token yog lub cim luv luv (1 teev) thaum qhov sib txuas Refresh Token yog lub cim nyob ntev (1 xyoos) uas koj tuaj yeem siv kom tau txais Access Token tshiab / Refresh Token khub thaum lub Access Token tas sij hawm. Kom tau txais ib qho tshiab Access Token thiab Refresh Token khub rau cov ntawv tso cai uas tsis tas yuav tas mus li, siv "Tam sim no Refresh Token" thiab hu rau qhov kawg ntawm qhov tsis muaj raws li tau piav qhia hauv qab no.

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

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

Ntxiv qhov kev tso cai header parameter nrog Base64 encoding siv "clientID:clientSecret"

Ceeb Toom: Tus neeg siv ID: tus neeg siv khoom zais qhov tseem ceeb sib haum rau tus neeg siv khoom tus nqi uas tau muab rau hauv koj Daim Ntawv Qhia Kuv Cov Ntaub Ntawv sau npe tseem ceeb.
Lub header parameter yuav ua raws li hauv qab no:
Lub npe: Tso Cai
Param tus nqi: Basic "base64encoded hlua"

Cov lus teb ua tiav yuav zoo li no:
{
"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_30_18_32_14_38_3 _5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_
ProgramEnrollment;IntervalDuration=900_3600 ;BlockDuration=Daily;HistoryLength={3P Registered historical length};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
"resourceURI": "https://api.pge.com/ GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
"authorizationURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

Ceeb Toom: Ib yam li ntawd, Client Access Token yog luv luv-nyob token (1 teev) thaum nws sib txuas Refresh Token yog ib qho token nyob ntev (1 xyoos) uas koj tuaj yeem siv tau kom tau txais tus Client Access Token tshiab / Refresh Token khub. thaum Client Access Token tas sij hawm. Kom tau txais ib qho tshiab Client Access Token/Refresh Token khub, siv tib cov kauj ruam uas tau piav saum toj no.

Cov neeg siv khoom yuav tuaj yeem hloov kho lawv cov ntawv tso cai los ntawm kev ua cov hauv qab no:

• Tshem Tawm Kev Pabcuam IDs los ntawm lawv cov ntawv tso cai
• Txuas ntxiv hnub kawg ntawm lub sijhawm tso cai
• Tso tseg kev tso cai

Ceeb Toom: Cov neeg siv khoom tsuas tuaj yeem hloov pauv lawv cov ntawv tso cai los ntawm kev nkag mus rau lawv tus lej PG&E online thiab ua raws li cov kauj ruam xav tau. Yog tias ib qho ntawm cov no tau ua, peb yuav ceeb toom rau koj ntawm Kev Ceeb Toom URI uas koj tau muab rau thaum sau npe.

Muaj kev xaiv rau kev tswj hwm thiab saib cov ntsiab lus ntawm koj cov neeg siv khoom tso cai:

• Koj tuaj yeem hu rau API tso cai (http GET ua haujlwm) siv koj tus neeg siv khoom_access_token nyob rau theem thib peb (kom paub meej txog txhua qhov kev tso cai) ntawm https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization lossis ntawm qib kev tso cai tus neeg siv khoom ntawm https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Cais, koj tseem tuaj yeem saib cov ntaub ntawv tso cai ntawm tus kheej los ntawm kev nkag mus rau hauv koj tus Share My Data account ntawm tus neeg sab nrauv portal thiab nkag mus rau Subscription ID rau kev tso cai koj tab tom nrhiav.

Yog tias koj tsis xav nkag mus rau cov ntaub ntawv cuam tshuam nrog kev tso cai, muaj txoj hauv kev xaiv los tshem tawm qhov kev tso cai:

• Koj tuaj yeem hu rau qhov kev tso cai tshem tawm API (http DELETE ua haujlwm) siv koj tus neeg siv khoom_access_token ntawm https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Xwb, koj tuaj yeem tshem tawm qhov kev tso cai los ntawm kev nkag mus rau hauv koj tus lej Qhia Kuv Cov Ntaub Ntawv los ntawm tus neeg sab nrauv portal thiab nkag mus rau Tus Neeg Sau Npe ID rau kev tso cai koj xav rho tawm.

Ceeb Toom: Cov neeg siv khoom yuav raug ceeb toom tias koj tau xaiv kom thim lawv qhov kev tso cai. Tsis tas li ntawd, ib zaug kev tso cai raug muab tso tseg, qhov kev txiav txim tsis tuaj yeem thim rov qab.

• PG&E yuav xa cov ntawv ceeb toom rau koj qhov kev ceeb toom URI muab thaum sau npe. Cov Ntawv Ceeb Toom suav nrog URIs sib raug rau cov ntaub ntawv npaj ua ntej npaj rau koj rov qab los thiab thov ntawm qhov muab URLs. Cov ntaub ntawv tau ntim ua ntej thiab cov ntawv ceeb toom xa tawm hauv ob qhov xwm txheej hauv qab no: (1) koj tau xaiv "Qhia rau kuv thaum cov ntaub ntawv npaj tau" hauv koj daim ntawv teev npe, qhov twg peb yuav ntim cov ntaub ntawv tshiab niaj hnub nrog rau kev kho yav dhau los cov hnub, lossis (2) koj tau ua qhov kev thov ua ntej ad hoc asynchronous uas cov ntaub ntawv thov tam sim no npaj txhij.
• Scenario 1 yog qhia hauv qab "DATA ACCESS: NTAUB NTAWV NTAUB NTAWV" ntu ntawm Cov Ntaub Ntawv Nkag Mus Rau Cov Txheej Txheem hauv qab no thiab Scenario 2 yog qhia hauv qab "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" ntu ntawm tib daim duab hauv qab no.

Thov nco ntsoov lub neej ntawm token ntawm Access Tokens, Client Access Token, thiab lawv cov Refresh Token uas raug siv hauv cov ntaub ntawv thov. Raws li kev coj ua zoo tshaj plaws, Access Token yog lub cim luv luv (1 teev) thaum lub cim tshiab tshiab yog lub cim nyob ntev (1 xyoos) uas koj tuaj yeem siv kom tau txais ib qho tshiab Access Token / Refresh Token khub thaum Access Token tas sij hawm. Ib yam li ntawd, Client Access Token yog lub sijhawm luv luv (1 teev) thaum nws qhov sib thooj Refresh Token yog lub token nyob ntev (1 xyoos) uas koj tuaj yeem siv kom tau txais Tus Neeg Siv Khoom Siv Token tshiab / Refresh Token khub thaum tus neeg siv khoom. Access Token tas sij hawm. Yog xav paub ntxiv txog kev tau txais ib khub token tshiab, xa mus rau Kauj Ruam 3, Thov kom nkag mus rau token tshiab, hauv peb cov ntaub ntawv tso cai tab.  Mus rau cov ntaub ntawv tso cai

Yog tias koj tau tso cai los ntawm cov neeg siv khoom kom tau txais "Account Information" (Account IDs, Service Agreement IDs and service start dates) thiab/los yog "Basic Information" (ie, username and service address), koj tuaj yeem thov cov ntaub ntawv no rau cov neeg siv khoom. ntawm ESPI tau hais tseg RetailCustomer APIs uas cov ntaub ntawv ua raws li cov qauv, retailCustomer.xsd, muab los saum toj no.

Synchronous (Standard thiab EEF thib peb tog)

Ib txoj hauv kev los thov cov neeg siv khoom cov ntaub ntawv yog siv synchronous API rau kev thov cov ntaub ntawv neeg siv khoom rau ib tus neeg siv khoom tso cai rau cov neeg siv khoom cov ntaub ntawv (piv txwv li, Cov Neeg Muag Khoom Muag Khoom):

Piv txwv Synchronous Thov URL: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID koj tau txais thaum kawg ntawm OAuth tso cai ib ntus kom tau txais tus lej nkag. Tus RetailCustomerID yog ib feem ntawm tus neeg siv khoomResourceUri kab parameter hauv cov lus teb token. (RetailCustomerID = SubscriptionID)

HTTP Header = Kev tso cai: Tus neeg tuav ntaub ntawv {tso cai nkag mus rau qhov kev tso cai no}

Teb = koj yuav tau txais cov ntaub ntawv rov qab synchronously rau RetailCustomerID. Cov ntaub ntawv ua raws li qhov retailCustomer.xsd

Ceeb Toom: Lub synchronous Retail Customer API yog nyob rau ntawm tus kheej Retail Customer Level uas sib raug rau ib tus neeg siv khoom tso cai.

Rau kev siv: daim duab hierarchical hauv qab no qhia txog kev sib raug zoo hierarchy rau ESPI cov ntaub ntawv hauv kev ua qauv PG&E cov ntaub ntawv cov neeg siv khoom.

Koj tuaj yeem thov cov neeg siv khoom cov ntaub ntawv los ntawm asynchronous API rau kev thov cov ntaub ntawv neeg siv khoom rau tag nrho koj cov neeg siv khoom tso cai rau cov ntaub ntawv cov neeg siv khoom (piv txwv li Cov Neeg Muag Khoom Muag).

Txhawm rau txhawb kev thov Asynchronous, koj daim ntawv thov yuav tsum txhawb nqa Cov Ntawv Ceeb Toom uas peb yuav xa tuaj rau koj (raws li Daim Ntawv Ceeb Toom URL koj tau muab thaum sau npe).

Piv txwv Asynchronous Thov URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID muab rau hauv ApplicationInformation Resource retrieved thaum lub sij hawm sau npe xeem. (BulkID = ClientID)

HTTP Header = Kev tso cai: Tus neeg tuav ntaub ntawv {tus neeg siv nkag tau token retrieve thaum sau npe xeem}

Teb = HTTP txheej xwm code 202 (Qhov no yog ib qho kev thov asynchronous qhov twg cov lus teb yuav raug muab tso rau qhov ceeb toom URL thaum cov ntaub ntawv npaj txhij). Thaum cov ntaub ntawv npaj txhij, peb yuav tshaj tawm cov ntawv ceeb toom rau koj qhov kev ceeb toom URI nrog them nyiaj ntawm URLs koj daim ntawv thov tuaj yeem rov qab los tau txais cov ntim ua ntej. Sample post ceeb toom zoo li hauv qab no

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

Ua Tau Txais ntawm qhov URL saum toj no nrog Client Access token kom tau txais cov ntaub ntawv.

Rau kev siv: daim duab hierarchical hauv qab no qhia txog kev sib raug zoo hierarchy rau ESPI cov ntaub ntawv hauv kev ua qauv PG&E cov ntaub ntawv cov neeg siv khoom.

Thaum kawg koj tuaj yeem tau txais cov ntaub ntawv tshiab ntawm cov neeg siv khoom niaj hnub siv cov qauv kev tso npe txhua hnub (piv txwv li, los ntawm kev xaiv "Tshaj tawm kuv li cov ntaub ntawv npaj tau (txhua hnub)" checkbox thaum sau npe).

Txhawm rau txhawb nqa tus qauv sau npe txhua hnub, koj daim ntawv thov yuav tsum tau txhawb nqa Cov Ntawv Ceeb Toom Peb yuav xa tuaj rau koj (raws li Daim Ntawv Ceeb Toom URL koj tau muab thaum sau npe).

Thaum cov ntaub ntawv npaj txhij, peb yuav tshaj tawm ib qho kev ceeb toom rau koj qhov kev ceeb toom URI nrog rau kev them nyiaj ntawm URLs koj daim ntawv thov tuaj yeem rov qab tau txais cov ntim ua ntej. Sample post ceeb toom zoo li hauv qab no:

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

Ua Tau Txais ntawm qhov URL saum toj no nrog Client Access token kom tau txais cov ntaub ntawv.

Rau kev siv, daim duab hierarchical hauv qab no qhia txog kev sib raug zoo hierarchy rau ESPI cov ntaub ntawv hauv kev ua qauv PG&E cov ntaub ntawv cov neeg siv khoom.

Yog tias koj tau txais kev tso cai los ntawm tus neeg siv khoom kom tau txais "Cov Ntaub Ntawv Siv" thiab / lossis "Cov Ntaub Ntawv Sau Nqi", koj tuaj yeem thov cov ntaub ntawv no los ntawm kev tso npe APIs uas cov ntaub ntawv ua raws li schema, espiDerived.xsd, muab saum toj no.

Synchronous Ad Hoc Thov (Txoj Cai thiab EEF thib peb tog)

Txhawm rau thov cov ntaub ntawv keeb kwm (rau ob qho tib si lub sijhawm siv cov ntaub ntawv thiab cov ntaub ntawv sau nqi), ib txoj hauv kev yog siv cov synchronous APIs nrog rau kev suav nrog qhov pib thiab hnub kawg thov tsis pub dhau lub sijhawm Zulu.

Piv txwv Synchronous Thov URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max= {endDate}

luam tawm-min = hnub pib uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. Hnub tim yog nyob rau hauv Zulu lub sij hawm ntawm yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 hom)

luam tawm-max = hnub kawg uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. Hnub tim yog nyob rau hauv Zulu lub sij hawm ntawm yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 hom)

Ceeb Toom: Rau API thov uas lees txais luam tawm-max thiab luam tawm-min-hnub tsis txwv, lub neej ntawd yog T-1 (hnub thov rho tawm 1 hnub). Rau kev siv cov ntsiab lus thov (xws li, .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary), peb xav kom muab ib tug ntau ntawm 30 hnub los yog ntau tshaj los xyuas kom meej tias muaj ib daim nqi. uas sib tshooj nrog lub sijhawm ntawd, txwv tsis pub cov ntaub ntawv yuav raug xa rov qab.

Subscription ID = SubscriptionID koj tau txais thaum kawg ntawm OAuth tso cai ib ntus kom tau txais ib qho token nkag. Tus ID nkag mus yog ib feem ntawm cov khoom siv URI parameter hauv cov lus teb token. (SubscribeID = RetailCustomerID)

UsagePointID = UsagePoint nyob rau hauv daim ntawv teev npe saum toj no. Koj tuaj yeem tau txais tag nrho cov ntsiab lus siv rau qhov muab Subscription los ntawm kev hu rau API URL hauv qab no thiab muab cov token nkag mus rau qhov kev tso npe hauv qhov kev tso cai header: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription /{SubscriptionID}/UsagePoint

HTTP Header = Kev Tso Cai: Tus Neeg Sawv Cev { nkag token rau qhov kev tso npe no}

Teb = koj yuav tau txais cov ntaub ntawv rov qab synchronously rau qhov siv taw tes rau lub sijhawm thov. Nws yuav muaj ob lub sijhawm siv cov ntaub ntawv () thiab cov ntaub ntawv them nqi ().

Synchronous siv APIs (raws li qhia los ntawm URL kev tsim kho uas xaus nrog Usage Point ID) yog nyob rau ntawm tus kheej siv Point theem (xws li, Daim Ntawv Pom Zoo Pabcuam), yog li ib daim ntawv thov yuav voj voog cov lus thov los ntawm txhua qhov Kev Siv Point IDs teej tug mus rau ib tug muab kev tso cai rau cov neeg siv khoom (ie, subscription).

Cov lus teb rau cov lus thov synchronous rov qab ob qho tib si cov ntaub ntawv ncua sij hawm (hauv qab) cuam tshuam rau hnub ntau yam thov nrog rau txhua lub hli siv tag nrho thiab cov nqi them nqi uas sib tshooj nrog cov hnub thov (hauv qab ).

• IntervalReading muaj qhov ncua sij hawm (15-min / teev) hluav taws xob siv thiab cov ntaub ntawv siv roj (txhua hnub)
• Cov Lus Qhia Txog Kev Siv muaj cov kev siv txhua hli thiab cov ntsiab lus them nqi (yog tias tso cai)

Nyob rau hauv cov lus teb koj yuav pom cov ntaub ntawv hais txog peb ESPI cov ntaub ntawv keeb kwm daim ntawv qhia

Rau kev siv, daim duab hierarchical hauv qab no qhia txog kev sib raug zoo hierarchy rau ESPI cov ntaub ntawv hauv kev ua qauv PG&E cov ntaub ntawv cov neeg siv khoom.

Cov hauv qab no yog ob peb lub ntsiab lus tseem ceeb ntawm cov ntaub ntawv no:

• Intervalblock yog rau 1 hnub
• IntervalReading (hauv qab ntu ntu thaiv) muaj qhov tseeb 15-min / teev hluav taws xob siv qhov tseem ceeb thiab cov nqi siv roj txhua hnub
• Rau cov neeg siv khoom siv hluav taws xob nrog rau ntawm qhov chaw tsim khoom (xws li Hnub Ci), cov khoom siv flowDirection qhia cov khoom xa tuaj (siv) thiab tau txais (tiam) cov ntaub ntawv siv. Rau cov neeg siv khoom nrog cov ntsuas ntsuas kom tsuas yog nyeem cov kev siv net (piv txwv li tsis muaj tiam neeg ntawm qhov chaw), lub ntsiab lus flowDirection qhia tias qhov kev siv yog tus nqi npaum li cas (qhov txawv ntawm qhov xa tawm tau txais):
  • Flow kev taw qhia ntawm 1 = xa (lub zog muab rau tus neeg siv khoom)
  • Flow kev taw qhia ntawm 19 = tau txais (net tiam ntws rov qab mus rau PG&E daim phiaj). (Ceeb toom, qhov tseem ceeb yog qhov tseeb)
  • Flow kev taw qhia ntawm 4 = net (xa rho tawm - tau txais)
• Ua tib zoo saib xyuas Lub Hwj Chim ntawm kaum qhov sib npaug thiab Chav ntsuas ntsuas (uom) txhawm rau xyuas kom raug siv nyeem ntawv

Batch Subscription (Standard thiab EEF thib peb tog)

Koj tuaj yeem thov cov ntaub ntawv siv los ntawm asynchronous API rau tag nrho cov ntsiab lus siv uas yog ib tus neeg siv khoom tso cai rau kev siv / cov ntaub ntawv them nqi (ie Subscription).

Txhawm rau txhawb nqa Ad Hoc Asynchronous thov (piv txwv li, rau ntau tshaj ib qho Kev Siv Point ntawm ib lub sijhawm), koj daim ntawv thov yuav tsum txhawb nqa Cov Ntawv Ceeb Toom Peb yuav xa tuaj rau koj (raws li Daim Ntawv Ceeb Toom URL koj tau muab thaum sau npe)

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

Subscription ID = SubscriptionID koj tau txais thaum kawg ntawm OAuth ib ntus kom tau txais ib qho token nkag. Tus ID nkag mus yog ib feem ntawm cov khoom sivURI parameter hauv cov lus teb token

luam tawm-min = hnub pib uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

luam tawm-max = hnub kawg uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Kev Tso Cai: Tus Neeg Sawv Cev { nkag token rau qhov kev tso npe no}

Teb = HTTP txheej xwm code 202 (qhov no yog qhov kev thov asynchronous qhov twg cov lus teb yuav raug muab tso rau qhov ceeb toom URL thaum cov ntaub ntawv npaj txhij)

Thaum cov ntaub ntawv npaj txhij, peb yuav tshaj tawm cov ntawv ceeb toom rau koj qhov kev ceeb toom URI nrog them nyiaj ntawm URLs koj daim ntawv thov tuaj yeem rov qab los tau txais cov ntim ua ntej. Tus qauv xa ntawv ceeb toom zoo li hauv qab no:

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

Ua Tau Txais ntawm qhov URL saum toj no nrog Access token kom tau txais cov ntaub ntawv. Qhov no yuav muaj ob lub sijhawm siv cov ntaub ntawv () nrog rau cov ntaub ntawv them nqi () rau lub sijhawm thov.

Batch Subscription (Standard thiab EEF thib peb tog)
Koj tuaj yeem thov kev siv thiab cov ntaub ntawv them nqi ntawm batch bulk asynchronous API rau tag nrho koj cov neeg siv khoom tso cai rau kev siv / cov ntaub ntawv them nqi (ie Subscriptions).

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

BulkID = BulkID muab rau hauv ApplicationInformation Resource retrieved thaum lub sij hawm sau npe xeem. (BulkID = ClientID)

luam tawm-min = hnub pib uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

luam tawm-max = hnub kawg uas yuav siv rau qhov kev thov no rub cov ntaub ntawv. (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Kev Tso Cai: Tus Thawj Coj {tus neeg siv khoom token}

Teb = HTTP txheej xwm code 202 (qhov no yog qhov kev thov asynchronous qhov twg cov lus teb yuav raug muab tso rau qhov ceeb toom URL thaum cov ntaub ntawv npaj txhij)

Thaum cov ntaub ntawv npaj tau lawm, peb yuav tshaj tawm cov ntawv ceeb toom rau koj qhov kev ceeb toom URI nrog them nyiaj ntawm URLs koj daim ntawv thov tuaj yeem rov qab tau txais cov ntim ua ntej. Sample post ceeb toom zoo li hauv qab no:

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

Ua Tau Txais ntawm qhov URL saum toj no nrog Access token kom tau txais cov ntaub ntawv. Qhov no yuav muaj ob lub sijhawm siv cov ntaub ntawv () nrog rau cov ntaub ntawv them nqi () rau lub sijhawm thov.

Thaum kawg koj tuaj yeem tau txais cov ntaub ntawv siv tam sim no thiab kev them nqi suav nrog kev kho cov hnub dhau los hauv cov neeg siv khoom tso cai nyob rau txhua hnub siv tus qauv kev tso npe txhua hnub (piv txwv li, los ntawm kev xaiv "Qhia kuv li cov ntaub ntawv npaj tau (txhua hnub)" checkbox thaum sau npe) .

Txhawm rau txhawb nqa tus qauv sau npe txhua hnub, koj daim ntawv thov yuav tsum tau txhawb nqa Cov Ntawv Ceeb Toom Peb yuav xa tuaj rau koj (raws li Daim Ntawv Ceeb Toom URL koj tau muab thaum sau npe).

Thaum cov ntaub ntawv npaj txhij, peb yuav tshaj tawm cov ntawv ceeb toom rau koj qhov kev ceeb toom URI nrog them nyiaj ntawm URLs koj daim ntawv thov tuaj yeem rov qab los tau txais cov ntim ua ntej. Sample post ceeb toom zoo li hauv qab no:

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

Ua kom tau txais ntawm qhov URL saum toj no nrog Access token kom tau txais cov ntaub ntawv. Qhov no yuav muaj ob lub sijhawm siv cov ntaub ntawv () nrog rau cov ntaub ntawv them nqi () rau lub sijhawm thov.

Lub Peb Hlis 20, 2023

Qhov tshiab:

1. Tso tawm API HTTP cov lus teb tshiab (204) rau ob qho tib si synchronous thiab asynchronous API hu los qhia thaum twg tsis muaj cov ntaub ntawv muaj rau ntau qhov kev thov.
2. Txhawb nqa x-kev lag luam header daim ntawv lo uas txhawb nqa lub peev xwm los txuas PG&E cov lus teb rau qhov tshwj xeeb Asynchronous API hu los ntawm kev xa rov qab tus nqi no nrog rau Kev Sib Txuas ID thaum cov ntaub ntawv thov npaj txhij.
3. Txhim kho cov ntaub ntawv nthuav dav ntxiv rau UsagePoint/MeterReadingID API los ntawm kev muab cov ntaub ntawv hluav taws xob luv luv rau ntau lub meters rau ib qho Kev Pabcuam Daim Ntawv Pom Zoo.
4. Muab qhov tseeb ntxiv rau Kev Nyeem Ntawv Qhov Ntsuas Qhov Ntsuas qhov tseem ceeb rau ESTIMATED luv luv cov ntaub ntawv los piav txog hom kev kwv yees siv rau lub sijhawm ntawd. Cov txiaj ntsig tshiab qhia txog kev kwv yees kwv yees tau raug siv hauv qab no:
   
   

5. RQI tus nqi thiab kev piav qhia

   0 - Siv tau: cov ntaub ntawv uas tau dhau los ntawm txhua qhov yuav tsum tau kuaj xyuas qhov tseeb thiab dhau los ntawm tag nrho lossis tau txheeb xyuas

   7 - Hloov kho manually: hloov lossis pom zoo los ntawm tib neeg

   8 - Kev kwv yees siv hnub siv: cov ntaub ntawv tus nqi raug hloov los ntawm lub tshuab xam tus nqi raws li kev txheeb xyuas cov ntaub ntawv keeb kwm siv tib hom kev ntsuas

   9 - Kev kwv yees siv linear interpolation: cov ntaub ntawv tus nqi raug suav nrog kev sib cuam tshuam raws li kev nyeem ua ntej thiab tom qab nws

   10 - Muaj lus nug: cov ntaub ntawv uas tau ua tsis tiav ib lossis ntau daim tshev

   11 - Derived: cov ntaub ntawv uas tau muab xam (siv logic lossis lej ua haujlwm), tsis tas ntsuas ncaj qha

   12 - Npaj (kev kwv yees): cov ntaub ntawv uas tau muab xam raws li kev kwv yees lossis kev kwv yees ntawm kev nyeem yav tom ntej

   13 - Mixed: qhia tias qhov zoo ntawm kev nyeem ntawv no muaj cov yam ntxwv sib xyaw

   14 - Raw: cov ntaub ntawv uas tsis tau dhau los ntawm kev siv tau, kho thiab kwv yees txheej txheem. CEEB TOOM MV90 Meters RQI qhov taw qhia yuav nyob twj ywm hauv 14 raws li qhov kawg RQ

   15 - Li qub rau huab cua: cov txiaj ntsig tau raug hloov kho rau tus account rau huab cua, los sib piv kev siv hauv cov huab cua sib txawv

   16 - Lwm yam: qhia tias tus yam ntxwv siv lwm yam uas tsis yog cov uas tau hais tseg

   17 - Validated: cov ntaub ntawv uas tau raug validated thiab tejzaum nws kho thiab/los yog kwv yees raws li kev pom zoo cov txheej txheem

   18 - Txheeb xyuas: cov ntaub ntawv uas ua tsis tau yam tsawg kawg yog ib qho ntawm qhov yuav tsum tau kuaj xyuas tab sis tau txiav txim siab los sawv cev siv tiag

   19 - Cov nyiaj tau los zoo: siv tau thiab siv tau rau lub hom phiaj them nqi [tseem tau txuas ntxiv rau ESPI tus qauv, thiab tsis yog ib feem ntawm thawj ESPI]

    

6. Tso tawm ntawm tus neeg muag khoom API siv cov ntsuas hauv Kev Qhia Kuv Cov Ntaub Ntawv Thib Peb Tus Neeg Muag Khoom Portal.

Kaum Ib Hlis 15, 2018

Qhov tshiab:

1. Cov Neeg Siv Khoom Siv Chav Kawm tau ntxiv lawm. Txhua SAID uas tau tso cai yuav raug txheeb xyuas raws li RES, AGR, COM/IND lossis Lwm yam.
2. Billing thiab Usage APIs yuav raug hloov kho kom lees txais cov lus nug tshiab-max thiab hloov kho-min (raws li lwm txoj hauv kev tshaj tawm-min thiab luam tawm-max). Cov ntaub ntawv xa rov qab yuav yog txhua qhov kev hloov pauv uas tau tshwm sim hauv qhov hloov kho-max thiab hloov kho-min tsis.
3. Hloov kev siv tus thib peb tus 5-tus lej Bulk ID nrog tus thib peb tus neeg siv khoom ID rau kev tso cai hauv online.
4. Muab kev xaiv rau lwm tus neeg sab nrauv los hloov cov neeg siv khoom mus rau PG&E tus account nkag los yog Guest Access tab ua ib feem ntawm kev tso cai hauv online.
5. Txhim kho PG&E's Share My Data cov neeg siv khoom dashboard kom yooj yim rau cov neeg siv khoom los saib tag nrho lawv cov ntaub ntawv uas twb muaj lawm kev tso cai nrog cov neeg thib peb.

Cuaj hlis 27, 2018

Qhov tshiab:

PG&E ntxiv cov ntaub ntawv tshiab rau Txoj Cai 24 cov ntaub ntawv teeb tsa ua ib feem ntawm PG&E's Expanded Data Set (EDS) project, thiab cov ntaub ntawv tshiab sib xws tau qhia hauv Txoj Cai 25 cov ntaub ntawv teeb tsa. Cov ntaub ntawv tshwj xeeb suav nrog PG&E txoj cai nthuav dav 25 cov ntaub ntawv teeb tsa tau teev tseg hauv qab no nrog kev xaiv EDS:

Txoj Cai 25 Cov Ntsiab Lus

Cov Lus Cim
Cov Ntsiab Lus
Tus lej Npe
Tus Kheej Chaw Nyob
Tus lej ID
EDS: Outage Block
Service Elements
PG&E UUID
Service ID
Yav Tom Ntej Kev Hloov Kho rau Kev Pabcuam
SA Status
Kev Pabcuam Pib Hnub
Qhov Chaw Pabcuam
Tam Sim No Qhov Kev Pabcuam
Keeb Kwm Kev Pabcuam Tariff
Tariff Options (Medical Baseline, CARE, FERA, FERA, , CCA_TBS, Solar Choice
Tam sim no Kev Pabcuam Voltage thiab Cov Khoom Siv Keeb Kwm Cov Nqi Them Nqi Kev Pabcuam Voltage
Service Meter Number
Tus naj npawb ntawm Kev Pabcuam Meters
Meter Hom
Tam Sim No Meter Nyeem Cycle
Keeb Kwm Billed Meter Nyeem Cycle
Tam Sim No Standby Rate Option yog On-site
Generation Keeb kwm Billed Standby Rate Option
EDS: Tus Neeg Siv Khoom Siv Chav Kawm
Cov Nqi Them Keeb Kwm
Daim Nqi Pib Hnub
Daim Ntawv Hnub Kawg
Bill tag nrho cov nqi ($)
Bill tag nrho kWh
EDS: Lub Npe Tus Muab Kev Pabcuam
Cov Nqi Them Keeb Kwm Tier Breakdown (yog tias muaj)
EDS: Kab Khoom Lub Sij Hawm
EDS: Lub Npe (Tshaj Tawm 1%-30%)
EDS: Volume (1234.2)
EDS: Tus Nqi ($ 0.032/kWh)
EDS: Tus Nqi ($ 100.23)
Keeb Kwm Tus Nqi TOU (kWh) tshwj tsis yog rau ABS-TX them nqi)
EDS: Kab Khoom Lub Sijhawm (rau TOU breakdown)
EDS: Lub Npe (ntawm TOU tus nqi)
EDS: Volume (1234.2)
EDS: Tus nqi ($ 0.032 / kWh)
EDS: Tus nqi ($ 100.23 )
Historical Bill Demand Breakdown
EDS: Line Item Bill Period (for Demand breakdown)
EDS: Name
EDS: Volume (1234.2)
EDS: Rate ($0.032/kWh)
EDS: Nqi ($100.23 Historical Bill)

EDS: Kab Khoom Lub Sij Hawm
EDS: Tus nqi them (DWR Bond Charge)
EDS: Volume (1234.2)
EDS: Unit (kWh)
EDS: Tus nqi ($ 0.032 / kWh)
EDS: Tus nqi ($ 100.23 Ustorical)
Intervals
Interval Usage Start
Default Interval Duration (in vib nas this)
Interval use Volume (1234.2)
Unit (kWh/Therms)
Utility Demand Response Programs
(DR) Program Name
Earliest Termination Date regardless Financial Obligation
Ntawm Lub Luag Haujlwm Nyiaj Txiag
DR Txoj Haujlwm Txheej Txheem
DR Txoj Haujlwm Kev Kawm Hnub Tiav
DR Txoj Haujlwm De-Enrollment Hnub
Cov Khoom Siv
Cov Khoom Siv
Lub Sijhawm Hauv Zos (DST cov ntsiab lus)
Cov Ntaub Ntawv Default
Kev Taw Qhia Lub Zog
Lub Hwjchim ntawm Kaum Qhov Kev Pabcuam (rau cov nqi siv ib ntus)
Lub Hwjchim ntawm Kaum Qhov Kev Pabcuam (rau Cov Nqi Them Nqi)
Lub Hwjchim ntawm Kaum Qhov Kev Pabcuam (Rau Kev Pabcuam Tag Nrho)
Lub Sijhawm Ntev (ntawm Kev Nyeem Ntawv)
Cov txiaj ntsig ntawm daim nqi tag nrho
Hluav Taws Xob Interval TOU Qhov Ntsuas

Lub Rau Hli 28, 2018

Raws li ib feem ntawm Click-Through project thiab txuas ntxiv txhim kho rau Kev Qhia Kuv Cov Ntaub Ntawv Platform, PG&E tau pib Click-Through Phase 2 thaum Lub Rau Hli 28, 2018.

Qhov tshiab:

Cov kev hloov pauv tseem ceeb tshaj plaws uas cuam tshuam rau cov neeg thib peb yog cov kev hloov pauv kom ua raws li OAuth 2.0 raws tu qauv (PG&E tshem tawm thawj zaug ntawm redirects) .  Nrhiav cov ntsiab lus hauv qab no.

TSEEM CEEB: Cov neeg thib peb yog YUAV TSUM kom hloov pauv lawv qhov kev siv OAuth uas twb muaj lawm. PG&E's Click-Through Phase 2 hloov pauv yog TSIS rov qab sib xws, yog li nws yog qhov tsim nyog rau cov neeg thib peb los siv cov kev hloov pauv nrog PG&E qhov kev siv. Yog tias tsis siv, cov txheej txheem kev tso cai rau cov neeg siv khoom tam sim no yuav tsum tsis ua haujlwm rau hnub txiav tawm ntawm Lub Rau Hli 29, 2018 .  Kev tso cai uas twb muaj lawm, txawm li cas los xij, tsis cuam tshuam.

1. Txhawm rau ua raws li OAuth 2.0 raws tu qauv, PG&E tau txo tus naj npawb ntawm redirect kauj ruam rau kev tso cai. Thawj zaug xa rov qab mus rau PG&E rau cov neeg siv khoom nkag mus rau hauv thiab xa daim ntawv tso cai tau ua ke nrog cov cai tso cai thov raws li hauv qab no:
   • Raws li tau pom hauv qhov piv txwv hauv qab no, kev tso cai thib peb tus lej thov tam sim no suav nrog kev hloov pauv ntawm tus neeg siv khoom browser mus rau PG&E qhov kev tso cai tshiabServerAuthorizationEndpoint URI, nrog rau cov kev thov tsim nyog:
     Tau https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={optionalState}
   • Cov ntsiab lus hauv qab no tau tso tseg: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. Kev ua yuam kev tshiab tuav cov lus rau kev tso cai code thov nrog qhov tsis muaj lossis tsis raug cai raws li hauv qab no:
   • Yog hais tias qhov yuav tsum tau client_id lossis redirect_uri tsis tau ploj lawm lossis tsis raug, ib qho (http 400) yuam kev nrog cov lus piav qhia yog qhia rau tus neeg siv khoom
   • Yog hais tias qhov yuav tsum tau teb_type parameter ploj lawm lossis tsis raug, tus neeg siv khoom yuav raug xa rov qab mus rau tus thib peb tus redirect_uri nrog rau qhov "invalid_request" qhov tsis raug ( ntxiv rau redirect_uri)
     
3. Rau cov neeg siv khoom nrog kev tso cai hauv online uas twb muaj lawm, muaj peev xwm rau ib tus neeg thib peb thov tus tshiab access_token/refresh_token khub ua ib feem ntawm kev tso cai tshiab uas hloov qhov uas twb muaj lawm (piv txwv li, kev tso cai hauv online ntawm tib neeg thib peb thiab cov neeg siv khoom ua ke). Qhov kev ua haujlwm no hais txog cov xwm txheej ntawm cov neeg thib peb poob ib khub access_token/refresh_token lossis lwm yam yuav tsum tau hloov pauv qhov kev tso cai thawj zaug rau ib tus neeg siv khoom pom zoo.
   • Rau kev thov rov tso cai dua, tus neeg siv khoom pom nplooj ntawv tso cai tshiab hloov ntawm nplooj ntawv "tswj kev tso cai" thaum xa rov qab los ntawm tus thib peb rau PG&E rau kev tso cai
   • Raws li cov neeg siv khoom tso cai, cov neeg thib peb tau txais ib daim ntawv ceeb toom rau lawv qhov kev ceeb toom URL uas qhov kev tso npe ID qub raug muab tso tseg (kev ceeb toom suav nrog kev tso cai API URL kawg rau tus ID nkag mus qub)
     
4. Lub peev xwm rau tus neeg siv khoom tawm ntawm lub pob "tso tseg" ntawm nplooj ntawv pov thawj lossis nplooj ntawv tso cai nrog redirect rov qab mus rau tus thib peb tus redirect_uri nrog rau qhov "access_denied" yuam kev parameter (appended rau redirect_uri)
5. Rau cov neeg thib peb uas tso npe nrog "pom pom" teeb tsa thiab yog li suav nrog hauv cov npe ntawm cov neeg thib peb cov neeg siv khoom yuav pom thaum lawv mus rau lawv tus account PG&E online thiab mus rau nplooj ntawv Qhia Kuv Cov Ntaub Ntawv tsaws:
   • Rau cov neeg siv khoom uas nkag mus rau hauv lawv tus account PG&E online thiab taug qab mus rau nplooj ntawv Qhia Kuv Cov Ntaub Ntawv tsaws thiab tom qab ntawd raug xa mus rau lwm tus neeg sau npe "Third Party Portal URI" thaum xaiv tus thib peb los ntawm cov npe ntawm cov neeg thib peb sau npe. Thaum lub sijhawm ntawd, cov neeg siv khoom tuaj yeem txuas ntxiv nrog tus thib peb tus txheej txheem OAuth. Thaum mus los ntawm txoj kev no, cov neeg siv khoom yuav tsis pom cov nplooj ntawv tso cai ntxiv lawm thaum xaiv ib tus neeg thib peb los ntawm cov npe poob ntawm cov neeg thib peb, tab sis hloov mus rau tus neeg thib peb lub npe "Third Party Portal URI" qhov twg lawv tuaj yeem pib qhov thib peb. tog pib txheej txheem OAuth
   • Lus Cim Tseg: Qee tus neeg thib peb tau nug txog yuav ua li cas txhawm rau txhim kho cov neeg siv khoom siv rau qhov kev siv no (piv txwv li, kev tso cai pib ntawm PG&E's site) xws li rau tus neeg siv khoom nws pom tias lawv raug coj ncaj qha mus rau nplooj ntawv tso cai thaum xaiv tus thib peb los ntawm kev xa rov qab. Txhawm rau pab txhawb cov neeg siv khoom zoo li no, cov neeg thib peb tuaj yeem xaiv los teeb tsa lawv "Third Party Portal URI" (ntawm Share My Data tswj nplooj ntawv sau npe) mus rau qhov kawg uas tau xa cov neeg siv khoom rov qab mus rau PG&E raws li ib feem ntawm kev tso cai code thov. Thaum tsis siv neeg redirect rov qab mus rau PG&E qhov kev tso caiServerAuthorizationEndpoint, tus neeg siv khoom yuav hla tus neeg siv khoom nkag nplooj ntawv (raws li lawv tau nkag mus rau hauv) thiab yuav ncaj qha mus rau nplooj ntawv tso cai. Rau qee tus neeg thib peb uas tau sau npe ua ntej Kev Qhia Kuv Cov Ntaub Ntawv Nyem Thru 2.0 tso tawm, qhov no tuaj yeem ua tiav los ntawm tsuas yog txhais lub Third Party Portal URI kom sib npaug ntawm qhov tsis siv "Third Party Scope Selection Screen"URI (sold SMD Registration field mus so kom txaus nyob rau hauv ib tug yav tom ntej tso).
     Hauv qhov sib piv, qee tus neeg thib peb yuav xav hloov pauv thawj zaug thiab tshuaj xyuas cov neeg siv khoom ntawm lawv sab thaum cov neeg siv khoom raug xa mus rau lawv 'Third Party Portal' URI ua ntej thov kev tso cai code, yog li cov lus qhia saum toj no tsuas yog cov lus qhia.
     
6. SMD tam sim no yuav muab cov ntsiab lus txhim kho Scope parameter raws li ib feem ntawm cov lus teb rau Kev Tso Cai Code Thov, Access Token Request, thiab Kev Tso Cai API. Qhov ntsuas qhov ntsuas tau zoo tso cai rau kev sib txuas lus qhov kawg ntawm cov neeg siv khoom tso cai. Tshwj xeeb, qhov kev txwv tsis pub muaj xws li "AdditionalScope" tus nqi uas qhia rau PG&E qhov kev txhawb nqa kev tso cai rau cov neeg siv khoom xaiv ntawm pawg ntaub ntawv (xws li "Siv", "Billing", "Basic", "Account", "Program Enrollment"). Qhov ntsuas qhov ntsuas qhov tseem ceeb tau raug ntes ntxiv rau cov ntaub ntawv hauv qab no: Download Txhawb Kev Ua Haujlwm Block Scope String Mapping Nyem Thru 2.0 (PDF)
   
   Ib qho piv txwv Token cov lus teb hauv qab no qhia txog qee qhov muaj peev xwm ua tau qhov tseem ceeb.
   • Piv txwv Token Teb:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     360 >
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     scope=FB=1_3_8_13_14_18_19_31_32_35_35_37_40_39_ ionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Txhua Hnub;HistoryLength={3P Registered historical length};AccountCollection ={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} xws li: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{ subscriptionID}
     tso caiURI:{AuthorizationURI} xws li: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} xws li:https://api.pge.com /GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Cov neeg thib peb tam sim no tuaj yeem sau npe kom tau txais cov ntaub ntawv tso cai rau Kev Nkag Mus Kawm los ntawm pawg tshiab "Program Enrollment" cov ntaub ntawv. Ob lub sijhawm ntsuas nrog rau cov neeg siv khoom tsis sib xws yuav tsim nyog tau txais kev tso cai sib faib cov ntaub ntawv rau SMD Nyem-Tshaj Theem 2. Cov ntsiab lus theem siab ntawm cov ntaub ntawv tshiab uas tau muab los ntawm Pab Pawg Cov Ntaub Ntawv Sau Npe yog raws li hauv qab no:
   • Kev Sau Npe Kawm Ntawv (PG&E Demand Response program name/status and CAISO information):
   • (Billing) Chaw nyob tus account
   • Daim Ntawv Pom Zoo Pabcuam Status
   • (Tam sim no) Service tariff
   • (Tam sim no) Service voltage (hluav taws xob nkaus xwb)
   • Service meter tooj (yog tias muaj)
   • Meter hom
   • (Tam sim no) Meter Read Cycle
   • (Tam sim no) Standby Rate Option yog On-Site Generation Indicator
   • (ntev ncua sij hawm siv) Duration (ntev hauv vib nas this)
   • (Nyob rau npe PG&E Demand Response) Lub Npe Txoj Haujlwm (yog muaj)
   • Hnub Kawg Ua Ntej Kawg los ntawm PG&E cuv npe thov Kev Thov Teb (DR) Txoj Haujlwm yam tsis muaj kev lav phib xaub nyiaj txiag
   • Hnub Kawg Ua Ntej Ua Ntej los ntawm PG&E cuv npe Demand Response (DR) Program tsis hais txog nyiaj txiag
   • PG&E Demand Response (DR) Qhov Kev Pabcuam (rau npe kawm) Cov xwm txheej
   • PG&E Demand Response (DR) Hnub rau npe kawm
   • PG&E Demand Response (DR) Program De-Enrollment Date
   • Lub Atom XML XSD (XML Schema Definition) daim ntawv qhia rau cov ntaub ntawv tshiab no raug ntes raws li cov ntaub ntawv hauv qab no:
     Download Cov Ntaub Ntawv Txhawb Nqa (PDF)
   • Associated relational data hierarchy model yog teev raws li hauv qab no:
     Download PGE ESPI Cov Ntaub Ntawv Tus Qauv (PDF)
   • UsagePoint (aka SA UUID)
     • ServiceDeliveryPoint\tariffProfile(tam sim no cov nqi kev pabcuam AKA tus nqi sijhawm suav nrog Standby Rate Option yog muaj)
     • readCycle (Tam sim no Meter Read Cycle)UsageSummary
     • readCycle (kev pab them nqi mus ncig)
     • Cov Khoom Muag (suav nrog them nqi hluav taws xob rau hluav taws xob)
     • tariffProfile (cov nqi them cov kev pabcuam suav nrog kev xaiv Standby Rate yog tias muaj
   • Hom Kev Nyeem Ntawv
     • Cov Khoom Muag (suav nrog theem tam sim no rau hluav taws xob thiab ua ntej rau Standby Rate Option qhov twg siv tau)
   • Tus Neeg Siv Khoom
     • (Acct Billing Address):
     • mainAddress/streetDetail...
     • mainAddress/townDetail...
     • mainAddress/postalCode...
   • Daim Ntawv Pom Zoo Cov Neeg Siv Khoom
     • xwm txheej\tus nqi (SA Status
   • Demand Response Program
     • program npe
     • enrollmentStatus
     • programDate/programDate
     • programDate/programDateDescription
   • Lub Twj Ntsuas
     • SerialNumber (meter ID)
     • hom (meter hom)
     • (tam sim no) intervalLength
   • Tseeb ESPI xml schema txhais (XSDs) siv rau cov ntaub ntawv tshiab no tau piav qhia raws li hauv qab no:
     Download XSDs (ZIP, 49 KB)ZIP. Qhib hauv Qhov rai tshiab.
     Nco tseg: XSDs rov qab sib xws.
   • Cov neeg thib peb yuav muaj peev xwm hloov lawv cov ntawv sau npe kom tso cai rau cov neeg siv khoom xaiv cov ntaub ntawv no thaum lub sijhawm tso cai los ntawm tus neeg sab nrauv portal hauv qab tswj kev sau npe> Kho> ntu: Qhia cov neeg siv khoom cov ntaub ntawv uas koj xav tau", xaiv qhov Kev Pabcuam Kev Sau Npe Kos Npe.
   • Ceeb toom: qhov no tsuas yog siv rau cov neeg siv khoom tso cai tshiab.
     
   • Tshiab APIs txhawm rau khaws DR Cov Ntaub Ntawv Sau Npe yog muaj nyob rau ntawm Bulk 3rd party theem nrog rau ntawm qib kev tso cai tus neeg siv khoom (RetailCustomerID theem), tau teev tseg raws li hauv qab no:
     Rub tawm tshiab PGE Txhawb APIs (PDF)
   • Asynchronous API rau kev thov DR Cov ntaub ntawv sau npe rau txhua qhov kev tso cai rau lwm tus neeg sab nrauv
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • Synchronous API rau kev thov DR cov ntaub ntawv sau npe ntawm tus neeg siv khoom tso cai qib
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

Thov nco ntsoov hais tias: Dhau li ntawm cov kev hloov pauv rau cov txheej txheem kev tso cai rau cov neeg siv khoom, lwm yam kev hloov pauv kuj tseem rov qab sib xws thiab yog kev yeem txhim kho cov neeg thib peb tuaj yeem xaiv los txhawb.

Yog tias koj muaj lus nug lossis xav tau kev txhawb nqa ntxiv, thov xa email rau sharemydata@pge.com .

Qhov tshiab:

1. Cov neeg siv khoom tam sim no tuaj yeem tau txais txiaj ntsig los ntawm cov txheej txheem kev tso cai Click-Through.
   • Peb tau hloov kho cov ntsiab lus hais txog yuav ua li cas tus neeg siv khoom tam sim no tuaj yeem qhia cov ntaub ntawv nrog koj lub tuam txhab.
     Kawm paub yuav ua li cas cov neeg siv khoom qhia cov ntaub ntawv nrog lub tuam txhab
     
     Lus Cim: Cov kev hloov no, tshwj xeeb tshaj yog kev txhim kho rau peb qhov kev tso cai UI, tau ua kom zoo rau cov khoom siv txawb (xws li, xov tooj lossis ntsiav tshuaj).
   • Kev hloov pauv tau ua rau cov txheej txheem tswj kev tso cai nkag tau rau cov neeg siv khoom los ntawm lawv tus account PG&E online:
     • Tus neeg siv khoom tseem tuaj yeem tshem tawm SAIDs los ntawm kev tso cai uas twb muaj lawm, txuas ntxiv hnub tso cai kawg thiab / lossis tshem tawm qhov kev tso cai txhua lub sijhawm. Txawm li cas los xij, txhawm rau ntxiv SAIDs ntxiv thiab / lossis hloov pauv cov ntaub ntawv tso cai cov ntawv tso cai uas twb muaj lawm yuav tsum tau muab tso tseg thiab yuav tsum tau tsim kev tso cai tshiab.
2. Yog xav tau, tam sim no cov neeg sab nrauv tuaj yeem siv qhov API no rau kev tshem tawm cov neeg siv khoom tso cai siv lawv tus thib peb Client Access Token (muab thaum pib SMD thib peb txheej txheem sau npe) los ntawm kev DELETE: https://api.pge.com/GreenButtonConnect/ espi/1_1/resource/Authorization/{AuthorizationID}
   
   Ceeb Toom 1: Rau PG&E qhov kev siv, AuthorizationID parameter yog tus nqi tib yam li SubscriptionID.
   
   Ceeb Toom 2: API tshiab muab cov neeg thib peb lub peev xwm tshem tawm (tso tseg) kev tso cai. Txawm li cas los xij, tsuas yog cov neeg siv khoom lawv tus kheej tuaj yeem tshem tawm SA IDs thiab / lossis hloov kho hnub tso cai kawg ntawm peb SMD tswj cov nplooj ntawv tso cai.
   
   Ceeb Toom: Raws li nrog txhua qhov kev thov API cov ntaub ntawv, cov neeg sab nrauv yuav tsum xub thov ib tug tshiab Token Pair (Client Access + Refresh Token) siv lawv qhov tseeb Refresh Token.
   
   Ceeb toom ntawm Token Lub Sijhawm Kawg:
   • Access Token: 1hr
   • Client Access Token: 5 min
   • Sib Nqus Refresh Token: 1 xyoo
3. Cov neeg thib peb tam sim no tuaj yeem tsim ntau yam Qhia Kuv Cov Ntaub Ntawv (SMD) sau npe siv tib lub tuam txhab npe thiab tus lej se yog xav tau. Txawm li cas los xij, lub npe zaub (uas cov neeg siv khoom pom thaum tso cai) tseem yuav tsum muaj qhov tshwj xeeb.
   
   Ceeb Toom: Tag nrho cov kev hloov pauv saum toj no yog rov qab sib xws thiab yog kev yeem txhim kho cov neeg thib peb tuaj yeem xaiv los txhawb. Download tau cov ntaub ntawv txhawb nqa rau qhov kev tso tawm no:
   
   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)

Lub Kaum Ob Hlis 20, 2015

Yuav tsum tau hloov pauv: cov kev hloov tshiab hauv qab no SMD 2.0 xav tau kev hloov pauv ntawm cov neeg thib peb.

1. Hauv kev txiav txim siab ntawm cov neeg thib peb nrog GBCMD (Green Button Txuas Kuv Cov Ntaub Ntawv) kev siv ntawm ntau yam khoom siv dua li ntawm PG&E xwb, peb yuav rov qab cov ntaub ntawvCustodianID (ie, dataCustodianID = PGE) hauv kev xa mus rau ThirdPartyScopeSelectionScreenURI thaum lub sijhawm OAuth tso cai ua ntu zus.
2. API thov uas lees txais hnub tsis txwv (piv txwv li, batch thov), yuav tsum siv cov ntaub ntawv Zulu (piv txwv li, luam tawm-max / luam tawm-min). Lwm hom hnub rau cov hnub tsis nyob hauv API thov yuav tsis raug txhawb.
   • APIs uas lees txais hnub tsis muaj cov ntaub ntawv nyob rau hauv qhov txuas, Txhawb APIs.xlsx
3. Lub Sijhawm TOU Indicators suav nrog cov ntaub ntawv siv hluav taws xob nruab nrab (raws li siv tau, qhov taw qhia ntawm TOU lub sijhawm twg txhua lub sijhawm sib raug rau)
   • Thov siv qhov kev pab cuam zoo li qub ID Mappings piav qhia txog dab tsi txhua lub sij hawm TOU enumeration sib raug rau (xws li, 1 = Lub Caij Ntuj Sov Peak thiab lwm yam). (Saib txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx )
4. Tus neeg siv khoom_id raws li pom nyob rau hauv dataCustodianScopeSelectionScreenURI (siv rau tus neeg thib peb pib OAuth) thiab muab rau hauv Daim Ntawv Thov Cov Ntaub Ntawv Kev Pabcuam thib peb thov thaum Lub Sijhawm Kev Ntsuas tau hloov kho rau 5 tus lej yog tias nws tsis yog lawm (xws li, ntxiv cov lej lej thiab lwm yam). Ntxiv mus, qhov URL tsis suav nrog '&verified=true' thaum kawg. Cov neeg thib peb yuav tsum hloov kho lawv cov URLs raws li.
   • Kom nthuav dav, cov ntaub ntawvCustodianScopeSelectionScreenURI zoo li hauv qab no: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX yog tus neeg siv khoom ID)
   • Yog li tam sim no tus neeg siv ID ntawm 123 yuav hloov mus rau qee yam zoo li 00123 lub ntsiab lus lawv cov ntaub ntawv tshiabCustodianScopeSelectionScreenURI yuav ua raws li hauv qab no:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 ( qub URL ua raws li hauv qab no: https:// sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. Cov neeg thib peb tau sau npe ua "ESP" lossis "Lub Chaw Pabcuam Hluav Taws Xob" tab tom hloov mus rau Hom Tus Neeg Siv Khoom. Tsis muaj kev hloov pauv ua haujlwm, tsuas yog hauv cov neeg siv hom npe. Distinguishing ESP user type (los ntawm Standard User type) yog ib qho kev sib txawv uas tsis tsim nyog, ua rau muaj kev tsis sib haum xeeb thaum lub sijhawm sau npe yam tsis muaj kev ua haujlwm sib txawv, yog li nws tau so haujlwm.

Kev Kho Kom Zoo Dua: Cov kev hloov pauv hauv qab no yog rov qab sib xws, thiab yog kev yeem txhim kho cov neeg thib peb tuaj yeem xaiv los txhawb.

1. Cov neeg thib peb yuav muaj peev xwm hloov pauv / hloov kho lawv cov ntawv pov thawj SSL uas lawv tau muab thaum xub thawj thaum sau npe (xws li, thaum daim ntawv pov thawj ze rau qhov kawg) ntawm tus thib peb portal hauv qab tswj kev sau npe> Kho> ntu tshiab: SSL Daim Ntawv Pov Thawj Cov Ntaub Ntawv (kev xaiv hloov tshiab).
2. Cov neeg thib peb tuaj yeem sau npe kom tau txais cov ntaub ntawv sau nqi yooj yim, cov ntaub ntawv cov neeg siv khoom, thiab cov ntaub ntawv roj.  Ob lub sijhawm ntsuas nrog rau cov neeg siv khoom tsis sib xws yuav tsim nyog tau tso cai sib faib cov ntaub ntawv rau SMD 2.0. Cov ntsiab lus siab ntawm cov ntaub ntawv tshiab muaj nyob hauv qab no:
   • Cov Ntaub Ntawv Kev Them Nqi: (rau ob qho tib si Interval thiab non-interval metered SAs)
     • Tus Nqi Sijhawm, nqi them $ tag nrho, Tiered pab (raws li muaj), Xav tau (raws li muaj), TOU tag nrho (raws li muaj)
     • Lus Cim Tseg: Rau cov neeg tau txais kev tso cai tsis yog ncua sij hawm ntsuas cov neeg siv khoom, cov neeg thib peb tsuas yog tau txais cov nqi siv tag nrho (piv txwv li, hauv Kev Siv Cov Ntsiab Lus) thiab tsis muaj kev nyeem ib ntus (piv txwv li, nyeem ib teev / txhua hnub raws li lawv tsis muaj)
   • Cov Ntaub Ntawv Cov Neeg Siv Khoom: (rau ob qho tib si ncua sij hawm thiab tsis yog ncua sij hawm ntsuas SAs)
     • Tus Neeg Siv Khoom Lub Npe, Chaw Nyob Kev Pabcuam, Tus lej ID, Daim Ntawv Pom Zoo Kev Pabcuam ID, Kev Pabcuam Daim Ntawv Pom Zoo Pib Hnub,
   • Interval Gas siv cov ntaub ntawv: (interval metered gas SAs nkaus xwb)
     • Interval (ie, niaj hnub) roj nyeem
   • Cov ntaub ntawv tshiab yog kos duab raws li qhov txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx
   • Associated relational data hierarchy yog teev nyob rau hauv qhov txuas, PGE ESPI Data Model.xlsx
   • Tseeb ESPI xml schema txhais (XSDs) siv rau cov ntaub ntawv tshiab no yog raws li XSDs txuas. Ceeb toom: lub XSDs rov qab tau tshaj:
     • espiDerived.xsd (Kev Siv Lub Sijhawm Nruab Nrab thiab Cov Ntaub Ntawv Sau Nqi)
     • retailcustomer.xsd (cov ntaub ntawv neeg siv khoom)

Yog tias koj muaj lus nug lossis xav tau kev txhawb nqa ntxiv, thov hu rau peb ntawm ShareMyData@pge.com .

Kaum Ob Hlis 18, 2015

Yuav tsum tau hloov pauv: cov nram qab no SMD 2.0 hloov tshiab yuav tsum tau hloov ntawm ib feem ntawm cov neeg siv nkag mus rau lawv tus kheej cov ntaub ntawv:

1. API thov uas lees txais hnub tsis txwv (piv txwv li, batch thov), yuav tsum siv cov ntaub ntawv Zulu (piv txwv li, luam tawm-max / luam tawm-min). Lwm hom hnub rau cov hnub tsis nyob hauv API thov yuav tsis txaus siab.
   • APIs uas lees txais hnub tsis muaj cov ntaub ntawv ib qho txuas, Txhawb APIs.xlsx
2. Lub Sijhawm Sijhawm Siv Sijhawm (TOU) ntsuas suav nrog cov ntaub ntawv siv hluav taws xob nruab nrab (raws li siv tau, qhov taw qhia ntawm TOU lub sijhawm twg txhua lub sijhawm sib raug rau)
   • Thov siv qhov zoo li qub Program ID Mappings piav qhia txog dab tsi txhua lub sijhawm TOU enumeration sib raug rau (xws li, 1 = Lub Caij Ntuj Sov Peak thiab lwm yam). (Saib txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx )

Kev Kho Kom Zoo Dua: Cov kev hloov pauv hauv qab no yog rov qab sib xws, thiab yog kev yeem txhim kho cov neeg thib peb tuaj yeem xaiv los txhawb.

1. Cov neeg siv Kev Nkag Nkag Tus Kheej yuav muaj peev xwm hloov pauv / hloov kho lawv cov ntawv pov thawj SSL uas lawv tau muab thaum xub thawj thaum sau npe (xws li, thaum daim ntawv pov thawj ze rau qhov kawg) ntawm tus thib peb portal hauv qab tswj kev sau npe> Kho> ntu tshiab: SSL Daim Ntawv Pov Thawj Cov Ntaub Ntawv (kev xaiv hloov tshiab)
2. Kev Nkag Mus Rau Tus Kheej Cov Ntawv Sau Npe yuav raug hloov kho kom suav nrog cov ntaub ntawv sau nqi yooj yim, cov ntaub ntawv neeg siv khoom, thiab cov ntaub ntawv roj. Ob lub sijhawm ntsuas raws li zoo raws li cov ntawv cog lus tsis tu ncua kev pabcuam yuav tsim nyog rau (tus kheej) kev tso cai rau SMD 2.0 Cov ntsiab lus siab ntawm cov ntaub ntawv tshiab muaj nyob hauv qab no:
   • Cov Ntaub Ntawv Kev Them Nqi: (rau ob qho tib si Interval thiab non-interval metered SAs)
     • Tus nqi teem caij, nqi them $ tag nrho, Tiered pab (raws li muaj), Xav tau (raws li muaj), TOU tag nrho (raws li muaj)
     • Lus Cim Tseg: Rau cov neeg tau txais kev tso cai tsis yog ncua sij hawm ntsuas cov neeg siv khoom, cov neeg thib peb tsuas yog tau txais cov nqi siv tag nrho (piv txwv li, hauv Kev Siv Cov Lus Qhia) thiab tsis muaj kev nyeem ntawv ib ntus (piv txwv li, nyeem ib teev / txhua hnub vim lawv tsis muaj)
   • Cov Ntaub Ntawv Cov Neeg Siv Khoom: (rau ob qho tib si ncua sij hawm thiab tsis cuam tshuam nrog SAs)
     • Tus Neeg Siv Khoom Lub Npe, Chaw Nyob Chaw Pabcuam, Tus lej ID, Daim Ntawv Pom Zoo Kev Pabcuam ID, Kev Pabcuam Daim Ntawv Pom Zoo Pib Hnub,
   • Interval Gas siv cov ntaub ntawv: (interval metered gas SAs nkaus xwb)
     • Interval (ie, niaj hnub) roj nyeem
   • Cov ntaub ntawv tshiab yog cov duab kos raws li qhov txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx
   • Associated relational data hierarchy yog teev nyob rau hauv qhov txuas, PGE ESPI Data Model.xlsx
   • Tseeb ESPI xml schema txhais (XSDs) siv rau cov ntaub ntawv tshiab no yog nyob rau hauv XSDs txuas. Ceeb toom: lub XSDs rov qab tau tshaj:
     • espiDerived.xsd (Kev Siv Lub Sijhawm Sijhawm thiab Cov Ntaub Ntawv Sau Nqi)
     • retailcustomer.xsd (cov ntaub ntawv neeg siv khoom)

Yog tias koj muaj lus nug lossis xav tau kev txhawb nqa ntxiv, thov hu rau peb ntawm ShareMyData@pge.com .

Kaum Ob Hlis 18, 2015

Yuav tsum tau hloov pauv: qhov kev hloov kho SMD 2.0 hauv qab no yuav tsum tau hloov ntawm ib feem ntawm CCA kev siv.

1. Ad hoc thov (piv txwv li, rau cov ntaub ntawv keeb kwm), yuav tsum tau ua siv Zulu lub sij hawm hnub tsis. Lwm hom hnub rau cov hnub tsis nyob hauv API thov yuav tsis txaus siab.
2. Kev pub noj txhua hnub yuav pib suav nrog cov ntaub ntawv sau nqi yooj yim thaum cov neeg siv khoom noj txhua hnub yuav suav nrog cov neeg siv khoom ntxiv. Cov ntaub ntawv tshiab no yuav muab rau ob qho tib si rau cov neeg siv khoom nruab nrab uas lawv tau txais cov ntaub ntawv tam sim no, nrog rau cov neeg siv khoom tsis sib xws hauv lawv thaj chaw uas lawv tsis tau txais cov ntaub ntawv tam sim no. Thaum kawg, qhov kev siv ib ntus uas muaj nyob rau hauv cov khoom noj txhua hnub yuav suav nrog cov ntsuas TOU lub sijhawm uas siv tau. Cov ntsiab lus siab ntawm cov ntaub ntawv tshiab yog raws li hauv qab no:
   • Cov Ntaub Ntawv Kev Them Nqi: (rau ob qho tib si Nruam thiab tsis cuam tshuam nrog SAs)
     • Tus nqi teem caij, nqi them $ tag nrho, Tiered pab (raws li muaj), Xav tau (raws li muaj), TOU tag nrho (raws li muaj)
   • (Ntxiv) Cov Ntaub Ntawv Cov Neeg Siv Khoom: (rau ob qho tib si ncua sij hawm thiab tsis yog ncua sij hawm ntsuas SAs)
     • Lub Npe Cov Neeg Siv Khoom, Chaw Nyob Chaw Pabcuam, Kev Pabcuam Daim Ntawv Pom Zoo Pib Hnub, Tus lej ID
   • Interval TOU indicators, As nrog Interval metered electric use data (raws li muaj, qhov taw qhia ntawm lub sij hawm TOU dab tsi txhua lub sij hawm sib raug rau)
     • Thov siv qhov zoo li qub Program ID Mappings piav qhia txog dab tsi txhua lub sij hawm TOU enumeration sib raug rau (xws li, 1 = Lub Caij Ntuj Sov Peak thiab lwm yam). (Saib txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx )
   • Tseeb ESPI xml schema txhais (XSDs) siv rau cov ntaub ntawv tshiab no yog nyob rau hauv XSDs. Nco tseg, XSDs yog rov qab sib xws:
     • espiDerived.xsd (Kev Siv Lub Sijhawm Sijhawm thiab Cov Ntaub Ntawv Sau Nqi)
     • Retailcustomer.xsd (Cov Neeg Siv Khoom)
   • Cov ntaub ntawv tshiab yog cov duab kos raws li qhov txuas, Txhawb Cov Ntaub Ntawv Cov Ntsiab Lus.xlsx
   • Associated relational data hierarchy yog teev nyob rau hauv qhov txuas, PGE ESPI Data Model.xlsx

Kev Kho Kom Zoo Dua: Cov kev hloov pauv hauv qab no yog rov qab sib xws, thiab yog kev yeem txhawb nqa cov neeg thib peb tuaj yeem xaiv los txhawb.

1. CCA's tuaj yeem ua ad hoc thov rau cov neeg siv khoom cov ntaub ntawv ntawm: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (xa rov qab cov ntaub ntawv tshiab ntawm cov neeg siv khoom thaum lub sijhawm thov), ntxiv rau rau cov ntawv ceeb toom txhua hnub tau txais.
2. CCA's yuav muaj peev xwm hloov tau lawv daim ntawv pov thawj SSL uas lawv thawj zaug muab thaum lub sijhawm sau npe (piv txwv li, thaum daim ntawv pov thawj ze rau qhov kawg) ntawm tus neeg sab nrauv portal, hauv qab tswj kev sau npe> Kho> ntu tshiab: SSL Daim Ntawv Pov Thawj Cov Ntaub Ntawv (kev xaiv hloov tshiab)

Yog tias koj muaj lus nug lossis xav tau kev txhawb nqa ntxiv, thov hu rau peb ntawm ShareMyData@pge.com .

Lub Yim Hli 21, 2015

Qhov tshiab:

1. Lub Xeev param thiab cov peev txheej URI hloov pauv hauv Oauth cov lus teb
   • Raws li ib feem ntawm OAuth tso cai code thov, tus thib peb muaj kev xaiv xa mus rau hauv lub xeev parameter uas PG&E yuav xa rov qab mus rau tus thib peb. PG&E tseem yuav xa cov cai tso cai ntawm kev ua tiav kev tso cai tiav. Qhov kev xaiv lub xeev no tuaj yeem siv los pab tus thib peb txheeb xyuas qhov twg qhov kev thov tau pib, thiab khi qhov kev thov rov qab rau cov ntawv tso cai uas lawv tau pib.
   • Raws li ib feem ntawm kev ua tiav ntawm kev thov token, peb muab cov ntaub ntawv rov qabURI thiab kev tso caiURI cais los ntawm cov ntaub ntawv token. Tam sim no cov URIs tau hloov pauv thiab ua ib feem ntawm qhov kev tso tawm no peb yuav kho qhov ntawd.

Kho qhov tsis xws luag:

1. Default dates published-max and published-min
   Tam sim no PG&E mandates tus thib peb tog xa nyob rau hauv luam tawm-min thiab luam tawm-max tsis nyob rau hauv epoch vib nas this rau txhua cov ntaub ntawv thov qhia PG&E lub sij hawm uas lawv thov cov ntaub ntawv. Peb tab tom ua qhov kev hloov pauv los daws cov lus thov rau cov xwm txheej hauv qab no:
   • luam tawm-min thiab luam tawm-max qhov tseem ceeb ploj lawm
   • luam tawm-min thiab luam tawm-max qhov tseem ceeb nyob hauv UTC
   • luam tawm-min thiab luam tawm-max qhov tseem ceeb yog nyob rau hauv vib nas this
   Nyob rau hauv qhov xwm txheej uas tsis muaj qhov tsis muaj, PG&E yuav rov qab hnub qub, uas tsis yog cov lus yuam kev raws li xa rov qab ua ntej qhov kev hloov pauv no. Default, nyob rau hauv peb cov ntaub ntawv, yog ib hnub cov ntaub ntawv rau hnub T-2. Yog hais tias qhov tsis muaj tam sim no thiab formatted kom raug, peb tseem yuav hwm cov tsis.
2. Kho rau cov hnub hauv kev tso cai xml
   Tam sim no nyob rau hauv qhov kev tso cai xml peb tau qhia hnub luam tawm thiab hnub tso cai. Cov hnub no yog nyob rau hauv milliseconds as opposed rau vib nas this uas yog tus qauv. Peb tab tom kho nws kom xa rov qab nyob rau hauv lub sijhawm vib nas this es tsis txhob milliseconds.
3. XML tsis raug xa rov qab rau /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Tam sim no peb tab tom xa cov lus teb tsis raug rau qib siab saum toj kawg nkaus GET qhov twg cov qauv ntawm XML tsis raug thiab peb tab tom rov nkag rau txhua lub sijhawm es tsis txhob tsim ib lub sijhawm luv luv rau 24 teev.
   
   Qhov no tau raug kho thiab tsuas yog ib ntu ntu yuav raug xa rov qab rau 24 ntu ntu.

Cov lus nug lossis kev txhawj xeeb? Thov hu rau ShareMyData@pge.com .

• Cov neeg siv khoom tso cai rau koj nkag mus rau lawv cov ntaub ntawv los ntawm My Energy, lawv tus account PG&E online. Rau cov ncauj lus kom ntxaws txog yuav ua li cas cov neeg siv khoom tuaj yeem tso cai rau cov neeg thib peb lossis lwm lub koom haum nkag mus rau lawv cov ntaub ntawv, thov saib Qhia Kuv Cov Ntaub Ntawv Thib Peb Cov Txheej Txheem.

Mus rau cov ntaub ntawv tso cai

• Tam sim no, tsis muaj kev txwv.

• Cov neeg siv khoom tuaj yeem xaiv lub sijhawm teev tseg uas koj tuaj yeem nkag mus rau lawv cov ntaub ntawv, lossis lawv tuaj yeem tawm lub sijhawm tso cai qhib.
• Koj daim ntawv thov tuaj yeem tshawb xyuas hnub kawg ntawm daim ntawv tso cai rau cov neeg siv khoom nrog rau lwm cov ntaub ntawv tso cai los ntawm kev hu rau cov ntaub ntawv tso cai APIs (xws li, .../espi/1_1/resource/Authorization and/or.../espi/1_1/resource/ Kev Tso Cai/{AuthorizationID}).
• Xwb, koj tuaj yeem tshawb xyuas daim ntawv tso cai hnub kawg los ntawm kev nkag rau hauv koj tus account thiab xaiv Tswj Kev Tso Cai.

• Yog tias tus neeg siv khoom xaiv lub sijhawm tso cai, ces lawv daim ntawv tso cai yuav tas rau thaum kawg ntawm lub sijhawm ntawd. Yog hais tias lawv tshem tawm qhov kev tso cai, ces lawv daim ntawv tso cai yuav tas hnub tom qab lawv tshem tawm qhov kev tso cai.
• Yog tias tus neeg siv khoom xaiv Indefinite raws li lawv lub sijhawm tso cai, ces lawv qhov kev tso cai tsis tas sijhawm. Nco tseg, nyob rau hauv kev txiav txim siab ntawm Txoj Cai 24 Cov Kev Xav Tau Txais Kev Pabcuam thiab lwm cov kev pabcuam siv Qhia Kuv Cov Ntaub Ntawv, tom qab-qhov tseeb kho rau cov hnub tso cai yav dhau los tuaj yeem muab rau cov neeg thib peb txog li peb xyoos tom qab tso cai tas sijhawm.
• Saib "Yuav ua li cas kho cov ntaub ntawv raug kho?" kom paub meej ntxiv txog kev txais kev kho.

• Txhua tus PG&E cov neeg siv khoom uas tam sim no ua haujlwm ID rau kev pabcuam roj lossis hluav taws xob tuaj yeem tso cai rau koj nkag mus rau lawv cov ntaub ntawv siv cov cuab yeej Qhia Kuv Cov Ntaub Ntawv tshiab.

• Cov neeg siv khoom txaus siab koom nrog hauv kev sib qhia lawv cov ntaub ntawv los ntawm Kev Qhia Kuv Cov Ntaub Ntawv tau raug txhawb kom sau npe rau My Energy account. Qhov no yuav ua rau tag nrho cov txheej txheem ua haujlwm tau zoo dua thiab tseem ua rau lawv muaj peev xwm tswj hwm lawv cov ntawv tso cai online.
• Cov neeg siv khoom tuaj yeem sau npe rau My Energy account thaum lub sijhawm tso cai.
• Muaj cov txheej txheem phau ntawv muaj rau cov neeg siv khoom kom tau txais Daim Ntawv Qhia Kuv Cov Ntaub Ntawv Tso Cai online thiab xa daim ntawv ua tiav ntawm email.
• Yog xav paub ntxiv txog cov txheej txheem phau ntawv, thov hu rau peb ntawm ShareMyData@pge.com .

• Cov neeg siv khoom yuav tsum tau ua lawv tus kheej tso cai online los ntawm lawv tus account PG&E online. Txawm li cas los xij, yog tias lawv ua tiav thiab kos npe rau Daim Ntawv Tso Cai Qhia Kuv Cov Ntaub Ntawv, ces koj tuaj yeem xa mus rau PG&E sawv cev.

Download Qhia Kuv Cov Ntaub Ntawv Kev Tso Cai Rau Cov Neeg Siv Khoom lossis Tshem Tawm Daim Ntawv Tso Cai (PDF, 308 KB)

• Koj tuaj yeem hloov kho koj OAuth URIs los ntawm kev nkag mus rau hauv koj tus as khauj, mus rau Tswj Kev Sau Npe> Kho> thiab hloov kho cov teb hauv qab OAuth 2.0 Cov Ntaub Ntawv seem.

• Koj tuaj yeem hloov kho koj Daim Ntawv Ceeb Toom URI los ntawm kev nkag mus rau hauv koj tus as khauj, mus rau Tswj Kev Sau Npe> Kho> thiab hloov kho cov teb hauv qab ntu Cov Ntaub Ntawv Nkag Mus.

• Koj tuaj yeem hloov kho koj daim ntawv pov thawj SSL los ntawm kev nkag mus rau hauv koj tus as khauj, mus rau Tswj Kev Sau Npe> Kho> thiab xaiv "Hloov tshiab" hauv ntu SSL Daim Ntawv Pov Thawj Cov Ntaub Ntawv. Nco ntsoov tias rau daim ntawv pov thawj tshiab uploads, nws yuav siv sij hawm ob peb hnub los hloov kho PG&E systems nrog daim ntawv pov thawj tshiab.  
• Daim ntawv lees paub email los ntawm Pab Pawg Qhia Kuv Cov Ntaub Ntawv txhawb nqa yuav raug xa thaum daim ntawv pov thawj tshiab tau thov.

• Thaum koj tau txais email qhia tias koj tau txais kev tso npe lawm, koj yuav nkag mus rau hauv koj tus Share My Data account thiab rub peb daim ntawv pov thawj SSL ntawm nplooj ntawv download PG&E SSL Daim Ntawv Pov Thawj.

Nkag mus rau Qhia Kuv Cov Ntaub Ntawv

• Qhia Kuv Cov Ntaub Ntawv ua raws Green Button Txuas Kuv Cov Ntaub Ntawv cog lus ua haujlwm. Qhia Kuv Cov Ntaub Ntawv kuj tseem ntiav OAuth 2.0 rau kev tso cai, Thauj Txheej Kev Ruaj Ntseg (TLS) 1.2 thiab qhov tsawg kawg nkaus suite ntawm cyber security protocols pom zoo los ntawm NIST (National Institute of Standards and Technology) xws li tsis muaj ntaub ntawv sib pauv hauv qhov tseeb.

• Tiv thaiv cov neeg siv khoom cov ntaub ntawv yog qhov tseem ceeb tshaj plaws rau PG&E. PG&E saib xyuas cov ntaub ntawv hais txog lawv cov neeg siv khoom - suav nrog cov ntaub ntawv ntiag tug - ua tsis pub lwm tus paub, ua raws txhua txoj cai lij choj thiab kev tswj hwm, suav nrog cov tsim los ntawm California Public Utilities Commission thiab lwm yam.  
• Tau ntau tshaj li ob xyoo lawm, PG&E thiab lwm qhov chaw ua lag luam uas muaj peev txheej hauv California tau ua raws li CPUC cov cai nruj heev uas txwv tsis pub lawv nthuav tawm cov ntaub ntawv tshwj xeeb rau cov neeg siv khoom, xws li cov ntaub ntawv them nqi, rau cov neeg thib peb yam tsis tau txais kev tso cai los ntawm tus neeg siv khoom.  
• Thaum tus neeg siv khoom tso cai tso tawm cov ntaub ntawv, nws yog tus neeg siv khoom thiab tus thib peb lub luag haujlwm los tiv thaiv cov ntaub ntawv ntawd.
• Ib tus neeg siv khoom tuaj yeem xaiv txwv tsis pub sib qhia cov ntaub ntawv nrog lwm tus neeg sab nrauv txhua lub sijhawm los ntawm kev nkag mus rau lawv tus account PG&E online thiab tshem tawm lawv qhov kev tso cai. PG&E's tag nrho txoj cai ntiag tug thiab Daim Ntawv Ceeb Toom Txog Kev Nkag Mus, Sau, Khaws, Siv thiab Tshaj Tawm Cov Ntaub Ntawv Siv Hluav Taws Xob muaj nyob ntawm pge.com/privacy .

• Nyob rau hauv lub Scope ntawm Kev Qhia Kuv Cov Ntaub Ntawv, Cov Neeg Thib Peb yuav raug rau Cov Neeg Siv Khoom ntiag tug thiab cov cai tiv thaiv tau teev tseg hauv Share My Data platform cov nqe lus thiab cov cai thiab cov cai uas suav nrog hauv Cov Neeg Siv Khoom Siv Tus Nqi Se.
• Cov neeg thib peb kuj tseem raug rau tag nrho lwm cov kev cai lij choj thiab cov kev cai hais txog kev tiv thaiv tus neeg siv khoom ntiag tug, suav nrog, tab sis tsis txwv rau, Cov Cai Hais Txog Kev Tiv Thaiv Tus Kheej thiab Kev Tiv Thaiv Kev Ruaj Ntseg rau Kev Siv Hluav Taws Xob Cov Ntaub Ntawv tau txais los ntawm CPUC raws li Txuas D rau Kev Txiav Txim 11- 07-056 (Electric), kuj tau sau tseg hauv PG&E's Electric Rule No. 27, thiab California Civil Code Section 1798.80 – 1798.84.
• Yog xav paub ntxiv, thov xaiv qhov txuas, hauv qab no:
  Qhia Kuv Cov Ntaub Ntawv Cov Cai thiab Cov Cai (PDF, 190 KB)
  Txoj Cai Hluav Taws Xob No. 27 (PDF, 1.6 MB)
  Txuas D rau Kev Txiav Txim Siab 11-07-056 (PDF)
  Nrhiav cov ntaub ntawv ntxiv: California Civil Code Section 1798.80 – 1798.84

• Thov xa mus rau qhov txuas, hauv qab no, kom paub meej cov npe ntawm cov ntaub ntawv uas tau txais kev txhawb nqa.

Tau txais cov ntaub ntawv ntxiv txog kev nkag mus rau cov ntaub ntawv

• Muaj qee lub sijhawm, cov ntaub ntawv siv lub sijhawm ploj lawm vim tias peb cov txheej txheem kev siv cov ntaub ntawv sau npe pom tau tias muaj cov ntaub ntawv uas ploj lawm lossis tsis raug nyeem uas yuav xav tau kev ua haujlwm ntxiv (kho thiab kwv yees).
• Rau cov neeg siv khoom raws sij hawm (piv txwv li, cov neeg siv khoom siv sij hawm-ntawm-Siv cov nqi txiav txim siab), cov xwm txheej no raug kho raws sij hawm los xyuas kom meej tias cov nqi them nqi raug raug rau lawv cov nqi them txhua hli tom ntej.

• Yog tias koj xav tau txais kev kho cov ntaub ntawv, thov xyuas kom meej tias koj kos lub Ceeb Toom Kuv raws li Cov Ntaub Ntawv Npaj Ua Ntej thaum sau npe lossis los ntawm kev nkag mus rau hauv koj tus lej online thiab xaiv lub checkbox hauv qab Kho Profile. Peb mam li suav nrog cov ntaub ntawv kho uas tau raug ntes los ntawm peb lub kaw lus nyob rau hauv 24 teev dhau los, ua ib feem ntawm kev pub noj txhua hnub, rau cov ntaub ntawv koj tau tso cai nkag mus.
• kev kho cov ntaub ntawv yuav them rau txhua qhov kev hloov pauv rau lub sijhawm tso cai, txog li peb xyoos.

Ceeb Toom: Nyob rau hauv kev txiav txim siab ntawm Txoj Cai 24 Cov Neeg Muab Kev Xav Tau thiab lwm cov kev pab cuam uas siv Qhia Kuv Cov Ntaub Ntawv, tom qab qhov tseeb kho rau cov hnub tso cai yav dhau los tuaj yeem muab rau 3rd tog ntev txog peb xyoos tom qab tso cai tas sij hawm.

• Yog tias tsim nyog, PG&E yuav xa cov ntawv ceeb toom rau koj qhov URL ceeb toom uas tau muab thaum sau npe. Cov Ntawv Ceeb Toom suav nrog URLs sib xws rau cov ntaub ntawv uas twb tau ntim ua ntej npaj rau koj rov qab los thiab thov ntawm qhov muab URLs. Cov ntaub ntawv tau ntim ua ntej thiab cov ntawv ceeb toom xa tawm hauv ob qhov xwm txheej hauv qab no: (1) koj tau xaiv "Qhia rau kuv thaum cov ntaub ntawv npaj tau" hauv koj daim ntawv teev npe, qhov twg peb yuav ntim cov ntaub ntawv tshiab niaj hnub nrog rau kev kho yav dhau los cov hnub, lossis (2) koj tau ua qhov kev thov ua ntej ad hoc asynchronous uas cov ntaub ntawv thov tam sim no npaj txhij. Scenario 1 yog qhia hauv qab "DATA ACCESS: NTAUB NTAWV NTAUB NTAWV" ntu ntawm Cov Ntaub Ntawv Nkag Mus Rau Cov Txheej Txheem ntawm cov ntaub ntawv nkag mus rau nplooj ntawv thiab scenario 2 yog qhia hauv qab "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" ntu ntawm tib daim duab kos kuj nyob rau ntawm nplooj ntawv Cov Ntaub Ntawv.

Mus saib cov ntaub ntawv nkag saum toj no

• Cov ntaub ntawv siv hluav taws xob muab los ntawm Qhia Kuv Cov Ntaub Ntawv tsis yog Cov Ntaub Ntawv Kev Ntsuas Zoo (SQMD) raws li tau teev tseg los ntawm California Independent System Operator (CAISO). SQMD yog tsim los ntawm kev sib faib Cov Nyiaj Tau Los Zoo Meter Cov Ntaub Ntawv (RQMD) los ntawm Distribution Loss Factor (DLF) muaj feem xyuam rau cov neeg siv khoom qhov hluav taws xob rau lub sijhawm ntawd, hloov cov ntsuas ntsuas mus rau lub sijhawm luv luv uas yuav tsum tau ua los ntawm CAISO thiab tom qab ntawd suav cov txiaj ntsig rau txhua qhov. ncua sij hawm mus rau qib aggregate xav tau los ntawm CAISO.
  
• PG&E tab tom siv cov chij ntawm "QualityOfReading" (QOR) Hom muab los ntawm ESPI tus qauv los sib txuas lus seb cov ntaub ntawv puas yog Cov Nyiaj Tau Los Zoo. QOR Hom ntes cov txiaj ntsig zoo sib txawv rau cov ntaub ntawv siv, suav nrog tus nqi qhia meej rau "Cov Ntaub Ntawv Nyiaj Tau Los Zoo" lossis "RQMD." PG&E yuav siv hom QOR no hauv nws cov ntaub ntawv xa tawm raws li hauv qab no:
  • PG&E txhawb nqa ESPI muab chav kawm "UsageSummary", uas yuav siv los txheeb xyuas cov hnub uas daim ntawv cog lus kev pabcuam raug them, tus nqi them nqi siv, thiab cov ntaub ntawv siv tau zoo thaum lub sijhawm thov. Cov Lus Qhia Txog Kev Siv yuav raug sau tseg thaum daim nqi muaj rau cov ntaub ntawv thov thiab yuav suav nrog ob tus chij (cov ntsiab lus) ntawm QOR Hom:
    • UsageSummary.QualityOfReading caij (ntawm UsageSummary theem) qhia qhov zoo thaum lub sij hawm thov ntawm qhov tseeb muab ib ntus kev pab cuam qhov tseem ceeb ntxiv rau kev kho raws li UsageSummary.billingPeriod hnub.
    • Lub DefaultQuality caij rau OverallConsumptionLastPeriod (raws li ib feem ntawm UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) qhia qhov zoo ntawm tag nrho cov nqi siv.
  • PG&E tseem yuav sib txuas lus qhov zoo ntawm kev siv cov ntaub ntawv nyob rau theem ntu ntawm lub sijhawm thov siv IntervalReading.ReadingQuality.Quality element.

• Thaum lub sijhawm sau npe koj tuaj yeem xaiv ntau npaum li cas cov ntaub ntawv keeb kwm koj xav tau, xws li 24, 36, lossis 48 lub hlis hauv qab "Cov ntaub ntawv keeb kwm tau thov ntau npaum li cas" dropdown.
• Raws li ib feem ntawm tus neeg siv khoom tso cai tso cai rau koj nkag mus rau lawv cov ntaub ntawv, lub sijhawm keeb kwm rau kev tso cai yuav raug ua txhaum cai rau koj xaiv rau npe rau Kev Pabcuam ID (cov ntsiab lus siv) suav nrog hauv kev tso cai.
• Koj tuaj yeem hloov kho koj cov ntaub ntawv keeb kwm yav dhau los, los ntawm kev nkag mus rau hauv koj tus as khauj, mus rau Tswj Kev Sau Npe> Kho> thiab xaiv los ntawm cov ntawv sau npe "Yuav thov cov ntaub ntawv keeb kwm ntau npaum li cas."
• Thov nco ntsoov tias cov ntaub ntawv muab rau hauv qhov kev thov keeb kwm yuav pib nrog hnub uas tus neeg siv khoom tso cai, tsis yog hnub uas koj thov rau API.

Ceeb Toom: Kev hloov pauv rau koj cov ntaub ntawv keeb kwm tau thov tsuas yog cuam tshuam rau kev tso cai rau cov neeg siv khoom tshiab, thaum cov neeg siv khoom tso cai dhau los yuav cuam tshuam txog koj qhov kev xaiv thaum lub sijhawm tso cai.

• Raws li tus qauv ESPI, cov lus teb siv Atom Publishing Standard. Thov xaiv qhov txuas, hauv qab no, kom pom cov npe tag nrho ntawm APIs uas tau txais kev txhawb nqa, nrog rau cov ntaub ntawv muaj.

Tau txais cov ntaub ntawv ntxiv txog kev nkag mus rau cov ntaub ntawv

• Active electric and gas Service IDs ntsia thiab nyeem los ntawm PG&E tau txais kev tso cai los ntawm Share My Data platform.
• Yog tias Kev Pabcuam ID cuam tshuam nrog kev tso cai hloov pauv vim yog ib qho ntawm cov laj thawj hauv qab no, kev tso cai yuav hloov mus rau Kev Pabcuam tshiab ID thiab nkag mus rau cov ntaub ntawv keeb kwm kev siv lub sijhawm yuav txuas ntxiv mus:
  • Kev kaw ib ntus vim tsis them nyiaj
  • Txav mus rau qhov nyiaj them poob haujlwm
  • Kev Hloov Meter
  • Tus nqi hloov pauv
• Lwm yam xwm txheej uas ua rau muaj kev hloov pauv hauv Kev Pabcuam ID xws li kev txav chaw lossis kev hloov ntawm lub tuam txhab yuav txiav tawm kev nkag mus. Ntxiv rau, yog tias ib tus as khauj tsis txuas los ntawm koj tus lej Kuv Lub Zog, tag nrho cov kev pabcuam ID hauv qab uas tau tso cai los ntawm Qhia Kuv Cov Ntaub Ntawv yuav raug tso cai vim qhov tshwm sim.

• Txhawm rau txiav txim siab qhov sib luag ntawm cov ntaub ntawv tso cai ncua sijhawm, thov siv lub sijhawm ntev raws li muab los ntawm tus qauv ESPI.
• PG&E tab tom muab cov ntaub ntawv siv sijhawm ib ntus ntawm tib lub granularity raws li sau rau lub hom phiaj them nqi, uas feem ntau yog nyob rau ib teev lossis 15 feeb rau cov ntaub ntawv hluav taws xob thiab txhua hnub rau cov ntaub ntawv roj rau cov neeg siv khoom nrog lub sijhawm ntsuas. Thaum nws tuaj yeem sib txawv ntawm cov neeg siv khoom, kev siv lub ntsuas hluav taws xob feem ntau muaj nyob rau hauv ib teev rau cov neeg siv khoom nyob hauv feem ntau thiab nyob rau theem 15-feeb rau cov neeg siv khoom lag luam feem ntau, thiab kev siv roj siv hluav taws xob feem ntau muaj nyob rau txhua hnub rau feem ntau. cov neeg siv khoom.
• Rau cov ntsuas uas tsis yog ncua sij hawm, cov ntaub ntawv yuav muab thaum muaj.

• Rau feem coob ntawm PG&E cov neeg siv khoom nrog Smart Meter tau teeb tsa, cov ntaub ntawv siv hluav taws xob thiab roj av muaj nyob rau thaum kawg ntawm hnub tom qab ntawm Share My Data platform.
• Ib feem me me ntawm PG&E cov neeg siv khoom hluav taws xob nrog cov khoom siv hluav taws xob raws li MV90 meters ntsia yuav xav tau sijhawm ntxiv rau cov ntaub ntawv kom muaj.

• Thaum peb tsis tuaj yeem txhawb nqa ncaj qha rau kev teeb tsa koj cov APIs, peb muaj ntau cov kev pabcuam muaj los pab koj IT thiab cov peev txheej hauv kev txhim kho. Thov siv peb nplooj ntawv API Cov Ntaub Ntawv kom paub ntau ntxiv. Thov koj xav tiv tauj ShareMyData@pge.com yog muaj lus nug ntxiv.

Yog xav paub ntxiv, mus saib daim ntawv thov programming interface (API)