ចែករំលែកទិន្នន័យរបស់ខ្ញុំសម្រាប់ភាគីទីបី

ក្នុងគោលបំណងដើម្បីអនុវត្តតាមស្តង់ដារស្តង់ដារថាមពលអាមេរិកខាងជើងបច្ចុប្បន្ន (NAESB) ស្តង់ដារក្រុមហ៊ុនផ្ដល់សេវាកម្មថាមពល (ESPI) សម្រាប់ការអនុញ្ញាត, PG&E បានអនុវត្តក្របខ័ណ្ឌ OAuth 2.0 Authorization សម្រាប់ការអនុញ្ញាតឱ្យដំណើរការទិន្នន័យ។ ដ្យាក្រាម ខាង ក្រោម នេះ បង្ហាញ ពី របៀប ដែល អតិថិជន ចាប់ ផ្តើម អនុញ្ញាត ជ្រើស ប៉ារ៉ាម៉ែត្រ វិសាល ភាព ហើយ បន្ទាប់ មក ដាក់ ជូន ការ អនុញ្ញាត របស់ ពួក គេ ។

សម្ភារៈយោងបន្ថែមលើសពីព័ត៌មានខាងក្រោម៖

ទាញយក Diagram លំដាប់ ESPI OAuth 2.0 (PDF, 193 KB)
មើលទិន្នន័យ Green Button SDK នៅ Github

ចំណាំ៖ សម្រាប់ អ្នក រុករក ជម្រើស សហគមន៍ មាន តែ client_access_token ប៉ុណ្ណោះ ដែល ត្រូវ ការ ស្នើ សុំ ទិន្នន័យ (តាម រយៈ ២-Legged OAuth) ហើយ ខាង ក្រោម នេះ មិន អនុវត្ត ទេ។

ការ អនុញ្ញាត ដែល បាន ចាប់ ផ្តើម នៅ កន្លែង ភាគី ទី បី

ដើម្បី ចាប់ ផ្តើម ការ អនុញ្ញាត ពី គេហទំព័រ ភាគី ទី បី ដូច ដែល បាន បង្ហាញ នៅ ក្នុង ដ្យាក្រាម ដំបូង ខាង លើ សំណើ កូដ អនុញ្ញាត ត្រូវ បាន ធ្វើ ឡើង ដោយ បង្វែរ កម្មវិធី រុករក របស់ អតិថិជន ឡើង វិញ ពី គេហទំព័រ ភាគី ទី បី របស់ អ្នក ទៅ កាន់ PG&E's AuthorizationServer Authorization Endpoint URL ជាមួយ នឹង ប៉ារ៉ាម៉ែត្រ សំណើ សមរម្យ ដូច ដែល បាន សរសេរ ខាង ក្រោម ។ នៅ ពេល ដែល ការ បង្វិល វិញ អតិថិជន នឹង ត្រូវ បាន បង្ហាញ នូវ ទំព័រ PG&E log-in សម្រាប់ ការផ្ទៀងផ្ទាត់ ភាព ត្រឹមត្រូវ បន្ទាប់ មក ដោយ ទំព័រ អនុញ្ញាត សម្រាប់ ការ អនុញ្ញាត ឲ្យ មាន ការ ចូល ទិន្នន័យ ទៅ ភាគី ទី បី របស់ អ្នក៖

authorizationServerAuthorizationEndpoint URI (with request parameters)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=កូដ&state={optionalState}

• Mandatory Request Parameters:
  • client_id = Client ID from your Share My Data registration milestones (i.e., client_id/client_secret pair).
  • redirect_uri = redirect URL ដែល អ្នក បាន បញ្ជាក់ ក្នុង ការ ចុះ ឈ្មោះ ទិន្នន័យ Share My របស់ អ្នក (URLs ត្រូវ តែ ផ្គូផ្គង)។
    ចំណាំ: យើងសូមណែនាំ URL encoding redirect_uri ជាឧទាហរណ៍ខាងក្រោម។
  • response_type = កូដ (static value)
• ប៉ារ៉ាម៉ែត្រស្នើសុំជម្រើស(s):
  • រដ្ឋ = ប៉ារ៉ាម៉ែត្រ រដ្ឋ អូប៉ាក ជម្រើស ដូច ដែល បាន អនុញ្ញាត ដោយ ស្តង់ដារ OAuth 2.0 ដែល ត្រូវ បាន ត្រលប់ មក វិញ ជាមួយ នឹង កូដ អនុញ្ញាត ដើម្បី ជួយ រក្សា រដ្ឋ ។ ឧទាហរណ៍ ប៉ារ៉ាម៉ែត្រ រដ្ឋ អាច ត្រូវ បាន ប្រើ ដោយ ភាគី ទី បី ដើម្បី កំណត់ អត្ត សញ្ញាណ តែ មួយ គត់ នូវ ដើម កំណើត របស់ អតិថិ ជន និង ដើម្បី ការពារ ការ ក្លែង បន្លំ ឆ្លង តំបន់ ។
  • login={guest} ផ្តល់ជម្រើសសម្រាប់ភាគីទីបីដើម្បីបង្វែរអតិថិជនទៅ PG&E's My Energy log‐in ឬទៅកាន់ផ្ទាំង Guest Access ដែលជាផ្នែកមួយនៃលំហូរនៃការអនុញ្ញាតតាមអនឡាញ។

ទំព័រគំរូ:ពាក្យសុំលេខកូដ Auth

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

ចំណាំ: ឧទាហរណ៍ redirect_uri parameter ខាងលើ មាន URL encoding អនុវត្ត (i.e. URL encoding of https://thirdparty.com/redirectUrl)

ប្រសិនបើអ្នកធ្វើការស្នើសុំត្រឹមត្រូវដូចខាងលើ ហើយអតិថិជនបានផ្ទៀងផ្ទាត់និងអនុញ្ញាតដោយជោគជ័យ អតិថិជននឹងត្រូវបានបង្វែរទៅ redirect_uri របស់អ្នកជាមួយនឹងលេខកូដអនុញ្ញាត (ការអនុញ្ញាត) ប៉ារ៉ាម៉ែត្រវិសាលភាពនិងប៉ារ៉ាម៉ែត្ររដ្ឋជម្រើស (ប្រសិនបើបានផ្តល់ជាផ្នែកមួយនៃការស្នើសុំការអនុញ្ញាត) ដូចឧទាហរណ៍ខាងក្រោម៖

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; បន្ថែមScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; ប្លក=ប្រចាំថ្ងៃ; HistoryLength={3P ចុះឈ្មោះប្រវែងប្រវត្តិសាស្ត្រ}; AccountCollection={រាប់ពី authorizedSAs};BR={ThirdPartyID}; dataCustodianId=PGE &state=pge12advertisement

ចំណាំ៖ លេខកូដ Authorization មានរយៈពេលខ្លី (ផុតកំណត់ក្នុងរយៈពេល 600 វិនាទី) ហើយត្រូវប្ដូរជាបន្តបន្ទាប់សម្រាប់គូដែលចូលដំណើរការ token/refresh token ដើម្បីបំពេញការអនុញ្ញាតនិងអនុញ្ញាតឱ្យដំណើរការទិន្នន័យនៅលើ។ សូមមើលវគ្គបន្ទាប់ (ភាគ២) សម្រាប់ព័ត៌មានលម្អិតអំពីពាក្យសុំ Access Token/ Refresh Token ។

(ការអនុញ្ញាត) scope parameter ដែលសរសេរខាងលើត្រូវបានត្រឡប់មកវិញជាផ្នែកមួយនៃការឆ្លើយតបទៅនឹងសំណើនៃ Authorization Code Request, Access Token Request រួមទាំង Authorization API ផងដែរ។ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព នេះ អនុញ្ញាត ឲ្យ ទាក់ ទង នឹង វិសាល ភាព ចុង ក្រោយ នៃ ការ អនុញ្ញាត របស់ អតិថិ ជន ។ ជា ពិសេស ប៉ារ៉ាម៉ែត្រ វិសាល ភាព រួម មាន តម្លៃ "AdditionalScope" ដែល ផ្គូផ្គង ទៅ នឹង PG&E's support customer authorization selections of data groups (ឧ. "Usage", "Billing", "Basic", "Account", "Program Enrollment") ។ តម្លៃ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព ត្រូវ បាន ចាប់ យក បន្ថែម ទៀត ក្នុង ឯកសារ យោង ដូច ខាង ក្រោម៖ ទាញយក មុខងារ គាំទ្រ Block Scope String Mapping Click Thru 2.0 (PDF, 222 KB)។

សាច់រឿងកំហុស

កំហុស អនុវត្ត របស់ ភាគី ទី ៣៖ ប្រសិន បើ ប៉ារ៉ាម៉ែត្រ តម្រូវ ការ នៃ client_id ឬ redirect_uri មាន ភាព មិន ត្រឹមត្រូវ ឬ បាត់ បង់ នៅ ពេល ស្នើ សុំ កូដ អនុញ្ញាត នោះ អតិថិជន នឹង ត្រូវ បាន បង្ហាញ នូវ សារ ដែល អាច ពន្យល់ បាន រួម ជាមួយ នឹង កំហុស ស៊េរី HTTP 400 ស៊េរី ស្តង់ដារ។ ស្រដៀង គ្នា នេះ ដែរ ប្រសិន បើ ប៉ារ៉ាម៉ែត្រ សំណើ ដែល ទាមទារ របស់ response_type បាត់ ឬ មិន ត្រឹមត្រូវ នោះ អតិថិជន នឹង ត្រូវ បាន បង្វែរ ត្រឡប់ ទៅ redirect_uri របស់ អ្នក វិញ ជាមួយ នឹង ប៉ារ៉ាម៉ែត្រ កំហុស "invalid_request" ដែល បាន កំណត់ ថា "invalid_request" ព្រម ទាំង ប៉ារ៉ាម៉ែត្រ រដ្ឋ ជម្រើស ប្រសិន បើ បាន ផ្ដល់ ជា ផ្នែក មួយ នៃ សំណើ កូដ អនុញ្ញាត ដើម ។

អតិថិ ជន ដែល បដិសេធ ក្នុង ការ អនុញ្ញាត : នៅ ពេល ដែល ភាគី ទី បី បង្វែរ អតិថិ ជន ឡើង វិញ ដើម្បី អនុញ្ញាត ជាមួយ PG&E អតិថិ ជន មាន ជម្រើស បដិសេធ តាម រយៈ ប៊ូតុង " លុប ចោល " ទាំង នៅ ក្នុង ទំព័រ និង ទំព័រ អនុញ្ញាត ។ ក្នុង ករណី បែប នេះ អតិថិជន នឹង ត្រូវ បាន បង្វែរ ត្រឡប់ ទៅ redirect_uri របស់ អ្នក វិញ ជាមួយ នឹង ប៉ារ៉ាម៉ែត្រ កំហុស "access_denied" ដែល បាន កំណត់ ថា "access_denied" ដែល បាន បម្រុង ទុក ដើម្បី បង្ហាញ ថា អតិថិជន បាន បដិសេធ ក្នុង ការ អនុញ្ញាត ។ លើស ពី នេះ ទៀត ប៉ារ៉ាម៉ែត្រ រដ្ឋ ជម្រើស នឹង ត្រូវ បាន ត្រលប់ មក វិញ ប្រសិន បើ បាន ផ្តល់ ជា លើក ដំបូង ជា ផ្នែក មួយ នៃ សំណើ កូដ អនុញ្ញាត ដើម ។

Authorizations ផ្តួចផ្តើមគំនិតនៅ PG&E

នៅពេលអតិថិជនចាប់ផ្តើមនៅលើ PG&E's customer web portal, "Your Account" បន្ទាប់មករុករកទៅកាន់ទំព័រចុះចតទិន្នន័យ Share My ពួកគេបានធ្វើបទបង្ហាញពីការធ្លាក់ចុះនៃភាគីទីបីដែលបានចុះឈ្មោះនិងអាចមើលឃើញ។ ដូច ដែល បាន បង្ហាញ នៅ ក្នុង ដ្យាក្រាម ទី ពីរ ខាង លើ នេះ នៅ លើ អតិថិ ជន ដែល ជ្រើស រើស ភាគី ទី បី ពី បញ្ជី ភាគី ទី បី ដែល បាន ចុះ ឈ្មោះ និង ជ្រើស រើស " បន្ទាប់ " អតិថិ ជន នឹង ត្រូវ បាន ប្តូរ ទិស ទៅ កាន់ " ច្រក ទ្វារ ភាគី ទី បី " ដែល នៅ ចំណុច នោះ អតិថិ ជន អាច បន្ត ដំណើរ ការ OAuth ដែល បាន ផ្តួច ផ្តើម ដោយ ភាគី ទី បី ដែល បាន រៀបរាប់ នៅ ក្នុង ផ្នែក មុន ។

ចំណាំ៖ ភាគីទីបីមួយចំនួនបានសាកសួរអំពីរបៀបដើម្បីធ្វើការផ្ទ្រីមបទពិសោធន៍របស់អតិថិជនសម្រាប់ករណីប្រើប្រាស់នេះ (មានន័យថាការអនុញ្ញាតដែលផ្តួចផ្តើមឡើងនៅលើគេហទំព័រ PG&E's) បែបនេះចំពោះអតិថិជនដែលវាមើលទៅពួកគេត្រូវបានគេយកដោយផ្ទាល់ទៅទំព័រអនុញ្ញាតមួយពេលជ្រើសរើសភាគីទីបីពីការធ្លាក់ចុះ។ ដើម្បីសម្រួលដល់បទពិសោធន៍អតិថិជនបែបនេះ ភាគីទីបីអាចជ្រើសរើសដើម្បីកំណត់ "Third Party Portal URI" របស់ខ្លួន (តាមរយៈទំព័រ Share My Data គ្រប់គ្រងការចុះឈ្មោះ) ដើម្បីជាចំណុចបញ្ចប់ដែលបង្វែរអតិថិជនមកវិញដោយស្វ័យប្រវត្តិទៅកាន់ PG&E ដែលជាផ្នែកមួយនៃការស្នើសុំលេខកូដអនុញ្ញាត។ នៅ ពេល បង្វែរ ដោយ ស្វ័យ ប្រវត្តិ ត្រឡប់ ទៅ កាន់ PG&E's authorization Server Authorization Endpoint អតិថិជន នឹង រំលង ទំព័រ ចូល អតិថិជន (ដូច ដែល បាន ចូល រួច ហើយ) ហើយ នឹង ទៅ កាន់ ទំព័រ អនុញ្ញាត ដោយ ផ្ទាល់។ សម្រាប់ ភាគី ទី ៣ ដែល បាន ចុះ ឈ្មោះ មុន ការ ចេញ ផ្សាយ របស់ Share My Data Click Thru 2.0 កាល ពី ចុង ខែ មិថុនា ឆ្នាំ ២០១៨ នេះ អាច សម្រេច បាន ដោយ គ្រាន់ តែ កំណត់ ថា ភាគី ទី ៣ Portal URI ដើម្បី ស្មើ នឹង ការ មិន ប្រើ ប្រាស់ "Third Party Scope Selection Screen" URI (field to be retired in a future release) ។

ផ្ទុយ ទៅ វិញ ភាគី ទី បី មួយ ចំនួន ប្រហែល ជា ចង់ ចូល រួម ជា លើក ដំបូង និង អេក្រង់ អតិថិជន នៅ ខាង ពួក គេ នៅ ពេល ដែល អតិថិជន ត្រូវ បាន បង្វែរ ទិស ទៅ កាន់ "ច្រក ទ្វារ ភាគី ទី បី" របស់ ពួក គេ មុន ពេល ស្នើ សុំ កូដ អនុញ្ញាត ដូច្នេះ វិធី សាស្ត្រ ខាង លើ នេះ គ្រាន់ តែ ជា ការ ផ្តល់ យោបល់ ប៉ុណ្ណោះ ។

ដើម្បី ទទួល បាន Access Token សូម ប្រើ Code Authorization ដែល បាន ទទួល និង ហៅ ចំណុច បញ្ចប់ ខាង ក្រោម នេះ ជាមួយ ប៉ារ៉ាម៉ែត្រ ស្នើសុំ ដូច ដែល បាន រៀបរាប់ ខាង ក្រោម នេះ ។ ដូចដែលបានរៀបរាប់ខាងលើ លេខកូដ Authorization នេះគឺមិនយូរប៉ុន្មានទេ គឺផុតកំណត់បន្ទាប់ពីរយៈពេល ១០ នាទី (៦០០វិនាទី) ដូច្នេះសូមធានាថា Access Token ត្រូវបានស្នើសុំភ្លាមៗលើវិក្កយបត្រនៃ Code ការអនុញ្ញាត។

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

• Mandatory Request Parameters:
  • grant_type = authorization_code (តម្លៃថេរ)
  • កូដ = កូដ អនុញ្ញាត ដែល បាន ទទួល ក្នុង ការ ឆ្លើយ តប ទៅ នឹង សំណើ កូដ អនុញ្ញាត
  • redirect_uri = redirect URL ដែល អ្នក បាន បញ្ជាក់ ក្នុង ការ ចុះ ឈ្មោះ ទិន្នន័យ Share My របស់ អ្នក (URLs ត្រូវ តែ ផ្គូផ្គង)។
    ចំណាំ៖ ដូចទៅនឹងការស្នើសុំកូដអនុញ្ញាត យើងសូមណែនាំ URL encoding redirect_uri។

ទំព័រគំរូ:ពាក្យសុំ
Access Token POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Add basic Authorization header parameter with Base64 encoding applied "clientID:clientSecret"

ចំណាំ: តម្លៃ clientId:clientSecret សមស្របទៅនឹងតម្លៃ clientID ដែលបានផ្តល់នៅក្នុង Share My Data registration milestones របស់អ្នក។
ប៉ារ៉ាម៉ែត្រ ក្បាល នឹង ស្ថិត ក្នុង ទ្រង់ទ្រាយ ដូច ខាង ក្រោម ៖
ឈ្មោះប៉ារ៉ាម : ការអនុញ្ញាត
តម្លៃប៉ារ៉ាម : Basic "base64encoded string"

ការ ឆ្លើយ តប ដ៏ ជោគជ័យ នឹង មាន រូបរាង ដូច នេះ ៖

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; បន្ថែមScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; ប្លក=ប្រចាំថ្ងៃ; HistoryLength={3P ចុះឈ្មោះប្រវែងប្រវត្តិសាស្ត្រ}; AccountCollection={រាប់ចំនួន SAs};BR={ThirdPartyID}; dataCustodianId=PGE
resourceURI:{ResourceURI} ឧ.: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{ការជាវid}
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

ចំណាំ៖ ការ Access Token ផុត កំណត់ ក្នុង 3600 secs (1 ម៉ោង) ខណៈ ដែល Refresh Token ឆ្លើយឆ្លង គ្នា ផុត កំណត់ ក្នុង រយៈ ពេល ១ ឆ្នាំ។ សូមមើលវគ្គបន្ទាប់ 3 សម្រាប់ព័ត៌មានលម្អិតអំពីការទទួលបាន Access Token/Refresh Token មួយគូថ្មី។

រក្សា ទុក ការ ចូល ដំណើរ ការ និង គូ ថូខឹន ស្រស់ ។
ដើម្បី ស្នើ ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ដំបូង និង ទិន្នន័យ ប្រចាំ ថ្ងៃ ដែល កំពុង បន្ត សូម ចូល មើល ការ ចូល ដំណើរ ការ ទិន្នន័យ ។

ក្នុងនាមជាការអនុវត្តដ៏ល្អបំផុត Access Token គឺជាថូខឹនដែលមានជីវិតខ្លី (1 ម៉ោង) ខណៈពេលដែល Refresh Token ឆ្លើយឆ្លងគ្នាគឺជាថូខឹនដែលមានប្រវែងវែង (1 ឆ្នាំ) ដែលអ្នកអាចប្រើដើម្បីទទួលយកគូ Access Token/Refresh Token ថ្មីមួយនៅពេល Access Token ផុតកំណត់។ ដើម្បីទទួលបាន Access Token និង Refresh Token គូថ្មីសម្រាប់ការអនុញ្ញាតដែលមិនមានផុតកំណត់ អាចប្រើ "Refresh Token បច្ចុប្បន្ន" និងហៅចំណុចបញ្ចប់ខាងក្រោមជាមួយនឹង parameters ដូចបានរៀបរាប់ខាងក្រោម។

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

ទំព័រគំរូ:សំណើរបស់
Token បង់រំលស់ POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Add basic Authorization header parameter with Base64 encoding applied "clientID:clientSecret"

ចំណាំ: តម្លៃ clientId:clientSecret សមស្របទៅនឹងតម្លៃ clientID ដែលបានផ្តល់នៅក្នុង Share My Data registration milestones របស់អ្នក។
ប៉ារ៉ាម៉ែត្រ ក្បាល នឹង ស្ថិត ក្នុង ទ្រង់ទ្រាយ ដូច ខាង ក្រោម ៖
ឈ្មោះប៉ារ៉ាម : ការអនុញ្ញាត
តម្លៃប៉ារ៉ាម : Basic "base64encoded string"

ការ ឆ្លើយ តប ដ៏ ជោគជ័យ នឹង មាន រូបរាង ដូច នេះ ៖
{
"access_token" : "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
«token_type»៖ «ខ្លាឃ្មុំ»,
"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; បន្ថែមScope=Usage_Billing_Basic_Account_
ProgramEnrollment; IntervalDuration=900_3600; ប្លក=ប្រចាំថ្ងៃ; HistoryLength={3P ចុះឈ្មោះប្រវែងប្រវត្តិសាស្ត្រ}; AccountCollection={រាប់ចំនួន 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"
}

ចំណាំ៖ ស្រដៀង គ្នា នេះ ដែរ Client Access Token គឺ ជា ថូខឹន ដែល មាន អាយុ ខ្លី (១ ម៉ោង) ខណៈ ដែល Refresh Token របស់ វា ត្រូវ គ្នា នោះ គឺ ជា ថូខឹន ដែល មាន អាយុ វែង (១ ឆ្នាំ) ដែល អ្នក អាច ប្រើ ដើម្បី ទទួល បាន នូវ Client Access Token/Refresh Token គូ ថ្មី នៅ ពេល ដែល Client Access Token ផុត កំណត់។ ដើម្បីទទួលបាន Client Access Token/Refresh Token គូថ្មី សូមយោងជំហានដូចគ្នាដែលបានរៀបរាប់ខាងលើ។

អតិថិជន នឹង អាច ធ្វើ បច្ចុប្បន្នភាព ការ អនុញ្ញាត របស់ ខ្លួន ដោយ ធ្វើ ដូច ខាង ក្រោម៖

• ការ ដក ចេញ នូវ សេវា IDs ពី ការ អនុញ្ញាត របស់ ពួក គេ
• ការ ពន្យារ កាល បរិច្ឆេទ បញ្ចប់ នៃ រយៈ ពេល អនុញ្ញាត
• ការ លុប ចោល ការ អនុញ្ញាត

ចំណាំ៖ អតិថិជននឹងគ្រាន់តែអាចធ្វើការផ្លាស់ប្តូរលើការអនុញ្ញាតរបស់ពួកគេដោយចូលគណនី PG&E តាមប្រព័ន្ធអ៊ីនធឺណិតរបស់ពួកគេនិងធ្វើតាមជំហានដែលត្រូវការ។ ប្រសិនបើមានសកម្មភាពណាមួយក្នុងសកម្មភាពទាំងនេះ យើងនឹងជូនដំណឹងដល់អ្នកតាមរយៈ Notification URI ដែលលោកអ្នកបានផ្តល់ក្នុងពេលចុះឈ្មោះ។

មានជម្រើសសម្រាប់គ្រប់គ្រងនិងមើលព័ត៌មានលំអិតនៃការអនុញ្ញាតរបស់អតិថិជនរបស់អ្នក:

• អ្នកអាចហៅការអនុញ្ញាត API (http GET operation) ដោយប្រើ client_access_token របស់អ្នកនៅកម្រិតភាគីទីបី (សម្រាប់ព័ត៌មានលម្អិតលើការអនុញ្ញាតទាំងអស់) https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization or at the individual customer authorization level at https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• ដោយ ឡែក អ្នក ក៏ អាច មើល ព័ត៌មាន លម្អិត នៃ ការ អនុញ្ញាត ផ្ទាល់ ខ្លួន ដោយ ដៃ ដោយ ចូល ទៅ ក្នុង គណនី ទិន្នន័យ Share My របស់ អ្នក តាម រយៈ ច្រក ទ្វារ ភាគី ទី បី និង ចូល ទៅ ក្នុង លេខ សម្គាល់ ការ ជាវ សម្រាប់ ការ អនុញ្ញាត ដែល អ្នក កំពុង ស្វែង រក ។

ប្រសិនបើអ្នកលែងចង់ចូលទៅកាន់ទិន្នន័យដែលទាក់ទងនឹងការអនុញ្ញាតនោះ វាមានវិធីសាស្រ្តជាជម្រើសដើម្បីលុបចោលការអនុញ្ញាត:

• អ្នក អាច ហៅ ការ អនុញ្ញាត នេះ ថា ជា ការ ដក ហូត API (http DELETE operation) ដោយ ប្រើ client_access_token របស់ អ្នក នៅ https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}។
• ផ្ទុយ ទៅ វិញ អ្នក អាច លុប ចោល ដោយ ដៃ នូវ ការ អនុញ្ញាត ដោយ ចូល ទៅ ក្នុង គណនី ទិន្នន័យ របស់ អ្នក Share My តាម រយៈ ច្រក ទ្វារ ភាគី ទី បី និង ចូល ទៅ ក្នុង លេខ សម្គាល់ ការ ជាវ សម្រាប់ ការ អនុញ្ញាត ដែល អ្នក ចង់ លុប ចោល ។

ចំណាំ៖ អតិថិជននឹងត្រូវបានជូនដំណឹងថាអ្នកបានជ្រើសរើសដើម្បីលុបចោលការអនុញ្ញាតរបស់ពួកគេ។ លើស ពី នេះ ទៀត នៅ ពេល ដែល ការ អនុញ្ញាត ត្រូវ បាន លុប ចោល សកម្ម ភាព មិន អាច កែ ប្រែ បាន ទេ ។

• PG&E នឹងផ្ញើសេចក្តីជូនដំណឹងជូន URI របស់លោកអ្នក ក្នុងអំឡុងពេលចុះឈ្មោះ។ ការ ជូន ដំណឹង រួម មាន URIs ដែល ត្រូវ គ្នា ទៅ នឹង ទិន្នន័យ ដែល បាន បង់ ថ្លៃ រួច រាល់ រួច ទៅ ហើយ សម្រាប់ អ្នក ដើម្បី ត្រឡប់ មក វិញ និង ស្នើ សុំ នៅ URLs ដែល បាន ផ្តល់ ឲ្យ ។ ទិន្នន័យ ត្រូវ បាន កំណត់ ជា មុន និង ការ ជូន ដំណឹង ដែល បាន ផ្ញើ ចេញ នៅ ក្នុង ស្ថាន ភាព ពីរ ដូច ខាង ក្រោម នេះ : ( 1 ) អ្នក បាន ជ្រើស រើស " ជូន ដំណឹង ដល់ ខ្ញុំ ថា ជា ទិន្នន័យ រួច រាល់ ហើយ " នៅ ក្នុង ទម្រង់ ចុះ ឈ្មោះ របស់ អ្នក ក្នុង ករណី ដែល យើង នឹង កញ្ចប់ ទិន្នន័យ ប្រចាំ ថ្ងៃ ចុង ក្រោយ បំផុត ជាមួយ នឹង ការ កែ តម្រូវ សម្រាប់ កាល បរិច្ឆេទ កន្លង មក ឬ ( 2 ) អ្នក បាន ធ្វើ សំណើ ដ៏ គួរ ឲ្យ ភ្ញាក់ ផ្អើល ពី មុន ដែល ទិន្នន័យ ដែល បាន ស្នើ សុំ ឥឡូវ នេះ ត្រៀម រួច រាល់ ។
• សាច់រឿងទី១ បង្ហាញពីក្រោម "DATA ACCESS: DAILY SUBSCRIPTION" ផ្នែកនៃ Data Access Methods diagrams ខាងក្រោម និង Scenario 2 ត្រូវបានបង្ហាញក្រោម "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" ផ្នែកនៃឌីយ៉ាក្រាមដូចគ្នាខាងក្រោម។

សូមមេត្តាចងចាំដល់ជីវិតដែលធ្វើអំពី Access Tokens, Client Access Token, និង Refresh Tokens ដែលឆ្លើយឆ្លងគ្នារបស់ពួកគេដែលបានប្រើប្រាស់ក្នុងការស្នើសុំទិន្នន័យ។ ក្នុងនាមជាការអនុវត្តដ៏ល្អបំផុត Access Token គឺជាថូខឹនដែលមានជីវិតខ្លី (1 ម៉ោង) ខណៈពេលដែលថូសស្រស់គឺជាថូខឹនដែលមានជីវិតយូរ (1 ឆ្នាំ) ដែលអ្នកអាចប្រើដើម្បីទទួលយកគូ Access Token/Refresh Token ថ្មីមួយនៅពេល Access Token ផុតកំណត់។ ស្រដៀង គ្នា នេះ ដែរ Client Access Token គឺ ជា ថូខឹន ដែល មាន អាយុ ខ្លី (១ ម៉ោង) ខណៈ ដែល Refresh Token របស់ វា មាន អាយុ វែង (១ ឆ្នាំ) ដែល អ្នក អាច ប្រើ ដើម្បី ទទួល បាន នូវ គូ ថ្មី Client Access Token/Refresh Token ពេល Client Access Token ផុត កំណត់។ សម្រាប់ ព័ត៌មាន លម្អិត បន្ថែម អំពី ការ ទទួល បាន គូ ថូខេន ថ្មី សំដៅ ទៅ លើ ជំហាន ទី 3 ដោយ ស្នើ សុំ ការ ចូល ដំណើរ ការ ថ្មី នៅ ក្នុង ផ្ទាំង ព័ត៌មាន លម្អិត នៃ ការ អនុញ្ញាត របស់ យើង ។ ទៅ រក ព័ត៌មាន លម្អិត នៃ ការ អនុញ្ញាត

ប្រសិនបើអ្នកត្រូវបានអនុញ្ញាតឱ្យដោយអតិថិជនដើម្បីទទួលបាន "ព័ត៌មានគណនេយ្យ" (Account IDs, Service Agreement IDs and service start dates) និង/ឬ "Basic Information" (i.e., customer name and service address), អ្នកអាចស្នើសុំព័ត៌មានអតិថិជនបែបនេះតាមរយៈ ESPI បាន កំណត់ RetailCustomer APIs ដែលទិន្នន័យសមស្របទៅនឹង schema, retailCustomer.xsd, provided above.

Synchronous (ភាគីទីបី Standard and EEF)

វិធីសាស្ត្រ មួយ ដើម្បី ស្នើសុំ ទិន្នន័យ អតិថិជន គឺ ត្រូវ ប្រើ API យោគៈ សម្រាប់ ស្នើ សុំ ព័ត៌មាន អតិថិជន តែ មួយ សម្រាប់ ការ អនុញ្ញាត ពី អតិថិជន (i.e., Retail Customer) ៖

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

RetailCustomerID = RetailCustomerID ដែល អ្នក បាន ទទួល នៅ ចុង បញ្ចប់ នៃ លំដាប់ នៃ ការ អនុញ្ញាត របស់ OAuth ដើម្បី ទទួល បាន ការ ចូល ដំណើរ ការ ថូខឹន ។ RetailCustomerID គឺ ជា ផ្នែក មួយ នៃ ប៉ារ៉ាម៉ែត្រ ផ្លូវ អតិថិ ជនResourceUri នៅ ក្នុង ការ ឆ្លើយ តប របស់ token ។ (RetailCustomerID=SubscriptionID)

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

Response = អ្នក នឹង ទទួល បាន ទិន្នន័យ ត្រឡប់ មក វិញ ដោយ ចៃដន្យ សម្រាប់ RetailCustomerID នោះ ។ ទិន្នន័យ អនុលោម តាម ការ លក់ រាយCustomer.xsd

ចំណាំ៖ អតិថិជនលក់រាយ API យោគៈ គឺស្ថិតនៅកម្រិតអតិថិជនលក់រាយឯកជន ដែលស្របទៅនឹងការអនុញ្ញាតរបស់អតិថិជនតែមួយ។

សម្រាប់យោង៖ diagram ឋានានុក្រមខាងក្រោមបង្ហាញឋានានុក្រមទំនាក់ទំនងសម្រាប់ធាតុទិន្នន័យ ESPI នៅក្នុងគំរូទិន្នន័យអតិថិជន PG&E ។

អ្នកក៏អាចស្នើសុំទិន្នន័យអតិថិជនតាមរយៈ API ដែលសុំព័ត៌មានអតិថិជនសម្រាប់ការអនុញ្ញាតរបស់អតិថិជនទាំងអស់សម្រាប់ទិន្នន័យអតិថិជន (i.e. Retail Customers)។

ដើម្បីគាំទ្រសំណើរ Asynchronous កម្មវិធីរបស់អ្នកនឹងត្រូវការគាំទ្រ Post Notifications យើងនឹងផ្ញើជូនលោកអ្នក (ដូចក្នុង Notification URL ដែលបានផ្តល់ក្នុងអំឡុងពេលចុះឈ្មោះ) ។

ឧទាហរណ៍ Asynchronous Request URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID បានផ្តល់ជូននៅក្នុង ApplicationInformation Resource retrieved during registration test. (BulkID=ClientID)

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

Response = HTTP status code 202 (នេះ ជា ការ ស្នើ សុំ ដែល ឆ្លើយ តប នឹង ត្រូវ បាន បង្ហោះ ទៅ កាន់ NOTIFICATION URL នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់)។ នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់ យើង នឹង POST នូវ ការ ជូន ដំណឹង ទៅ កាន់ ការ ជូន ដំណឹង ដែល បាន ផ្តល់ ឲ្យ របស់ អ្នក URI ជាមួយ នឹង ការ ផ្ទុក URLs ដែល កម្មវិធី របស់ អ្នក អាច ត្រឡប់ មក វិញ ដើម្បី ទទួល បាន កញ្ចប់ មុន ។ សេចក្តីជូនដំណឹង ប្រៃសណីយ៍ គំរូ មើល ទៅ ដូច ខាង ក្រោម

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

អនុវត្ត GET នៅ លើ URL ខាង លើ ជាមួយ Client Access token ដើម្បី ទទួល បាន ទិន្នន័យ ។

សម្រាប់យោង៖ diagram ឋានានុក្រមខាងក្រោមបង្ហាញឋានានុក្រមទំនាក់ទំនងសម្រាប់ធាតុទិន្នន័យ ESPI នៅក្នុងគំរូទិន្នន័យអតិថិជន PG&E ។

ចុង ក្រោយ អ្នក អាច ទទួល បាន ព័ត៌មាន អតិថិ ជន ចុង ក្រោយ បំផុត ជា រៀង រាល់ ថ្ងៃ ដោយ ប្រើ គំរូ ជាវ ប្រចាំ ថ្ងៃ ( មាន ប្រភព ដោយ ជ្រើស រើស " ជូន ដំណឹង ខ្ញុំ ជា ទិន្នន័យ រួច រាល់ ( ប្រចាំ ថ្ងៃ ) " ប្រអប់ ត្រួត ពិនិត្យ ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ ) ។

ដើម្បីគាំទ្រម៉ូដែលជាវប្រចាំថ្ងៃ កម្មវិធីរបស់អ្នកនឹងត្រូវការការគាំទ្រ Post Notifications យើងនឹងផ្ញើជូនលោកអ្នក (ដូចក្នុង Notification URL ដែលអ្នកបានផ្តល់ក្នុងអំឡុងពេលចុះឈ្មោះ) ។

នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់ យើង នឹង POST នូវ ការ ជូន ដំណឹង ទៅ កាន់ ការ ជូន ដំណឹង ដែល បាន ផ្តល់ ឲ្យ របស់ អ្នក URI ជាមួយ នឹង ការ ផ្ទុក URLs ដែល កម្មវិធី របស់ អ្នក អាច ត្រឡប់ មក វិញ ដើម្បី ទទួល បាន កញ្ចប់ មុន ។ សេចក្តីជូនដំណឹង ប្រៃសណីយ៍គំរូ មានលក្ខណៈដូចរូបខាងក្រោម៖

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

អនុវត្ត GET នៅ លើ URL ខាង លើ ជាមួយ Client Access token ដើម្បី ទទួល បាន ទិន្នន័យ ។

សម្រាប់យោង diagram ឋានានុក្រមខាងក្រោមបង្ហាញឋានានុក្រមទំនាក់ទំនងសម្រាប់ធាតុទិន្នន័យ ESPI នៅក្នុងគំរូទិន្នន័យអតិថិជន PG&E ។

ប្រសិនបើអ្នកត្រូវបានអនុញ្ញាតឱ្យដោយអតិថិជនដើម្បីទទួលបាន "ព័ត៌មានប្រើប្រាស់" និង/ឬ "ព័ត៌មាន Billing" អ្នកអាចស្នើសុំទិន្នន័យនេះតាមរយៈការជាវ APIs ដែលទិន្នន័យសមស្របទៅនឹង schema, espiDerived.xsd, ដែលបានផ្តល់ខាងលើ។

សំណើសុំ Ad Hoc របស់ក្រុមហ៊ុន Synchronous (ស្តង់និង EEF 3 ភាគីទីបី)

ដើម្បី ស្នើ ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ( សម្រាប់ ទិន្នន័យ ការ ប្រើប្រាស់ ចន្លោះ ពេល និង ទិន្នន័យ សេចក្តី ព្រាង ច្បាប់ ) វិធី សាស្ត្រ មួយ គឺ ប្រើ APIs ដែល មាន យោគៈ ជាមួយ នឹង ការ បញ្ចូល ប៉ារ៉ាម៉ែត្រ កាលបរិច្ឆេទ ចាប់ផ្ដើម ត្រឹមត្រូវ និង បញ្ចប់ នៅ ក្នុង ម៉ោង Zulu ។

ឧទាហរណ៍ Synchronous Request URL:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max={endDate}

បានផ្សាយ-min = កាលបរិច្ឆេទ ចាប់ផ្ដើម ដែល នឹង ត្រូវ អនុវត្ត ចំពោះ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ កាលបរិច្ឆេទគឺនៅក្នុង Zulu time នៃ yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 format)

បាន បោះពុម្ព ផ្សាយ-max = កាលបរិច្ឆេទ បញ្ចប់ ដែល នឹង ត្រូវ អនុវត្ត ទៅ លើ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ កាលបរិច្ឆេទគឺនៅក្នុង Zulu time នៃ yyyy-MM-ddTHH:mm:ssZ (IETC RFC 3339 format)

ចំណាំ៖ ចំពោះសំណើរបស់ API ដែលទទួលយកប៉ារ៉ាម៉ែត្រដែលបានបោះពុម្ពផ្សាយ និងចេញផ្សាយ-min-date parameters លំនាំដើមគឺ T-1 (កាលបរិច្ឆេទនៃការស្នើសុំ ដក 1 ថ្ងៃ)។ ចំពោះការស្នើសុំសង្ខេបការប្រើប្រាស់ (ឧ.ឧ., .../espi/1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary) យើងខ្ញុំសូមស្នើឱ្យផ្តល់ជាជួរ 30 ថ្ងៃ ឬច្រើនជាងនេះដើម្បីធានាបាននូវអត្រាការប្រាក់ដែលអាចរកបានជាមួយរយៈពេលនោះ បើមិនដូច្នោះទេគ្មានទិន្នន័យនឹងត្រូវបានត្រឡប់មកវិញទេ។

Subscription ID = SubscriptionID ដែល អ្នក បាន ទទួល នៅ ចុង បញ្ចប់ នៃ លំដាប់ នៃ ការ អនុញ្ញាត របស់ OAuth ដើម្បី ទទួល បាន ការ ចូល ដំណើរ ការ ទៅ កាន់ ថូខឹន ។ ID ជាវ គឺ ជា ផ្នែក មួយ នៃ ប៉ារ៉ាម៉ែត្រ resourceURI នៅ ក្នុង ការ ឆ្លើយ តប របស់ token ។ (SubscriptionID=RetailCustomerID)

UsagePointID = ការប្រើប្រាស់Point នៅក្រោមលេខសម្គាល់ជាវខាងលើ។ អ្នកអាចទទួលបានចំណុចប្រើប្រាស់ទាំងអស់សម្រាប់ Subscription ដែលបានផ្ដល់ដោយហៅខាងក្រោម API URL និងផ្គត់ផ្គង់ការចូលដំណើរការដើម្បីជាវនោះនៅក្នុងក្បាលការអនុញ្ញាត: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

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

ចម្លើយ = អ្នក នឹង ទទួល បាន ទិន្នន័យ ត្រឡប់ មក វិញ ដោយ ចៃដន្យ សម្រាប់ ចំណុច ប្រើ នោះ សម្រាប់ រយៈ ពេល ដែល បាន ស្នើ ។ វា នឹង មាន ទាំង ទិន្នន័យ ការ ប្រើប្រាស់ ចន្លោះ ពេល () និង ទិន្នន័យ សេចក្តី ព្រាង ច្បាប់ () ។

ការប្រើ Synchronous usage APIs (ដូចដែលបានបញ្ជាក់ដោយ URL construction ដែលបញ្ចប់ដោយ Usage Point ID) គឺស្ថិតនៅកម្រិតនៃការប្រើប្រាស់ (i.e., Service Agreement level) ដូច្នេះកម្មវិធីមួយនឹងកាត់តសំណើតាមរយៈ Use Point IDs នីមួយៗដែលជាកម្មសិទ្ធិរបស់អតិថិជនដែលបានផ្ដល់អោយ (i.e., subscription) ។

ការ ឆ្លើយ តប ទៅ នឹង សំណើ សំយោគ ត្រឡប់ មក វិញ ទាំង ទិន្នន័យ ចន្លោះ ពេល ( ក្រោម ) ដែល ទាក់ ទង ទៅ នឹង ជួរ កាល បរិច្ឆេទ ដែល បាន ស្នើ ព្រម ទាំង ចំនួន សរុប នៃ ការ ប្រើប្រាស់ ប្រចាំ ខែ និង ថ្លៃ ថវិកា ដែល បាន លើស ពី ជួរ កាល បរិច្ឆេទ ដែល បាន ស្នើ ឡើង ( ក្រោម ) ។

• IntervalReading មាន interval (15-min/hourly) អគ្គិសនីប្រើប្រាស់និងចន្លោះ (ប្រចាំថ្ងៃ) ទិន្នន័យប្រើប្រាស់ឧស្ម័ន
• សង្ខេបការប្រើប្រាស់មានសរុបការប្រើប្រាស់ប្រចាំខែ និងសេចក្តីលម្អិតនៃសេចក្តីព្រាងច្បាប់ (ប្រសិនបើមានការអនុញ្ញាត)

នៅ ក្នុង ការ ឆ្លើយ តប អ្នក នឹង រក ឃើញ ធាតុ ទិន្នន័យ ដែល ត្រូវ គ្នា ទៅ នឹង តារាង ផែនទី ធាតុ ទិន្នន័យ ESPI របស់ យើង

សម្រាប់យោង diagram ឋានានុក្រមខាងក្រោមបង្ហាញឋានានុក្រមទំនាក់ទំនងសម្រាប់ធាតុទិន្នន័យ ESPI នៅក្នុងគំរូទិន្នន័យអតិថិជន PG&E ។

ខាងក្រោម នេះ ជា ការ បញ្ជាក់ គន្លឹះ មួយ ចំនួន លើ ធាតុ ទិន្នន័យ ទាំងនេះ ៖

• អាំងប៉ាវ ១ថ្ងៃ
• IntervalReading (ក្រោម Interval Block) មាន តម្លៃ ប្រើប្រាស់ អគ្គិសនី ជាក់ ស្តែង 15-min/hourly និង តម្លៃ ប្រើប្រាស់ ឧស្ម័ន ប្រចាំ ថ្ងៃ
• សម្រាប់អតិថិជនអគ្គិសនីដែលមានជំនាន់នៅលើគេហទំព័រ (ឧ. សូរ្យ) ធាតុលំហូរ បង្ហាញពីទិន្នន័យប្រើប្រាស់ (supply) និងទទួលបាន (ជំនាន់) ។ សម្រាប់អតិថិជនដែលមានម៉ែត្រកំណត់រចនាសម្ព័ន្ធត្រឹមតែអានការប្រើប្រាស់សំណាញ់ (មានន័យថាគ្មានជំនាន់ណាមួយនៅលើ-site) ធាតុ flowDirection ចង្អុលបង្ហាញថាការប្រើប្រាស់គឺជាចំនួនសំណាញ់ (difference of delivered minus received):
  • ទិសលំហូរ 1 = បានផ្តល់ជូន (ថាមពលផ្គត់ផ្គង់ដល់អតិថិជន)
  • ទិសលំហូរនៃ 19 = ទទួលបាន (net generation flowing back to PG&E grid) ។ (ចំណាំ, តម្លៃគឺដាច់ខាត)
  • ទិសលំហូរនៃ 4 = សំណាញ់ (delivered minus – ទទួលបាន)
• យកចិត្តទុកដាក់ជាពិសេសទៅលើ Power of ten multiplier និង Unit of Measure (uom) ដើម្បីឱ្យប្រាកដថាការអានការប្រើប្រាស់ត្រឹមត្រូវ

Batch Subscription (ស្តង់និង EEF 3 ភាគីទី៣)

អ្នកក៏អាចស្នើសុំទិន្នន័យប្រើប្រាស់តាមរយៈ API ដែលអ្នកប្រើជាយនីតសម្រាប់គ្រប់ចំនុចប្រើប្រាស់ទាំងអស់ដែលជាកម្មសិទ្ធិរបស់អតិថិជនតែមួយសម្រាប់ការប្រើប្រាស់/ទិន្នន័យប្រាក់បញ្ញើ (i.e. Subscription)។

ដើម្បីគាំទ្រសំណើរ Ad Hoc Asynchronous (មានន័យថាសម្រាប់ច្រើនជាងចំណុចប្រើប្រាស់តែមួយក្នុងពេលតែមួយ) កម្មវិធីរបស់អ្នកនឹងត្រូវការការគាំទ្រ Post Notifications ដែលយើងនឹងផ្ញើជូនលោកអ្នក (ដូចក្នុង Notification URL ដែលអ្នកបានផ្តល់ក្នុងពេលចុះឈ្មោះ)

ឧទាហរណ៍ Asynchronous Request URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

Subscription ID = SubscriptionID ដែល អ្នក បាន ទទួល នៅ ចុង បញ្ចប់ នៃ លំដាប់ OAuth ដើម្បី ទទួល បាន ការ ចូល ដំណើរ ការ ថូខឹន ។ ID ជាវ គឺ ជា ផ្នែក មួយ នៃ ប៉ារ៉ាម៉ែត្រ resourceURI ក្នុង ការ ឆ្លើយ តប របស់ token

បានផ្សាយ-min = កាលបរិច្ឆេទ ចាប់ផ្ដើម ដែល នឹង ត្រូវ អនុវត្ត ចំពោះ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

បាន បោះពុម្ព ផ្សាយ-max = កាលបរិច្ឆេទ បញ្ចប់ ដែល នឹង ត្រូវ អនុវត្ត ទៅ លើ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

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

Response = HTTP status code 202 (នេះ ជា សំណើ សុំ យោគយល់ ដែល ចម្លើយ នឹង ត្រូវ បាន បង្ហោះ ទៅ កាន់ សេចក្ដី ជូន ដំណឹង URL នៅ ពេល ទិន្នន័យ ត្រៀម រួច រាល់)

នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់ យើង នឹង POST នូវ ការ ជូន ដំណឹង ទៅ កាន់ ការ ជូន ដំណឹង ដែល បាន ផ្តល់ ឲ្យ របស់ អ្នក URI ជាមួយ នឹង ការ ផ្ទុក URLs ដែល កម្មវិធី របស់ អ្នក អាច ត្រឡប់ មក វិញ ដើម្បី ទទួល បាន កញ្ចប់ មុន ។ សេចក្តីជូនដំណឹង ប្រៃសណីយ៍គំរូ មានលក្ខណៈដូចរូបខាងក្រោម៖

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

អនុវត្ត GET នៅ លើ URL ខាង លើ ជាមួយ Access token ដើម្បី ទទួល បាន ទិន្នន័យ ។ នេះ នឹង មាន ទាំង ទិន្នន័យ ប្រើប្រាស់ ចន្លោះ ពេល () ព្រម ទាំង ព័ត៌មាន Bill () សម្រាប់ រយៈ ពេល ដែល បាន ស្នើ។

Batch Subscription (ស្តង់និង EEF 3 ភាគីទី៣)
អ្នកក៏អាចស្នើសុំការប្រើប្រាស់និងការចេញវិក្កយបត្រព័ត៌មានតាមរយៈភាគ bulch asynchronous API សម្រាប់ការអនុញ្ញាតរបស់អតិថិជនទាំងអស់របស់អ្នកសម្រាប់ការប្រើប្រាស់/អត្រាការប្រាក់ទិន្នន័យ (i.e. Subscriptions)។

ឧទាហរណ៍ Batch Bulk ស្នើ URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate}

BulkID = BulkID បានផ្តល់ជូននៅក្នុង ApplicationInformation Resource retrieved during registration test. (BulkID=ClientID)

បានផ្សាយ-min = កាលបរិច្ឆេទ ចាប់ផ្ដើម ដែល នឹង ត្រូវ អនុវត្ត ចំពោះ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

បាន បោះពុម្ព ផ្សាយ-max = កាលបរិច្ឆេទ បញ្ចប់ ដែល នឹង ត្រូវ អនុវត្ត ទៅ លើ សំណើ នេះ សម្រាប់ ទាញ ទិន្នន័យ ។ (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Authorization:Bearer {client access token}

Response = HTTP status code 202 (នេះ ជា សំណើ សុំ យោគយល់ ដែល ចម្លើយ នឹង ត្រូវ បាន បង្ហោះ ទៅ កាន់ សេចក្ដី ជូន ដំណឹង URL នៅ ពេល ទិន្នន័យ ត្រៀម រួច រាល់)

នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់ យើង នឹង POST នូវ ការ ជូន ដំណឹង ទៅ កាន់ ការ ជូន ដំណឹង ដែល បាន ផ្តល់ ឲ្យ របស់ អ្នក URI ជាមួយ នឹង ការ ផ្ទុក URLs ដែល កម្មវិធី របស់ អ្នក អាច ត្រឡប់ មក វិញ ដើម្បី ទទួល បាន កញ្ចប់ មុន ។ សេចក្តីជូនដំណឹង ប្រៃសណីយ៍គំរូ មានលក្ខណៈដូចរូបខាងក្រោម៖

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

អនុវត្ត GET នៅ លើ URL ខាង លើ ជាមួយ Access token ដើម្បី ទទួល បាន ទិន្នន័យ ។ នេះ នឹង មាន ទាំង ទិន្នន័យ ប្រើប្រាស់ ចន្លោះ ពេល () ព្រម ទាំង ព័ត៌មាន Bill () សម្រាប់ រយៈ ពេល ដែល បាន ស្នើ។

ចុង ក្រោយ អ្នក អាច ទទួល បាន ព័ត៌មាន ប្រើប្រាស់ ចុង ក្រោយ បំផុត និង ការ បង់ ថ្លៃ រួម ទាំង ការ កែ តម្រូវ សម្រាប់ កាល បរិច្ឆេទ កន្លង មក នៅ ក្នុង រយៈ ពេល អនុញ្ញាត របស់ អតិថិ ជន ជា រៀង រាល់ ថ្ងៃ ដោយ ប្រើ គំរូ ជាវ ប្រចាំ ថ្ងៃ ( មាន ឧទាហរណ៍ ដោយ ជ្រើស រើស " ជូន ដំណឹង ខ្ញុំ ថា ជា ទិន្នន័យ រួច រាល់ ( ប្រចាំ ថ្ងៃ ) " ប្រអប់ ត្រួត ពិនិត្យ ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ ) ។

ដើម្បីគាំទ្រម៉ូដែលជាវប្រចាំថ្ងៃ កម្មវិធីរបស់អ្នកនឹងត្រូវការការគាំទ្រ Post Notifications យើងនឹងផ្ញើជូនលោកអ្នក (ដូចក្នុង Notification URL ដែលអ្នកបានផ្តល់ក្នុងអំឡុងពេលចុះឈ្មោះ) ។

នៅ ពេល ដែល ទិន្នន័យ បាន ត្រៀម រួច រាល់ យើង នឹង POST នូវ ការ ជូន ដំណឹង ទៅ កាន់ ការ ជូន ដំណឹង ដែល បាន ផ្តល់ ឲ្យ របស់ អ្នក URI ជាមួយ នឹង ការ ផ្ទុក URLs ដែល កម្មវិធី របស់ អ្នក អាច ត្រឡប់ មក វិញ ដើម្បី ទទួល បាន កញ្ចប់ មុន ។ សេចក្តីជូនដំណឹង ប្រៃសណីយ៍គំរូ មានលក្ខណៈដូចរូបខាងក្រោម៖

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

អនុវត្ត GET នៅ លើ URL ខាង លើ ជាមួយ Access token ដើម្បី ទទួល បាន ទិន្នន័យ ។ នេះ នឹង មាន ទាំង ទិន្នន័យ ប្រើប្រាស់ ចន្លោះ ពេល () ព្រម ទាំង ព័ត៌មាន Bill () សម្រាប់ រយៈ ពេល ដែល បាន ស្នើ។

២០ មីនា ២០២៣

អ្វីដែលថ្មី៖

1. ការ ចេញ ផ្សាយ កូដ ឆ្លើយ តប API HTTP ថ្មី (204) សម្រាប់ ទាំង ការ ហៅ API ដែល មាន យោគយល់ និង យោគយល់ ដើម្បី បង្ហាញ នៅ ពេល ដែល គ្មាន ទិន្នន័យ សម្រាប់ ជួរ ដែល បាន ស្នើ សុំ។
2. ការ គាំទ្រ ស្លាក ក្បាល x-transaction ដែល គាំទ្រ សមត្ថភាព ក្នុង ការ ភ្ជាប់ ការ ឆ្លើយ តប របស់ PG&E ទៅ នឹង ការ ហៅ API ជាក់លាក់ ដោយ ប្រគល់ តម្លៃ នេះ រួម ជាមួយ នឹង លេខ សម្គាល់ Correlation នៅ ពេល ដែល ឯកសារ ដែល បាន ស្នើ រួច រាល់ ។
3. បាន ធ្វើ ឲ្យ ប្រសើរ ឡើង នូវ ក្រានីត ទិន្នន័យ បន្ថែម ទៅ លើ ការ ប្រើប្រាស់Point/MeterReadingID API ដោយ ផ្តល់ ទិន្នន័យ ចន្លោះ ពេល អគ្គិសនី សម្រាប់ ម៉ែត្រ ជា ច្រើន ទៅ ស្ថាន ភាព កិច្ច ព្រម ព្រៀង សេវា តែ មួយ ។
4. បាន ផ្តល់ នូវ ភាព ច្បាស់លាស់ បន្ថែម ទៅ លើ តម្លៃ ចង្អុល បង្ហាញ គុណភាព អាន សម្រាប់ ទិន្នន័យ ចន្លោះ ពេល ដែល បាន ប៉ាន់ ស្មាន ដើម្បី ពិពណ៌នា អំពី ប្រភេទ នៃ ការ ប៉ាន់ ស្មាន ដែល ប្រើ សម្រាប់ ចន្លោះ នោះ ។ តម្លៃ ថ្មី ដែល បង្ហាញ ពី សន្ទស្សន៍ ប៉ាន់ស្មាន ត្រូវ បាន អនុវត្ត គឺ នៅ ខាង ក្រោម ៖
   
   

5. តម្លៃ និង ការ ពិពណ៌នា RQI

   0 - សុពលភាព: ទិន្នន័យដែលបានឆ្លងកាត់ការត្រួតពិនិត្យសុពលភាពដែលទាមទារទាំងអស់និងបានឆ្លងកាត់ទាំងអស់ឬត្រូវបានផ្ទៀងផ្ទាត់

   ៧ - កែសម្រួលដោយដៃ៖ ជំនួស ឬអនុម័តដោយមនុស្ស

   ៨ - ប៉ាន់ស្មាន ដោយ ប្រើ ថ្ងៃ យោង ៖ តម្លៃ ទិន្នន័យ ត្រូវ បាន ជំនួស ដោយ តម្លៃ គណនា ម៉ាស៊ីន ដោយ ផ្អែក លើ ការ វិភាគ ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ដោយ ប្រើ ប្រភេទ រង្វាស់ ដូច គ្នា

   ៩ - ត្រូវ បាន ប៉ាន់ ស្មាន ថា ប្រើ ប្រាស់ linear interpolation: តម្លៃ ទិន្នន័យ ត្រូវ បាន គណនា ដោយ ប្រើ ប្រាស់ linear interpolation ដោយ ផ្អែក លើ ការ អាន មុន និង បន្ទាប់ ពី វា

   ១០ - គួរ ឲ្យ សង្ស័យ ៖ ទិន្នន័យ ដែល បាន បរាជ័យ ការ ត្រួត ពិនិត្យ មួយ ឬ ច្រើន ជាង នេះ

   ១១ - ដកស្រង់ ៖ ទិន្នន័យ ដែល ត្រូវ បាន គណនា (ប្រើ ប្រាស់ logic ឬ ប្រតិបត្តិការ គណិតវិទ្យា) មិន ចាំ បាច់ វាស់ ដោយ ផ្ទាល់

   ១២ - Projected (ព្យាករណ៍) : ទិន្នន័យដែលបានគណនាជា projection ឬ ការព្យាករណ៍នៃការអាននាពេលអនាគត

   ១៣ - លាយឡំគ្នា៖ បញ្ជាក់ ថា គុណភាព នៃ ការ អាន នេះ មាន លក្ខណៈ ចម្រុះ

   ១៤ - Raw : ទិន្នន័យ ដែល មិន បាន ឆ្លង កាត់ ការ ធ្វើ ឲ្យ ត្រឹមត្រូវ ការ កែ សម្រួល និង ដំណើរ ការ ប៉ាន់ស្មាន ។ សូចនាករ NOTE MV90 Meters RQI នឹងស្ថិតនៅក្នុង 14 ជាស្ថានភាព RQ ចុងក្រោយ

   ១៥ - ជាធម្មតាសម្រាប់អាកាសធាតុ: តម្លៃត្រូវបានលៃតម្រូវដើម្បីគណនាអាកាសធាតុ, ដើម្បីប្រៀបធៀបការប្រើប្រាស់នៅក្នុងអាកាសធាតុផ្សេងគ្នា

   ១៦ - ដទៃទៀត ៖ បញ្ជាក់ ថា លក្ខណៈ អនុវត្ត ក្រៅពី លក្ខណៈ ដែល បាន កំណត់

   ១៧ - សុពលភាព ៖ ទិន្នន័យ ដែល បាន ធ្វើ ឲ្យ មាន សុពលភាព និង អាច កែ សម្រួល និង /ឬ ត្រូវ បាន ប៉ាន់ ស្មាន ស្រប តាម នីតិវិធី ដែល បាន អនុម័ត

   18 - Verified : ទិន្នន័យ ដែល បាន បរាជ័យ យ៉ាង ហោច ណាស់ មួយ ក្នុង ចំណោម ការ ត្រួត ពិនិត្យ សុពលភាព ដែល ចាំបាច់ ប៉ុន្តែ បាន ប្តេជ្ញា ចិត្ត តំណាង ឲ្យ ការ ប្រើប្រាស់ ជាក់ ស្តែង

   ១៩ - គុណភាព ប្រាក់ ចំណូល ៖ មាន សុពលភាព និង អាច ទទួល យក បាន សម្រាប់ គោល បំណង វិក្កយបត្រ [អាច ពង្រីក ស្តង់ដារ ESPI និង មិន មែន ជា ផ្នែក មួយ នៃ ESPI ដើម]

    

6. ការ ចេញ ផ្សាយ រង្វាស់ ប្រើប្រាស់ API នៅ ក្នុង ច្រក លក់ Share My Data Third Party ។

ថ្ងៃទី១៥ ខែវិច្ឆិកា ឆ្នាំ២០១៨

អ្វីដែលថ្មី៖

1. សូចនាករថ្នាក់អតិថិជនត្រូវបានបន្ថែម។ រាល់ SAID ដែល មាន ការ អនុញ្ញាត នឹង ត្រូវ បាន កំណត់ អត្ត សញ្ញាណ ថា ជា RES, AGR, COM/IND ឬ ផ្សេង ទៀត ។
2. Billing and Usage APIs នឹង ត្រូវ បាន ធ្វើ បច្ចុប្បន្ន ភាព ដើម្បី ទទួល យក ប៉ារ៉ាម៉ែត្រ សំណួរ ដែល បាន ធ្វើ បច្ចុប្បន្ន ភាព និង ធ្វើ បច្ចុប្បន្ន ភាព (ជា ជម្រើស មួយ សម្រាប់ បោះពុម្ព ផ្សាយ-min និង បោះពុម្ព-max)។ ទិន្នន័យ ដែល បាន ត្រឡប់ មក វិញ នឹង ជា ការ ផ្លាស់ ប្តូរ ទាំង អស់ ដែល បាន កើត ឡើង នៅ ក្នុង ប៉ារ៉ាម៉ែត្រ ដែល បាន ធ្វើ បច្ចុប្បន្ន ភាព និង អប្បបរមា ដែល បាន ធ្វើ បច្ចុប្បន្ន ភាព ។
3. ការជំនួសការប្រើប្រាស់ 5-digit Bulk ID របស់ភាគីទីបីជាមួយនឹងកម្មវិធី Client ID របស់ភាគីទីបីសម្រាប់លំហូរការអនុញ្ញាតតាមអ៊ិនធឺណិត។
4. ការផ្តល់ជម្រើសសម្រាប់ភាគីទីបីដើម្បីបង្វែរអតិថិជនទៅការចូលគណនី PG&E ឬផ្ទាំង Guest Access ដែលជាផ្នែកមួយនៃលំហូរការអនុញ្ញាតតាមអ៊ិនធឺណិត។
5. ការ ធ្វើ ឲ្យ ប្រសើរ ឡើង នូវ ក្តារ ចុច ចែក រំលែក ទិន្នន័យ របស់ PG&E ដើម្បី ធ្វើ ឲ្យ អតិថិ ជន កាន់ តែ ងាយ ស្រួល ក្នុង ការ មើល ការ អនុញ្ញាត ចែក រំលែក ទិន្នន័យ ដែល មាន ស្រាប់ ទាំង អស់ របស់ ពួក គេ ជាមួយ ភាគី ទី បី ។

September 27, 2018

អ្វីដែលថ្មី៖

PG&E added new data elements to the Rule 24 data set ជា ផ្នែក មួយ នៃ គម្រោង PG&E's Expanded Data Set (EDS) ហើយ ធាតុ ទិន្នន័យ ថ្មី ត្រូវ បាន ដាក់ បញ្ចូល ក្នុង សំណុំ ទិន្នន័យ Rule 25។ ធាតុ ទិន្នន័យ ជាក់លាក់ ដែល រួម មាន សំណុំ ទិន្នន័យ Rule 25 ដែល បាន ពង្រីក របស់ PG&E ត្រូវ បាន កំណត់ នៅ ខាង ក្រោម ជាមួយ នឹង ការ កំណត់ EDS ៖

ច្បាប់ ២៥ ធាតុទិន្នន័យ

កំណត់ចំណាំ
ធាតុគណនេយ្យ
ឈ្មោះគណនី
អាសយដ្ឋានគណនី
អត្តសញ្ញាណប័ណ្ណគណនី
EDS: ប្លុកក្រៅ
ធាតុសេវាកម្ម
PG&E UUID
លេខសម្គាល់សេវាកម្ម
ការផ្លាស់ប្តូរអនាគតនៃស្ថានភាពសេវាកម្ម
ស្ថានភាព
SA កាលបរិច្ឆេទចាប់ផ្តើមសេវាកម្ម
អាសយដ្ឋានសេវាកម្ម
ពន្ធសេវាបច្ចុប្បន្ន
ពន្ធសេវាកម្ម
Billed ប្រវត្តិសាស្រ្ត ជម្រើសពន្ធ (Medical Baseline, CARE, FERA, TBS, CCA_TBS, ការជ្រើសរើសព្រះអាទិត្យ
សេវា កម្ម បច្ចុប្បន្ន Voltage និង Commodity Historical Billed Service Voltage
លេខសេវាកម្ម
Meter ចំនួននៃសេវាកម្ម ម៉ែត
ប្រភេទ
Meter វដ្តអាន
Meter បច្ចុប្បន្ន ប្រវត្តិ សាស្ត្រ Billed Meter Read Cycle
ជម្រើស Standby Rate បច្ចុប្បន្ន ប្រសិនបើ សូចនាករ
ជំនាន់ On-site ជម្រើស
អត្រា ស្តេនប៊ី ជា ប្រវត្តិ សាស្ត្រ EDS: សូចនាករថ្នាក់អតិថិជន
ធាតុ
វិក្កយបត្រ ប្រវត្តិសាស្ត្រ កាល បរិច្ឆេទ
ចាប់ ផ្តើម របស់ Bill កាល បរិច្ឆេទ
បញ្ចប់ សេចក្តី ព្រាង ច្បាប់ Bill total charges($)
Bill សរុប kWh
EDS: ឈ្មោះអ្នកផ្តល់សេវា
ប្រវត្តិសាស្រ្ត Bill Tier Breakdown (បើមាន)
EDS: កំឡុងពេល
Bill របស់បន្ទាត់ EDS: ឈ្មោះ (Over Baseline 1%-30%)
EDS: វ៉ុល (1234.2)
EDS: បញ្ចុះតម្លៃ ($0.032/kWh)
EDS: តម្លៃ ($100.23)
បែកធ្លាយ Bill TOU kWh ប្រវត្តិសាស្ត្រ (លើកលែងតែ ABS-TX billed)
EDS: Line Item Bill Period (សម្រាប់ការរំលាយ TOU)
EDS: ឈ្មោះ (of TOU charge)
EDS: វ៉ុល (1234.2)
EDS: បញ្ចុះតម្លៃ ($0.032/kWh)
EDS: តម្លៃ ($100.23)
សេចក្តី ព្រាង ច្បាប់ ប្រវត្តិ សាស្ត្រ ទាម ទារ ឲ្យ បែក បាក់
EDS: Line Item Bill Period (សម្រាប់ទាមទារការបាក់បែក)
EDS: ឈ្មោះ
EDS: វ៉ុល (1234.2)
EDS: បញ្ចុះតម្លៃ ($0.032/kWh)
EDS: តម្លៃ ($100.23)
ធាតុបន្ទាត់
Bill ប្រវត្តិសាស្រ្ត EDS: កំឡុងពេល
Bill របស់បន្ទាត់ EDS: ឈ្មោះ Charge (DWR Bond Charge)
EDS: វ៉ុល (1234.2)
EDS: ឯកតា (kWh)
EDS: បញ្ចុះតម្លៃ ($0.032/kWh)
EDS: តម្លៃ ($100.23)
អាំងទែរប្រើជាប្រវត្តិសាស្ត្រ
ចាប់ផ្តើមប្រើប្រាស់
Interval លំនាំដើម Interval Duration( in seconds)
វ៉ុលនៃការប្រើប្រាស់ Interval (1234.2)
ឯកតា (kWh/Therms)
កម្មវិធីឆ្លើយតបតម្រូវការឧបករណ៍ប្រើប្រាស់
(DR) ឈ្មោះកម្មវិធី
កាល បរិច្ឆេទ បញ្ចប់ ដំបូង បំផុត ដោយ គ្មាន កាតព្វកិច្ច
ហិរញ្ញវត្ថុ កាល បរិច្ឆេទ បញ្ចប់ ដំបូង ដោយ មិន គិត ពី កាតព្វកិច្ច
ហិរញ្ញវត្ថុ ស្ថានភាព
កម្មវិធី DR កាលបរិច្ឆេទចុះឈ្មោះចូលរៀនកម្មវិធី
DR កាលបរិច្ឆេទចុះឈ្មោះចូលរៀនកម្មវិធី DR Program De-Enrollment
ធាតុទិន្នន័យ

ទំនិញ ប៉ារ៉ាម៉ែត្រម៉ោងមូលដ្ឋាន (DST details)
គុណភាពទិន្នន័យលំនាំដើម
ទិសថាមពល
Power of Ten Multiplier (សម្រាប់តម្លៃប្រើប្រាស់អន្តរកាល)
Power of Ten Multiplier (for Billed Demand)
Power of Ten Multiplier (For Billed total usage)
ប្រវែងអន្តរកាល(of Usage Reading)
រូបិយប័ណ្ណ នៃ ការ ចំណាយ
សរុប នៃ សេចក្តី ព្រាង ច្បាប់ សូចនាករ Interval TOU អគ្គិសនី

ខែមិថុនា 28, 2018

ជា ផ្នែក មួយ នៃ គម្រោង Click-Through និង ការ កែ លម្អ បន្ត ទៅ លើ វេទិកា ទិន្នន័យ Share My, PG&E បាន ដាក់ ចេញ នូវ Click-Through Phase 2 នៅ ថ្ងៃ ទី ២៨ ខែ មិថុនា ឆ្នាំ ២០១៨។

អ្វីដែលថ្មី៖

ការ ផ្លាស់ ប្តូរ ដ៏ សំខាន់ បំផុត ដែល ប៉ះ ពាល់ ដល់ ភាគី ទី បី គឺ ការ ផ្លាស់ ប្តូរ ដើម្បី អនុលោម តាម ពិធី សារ OAuth 2.0 ( PG&E បាន លុប ចោល ស៊េរី ដំបូង នៃ ប្រយោល ) ។ រកព័ត៌មានលម្អិតខាងក្រោម។

សំខាន់: ភាគី ទី បី ត្រូវ បាន តម្រូវ ឲ្យ ធ្វើ ការ ផ្លាស់ ប្តូរ ទៅ លើ ការ អនុវត្ត OAuth ដែល មាន ស្រាប់ របស់ ពួក គេ ។ ការ ផ្លាស់ប្ដូរ Click-Through Phase 2 របស់ PG&E គឺ មិន ត្រូវ គ្នា ផ្នែក ខាង ក្រោយ ទេ ដូច្នេះ វា ចាំបាច់ សម្រាប់ ភាគី ទី បី ក្នុង ការ អនុវត្ត ការ ផ្លាស់ ប្តូរ ដែល ស្រប ទៅ នឹង ការ អនុវត្ត របស់ PG&E ។ ដោយ គ្មាន ការ អនុវត្ត ដំណើរការ អនុញ្ញាត អតិថិជន បច្ចុប្បន្ន នឹង ឈប់ ធ្វើការ លើ កាលបរិច្ឆេទ កាត់ បន្ថយ ២៩ មិថុនា ២០១៨។ ទោះ ជា យ៉ាង ណា ក៏ ដោយ ការ អនុញ្ញាត ដែល មាន ស្រាប់ គឺ មិន មាន ផល ប៉ះ ពាល់ ឡើយ ។

1. ដើម្បី អនុលោម តាម ពិធីការ OAuth 2.0, PG&E បាន កាត់ បន្ថយ ចំនួន ជំហាន ប្រយោល សម្រាប់ ការ អនុញ្ញាត។ វិក្កយបត្រដំបូងទៅ PG&E សម្រាប់អតិថិជនក្នុងការចូលនិងដាក់ស្នើរសុំការអនុញ្ញាតត្រូវបានបញ្ចូលគ្នាជាមួយការស្នើសុំលេខកូដអនុញ្ញាតដូចខាងក្រោម៖
   • ដូច ដែល បាន បង្ហាញ នៅ ក្នុង ឧទាហរណ៍ ខាង ក្រោម នេះ ការ ស្នើ សុំ កូដ Authorization របស់ ភាគី ទី បី ឥឡូវ នេះ រួម មាន ការ បង្វែរ ទិស នៃ កម្មវិធី រុករក របស់ អតិថិ ជន ទៅ កាន់ PG&E's new authorizationServerAuthorizationEndpoint URI រួម ជាមួយ ប៉ារ៉ាម៉ែត្រ ស្នើសុំ សមរម្យ៖
     GET https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=កូដ&state={optionalState}
   • ចំណុច ចុង ក្រោយ ខាង ក្រោម នេះ បាន ចូល និ វត្ដ ន៍៖ https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. កំហុស ថ្មី ដោះស្រាយ សារ សម្រាប់ ការ អនុញ្ញាត កូដ ស្នើ សុំ ដោយ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព ដែល បាត់ ឬ មិន ត្រឹមត្រូវ ដូច ខាង ក្រោម ៖
   • ប្រសិនបើ ប៉ារ៉ាម៉ែត្រ client_id ឬ redirect_uri ដែល ត្រូវការ កំពុង បាត់ ឬ មិន ត្រឹមត្រូវ នោះ កំហុស (http 400) ដែល មាន សារ អន្លើ ត្រូវ បាន បង្ហាញ ដល់ អតិថិជន
   • ប្រសិនបើ ប៉ារ៉ាម៉ែត្រ response_type ដែល ទាមទារ កំពុង បាត់ ឬ មិន ត្រឹមត្រូវ នោះ អតិថិជន នឹង ត្រូវ បាន បង្វែរ ត្រឡប់ ទៅ redirect_uri របស់ ភាគី ទី ៣ វិញ ដោយ មាន ប៉ារ៉ាម៉ែត្រ កំហុស "invalid_request" (បម្រុង ទុក redirect_uri)
     
3. សម្រាប់អតិថិជនដែលមានការអនុញ្ញាតតាមអនឡាញដែលមានស្រាប់ សមត្ថភាពសម្រាប់ភាគីទីបីដើម្បីស្នើសុំភាគីថ្មី access_token/refresh_token ជាផ្នែកមួយនៃការអនុញ្ញាតថ្មីដែលជំនួសភាគីដែលមានស្រាប់ (i.e., ការអនុញ្ញាតតាមអនឡាញនៃភាគីទីបីដូចគ្នានិងការបន្សំអតិថិជន)។ មុខងារ នេះ ដោះស្រាយ ស្ថានភាព ភាគី ទី ៣ បាត់បង់ access_token/refresh_token គូ ឬ ក៏ ត្រូវ ផ្លាស់ ប្តូរ វិសាលភាព នៃ ការ អនុញ្ញាត ដើម ក្នុង ការ អនុម័ត របស់ អតិថិជន។
   • សម្រាប់ សំណើ សុំ ការ អនុញ្ញាត ឡើង វិញ អតិថិជន មើល ទំព័រ អនុញ្ញាត ថ្មី ជំនួស ឲ្យ ទំព័រ "គ្រប់គ្រង ការ អនុញ្ញាត" នៅ ពេល ដែល ត្រូវ បាន បង្វែរ ដោយ ភាគី ទី បី ទៅ PG&E សម្រាប់ ការ អនុញ្ញាត
   • នៅ ពេល ដែល ការ អនុញ្ញាត របស់ អតិថិជន ភាគី ទី បី ទទួល បាន ការ ជូន ដំណឹង ទៅ កាន់ URL សេចក្ដី ជូន ដំណឹង ដែល បាន ចុះ ឈ្មោះ របស់ ពួក គេ ថា លេខ សម្គាល់ ការ ជាវ ចាស់ ត្រូវ បាន លុប ចោល (ការ ជូន ដំណឹង រួម មាន ការ អនុញ្ញាត API URL endpoint for the old subscription ID)
     
4. សមត្ថភាពសម្រាប់អតិថិជនដើម្បីចេញតាមរយៈប៊ូតុង "លុបចោល" នៅលើទំព័រផ្ទៀងផ្ទាត់ឬទំព័រការអនុញ្ញាតដោយបង្វែរត្រឡប់ទៅភាគីទីបី redirect_uri ជាមួយនឹងប៉ារ៉ាម៉ែត្រកំហុស "access_denied" (ឧទ្ទិសដល់ redirect_uri)
5. សម្រាប់ ភាគី ទី ៣ ដែល ចុះ ឈ្មោះ ជាមួយ នឹង ការ កំណត់ "ភាព មើល ឃើញ" ហើយ ដូច្នេះ ត្រូវ បាន បញ្ចូល ក្នុង បញ្ជី អតិថិជន ភាគី ទី បី ដែល បាន ចុះ ឈ្មោះ នឹង ឃើញ នៅ ពេល ដែល ពួក គេ ទៅ កាន់ គណនី អនឡាញ PG&E របស់ ពួក គេ ហើយ រុករក ទៅ ទំព័រ ចុះ ចត ទិន្នន័យ Share My៖
   • សម្រាប់អតិថិជនដែលចូលគណនីអនឡាញ PG&E របស់ខ្លួន ហើយធ្វើការរុករកទៅកាន់ទំព័រចុះចតទិន្នន័យ Share My បន្ទាប់មកត្រូវបានបង្វែរទៅភាគីទីបីដែលបានចុះបញ្ជី "Third Party Portal URI" នៅពេលជ្រើសរើសភាគីទីបីពីបញ្ជីនៃភាគីទីបីដែលបានចុះឈ្មោះ។ នៅ ចំណុច នោះ អតិថិជន អាច បន្ត ដំណើរ ការ ជាមួយ ភាគី ទី បី ដែល បាន ចាប់ ផ្តើម ដំណើរ ការ OAuth ។ នៅ ពេល ឆ្លង កាត់ ផ្លូវ នេះ អតិថិ ជន នឹង មិន ត្រូវ បាន បង្ហាញ ទំព័រ អនុញ្ញាត ទៀត ទេ នៅ ពេល ជ្រើស រើស ភាគី ទី បី ពី បញ្ជី ធ្លាក់ ចុះ នៃ ភាគី ទី បី ប៉ុន្តែ ជំនួស មក វិញ ត្រូវ បាន ប្តូរ ទៅ " ច្រក ទ្វារ ភាគី ទី បី " របស់ ភាគី ទី បី ដែល ពួក គេ អាច ចាប់ ផ្តើម ដំណើរ ការ OAuth ដែល បាន ចាប់ ផ្តើម ។
   • ចំណាំ៖ ភាគី ទី បី មួយ ចំនួន បាន សួរ អំពី របៀប ពង្រឹង បទ ពិសោធន៍ របស់ អតិថិ ជន សម្រាប់ ករណី ប្រើប្រាស់ នេះ ( មាន ឧទាហរណ៍ ការ អនុញ្ញាត ដែល បាន ចាប់ ផ្តើម នៅ លើ គេហទំព័រ PG&E ) ដូច នេះ ទៅ កាន់ អតិថិ ជន វា ហាក់ ដូច ជា ពួក គេ ត្រូវ បាន យក ទៅ ទំព័រ អនុញ្ញាត ដោយ ផ្ទាល់ នៅ ពេល ជ្រើស រើស ភាគី ទី បី ពី ការ ធ្លាក់ ចុះ នេះ ។ ដើម្បីសម្រួលដល់បទពិសោធន៍អតិថិជនបែបនេះ ភាគីទីបីអាចជ្រើសរើសដើម្បីកំណត់ "Third Party Portal URI" របស់ខ្លួន (តាមរយៈទំព័រ Share My Data គ្រប់គ្រងការចុះឈ្មោះ) ដើម្បីជាចំណុចបញ្ចប់ដែលបង្វែរអតិថិជនមកវិញដោយស្វ័យប្រវត្តិទៅកាន់ PG&E ដែលជាផ្នែកមួយនៃការស្នើសុំលេខកូដអនុញ្ញាត។ នៅ ពេល បង្វែរ ដោយ ស្វ័យ ប្រវត្តិ ត្រឡប់ ទៅ កាន់ PG&E's authorizationServerAuthorizationEndpoint អតិថិជន នឹង រំលង ទំព័រ ចូល អតិថិជន (ដូច ដែល ពួក គេ បាន ចូល រួច ហើយ) ហើយ នឹង ទៅ កាន់ ទំព័រ អនុញ្ញាត ដោយ ផ្ទាល់។ សម្រាប់ភាគីទីបីមួយចំនួនដែលបានចុះឈ្មោះមុនការចេញ Share My Data Click Thru 2.0 នេះអាចត្រូវបានសម្រេចដោយគ្រាន់តែកំណត់ Portal URI របស់ភាគីទីបីដើម្បីស្មើភាពដែលមិនមាន "Third Party Scope Selection Screen" URI (វាលចុះឈ្មោះ SMD ចាស់ដើម្បីចូលនិវត្តន៍ក្នុងថ្ងៃចេញផ្សាយនាពេលអនាគត)។
     ផ្ទុយ ទៅ វិញ ភាគី ទី បី មួយ ចំនួន ប្រហែល ជា ចង់ ចូល រួម ជា លើក ដំបូង និង អេក្រង់ អតិថិជន នៅ ខាង ពួក គេ នៅ ពេល ដែល អតិថិជន ត្រូវ បាន បង្វែរ ទៅ 'Third Party Portal' URI របស់ ពួក គេ មុន ពេល ស្នើ សុំ កូដ អនុញ្ញាត ដូច្នេះ វិធី សាស្ត្រ ខាង លើ គឺ គ្រាន់ តែ ជា យោបល់ មួយ ប៉ុណ្ណោះ ។
     
6. SMD ឥឡូវនេះនឹងផ្តល់នូវការធ្វើឱ្យ Scope parameter មានភាពកាន់តែទូលំទូលាយ ដែលជាផ្នែកមួយនៃការឆ្លើយតបទៅនឹងសំណើនៃកូដ Authorization, Access Token Request, និង Authorization API។ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព ដែល បាន ធ្វើ ឲ្យ ប្រសើរ ឡើង អនុញ្ញាត ឲ្យ ទាក់ ទង នឹង វិសាល ភាព ចុង ក្រោយ នៃ ការ អនុញ្ញាត របស់ អតិថិ ជន ។ ជា ពិសេស ប៉ារ៉ាម៉ែត្រ វិសាល ភាព រួម មាន តម្លៃ "AdditionalScope" ដែល ផ្គូផ្គង ទៅ នឹង PG&E's support customer authorization selections of data groups (ឧ. "Usage", "Billing", "Basic", "Account", "Program Enrollment") ។ តម្លៃ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព ត្រូវ បាន ចាប់ យក បន្ថែម ទៀត ក្នុង ឯកសារ ដូច ខាង ក្រោម៖ ទាញយក មុខងារ គាំទ្រ Block Scope String Mapping Click Thru 2.0 (PDF)
   
   ឧទាហរណ៍ មួយ ដែល Token ឆ្លើយ តប ខាង ក្រោម នេះ បង្ហាញ ពី តម្លៃ ប៉ារ៉ាម៉ែត្រ វិសាល ភាព មួយ ចំនួន ដែល អាច ធ្វើ ទៅ បាន ។
   • ឧទាហរណ៍ Token Response:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47; បន្ថែមScope=Usage_Billing_Basic_Account_ProgramEnrollment; IntervalDuration=900_3600; ប្លក=ប្រចាំថ្ងៃ; HistoryLength={3P ចុះឈ្មោះប្រវែងប្រវត្តិសាស្ត្រ}; AccountCollection={រាប់ចំនួន 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. ឥឡូវ នេះ ភាគី ទី បី អាច ចុះ ឈ្មោះ ទទួល បាន ព័ត៌មាន ចុះ ឈ្មោះ កម្មវិធី ដែល មាន ការ អនុញ្ញាត តាម រយៈ ក្រុម ទិន្នន័យ "ការ ចុះ ឈ្មោះ កម្មវិធី" ថ្មី។ អតិថិ ជន ទាំង ពីរ បាន វាស់ ស្ទង់ ព្រម ទាំង អតិថិជន ដែល មិន មាន ចន្លោះ ពេល នឹង មាន សិទ្ធិ អនុញ្ញាត ក្នុង ការ ចែក រំលែក ទិន្នន័យ សម្រាប់ SMD Click-Through Phase 2 ។ សង្ខេបកម្រិតខ្ពស់នៃធាតុទិន្នន័យដែលទើបនឹងអាចរកបានដែលផ្តល់ជូនដោយក្រុមទិន្នន័យចុះឈ្មោះកម្មវិធីមានដូចខាងក្រោម៖
   • ការចុះឈ្មោះកម្មវិធី (PG&E Demand Response program name/status and CAISO information):
   • (Billing) អាសយដ្ឋានគណនី
   • ស្ថានភាពកិច្ចព្រមព្រៀងសេវាកម្ម
   • (បច្ចុប្បន្ន) ពន្ធសេវាកម្ម
   • (បច្ចុប្បន្ន) វ៉ុលសេវាកម្ម (អគ្គីសនីតែ)
   • លេខវាស់សេវាកម្ម (បើមាន)
   • ប្រភេទ Meter
   • (បច្ចុប្បន្ន) ម៉ែត្រ អាន វដ្ត
   • (បច្ចុប្បន្ន) ជម្រើស បញ្ចុះតម្លៃ Standby ប្រសិន បើ ការ ចង្អុល បង្ហាញ ជំនាន់ On-Site
   • (default interval usage) Duration( length in seconds)
   • (ចុះឈ្មោះ PG&E Demand Response) ឈ្មោះកម្មវិធី (if applicable)
   • កាលបរិច្ឆេទ បញ្ចប់ មុន បំផុត ពី កម្មវិធី PG&E បាន ចុះ ឈ្មោះ ទាមទារ ឆ្លើយតប (DR) ដោយ គ្មាន កាតព្វកិច្ច ហិរញ្ញវត្ថុ
   • កាល បរិច្ឆេទ បញ្ចប់ មុន បំផុត ពី PG&E បាន ចុះ ឈ្មោះ កម្មវិធី ឆ្លើយតប ការ ទាមទារ (DR) ដោយ មិន គិត ពី កាតព្វកិច្ច ហិរញ្ញវត្ថុ
   • PG&E Demand Response (DR) កម្មវិធី (ការចុះឈ្មោះចូលរៀន) ស្ថានភាព
   • PG&E Demand Response (DR) កាលបរិច្ឆេទចុះឈ្មោះចូលរៀនកម្មវិធី
   • PG&E Demand Response (DR) កាលបរិច្ឆេទកម្មវិធី De-Enrollment
   • អាតូម XML XSD (XML Schema Definition) ផែនទី សម្រាប់ ធាតុ ទិន្នន័យ ថ្មី ទាំង នេះ ត្រូវ បាន ចាប់ យក ជា ឯកសារ ដូច ខាង ក្រោម៖
     ទាញ យក ធាតុ ទិន្នន័យ គាំទ្រ (PDF)
   • គំរូ ឋានានុក្រម ទិន្នន័យ ដែល ទាក់ទង នឹង Associated ត្រូវ បាន គូស បង្ហាញ ក្នុង មួយ ខាង ក្រោម នេះ ៖
     ទាញយក PGE ESPI Data Model (PDF)
   • ចំនុចប្រើប្រាស់ (aka SA UUID)
     • ServiceDeliveryPoint\tariffProfile(កាលវិភាគអត្រាសេវាបច្ចុប្បន្ន AKA រួមមាន Standby Rate Option ប្រសិនបើអាចអនុវត្តបាន)
     • readCycle (current Meter Read Cycle)UsageSummary
     • readCycle (វដ្តសេវាកម្ម billing)
     • ទំនិញ (រួមមាន កម្រិត វ៉ុល ដែល បាន វិក្កយបត្រ សម្រាប់ អគ្គិសនី)
     • ពន្ធProfile (អាករ លើ កម្រៃ សេវា រួម ទាំង ជម្រើស Standby Rate ប្រសិន បើ អាច អនុវត្ត បាន
   • ប្រភេទអាន
     • Commodity (រួមបញ្ចូលកម្រិត voltage បច្ចុប្បន្នសម្រាប់ថាមពលអគ្គិសនីនិង prefix សម្រាប់ Standby Rate Option ដែលជាកន្លែងដែលអាចអនុវត្តបាន)
   • គណនីអតិថិជន
     • (Acct Billing Address):
     • mainAddress/streetDetail...
     • mainAddress/townDetail...
     • mainAddress/postalCode...
   • កិច្ចព្រមព្រៀងអតិថិជន
     • status\value (SA Status
   • កម្មវិធីឆ្លើយតបតម្រូវការ
     • ឈ្មោះ កម្មវិធី
     • បញ្ញត្តិចុះឈ្មោះចូលរៀន
     • programDate/programDate
     • programDate/programDateDescription
   • កុងទ័រ
     • serialNumber (meter id)
     • ប្រភេទ (ប្រភេទ ម៉ែត្រ)
     • (current) intervalLength
   • និយមន័យ ESPI xml schema ចុងក្រោយបំផុត (XSDs) ប្រើសម្រាប់ធាតុទិន្នន័យថ្មីទាំងនេះត្រូវបានចែងក្នុងមួយដូចខាងក្រោម:
     ទាញយក XSDs (ZIP, 49 KB)ZIP. បើកក្នុង Window ថ្មី។
     ចំណាំ: XSDs គឺស្របគ្នាក្រោយ។
   • ភាគី ទី ៣ នឹង មាន សមត្ថភាព ផ្លាស់ ប្តូរ ការ ចុះ ឈ្មោះ របស់ ខ្លួន ដើម្បី អនុញ្ញាត ឲ្យ អតិថិជន ជ្រើស រើស ក្រុម ទិន្នន័យ នេះ ក្នុង អំឡុង ពេល នៃ ការ អនុញ្ញាត តាម ច្រក ទ្វារ ភាគី ទី ៣ ក្រោម ការ គ្រប់គ្រង ការ ចុះ ឈ្មោះ >Edit > ផ្នែក៖ ចង្អុលបង្ហាញព័ត៌មានរបស់អតិថិជនដែលអ្នកត្រូវការ", ជ្រើសរើសប្រអប់ពិនិត្យចុះឈ្មោះកម្មវិធី.
   • ចំណាំ៖ នេះ នឹង អនុវត្ត តែ ចំពោះ ការ អនុញ្ញាត ថ្មី របស់ អតិថិជន ប៉ុណ្ណោះ។
     
   • APIs ថ្មីដើម្បីយកព័ត៌មាន DR Enrollment អាចរកបាននៅកម្រិត Bulk 3 rd party ក៏ដូចនៅកម្រិតអនុញ្ញាតរបស់អតិថិជនម្នាក់ៗ (RetailCustomerID level) ដែលបានរៀបរាប់ក្នុងមួយខាងក្រោមនេះ៖
     ទាញយក PGE ថ្មី គាំទ្រ APIs (PDF)
   • Asynchronous API ចំពោះការស្នើសុំព័ត៌មាន DR Enrollment សម្រាប់ការអនុញ្ញាតទាំងអស់ទៅកាន់ភាគីទីបី
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • Synchronous API សម្រាប់ស្នើសុំព័ត៌មានចុះឈ្មោះ DR នៅកម្រិតអនុញ្ញាតរបស់អតិថិជនម្នាក់ៗ
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

សូមចំណាំ៖ ក្រៅ ពី ការ ផ្លាស់ ប្តូរ ដំណើរ ការ អនុញ្ញាត របស់ អតិថិ ជន ការ ផ្លាស់ ប្តូរ ផ្សេង ទៀត ក៏ ឆប គ្នា ថយ ក្រោយ និង ជា ការ បង្កើន ដោយ ស្ម័គ្រ ចិត្ត ភាគី ទី បី អាច ជ្រើស រើស គាំទ្រ បាន ។

ប្រសិនបើអ្នកមានសំណួរណាមួយឬត្រូវការការគាំទ្របន្ថែម សូមមានអារម្មណ៍ឥតគិតថ្លៃចំពោះអ៊ីម៉ែល sharemydata@pge.com។

អ្វីដែលថ្មី៖

1. ឥឡូវនេះអតិថិជនអាចទទួលប្រយោជន៍ពីដំណើរការនៃការចុច-Through ការអនុញ្ញាតដែលមានស្ទ្រីម។
   • យើង បាន ធ្វើ បច្ចុប្បន្ន ភាព ព័ត៌មាន លម្អិត អំពី របៀប ដែល អតិថិ ជន អាច ចែក រំលែក ទិន្នន័យ ជាមួយ ក្រុម ហ៊ុន របស់ អ្នក ឥឡូវ នេះ ។
     ស្វែងយល់ពីរបៀបដែលអតិថិជនចែករំលែកទិន្នន័យជាមួយក្រុមហ៊ុន
     
     ចំណាំ៖ ការ ផ្លាស់ ប្តូរ ទាំង នេះ ជា ពិសេស ការ កែ លម្អ ទៅ លើ ការ អនុញ្ញាត របស់ យើង UI ត្រូវ បាន ធ្វើ ឲ្យ ប្រសើរ ឡើង សម្រាប់ ឧបករណ៍ ចល័ត ( ឧទាហរណ៍ ទូរស័ព្ទ ឬ តុ ) ។
   • ការផ្លាស់ប្តូរត្រូវបានធ្វើឡើងចំពោះដំណើរការនៃការអនុញ្ញាតគ្រប់គ្រងអាចដំណើរការបានដល់អតិថិជនតាមរយៈគណនីអនឡាញ PG&E របស់ពួកគេ:
     • អតិថិជននៅតែអាចដក SAIDs ចេញពីការអនុញ្ញាតដែលមានស្រាប់ ពង្រីកកាលបរិច្ឆេទបញ្ចប់នៃការអនុញ្ញាត និង/ឬលុបចោលការអនុញ្ញាតនៅពេលណាមួយ។ ទោះ ជា យ៉ាង ណា ក៏ ដោយ ដើម្បី បន្ថែម SAIDs បន្ថែម និង/ឬ ផ្លាស់ ប្តូរ ធាតុ ទិន្នន័យ ដែល មាន សិទ្ធិ អនុញ្ញាត ដែល មាន ស្រាប់ ចាំបាច់ ត្រូវ លុប ចោល ហើយ ការ អនុញ្ញាត ថ្មី ត្រូវ តែ បង្កើត ។
2. បើចង់បានហើយ ពេលនេះ ភាគីទីបីអាចប្រើ API នេះ សម្រាប់ដកហូតការអនុញ្ញាតពីអតិថិជនម្នាក់ៗ ដោយប្រើប្រាស់កម្មវិធី Client Access Token ទីបី (ផ្តល់ជូនក្នុងអំឡុងពេលដំណើរការចុះឈ្មោះរបស់ភាគីទីបី SMD ដំបូង) តាមរយៈប្រតិបត្តិការ DELETE: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   ចំណាំទី១៖ ចំពោះការអនុវត្ត PG&E ប៉ារ៉ាម៉ែត្រ AuthorizationID គឺមានតម្លៃដូចគ្នានឹង SubscriptionID ។
   
   ចំណាំទី២៖ API ថ្មីផ្តល់ភាគីទីបីនូវសមត្ថភាពដកហូត (លុបចោល) ការអនុញ្ញាត។ ទោះ ជា យ៉ាង ណា ក៏ ដោយ មាន តែ អតិថិជន ប៉ុណ្ណោះ ដែល ខ្លួន ឯង ផ្ទាល់ អាច ដក ចេញ នូវ SA IDs និង/ឬ ធ្វើ បច្ចុប្បន្ន ភាព កាល បរិច្ឆេទ បញ្ចប់ នៃ ការ អនុញ្ញាត តាម រយៈ SMD របស់ យើង ដែល គ្រប់ គ្រង ទំព័រ អនុញ្ញាត ។
   
   រំលឹកឡើងវិញ៖ ដូចទៅនឹងសំណើរទិន្នន័យរបស់ API ទាំងអស់ ភាគីទីបីត្រូវស្នើសុំ Token Pair ថ្មីជាមុនសិន (Client Access + Refresh Token) ដោយប្រើប្រាស់ Refresh Tokens ចុងក្រោយរបស់ពួកគេ។
   
   រំលឹកអំពីរយៈពេលផុតកំណត់ Token:
   • Access Token:1hr
   • Client Access Token: 5 min
   • ឆ្លងឆ្លើយ ថូខឹនស្រស់៖ 1Yr
3. ឥឡូវ នេះ ភាគី ទី បី អាច បង្កើត ការ ចុះ ឈ្មោះ Share My Data ( SMD ) ជា ច្រើន ដោយ ប្រើ ឈ្មោះ ក្រុម ហ៊ុន ដូច គ្នា និង Tax ID ប្រសិន បើ ចាំបាច់ ។ ទោះ ជា យ៉ាង ណា ក៏ ដោយ ឈ្មោះ បង្ហាញ (ដែល អតិថិជន មើល ឃើញ នៅ ពេល អនុញ្ញាត) នៅ តែ ត្រូវ តែ មាន តែ មួយ គត់។
   
   ចំណាំ៖ ការផ្លាស់ប្តូរទាំងអស់ខាងលើ គឺស្របគ្នាក្រោយ និងមានការជួយបង្កើនដោយស្ម័គ្រចិត្ត គណបក្សនយោបាយទីបី អាចជ្រើសរើសគាំទ្របាន។ ទាញយកឯកសារគាំទ្រសម្រាប់ការចេញផ្សាយនេះ:
   
   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)

២០ ធ្នូ ២០១៥

ត្រូវការការផ្លាស់ប្តូរ: បច្ចុប្បន្នភាព SMD 2.0 ដូចខាងក្រោមតម្រូវឱ្យមានការផ្លាស់ប្តូរលើផ្នែកនៃភាគីទីបី។

1. ក្នុង ការ ពិចារណា ភាគី ទី ៣ ជាមួយ នឹង GBCMD (Green Button Connect My Data) នៅ ឧបករណ៍ ប្រើប្រាស់ ច្រើន ក្រៅ ពី គ្រាន់ តែ PG&E យើង នឹង បញ្ជូន ទិន្នន័យ ត្រឡប់ មក វិញ នូវ ទិន្នន័យCustodianID (i.e., dataCustodianID=PGE) ក្នុង ការ បង្វែរ ទិស ដៅ ទៅ កាន់ ទី បីPartyScopeSelectionScreenURI ក្នុង អំឡុង ពេល លំដាប់ នៃ ការ អនុញ្ញាត OAuth។
2. API ការស្នើសុំដែលទទួលយកប៉ារ៉ាម៉ែត្រកាលបរិច្ឆេទ (ឧ. សំណើរ batch) ត្រូវប្រើប៉ារ៉ាម៉ែត្រទិន្នន័យ Zulu (ឧ. បោះពុម្ព-max/ published-min) ។ ទ្រង់ទ្រាយ កាលបរិច្ឆេទ ផ្សេង ទៀត សម្រាប់ ប៉ារ៉ាម៉ែត្រ កាលបរិច្ឆេទ ក្នុង សំណើ API នឹង មិន ត្រូវ បាន គាំទ្រ ឡើយ & # 160; ។
   • APIs ដែលទទួលយកប៉ារ៉ាម៉ែត្រកាលបរិច្ឆេទត្រូវបានធ្វើឯកសារក្នុងមួយភ្ជាប់, គាំទ្រ APIs.xlsx
3. សូចនាករ Interval TOU រួមមានទិន្នន័យប្រើប្រាស់អគ្គិសនី Interval metered (ជាការអនុវត្ត, សូចនាករនៃអ្វីដែល TOU period each interval សមស្របទៅនឹង)
   • សូមយោងលើកម្មវិធី static Program ID Mappings ដែលលម្អិតអំពីអ្វីដែល interval TOU enumeration នីមួយៗត្រូវនឹង (ឧ. 1 = Summer Peak etc.).។ (មើល ភ្ជាប់, គាំទ្រធាតុទិន្នន័យ.xlsx)
4. client_id ដូច ដែល បាន រក ឃើញ នៅ ក្នុង dataCustodianScopeSelectionScreenURI (ប្រើ សម្រាប់ ភាគី ទី ៣ ដែល បាន ផ្តួច ផ្តើម OAuth) និង បាន ផ្ដល់ នៅ ក្នុង សំណើ ភាគី ទី បី ផ្នែក ធនធាន ព័ត៌មាន កម្មវិធី អំឡុង ពេល ប្រឡង ចុះ ឈ្មោះ កំពុង ត្រូវ បាន ធ្វើ បច្ចុប្បន្ន ភាព ទៅ ៥ តួ ប្រសិន បើ មិន ទាន់ មាន (ឧ.) បន្ថែម សូន្យ នាំ មុខ ។ល។ លើស ពី នេះ ទៀត URL លែង រួម បញ្ចូល '&verified=true' នៅ ចុង បញ្ចប់ ទៀត ហើយ។ ភាគី ទី បី នឹង ត្រូវ ធ្វើ បច្ចុប្បន្ន ភាព URLs របស់ ពួក គេ ស្រប តាម នោះ ។
   • ដើម្បី elaborate ទិន្នន័យCustodianScopeSelectionScreenURI មើល ទៅ ដូច ខាង ក្រោម៖ https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX is the clientID)
   • ដូច្នេះ អតិថិ ជន បច្ចុប្បន្ន ដែល មាន អាយុ 123 ឆ្នាំ នឹង ផ្លាស់ ប្តូរ ទៅ ជា អ្វី មួយ ដូច ជា 00123 មាន ន័យ ថា ទិន្នន័យ ថ្មី របស់ ពួក គេCustodianScopeSelectionScreenURI នឹង មាន ដូច ខាង ក្រោម នេះ ៖
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (URL ចាស់ ដូចខាងក្រោម: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. ភាគីទីបីដែលបានចុះបញ្ជីជា "ESP" ឬ "ក្រុមហ៊ុនផ្ដល់សេវាកម្មថាមពល" កំពុងផ្លាស់ប្តូរទៅជាប្រភេទអ្នកប្រើប្រាស់ស្តង់ដារ។ គ្មានការផ្លាស់ប្តូរមុខងារទេ មានតែនៅក្នុងប្រភេទលេខនៃអ្នកប្រើប្រាស់ប៉ុណ្ណោះ។ ការបែងចែកប្រភេទអ្នកប្រើប្រាស់ ESP (ពីប្រភេទ Standard User) គឺជាភាពខុសគ្នាដែលមិនចាំបាច់ ជាហេតុធ្វើឲ្យមានការភាន់ច្រឡំអំឡុងពេលដំណើរការចុះឈ្មោះដោយមិនផ្តល់មុខងារផ្សេងណាមួយឡើយ ហេតុនេះវាកំពុងតែចូលនិវត្តន៍។

ការលើកកំពស់ជម្រើស: ការ ផ្លាស់ ប្តូរ ខាង ក្រោម នេះ គឺ ឆប គ្នា ថយ ក្រោយ ហើយ ការ បង្កើន ដោយ ស្ម័គ្រ ចិត្ត ភាគី ទី បី អាច ជ្រើស រើស គាំទ្រ បាន ។

1. ភាគីទីបីនឹងមានសមត្ថភាពក្នុងការផ្លាស់ប្តូរ/update ដោយស្វ័យប្រវត្តិនូវ SSL certs របស់ពួកគេដែលពួកគេបានផ្តល់ដើមក្នុងអំឡុងពេលចុះឈ្មោះ (ឧ. នៅពេលដែល cert nears ជិតផុតកំណត់) តាមរយៈច្រកចូលភាគីទីបីក្រោមការគ្រប់គ្រងការចុះឈ្មោះ >Edit > ផ្នែកថ្មី៖ ព័ត៌មានបញ្ជាក់ SSL (Update option) ។
2. ភាគីទីបីអាចចុះឈ្មោះទទួលព័ត៌មានវិក្កយបត្រជាមូលដ្ឋានដែលមានការអនុញ្ញាត, ព័ត៌មានអតិថិជន, និងទិន្នន័យឧស្ម័ន។  ទាំង ចន្លោះ ពេល ដែល បាន វាស់ ក៏ ដូច ជា អតិថិ ជន ដែល មិន មែន ជា ម៉ែត្រ នឹង មាន សិទ្ធិ អនុញ្ញាត ក្នុង ការ ចែក រំលែក ទិន្នន័យ សម្រាប់ SMD 2.0 ។ សង្ខេប កម្រិត ខ្ពស់ នៃ ធាតុ ទិន្នន័យ ដែល ទើប តែ មាន ថ្មី គឺ មាន ដូច ខាង ក្រោម៖
   • Billing Info: (សម្រាប់ទាំង Interval និង non-interval metered SAs)
     • កាលវិភាគអត្រា, អត្រាការប្រាក់ $ សរុប, ការប្រើ Tiered (ជាការអនុវត្ត), តម្រូវការ (ជាការអនុវត្ត), TOU totals (as applicable)
     • ចំណាំ៖ សម្រាប់អតិថិជនដែលមិនមានចន្លោះដែលអនុញ្ញាត ភាគីទីបីនឹងទទួលបានអត្រាការប្រាក់សរុបប្រើប្រាស់ (i.e., in Usage Summary) និងគ្មានការប្រើប្រាស់អន្តរកាលអាន (ឧ., ម៉ោងអានតាមម៉ោង/ប្រចាំថ្ងៃតាមដែលមិនមាន)
   • ព័ត៌ មានអតិថិជន៖ (សម្រាប់ទាំងចន្លោះ និងមិនអន្តរកាល SAs)
     • ឈ្មោះអតិថិជន, Service Address, Account ID, Service Agreement ID, Service Agreement ID, Service Agreement service Start Date,
   • ទិន្នន័យប្រើប្រាស់ឧស្ម័ន Interval: (interval metered gas SAs only)
     • Interval (i.e., daily) ឧស្ម័នអាន
   • ធាតុ ទិន្នន័យ ថ្មី ត្រូវ បាន ដ្យាក្រាម ដូច ក្នុង មួយ ធាតុ ទិន្នន័យ ដែល បាន ភ្ជាប់, គាំទ្រ.xlsx
   • ឋានានុក្រមទិន្នន័យទាក់ទង Associated relational data ឋានានុក្រមទិន្នន័យត្រូវបានបង្ហាញនៅក្នុង attached, PGE ESPI Data Model.xlsx
   • និយមន័យ ESPI xml schema ចុង ក្រោយ បំផុត (XSDs) ដែល ប្រើ សម្រាប់ ធាតុ ទិន្នន័យ ថ្មី ទាំង នេះ គឺ ក្នុង មួយ XSDs ដែល បាន ភ្ជាប់ ។ ចំណាំ៖ XSDs មានលក្ខណៈត្រលប់ក្រោយគ្នា៖
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (ព័ត៌មានអតិថិជន)

អ្នកគួរតែមានសំណួរ ឬត្រូវការការគាំទ្របន្ថែម សូមមេត្តាមេត្តាជួយទំនាក់ទំនងយើងខ្ញុំដោយមិនគិតថ្លៃ ShareMyData@pge.com។

១៨ ធ្នូ ២០១៥
 

ការ ផ្លាស់ប្ដូរ ដែល ទាមទារ ៖ ការ ធ្វើ បច្ចុប្បន្ន ភាព SMD 2.0 ដូច ខាង ក្រោម នេះ តម្រូវ ឲ្យ មាន ការ ផ្លាស់ ប្តូរ លើ ផ្នែក នៃ អ្នក ប្រើប្រាស់ ទាំង នោះ ដែល ចូល ដំណើរ ការ ទិន្នន័យ ផ្ទាល់ ខ្លួន របស់ ពួក គេ ៖

1. API ការស្នើសុំដែលទទួលយកប៉ារ៉ាម៉ែត្រកាលបរិច្ឆេទ (ឧ. សំណើរ batch) ត្រូវប្រើប៉ារ៉ាម៉ែត្រទិន្នន័យ Zulu (ឧ. បោះពុម្ព-max/ published-min) ។ ទ្រង់ទ្រាយ កាលបរិច្ឆេទ ផ្សេង ទៀត សម្រាប់ ប៉ារ៉ាម៉ែត្រ កាលបរិច្ឆេទ ក្នុង សំណើ API នឹង មិន ត្រូវ បាន គាំទ្រ ឡើយ & # 160; ។
   • APIs ដែលទទួលយកប៉ារ៉ាម៉ែត្រកាលបរិច្ឆេទត្រូវបានធ្វើឯកសារក្នុងមួយភ្ជាប់, គាំទ្រ APIs.xlsx
2. Interval Time of Use (TOU) សូចនាកររួមបញ្ចូលជាមួយទិន្នន័យប្រើប្រាស់អគ្គិសនី Interval metered (ជាការអនុវត្ត, សូចនាករនៃអ្វីដែល TOU period each interval សមស្របទៅនឹង)
   • សូមយោងលើកម្មវិធី static Program ID Mappings ដែលលម្អិតអំពីអ្វីដែល interval TOU enumeration នីមួយៗត្រូវនឹង (ឧ. 1 = Summer Peak etc.).។ (មើល ភ្ជាប់, គាំទ្រធាតុទិន្នន័យ.xlsx)

ការលើកកំពស់ជម្រើស: ការ ផ្លាស់ ប្តូរ ខាង ក្រោម នេះ គឺ ឆប គ្នា ថយ ក្រោយ ហើយ ការ បង្កើន ដោយ ស្ម័គ្រ ចិត្ត ភាគី ទី បី អាច ជ្រើស រើស គាំទ្រ បាន ។

1. អ្នកប្រើប្រាស់ Access ផ្ទាល់ខ្លួន នឹង មាន សមត្ថភាព ផ្លាស់ប្ដូរ /update ដោយស្វ័យប្រវត្តិ នូវ SSL certs របស់ ពួក គេ ដែល ពួក គេ បាន ផ្ដល់ ដំបូង ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ (ឧ. ពេល ដែល cert ជិត ផុត កំណត់) តាម រយៈ ច្រក ទ្វារ ភាគី ទី បី ក្រោម ការ គ្រប់គ្រង ការ ចុះ ឈ្មោះ > Edit > ផ្នែក ថ្មី ៖ ព័ត៌មានវិញ្ញាបនប័ត្រ SSL (Update option)
2. ការចុះឈ្មោះអ្នកប្រើប្រាស់ Access ដោយខ្លួនឯងនឹងត្រូវបានធ្វើបច្ចុប្បន្នភាពដើម្បីរួមបញ្ចូលនូវព័ត៌មានវិក្កយបត្រជាមូលដ្ឋានដែលមានការអនុញ្ញាត, ព័ត៌មានអតិថិជន, និងទិន្នន័យឧស្ម័ន។ ទាំង interval ដែល បាន វាស់ ព្រម ទាំង កិច្ច ព្រម ព្រៀង សេវា ដែល មិន មាន ចន្លោះ ពេល នឹង មាន សិទ្ធិ ទទួល បាន ការ អនុញ្ញាត (self) សម្រាប់ SMD 2.0 សង្ខេប កម្រិត ខ្ពស់ នៃ ធាតុ ទិន្នន័យ ដែល ទើប តែ មាន ថ្មី ៗ នេះ មាន ដូច ខាង ក្រោម៖
   • Billing Info: (សម្រាប់ទាំង Interval និង non-interval metered SAs)
     • កាលវិភាគអត្រា, អត្រាការប្រាក់ $ សរុប, ការប្រើ Tiered (ជាការអនុវត្ត), តម្រូវការ (ជាការអនុវត្ត), TOU totals (as applicable)
     • ចំណាំ៖ សម្រាប់អតិថិជនដែលមិនមានចន្លោះដែលអនុញ្ញាត ភាគីទីបីនឹងទទួលបានអត្រាការប្រាក់សរុបប្រើប្រាស់ (i.e., in Usage Summary) និងគ្មានការប្រើប្រាស់អន្តរកាលអាន (ឧ., ម៉ោងអានតាមម៉ោង/ប្រចាំថ្ងៃតាមដែលមិនមាន)
   • ព័ត៌ មានអតិថិជន៖ (សម្រាប់ទាំងចន្លោះ និងមិនអន្តរកាល SAs)
     • ឈ្មោះអតិថិជន, Service Address, Account ID, Service Agreement ID, Service Agreement ID, Service Agreement service Start Date,
   • ទិន្នន័យប្រើប្រាស់ឧស្ម័ន Interval: (interval metered gas SAs only)
     • Interval (i.e., daily) ឧស្ម័នអាន
   • ធាតុ ទិន្នន័យ ថ្មី ត្រូវ បាន ដ្យាក្រាម ដូច ក្នុង មួយ ធាតុ ទិន្នន័យ ដែល បាន ភ្ជាប់, គាំទ្រ.xlsx
   • ឋានានុក្រមទិន្នន័យទាក់ទង Associated relational data ឋានានុក្រមទិន្នន័យត្រូវបានបង្ហាញនៅក្នុង attached, PGE ESPI Data Model.xlsx
   • និយមន័យ ESPI xml schema ចុង ក្រោយ បំផុត (XSDs) ដែល ប្រើ សម្រាប់ ធាតុ ទិន្នន័យ ថ្មី ទាំង នេះ គឺ ក្នុង មួយ XSDs ដែល បាន ភ្ជាប់ ។ ចំណាំ៖ XSDs មានលក្ខណៈត្រលប់ក្រោយគ្នា៖
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (ព័ត៌មានអតិថិជន)

អ្នកគួរតែមានសំណួរ ឬត្រូវការការគាំទ្របន្ថែម សូមមេត្តាមេត្តាជួយទំនាក់ទំនងយើងខ្ញុំដោយមិនគិតថ្លៃ ShareMyData@pge.com។

១៨ ធ្នូ ២០១៥
 

ត្រូវការការផ្លាស់ប្តូរ: បច្ចុប្បន្នភាព SMD 2.0 ដូចខាងក្រោមតម្រូវឱ្យមានការផ្លាស់ប្តូរផ្នែកនៃការអនុវត្ត CCA ។

1. Ad hoc requests (ឧទាហរហៈសម្រាប់ទិន្នន័យប្រវត្តិសាស្ត្រ) ត្រូវធ្វើឡើងដោយប្រើប៉ារ៉ាម៉ែត្រកាលបរិច្ឆេទ Zulu។ ទ្រង់ទ្រាយ កាលបរិច្ឆេទ ផ្សេង ទៀត សម្រាប់ ប៉ារ៉ាម៉ែត្រ កាលបរិច្ឆេទ ក្នុង សំណើ API នឹង មិន ត្រូវ បាន គាំទ្រ ឡើយ & # 160; ។
2. មតិ ព័ត៌មាន ប្រើប្រាស់ ជា ច្រើន ប្រចាំ ថ្ងៃ នឹង ចាប់ ផ្តើម រួម បញ្ចូល ព័ត៌មាន ចេញ ថ្លៃ មូលដ្ឋាន ខណៈ ដែល មតិ ព័ត៌មាន អតិថិ ជន ជា ច្រើន ប្រចាំ ថ្ងៃ នឹង រួម បញ្ចូល ព័ត៌មាន បន្ថែម របស់ អតិថិ ជន ។ ទិន្នន័យ ថ្មី នេះ នឹង ត្រូវ បាន ផ្តល់ ទាំង សម្រាប់ អតិថិជន ដែល បាន វាស់ ចន្លោះ ដែល ពួក គេ ទទួល ទិន្នន័យ សម្រាប់ ពេល បច្ចុប្បន្ន ក៏ ដូច ជា សម្រាប់ អតិថិជន ដែល មិន មែន ជា ម៉ែត្រ នៅ ក្នុង ទឹក ដី របស់ ពួក គេ ដែល ពួក គេ មិន ទទួល ទិន្នន័យ បច្ចុប្បន្ន ។ ចុង ក្រោយ តម្លៃ ប្រើប្រាស់ ចន្លោះ ពេល ដែល បាន ផ្តល់ ឲ្យ នៅ ក្នុង មតិ ព័ត៌មាន ប្រើប្រាស់ ជា ច្រើន ប្រចាំ ថ្ងៃ នឹង រួម បញ្ចូល ទាំង ការ ចង្អុល បង្ហាញ ចន្លោះ ពេល TOU ដែល អាច អនុវត្ត បាន ។ សង្ខេប កម្រិត ខ្ពស់ នៃ ធាតុ ទិន្នន័យ ថ្មី មាន ដូច ខាង ក្រោម ៖
   • Billing Info: (សម្រាប់ទាំង Interval និង non-interval metered SAs)
     • កាលវិភាគអត្រា, អត្រាការប្រាក់ $ សរុប, ការប្រើ Tiered (ជាការអនុវត្ត), តម្រូវការ (ជាការអនុវត្ត), TOU totals (as applicable)
   • (បន្ថែម) ព័ត៌ មានអតិថិជន៖ (សម្រាប់ទាំងចន្លោះ និងមិនអន្តរកាល SAs)
     • ឈ្មោះអតិថិជន, Service Address, Service Agreement service Start Date, Account ID
   • សូចនាករ Interval TOU រួមមានទិន្នន័យប្រើប្រាស់អគ្គិសនី Interval metered (ជាការអនុវត្ត, សូចនាករនៃអ្វីដែល TOU period each interval សមស្របទៅនឹង)
     • សូមយោងលើកម្មវិធី static Program ID Mappings ដែលលម្អិតអំពីអ្វីដែល interval TOU enumeration នីមួយៗត្រូវនឹង (ឧ. 1 = Summer Peak etc.).។ (មើល ភ្ជាប់, គាំទ្រធាតុទិន្នន័យ.xlsx)
   • និយមន័យ ESPI xml schema ចុង ក្រោយ បំផុត (XSDs) ដែល ប្រើ សម្រាប់ ធាតុ ទិន្នន័យ ថ្មី ទាំង នេះ គឺ ក្នុង មួយ XSDs ដែល បាន ភ្ជាប់ ។ ចំណាំ, XSDs ខាងក្រោយគឺសមស្របគ្នា:
     • espiDerived.xsd (Interval Usage and Billing Info)
     • retailcustomer.xsd (ព័ត៌មានអតិថិជន)
   • ធាតុ ទិន្នន័យ ថ្មី ត្រូវ បាន ដ្យាក្រាម ដូច ក្នុង មួយ ធាតុ ទិន្នន័យ ដែល បាន ភ្ជាប់, គាំទ្រ.xlsx
   • ឋានានុក្រមទិន្នន័យទាក់ទង Associated relational data ឋានានុក្រមទិន្នន័យត្រូវបានបង្ហាញនៅក្នុង attached, PGE ESPI Data Model.xlsx

ការលើកកំពស់ជម្រើស: ការ ផ្លាស់ ប្តូរ ខាង ក្រោម នេះ គឺ ឆប គ្នា ថយ ក្រោយ ហើយ ការ បង្កើន ដោយ ស្ម័គ្រ ចិត្ត ភាគី ទី បី អាច ជ្រើស រើស គាំទ្រ បាន ។

1. CCA's can make ad hoc requests for customer information at: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (returns latest snapshot of customer info at time of request) ក្រៅ ពី ការ ជូន ដំណឹង ប្រចាំ ថ្ងៃ ដែល បាន ទទួល។
2. CCA នឹង មាន សមត្ថភាព ផ្លាស់ ប្តូរ SSL របស់ ខ្លួន ដោយ ស្វ័យ ប្រវត្តិ ដែល ពួក គេ បាន ផ្ដល់ ដំបូង ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ (ឧ. ពេល ដែល ថ្ងាស ជិត ផុត កំណត់) តាម រយៈ ច្រក ទ្វារ ភាគី ទី ៣ ក្រោម ការ គ្រប់គ្រង ការ ចុះ ឈ្មោះ > Edit > ផ្នែក ថ្មី៖ ព័ត៌មានវិញ្ញាបនប័ត្រ SSL (Update option)

អ្នកគួរតែមានសំណួរ ឬត្រូវការការគាំទ្របន្ថែម សូមមេត្តាមេត្តាជួយទំនាក់ទំនងយើងខ្ញុំដោយមិនគិតថ្លៃ ShareMyData@pge.com។

ខែសីហា 21, 2015
 

អ្វីដែលថ្មី៖

1. ប៉ារ៉ាម៉ែត្រ រដ្ឋ និង ធនធាន URI ផ្លាស់ប្ដូរ ក្នុង ការ ឆ្លើយ តប របស់ Oauth
   • ជា ផ្នែក មួយ នៃ សំណើ កូដ អនុញ្ញាត របស់ OAuth ភាគី ទី បី មាន ជម្រើស ផ្ញើ នៅ ក្នុង ប៉ារ៉ាម៉ែត្រ រដ្ឋ ដែល PG&E នឹង បញ្ជូន ត្រឡប់ ទៅ ភាគី ទី បី វិញ ។ PG&E ក៏ នឹង ផ្ញើ កូដ អនុញ្ញាត ស្តី ពី ការ បញ្ចប់ ការ អនុញ្ញាត ដោយ ជោគជ័យ ផង ដែរ ។ ប៉ារ៉ាម៉ែត្រ រដ្ឋ ជម្រើស នេះ អាច ត្រូវ បាន ប្រើ ដើម្បី ជួយ ភាគី ទី បី ឲ្យ កំណត់ អត្ត សញ្ញាណ ពី កន្លែង ដែល សំណើ នេះ ត្រូវ បាន ផ្តួច ផ្តើម និង ភ្ជាប់ សំណើ ត្រឡប់ ទៅ នឹង ការ អនុញ្ញាត ដែល ពួក គេ បាន ផ្តួច ផ្តើម វិញ ។
   • ជា ផ្នែក មួយ នៃ ការ បញ្ចប់ ការ ស្នើ សុំ ថូខេន ដោយ ជោគ ជ័យ យើង ចែក រំលែក ធនធាន ត្រឡប់ មក វិញ និង ការ អនុញ្ញាត ឲ្យ មាន ការ អនុញ្ញាត ដាច់ ដោយ ឡែក ពី ព័ត៌មាន ថូខេន ។ បច្ចុប្បន្ន URIs ទាំង នេះ ត្រូវ បាន បង្វិល ហើយ ជា ផ្នែក មួយ នៃ ការ ចេញ ផ្សាយ នេះ យើង នឹង កែ តម្រូវ វា ។

កំហុសថេរ:

1. កាលបរិច្ឆេទ លំនាំដើម ដែល បាន បោះពុម្ព-max និង បោះពុម្ព-min
   បច្ចុប្បន្ន PG&E បង្គាប់ ឲ្យ ភាគី ទី បី ផ្ញើ នៅ ក្នុង ប៉ារ៉ាម៉ែត្រ ដែល បាន បោះ ពុម្ព ផ្សាយ និង បោះ ពុម្ព ផ្សាយ ក្នុង epoch seconds សម្រាប់ សំណើ ទិន្នន័យ នីមួយៗ ដើម្បី ប្រាប់ PG&E រយៈ ពេល ដែល ពួក គេ កំពុង ស្នើ សុំ ទិន្នន័យ ។ យើងកំពុងអនុវត្តការផ្លាស់ប្តូរដើម្បីដោះស្រាយសំណើសម្រាប់សាច់រឿងខាងក្រោម៖
   • តម្លៃ អតិបរមា ដែល បាន បោះពុម្ព ផ្សាយ និង បោះពុម្ព ផ្សាយ កំពុង បាត់
   • តម្លៃ អតិបរមា ដែល បាន បោះពុម្ព ផ្សាយ និង បោះពុម្ព ផ្សាយ គឺ នៅ ក្នុង UTC
   • តម្លៃ អតិបរមា ដែល បាន បោះពុម្ព ផ្សាយ និង បោះពុម្ព ផ្សាយ គឺ ស្ថិត នៅ ក្នុង វិនាទី epoch
   ក្នុង ករណី ដែល ប៉ារ៉ាម៉ែត្រ កំពុង បាត់ PG&E នឹង ត្រឡប់ កាលបរិច្ឆេទ លំនាំ ដើម វិញ ដែល ផ្ទុយ ទៅ នឹង សារ កំហុស ដូច ដែល បាន ត្រឡប់ មក វិញ មុន ពេល ការ ផ្លាស់ប្ដូរ នេះ ។ លំនាំ ដើម ក្នុង ករណី របស់ យើង គឺ ជា ទិន្នន័យ មួយ ថ្ងៃ សម្រាប់ កាល បរិច្ឆេទ T-2 ។ ប្រសិន បើ ប៉ារ៉ាម៉ែត្រ មាន វត្តមាន និង ទ្រង់ទ្រាយ ត្រឹមត្រូវ យើង នឹង បន្ត គោរព ប៉ារ៉ាម៉ែត្រ ។
2. ជួសជុល កាលបរិច្ឆេទ ក្នុង ការ អនុញ្ញាត xml
   បច្ចុប្បន្ននៅក្នុងការអនុញ្ញាត xml យើង shared the published date and authorization date. កាល បរិច្ឆេទ ទាំង នេះ គឺ នៅ ក្នុង មីល្លីវិនាទី ដែល ផ្ទុយ ទៅ នឹង វិនាទី ដែល ជា ស្តង់ដារ ។ យើង កំពុង ជួសជុល វា ដើម្បី បញ្ជូន ត្រឡប់ មក វិញ ក្នុង រយៈ ពេល ប៉ុន្មាន វិនាទី ជំនួស ឲ្យ មីល្លីវិនាទី ។
3. Incorrect XML បានត្រឡប់មកវិញសម្រាប់ /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   បច្ចុប្បន្ន យើង កំពុង ត្រឡប់ មក វិញ នូវ ការ ឆ្លើយ តប មិន ត្រឹមត្រូវ សម្រាប់ កម្រិត ធនធាន ខាង លើ GET ដែល រចនា សម្ព័ន្ធ របស់ XML មិន ត្រឹម ត្រូវ ហើយ យើង កំពុង ធ្វើ ការ ចូល ម្តង ទៀត សម្រាប់ ចន្លោះ ពេល នីមួយៗ ជំនួស ឲ្យ ការ បង្កើត ប្លុក ចន្លោះ ពេល តែ មួយ សម្រាប់ រយៈ ពេល 24 ម៉ោង ។
   
   នេះ ត្រូវ បាន ជួសជុល ហើយ មាន តែ ប្លុក ចន្លោះ ពេល តែ មួយ ប៉ុណ្ណោះ ដែល នឹង ត្រូវ បាន ត្រលប់ មក វិញ សំរាប់ ប្លុក ចន្លោះ ពេល 24 ។

សំណួរ ឬ កង្វល់ ? សូមទាក់ទង ShareMyData@pge.com។

• អតិថិជន អនុញ្ញាត ឲ្យ អ្នក ចូល ដំណើរ ការ ទិន្នន័យ របស់ ពួក គេ តាម រយៈ My Energy គណនី PG&E online របស់ ពួក គេ ។ សម្រាប់ ទិដ្ឋភាព ទូទៅ លម្អិត អំពី របៀប ដែល អតិថិជន អាច អនុញ្ញាត ឲ្យ ភាគី ទី បី ឬ អង្គភាព ផ្សេង ទៀត ចូល ទៅ កាន់ ទិន្នន័យ របស់ ពួក គេ សូម មើល ទិដ្ឋភាព Share My Data Third-Party Overview ។

ទៅ រក ព័ត៌មាន លម្អិត នៃ ការ អនុញ្ញាត

• បច្ចុប្បន្នគ្មានដែនកំណត់ទេ។

• អតិថិជនអាចជ្រើសរើសចំនួនពេលវេលាជាក់លាក់ដែលអ្នកអាចចូលទៅកាន់ទិន្នន័យរបស់ពួកគេឬពួកគេអាចទុករយៈពេលអនុញ្ញាតបើកចំហ។
• កម្មវិធីរបស់អ្នកអាចពិនិត្យមើលកាលបរិច្ឆេទបញ្ចប់នៃការអនុញ្ញាតរបស់អតិថិជន រួមជាមួយព័ត៌មានលំអិតនៃការអនុញ្ញាតផ្សេងទៀតដោយហៅធនធានការអនុញ្ញាត APIs (ឧ., .../espi/1_1/resource/Authorization and/or.../espi/1/1/resource/Authorization/{AuthorizationID}) ។
• ដូច គ្នា នេះ ដែរ អ្នក អាច ពិនិត្យ មើល កាលបរិច្ឆេទ បញ្ចប់ ការ អនុញ្ញាត ដោយ ដៃ ដោយ ចូល ទៅ ក្នុង គណនី របស់ អ្នក និង ជ្រើស រើស Manage Authorizations ។

• ប្រសិន បើ អតិថិជន ជ្រើស រើស រយៈ ពេល នៃ ការ អនុញ្ញាត ដែល បាន កំណត់ នោះ ការ អនុញ្ញាត របស់ ពួក គេ ផុត កំណត់ នៅ ចុង បញ្ចប់ នៃ រយៈ ពេល នោះ ។ ប្រសិន បើ ពួក គេ លុប ចោល ការ អនុញ្ញាត នោះ ការ អនុញ្ញាត របស់ ពួក គេ ផុត កំណត់ មួយ ថ្ងៃ បន្ទាប់ ពី ពួក គេ លុប ចោល ការ អនុញ្ញាត ។
• ប្រសិន បើ អតិថិជន ជ្រើស រើស Indefinite ជា រយៈ ពេល អនុញ្ញាត របស់ ពួក គេ នោះ ការ អនុញ្ញាត របស់ ពួក គេ មិន ផុត កំណត់ ទេ ។ កំណត់ ចំណាំ ក្នុង ការ ពិចារណា អំពី អ្នក ផ្តល់ ចម្លើយ តម្រូវ ការ ច្បាប់ 24 និង កម្ម វិធី ផ្សេង ទៀត ដោយ ប្រើ Share My Data បន្ទាប់ ពី ការ កែ តម្រូវ បន្ទាប់ ពី ការ កែ តម្រូវ បែប នេះ សម្រាប់ ជួរ កាល បរិច្ឆេទ ដែល បាន អនុញ្ញាត ពី មុន អាច ត្រូវ បាន ផ្តល់ ទៅ ភាគី ទី បី រហូត ដល់ បី ឆ្នាំ បន្ទាប់ ពី ការ អនុញ្ញាត ផុត កំណត់ ។
• សូមមើល "តើការកែតម្រូវទិន្នន័យនឹងដោះស្រាយយ៉ាងដូចម្តេច?" សម្រាប់ ព័ត៌មាន លម្អិត បន្ថែម អំពី ការ ទទួល បាន ការ កែ តម្រូវ ។

• អតិថិ ជន PG&E ណា មួយ ដែល មាន លេខ សម្គាល់ សេវា សកម្ម បច្ចុប្បន្ន សម្រាប់ ឧស្ម័ន ឬ សេវា អគ្គិសនី អាច អនុញ្ញាត ឲ្យ អ្នក ចូល ដំណើរ ការ ទិន្នន័យ របស់ ពួក គេ ដោយ ប្រើ ឧបករណ៍ Share My Data ថ្មី ។

• អតិថិជនដែលចាប់អារម្មណ៍ក្នុងការចូលរួមចែករំលែកទិន្នន័យរបស់ពួកគេតាមរយៈកម្មវិធី Share My Data ត្រូវបានលើកទឹកចិត្តយ៉ាងខ្លាំងក្នុងការចុះឈ្មោះសម្រាប់គណនី My Energy ។ នេះ នឹង ធ្វើ ឲ្យ ដំណើរ ការ ទាំង មូល កាន់ តែ មាន ប្រសិទ្ធិ ភាព និង ផ្តល់ ឲ្យ ពួក គេ នូវ សមត្ថ ភាព ក្នុង ការ គ្រប់ គ្រង ការ អនុញ្ញាត របស់ ពួក គេ តាម ប្រព័ន្ធ អ៊ីនធឺណិត ។
• អតិថិជន អាច ចុះ ឈ្មោះ សម្រាប់ គណនី ថាមពល របស់ ខ្ញុំ ក្នុង អំឡុង ពេល ដំណើរ ការ អនុញ្ញាត ។
• មានដំណើរការដោយដៃសម្រាប់អតិថិជនដើម្បីទទួលបាន Share My Data Authorization Form តាមអនឡាញនិងដាក់ស្នើសំណុំបែបបទដែលបានបំពេញតាមរយៈអ៊ីម៉ែល។
• សម្រាប់ ព័ត៌មាន បន្ថែម អំពី ដំណើរការ សៀវភៅ ដៃ សូម ទាក់ទង មក យើង នៅ ShareMyData@pge.com។

• អតិថិ ជន ត្រូវ បាន តម្រូវ ឲ្យ ធ្វើ ការ អនុញ្ញាត ផ្ទាល់ ខ្លួន របស់ ពួក គេ តាម រយៈ គណនី អនឡាញ PG&E របស់ ពួក គេ ។ ទោះ ជា យ៉ាង ណា ក៏ ដោយ ប្រសិន បើ ពួក គេ បញ្ចប់ និង ចុះ ហត្ថ លេខា លើ ទម្រង់ ការ អនុញ្ញាត ទិន្នន័យ របស់ Share My នោះ អ្នក អាច ដាក់ ជូន វា ទៅ PG&E ជំនួស ពួក គេ ។

ទាញយក Share My Data Customer Authorization or Revocation of Authorization form (PDF, 308 KB)

• អ្នកអាចធ្វើបច្ចុប្បន្នភាព OAuth URIs របស់អ្នកដោយចូលគណនីរបស់អ្នក, រុករកដើម្បីគ្រប់គ្រងការចុះបញ្ជី > Edit > និងធ្វើបច្ចុប្បន្នភាពវាលក្រោមដីផ្នែកព័ត៌មាន OAuth 2.0។

• លោកអ្នកអាចធ្វើបច្ចុប្បន្នភាព Notification URI របស់លោកអ្នកបានដោយចូលគណនីរបស់អ្នក, រុករកដើម្បីគ្រប់គ្រងការចុះបញ្ជី > Edit > និងការធ្វើបច្ចុប្បន្នភាពវាលក្រោមដីផ្នែកទិន្នន័យ Access Information ។

• អ្នកអាចធ្វើបច្ចុប្បន្នភាពវិញ្ញាបនប័ត្រ SSL របស់អ្នកដោយចូលគណនីរបស់អ្នក, រុករកដើម្បីគ្រប់គ្រងការចុះបញ្ជី > Edit > និងជ្រើសរើស "Update" នៅក្នុងផ្នែកព័ត៌មានវិញ្ញាបនប័ត្រ SSL។ ចំណាំថា សម្រាប់ការបង្ហោះវិញ្ញាបនបត្រថ្មី វាអាចចំណាយពេលច្រើនថ្ងៃដើម្បីធ្វើបច្ចុប្បន្នភាពប្រព័ន្ធ PG&E ជាមួយវិញ្ញាបនប័ត្រថ្មី។  
• អ៊ីម៉ែល បញ្ជាក់ ពី ក្រុម គាំទ្រ ទិន្នន័យ Share My នឹង ត្រូវ ផ្ញើ នៅ ពេល ដែល វិញ្ញាបនបត្រ ថ្មី ត្រូវ បាន អនុវត្ត ។

• នៅពេលលោកអ្នកទទួលបានអ៊ីម៉ែលដែលបង្ហាញពីការចុះឈ្មោះរបស់អ្នកត្រូវបានទទួលយក, អ្នកនឹងអាចចូលគណនីទិន្នន័យ Share My របស់អ្នកនិងទាញយកវិញ្ញាបនប័ត្រ SSLរបស់យើងតាមរយៈទំព័រមូលបត្រទាញយក PG&E SSL។

ចូល ទៅ ចែក រំលែក ទិន្នន័យ របស់ ខ្ញុំ

• Share My Data ធ្វើតាម Green Button Connect My Data implementation agreements. Share My Data ក៏ធ្វើការ OAuth 2.0 សម្រាប់ការអនុញ្ញាត, Security ស្រទាប់ដឹកជញ្ជូន (TLS) 1.2 និង ឈុតអប្បបរមានៃពិធីសារសុវត្ថិភាពអ៊ីនធើណែតដែលបានអនុម័តដោយ NIST (វិទ្យាស្ថានជាតិស្តង់ដានិងបច្ចេកវិទ្យា) ដូចជាមិនមានព័ត៌មានត្រូវបានផ្លាស់ប្តូរច្បាស់លាស់នោះទេ។

• ការការពារព័ត៌មានរបស់អតិថិជនគឺជាអាទិភាពខ្ពស់បំផុតសម្រាប់ PG&E. PG&E ចាត់ទុកព័ត៌មានអំពីអតិថិជនរបស់ពួកគេរួមទាំងព័ត៌មានផ្ទាល់ខ្លួន- ជាព័ត៌មានសម្ងាត់, សមស្របនឹងតម្រូវការច្បាប់និងបទប្បញ្ញត្តិទាំងអស់, រួមទាំងការដែលបង្កើតដោយគណៈកម្មការលទ្ធកម្មសាធារណៈរដ្ឋកាលីហ្វ័រនីញ៉ានិងអ្នកផ្សេងទៀត.  
• អស់ រយៈ ពេល ជាង ពីរ ទស វត្សរ៍ មក ហើយ PG&E និង ឧបករណ៍ ប្រើប្រាស់ ដែល ជា កម្ម សិទ្ធិ របស់ អ្នក វិនិយោគ ផ្សេង ទៀត នៅ រដ្ឋ កាលីហ្វ័រញ៉ា ត្រូវ បាន ទទួល បទ ប្បញ្ញត្តិ CPUC តឹង រឹង ខ្លាំង ណាស់ ដែល ហាម ឃាត់ ពួក គេ មិន ឲ្យ បង្ហាញ ព័ត៌មាន ជាក់លាក់ របស់ អតិថិ ជន ដូច ជា ការ បង់ ប្រាក់ ទិន្នន័យ ទៅ ភាគី ទី បី ដោយ គ្មាន ការ យល់ ព្រម យ៉ាង ច្បាស់ ពី អតិថិ ជន ។  
• នៅ ពេល ដែល អតិថិ ជន អនុញ្ញាត ឲ្យ ចេញ ផ្សាយ ទិន្នន័យ វា គឺ ជា ការ ទទួល ខុស ត្រូវ របស់ អតិថិ ជន និង ភាគី ទី បី ក្នុង ការ ការពារ ទិន្នន័យ នោះ ។
• អតិថិ ជន ម្នាក់ អាច ជ្រើស រើស បញ្ឈប់ ការ ចែក រំលែក ទិន្នន័យ ជាមួយ ភាគី ទី បី នៅ ពេល ណា ក៏ បាន ដោយ ចូល ទៅ ក្នុង គណនី អនឡាញ PG&E របស់ ពួក គេ និង លុប ចោល ការ អនុញ្ញាត របស់ ពួក គេ ។ PG&E's complete privacy policy and Notice of Accessing, Collecting, Storing, Using and Disclosing Energy Usage Information is available at pge.com/privacy.

• នៅ ក្នុង វិសាល ភាព នៃ កម្ម វិធី ទិន្នន័យ Share My ភាគី ទី បី ស្ថិត នៅ ក្រោម ច្បាប់ ឯក ជន និង ការពារ ទិន្នន័យ អតិថិ ជន ដែល បាន បញ្ជាក់ នៅ ក្នុង លក្ខខណ្ឌ និង លក្ខខណ្ឌ វេទិកា ទិន្នន័យ ចែក រំលែក របស់ ខ្ញុំ និង ចំពោះ តម្រូវ ការ ដែល បាន បញ្ចូល ក្នុង ពន្ធ ចូល ដំណើរ ការ ទិន្នន័យ អតិថិ ជន ។
• ភាគី ទី ៣ ក៏ ស្ថិត នៅ ក្រោម ច្បាប់ និង បទ ប្បញ្ញត្តិ ដែល អាច អនុវត្ត បាន ផ្សេងៗ ទៀត ទាក់ទង នឹង ការ ការពារ ភាព ឯកជន របស់ អតិថិជន រួម មាន ប៉ុន្តែ មិន កំណត់ ទេ ច្បាប់ ស្ដីពី ភាព ឯកជន និង ការ ការពារ សន្តិសុខ សម្រាប់ ទិន្នន័យ ប្រើប្រាស់ ថាមពល ដែល បាន អនុម័ត ដោយ CPUC ជា ឯកសារ ភ្ជាប់ D ទៅ នឹង សេចក្តី សម្រេច 11-07-056 (Electric) ក៏ បាន សង្ខេប ក្នុង ច្បាប់ អគ្គិសនី PG&E's Electric Rule លេខ ២៧។ និងក្រមរដ្ឋប្បវេណីកាលីហ្វ័រនីញ៉ា ភាគ 1798.80 – 1798.84។
• សម្រាប់ព័ត៌មានបន្ថែមសូមជ្រើសរើសតំណភ្ជាប់ខាងក្រោម៖
  ចែក រំលែក លក្ខខណ្ឌ និង លក្ខខណ្ឌ ទិន្នន័យ របស់ ខ្ញុំ (PDF, 190 KB)
  Electric Rule លេខ 27 (PDF, 1.6 MB)
  ភ្ជាប់ D ទៅ សេចក្តីសម្រេច 11-07-056 (PDF)
  រកព័ត៌មានបន្ថែម៖ ក្រមរដ្ឋប្បវេណីកាលីហ្វ័រនីញ៉ា ភាគ 1798.80 – 1798.84

• សូមយោងតំណភ្ជាប់ខាងក្រោម សម្រាប់បញ្ជីលម្អិតនៃធាតុទិន្នន័យដែលបានគាំទ្រ។

ទទួល បាន ព័ត៌មាន បន្ថែម អំពី ការ ចូល ដំណើរ ការ ទិន្នន័យ

• ជួនកាល ទិន្នន័យ ការ ប្រើប្រាស់ ចន្លោះ ពេល កំពុង បាត់ បង់ ព្រោះ ដំណើរ ការ សុពលភាព ទិន្នន័យ នៅ លើ ស្ទ្រីម របស់ យើង រក ឃើញ ថា មាន ទិន្នន័យ បាត់ ឬ មិន ត្រឹមត្រូវ ដែល អាច ទាមទារ ឲ្យ មាន ដំណើរការ បន្ថែម ទៀត (editing and or estimation) ។
• សម្រាប់ អតិថិជន ដែល បាន បង់ ថ្លៃ ចន្លោះ ពេល ( ឧទាហរណ៍ អតិថិជន ដែល មាន ការ ពិចារណា លើ ការ បង់ ប្រាក់ Time-of-Use ) ករណី ទាំង នេះ ត្រូវ បាន កែ តម្រូវ ទាន់ ពេល ដើម្បី ធានា ការ គណនា សេចក្តី ព្រាង ច្បាប់ ត្រឹម ត្រូវ លើ សេចក្តី ព្រាង ច្បាប់ ប្រចាំ ខែ ដែល នឹង មក ដល់ របស់ ពួក គេ ។

• ប្រសិន បើ អ្នក ចង់ ទទួល បាន ការ កែ តម្រូវ ទិន្នន័យ សូម ធានា ថា អ្នក ពិនិត្យ មើល Notify Me ជា Data គឺ Ready checkbox ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ ឬ ដោយ ចូល ទៅ កាន់ គណនី អនឡាញ របស់ អ្នក ហើយ ជ្រើស ប្រអប់ ត្រួត ពិនិត្យ នេះ នៅ ក្រោម Edit Profile ។ បន្ទាប់ មក យើង នឹង បញ្ចូល ការ កែ តម្រូវ ទិន្នន័យ ដែល ត្រូវ បាន ចាប់ ដោយ ប្រព័ន្ធ របស់ យើង ក្នុង អំឡុង ពេល 24 ម៉ោង មុន ដែល ជា ផ្នែក មួយ នៃ មតិ ព័ត៌មាន ប្រើប្រាស់ ប្រចាំ ថ្ងៃ សម្រាប់ ទិន្នន័យ ណា មួយ ដែល អ្នក ត្រូវ បាន អនុញ្ញាត ឲ្យ ចូល ដំណើរ ការ ។
• ការ កែ តម្រូវ ទិន្នន័យ នឹង គ្រប ដណ្តប់ លើ ការ ផ្លាស់ ប្តូរ ណា មួយ សម្រាប់ រយៈ ពេល ដែល បាន អនុញ្ញាត រហូត ដល់ អតិបរមា បី ឆ្នាំ ។

ចំណាំ៖ នៅក្នុងការពិចារណាលើ Rule 24 Demand Response Providers និងកម្មវិធីផ្សេងទៀត ដោយប្រើ Share My Data, បន្ទាប់ពីការកែតម្រូវតាមការពិតសម្រាប់កាលបរិច្ឆេទដែលបានអនុញ្ញាតពីមុនអាចត្រូវបានផ្តល់ជូនទៅភាគីទី 3 រហូតដល់ទៅ 3 ឆ្នាំបន្ទាប់ពីការផុតកំណត់នៃការអនុញ្ញាត។

• ប្រសិន បើ អាច អនុវត្ត បាន PG&E នឹង ផ្ញើ សេចក្ដី ជូន ដំណឹង ទៅ URL ជូន ដំណឹង របស់ អ្នក ដែល បាន ផ្ដល់ ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ ។ ការ ជូន ដំណឹង រួម មាន URLs ដែល ត្រូវ គ្នា ទៅ នឹង ទិន្នន័យ ដែល បាន រៀប ចំ ជា មុន រួច ទៅ ហើយ សម្រាប់ អ្នក ដើម្បី ត្រឡប់ មក វិញ និង ស្នើ សុំ នៅ URLs ដែល បាន ផ្តល់ ឲ្យ ។ ទិន្នន័យ ត្រូវ បាន កំណត់ ជា មុន និង ការ ជូន ដំណឹង ដែល បាន ផ្ញើ ចេញ នៅ ក្នុង ស្ថាន ភាព ពីរ ដូច ខាង ក្រោម នេះ : ( 1 ) អ្នក បាន ជ្រើស រើស " ជូន ដំណឹង ដល់ ខ្ញុំ ថា ជា ទិន្នន័យ រួច រាល់ ហើយ " នៅ ក្នុង ទម្រង់ ចុះ ឈ្មោះ របស់ អ្នក ក្នុង ករណី ដែល យើង នឹង កញ្ចប់ ទិន្នន័យ ប្រចាំ ថ្ងៃ ចុង ក្រោយ បំផុត ជាមួយ នឹង ការ កែ តម្រូវ សម្រាប់ កាល បរិច្ឆេទ កន្លង មក ឬ ( 2 ) អ្នក បាន ធ្វើ សំណើ ដ៏ គួរ ឲ្យ ភ្ញាក់ ផ្អើល ពី មុន ដែល ទិន្នន័យ ដែល បាន ស្នើ សុំ ឥឡូវ នេះ ត្រៀម រួច រាល់ ។ សាច់រឿងទី១ បង្ហាញពីក្រោម "DATA ACCESS: DAILY SUBSCRIPTION" ផ្នែកនៃ Data Access Methods diagrams on the Data Access Page and scenario 2 ត្រូវបានបង្ហាញក្រោម "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" ផ្នែកនៃឌីយ៉ាក្រាមដូចគ្នានេះក៏នៅលើទំព័រដំណើរការទិន្នន័យផងដែរ។

ចូលទៅកាន់ data access ខាងលើ

• ទិន្នន័យប្រើប្រាស់អគ្គិសនីដែលផ្តល់ដោយ Share My Data មិនមែនជាដំណោះស្រាយទិន្នន័យគុណភាព (SQMD) ដូចដែលបានបញ្ជាក់ដោយប្រតិបត្តិករប្រព័ន្ធឯករាជ្យកាលីហ្វ័រញ៉ា (CAISO)។ SQMD ត្រូវ បាន បង្កើត ឡើង ដោយ ការ បង្កើន ទិន្នន័យ ម៉ែត្រ គុណ ភាព ប្រាក់ ចំណូល ( RQMD ) ដោយ កត្តា ខាត បង់ ចែក ចាយ ( DLF ) ដែល អាច អនុវត្ត បាន ចំពោះ កម្រិត វ៉ុល របស់ អតិថិ ជន នោះ សម្រាប់ ចន្លោះ នោះ ដោយ បម្លែង ចន្លោះ ពេល ដែល បាន វាស់ ទៅ រយៈ ពេល ចន្លោះ ដែល តម្រូវ ដោយ CAISO ហើយ បន្ទាប់ មក សង្ខេប លទ្ធ ផល សម្រាប់ ចន្លោះ ពេល នីមួយ ៗ ទៅ កម្រិត សរុប ដែល តម្រូវ ដោយ CAISO ។
  
• PG&E កំពុងអនុវត្តទង់ជាតិនៃប្រភេទ "QualityOfReading" (QOR) ដែលផ្តល់ដោយស្តង់ដារ ESPI ដើម្បីទាក់ទងថាតើទិន្នន័យគឺជាគុណភាពនៃប្រាក់ចំណូលឬយ៉ាងណា។ ប្រភេទ QOR ចាប់ យក តម្លៃ គុណ ភាព ផ្សេង គ្នា សម្រាប់ ទិន្នន័យ ប្រើប្រាស់ រួម មាន តម្លៃ ជាក់លាក់ មួយ សម្រាប់ "ទិន្នន័យ គុណភាព ប្រាក់ ចំណូល" ឬ "RQMD"។ PG&E នឹង ប្រើ ប្រភេទ QOR នេះ ក្នុង ការ បញ្ជូន ទិន្នន័យ របស់ វា ដូច ខាង ក្រោម៖
  • PG&E គាំទ្រ ESPI បាន ផ្តល់ នូវ ថ្នាក់ "UsageSummary" ដែល នឹង ត្រូវ បាន ប្រើ ដើម្បី កំណត់ អត្តសញ្ញាណ កាលបរិច្ឆេទ ដែល កិច្ច ព្រម ព្រៀង សេវា ត្រូវ បាន វិក្កយបត្រ ចំនួន ប្រើប្រាស់ ដែល បាន ចេញ វិក្ក័យបត្រ និង គុណភាព ទិន្នន័យ ប្រើប្រាស់ នៅ ពេល មាន ការ ស្នើ សុំ។ ការប្រើប្រាស់Summary នឹង មាន ប្រជា ជន នៅ ពេល ដែល សេចក្តី ព្រាង ច្បាប់ នេះ មាន សម្រាប់ ទិន្នន័យ ដែល បាន ស្នើ សុំ ហើយ នឹង បញ្ចូល ទង់ ជាតិ ចំនួន ពីរ (ធាតុ) នៃ ប្រភេទ QOR៖
    • ធាតុប្រើប្រាស់Summary.QualityOfReading (នៅកម្រិត UsageSummary) ចង្អុលបង្ហាញពីគុណភាពនៅពេលស្នើសុំតម្លៃប្រើប្រាស់ចន្លោះពេលចុងក្រោយបំផុត បូកនឹងការកែតម្រូវដែលស្របទៅនឹងកាលបរិច្ឆេទ UsageSummary.billingPeriod ។
    • ធាតុ DefaultQuality សម្រាប់ OverallConsumptionLastPeriod (ជាផ្នែកមួយនៃការប្រើប្រាស់Summary.OverallConsumptionLastPeriod.ReadingTypeRef) បង្ហាញពីគុណភាពនៃការប្រើប្រាស់វិក្កយបត្រសរុប។
  • PG&E ក៏នឹងទំនាក់ទំនងនូវគុណភាពនៃទិន្នន័យប្រើប្រាស់នៅកម្រិតចន្លោះពេលស្នើសុំប្រើប្រាស់ IntervalReading.ReadingQuality.Quality element ផងដែរ។

• ក្នុង អំឡុង ពេល ចុះ ឈ្មោះ អ្នក អាច ជ្រើស ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ដែល អ្នក ត្រូវការ ទាំង 24, 36 ឬ 48 ខែ ក្រោម " ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ត្រូវ បាន ស្នើ " ការ ធ្លាក់ ចុះ ។
• ជា ផ្នែក មួយ នៃ ការ អនុញ្ញាត របស់ អតិថិ ជន ដែល អនុញ្ញាត ឲ្យ អ្នក ចូល ដំណើរ ការ ទិន្នន័យ របស់ ពួក គេ រយៈ ពេល ប្រវត្តិ សាស្ត្រ សម្រាប់ ការ អនុញ្ញាត នឹង ត្រូវ បាន បន្ធូរ បន្ថយ ទៅ ការ ជ្រើស រើស ចុះ ឈ្មោះ របស់ អ្នក សម្រាប់ សេវា IDs ( ចំណុច ប្រើប្រាស់ ) ដែល រួម បញ្ចូល ក្នុង ការ អនុញ្ញាត ។
• អ្នក អាច ធ្វើ បច្ចុប្បន្នភាព ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ដែល បាន ស្នើ ដោយ ចូល ទៅ ក្នុង គណនី របស់ អ្នក ដោយ រុករក ដើម្បី គ្រប់គ្រង ការ ចុះ ឈ្មោះ > Edit > និង ការ ជ្រើស រើស ពី dropdown ដែល មាន ស្លាក ថា "តើ ទិន្នន័យ ប្រវត្តិ សាស្ត្រ ប៉ុន្មាន ត្រូវ បាន ស្នើ"។
• សូមបញ្ជាក់ថា ទិន្នន័យដែលបានផ្តល់ក្នុងការស្នើសុំជាប្រវត្តិសាស្ត្រ នឹងចាប់ផ្ដើមពីកាលបរិច្ឆេទដែលអតិថិជនធ្វើលិខិតអនុញ្ញាត ផ្ទុយទៅនឹងកាលបរិច្ឆេទដែលលោកអ្នកធ្វើការស្នើសុំទៅ API។

ចំណាំ៖ ការផ្លាស់ប្តូរទិន្នន័យប្រវត្តិសាស្ត្រដែលបានស្នើសុំរបស់អ្នកតែប៉ះពាល់ដល់ការអនុញ្ញាតរបស់អតិថិជនថ្មីប៉ុណ្ណោះ ខណៈដែលការអនុញ្ញាតពីអតិថិជនមុននឹងឆ្លុះបញ្ចាំងពីការជ្រើសរើសរបស់អ្នកនៅពេលមានការអនុញ្ញាត។

• ជា ស្តង់ដារ ESPI ការ ឆ្លើយ តប នេះ ប្រើ ស្តង់ដារ ការ បោះ ពុម្ព ផ្សាយ អាតូម ។ សូម ជ្រើស តំណ ខាង ក្រោម ដើម្បី មើល បញ្ជី ពេញលេញ នៃ APIs ដែល ត្រូវ បាន គាំទ្រ រួម ជាមួយ ធាតុ ទិន្នន័យ ដែល មាន ។

ទទួល បាន ព័ត៌មាន បន្ថែម អំពី ការ ចូល ដំណើរ ការ ទិន្នន័យ

• សេវាអគ្គិសនី និងឧស្ម័នសកម្ម IDs ដែលដំឡើង និងអានដោយ PG&E មានសិទ្ធទទួលការអនុញ្ញាតតាមរយៈវេទិកា Share My Data។
• ប្រសិន បើ លេខ សម្គាល់ សេវា ដែល ទាក់ ទង នឹង ការ ផ្លាស់ ប្តូរ ការ អនុញ្ញាត ដោយសារ ហេតុ ផល មួយ ក្នុង ចំណោម ហេតុ ផល ដូច ខាង ក្រោម នេះ ការ អនុញ្ញាត នឹង ផ្លាស់ ប្តូរ ទៅ លេខ សម្គាល់ សេវា ថ្មី និង ការ ចូល ទៅ កាន់ ទិន្នន័យ ប្រើប្រាស់ ចន្លោះ ពេល ប្រវត្តិ សាស្ត្រ នឹង បន្ត :
  • ការ បិទ ជា បណ្តោះ អាសន្ន ដោយសារ តែ ការ មិន បង់ ប្រាក់
  • ផ្លាស់ទី ទៅ ការ ចេញ វិក្ក័យបត្រ អន្តរកាល
  • ការផ្លាស់ប្តូរម៉ែត្រ
  • ការ ផ្លាស់ប្ដូរ អត្រា
• ស្ថានភាព ផ្សេង ទៀត ដែល នាំ ឲ្យ មាន ការ ផ្លាស់ ប្តូរ ក្នុង លេខ សម្គាល់ សេវា ដូច ជា ការ ផ្លាស់ ប្តូរ ទី តាំង ឬ ការ ផ្លាស់ ប្តូរ របស់ ក្រុម ហ៊ុន នឹង បញ្ចប់ ការ ចូល ដំណើរ ការ ។ លើស ពី នេះ ទៀត ប្រសិន បើ គណនី មួយ មិន ត្រូវ បាន ភ្លឹបភ្លែត ពី គណនី ថាមពល របស់ អ្នក នោះ សេវា IDs ដែល គូស បញ្ជាក់ ទាំង អស់ ដែល ត្រូវ បាន អនុញ្ញាត តាម រយៈ Share My Data នឹង មិន ត្រូវ បាន អនុញ្ញាត ជា លទ្ធ ផល ឡើយ ។

• ដើម្បីកំណត់អំពីភាពក្រានីតនៃទិន្នន័យចន្លោះដែលមានការអនុញ្ញាត សូមយោងធាតុ Interval Length ដូចដែលបានផ្តល់ដោយស្តង់ដារ ESPI។
• PG&E កំពុង ផ្តល់ ទិន្នន័យ ប្រើប្រាស់ ចន្លោះ ពេល នៅ ក្នុង ក្រានីធី ដូច គ្នា នឹង ការ ប្រមូល សម្រាប់ គោល បំណង ចេញ វិក្ក័យបត្រ ដែល ជា ទូទៅ មាន មូលដ្ឋាន ប្រចាំ ម៉ោង ឬ 15 នាទី សម្រាប់ ទិន្នន័យ អគ្គិសនី និង ប្រចាំ ថ្ងៃ សម្រាប់ ទិន្នន័យ ឧស្ម័ន សម្រាប់ អតិថិ ជន ទាំង នោះ ដែល មាន ម៉ែត្រ ចន្លោះ ពេល ។ ចំណែក ឯ ការ ប្រើប្រាស់ ចរន្ត អគ្គិសនី ជា ទូទៅ អាច មាន នៅ កម្រិត ម៉ោង សម្រាប់ អតិថិជន ដែល មាន ទីលំនៅ ភាគ ច្រើន និង នៅ កម្រិត ចន្លោះ ពេល ១៥ នាទី សម្រាប់ អតិថិជន ពាណិជ្ជ កម្ម ភាគ ច្រើន ហើយ ការ ប្រើ ប្រាស់ ចន្លោះ វាស់ ឧស្ម័ន ជា ទូទៅ មាន នៅ កម្រិត ប្រចាំ ថ្ងៃ សម្រាប់ អតិថិជន ភាគ ច្រើន។
• សម្រាប់ មិន មែន ម៉ែត្រ ចន្លោះ ទិន្នន័យ នឹង ត្រូវ បាន ផ្តល់ ឲ្យ នៅ ពេល មាន & # 160; ។

• សម្រាប់អតិថិជនភាគច្រើននៃ PG&E ដែលមាន Smart Meter ដំឡើងទិន្នន័យប្រើប្រាស់អគ្គិសនីនិងឧស្ម័នគឺអាចរកបាននៅចុងបញ្ចប់នៃថ្ងៃបន្ទាប់តាមរយៈវេទិកា Share My Data។
• ចំណែក តូច នៃ អតិថិជន អគ្គិសនី PG&E ដែល មាន ក្រុមហ៊ុន ដឹក ជញ្ជូន ខ្សែ ថាមពល មាន មូលដ្ឋាន លើ MV90 ម៉ែត្រ ដែល បាន ដំឡើង អាច ទាមទារ ពេល វេលា បន្ថែម សម្រាប់ ទិន្នន័យ អាច រក បាន។

• ទោះបី ជា យើង មិន អាច គាំទ្រ ដោយ ផ្ទាល់ ដល់ ការ រៀបចំ APIs របស់ អ្នក ក៏ ដោយ យើង មាន ធនធាន មួយ ចំនួន ដែល អាច រក បាន ដើម្បី ជួយ ដល់ IT និង ធនធាន បច្ចេកទេស របស់ អ្នក ក្នុង ដំណើរ ការ អភិវឌ្ឍន៍ ។ សូមយោងទំព័រឯកសារ API របស់យើងដើម្បីរៀនបន្ថែម។ សូមមេត្តាជួយទំនាក់ទំនង ShareMyData@pge.com ជាមួយសំណួរបន្ថែមណាមួយ។

សម្រាប់ព័ត៌មានបន្ថែមសូមចូលទៅកាន់ programming interface (API)