แบ่งปันข้อมูลของฉันสําหรับบุคคลที่สาม

เพื่อให้สอดคล้องกับมาตรฐานการอนุญาตปัจจุบันของ North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) PG&E จึงได้ใช้กรอบการอนุญาต OAuth 2.0 เพื่ออนุญาตการเข้าถึงข้อมูล แผนภาพด้านล่างแสดงวิธีการเริ่มต้นการอนุญาตของลูกค้า เลือกพารามิเตอร์ขอบเขต แล้วส่งการอนุญาตของพวกเขา

เอกสารอ้างอิงเพิ่มเติมนอกเหนือจากข้อมูลด้านล่าง:

ดาวน์โหลดแผนผังลําดับ ESPI OAuth 2.0 (PDF, 193 KB)
ดู SDK ข้อมูลปุ่มสีเขียวที่ Github

หมายเหตุ: สําหรับผู้รวบรวมตัวเลือกชุมชน เฉพาะไคลเอ็นต์_access_token เท่านั้นที่จําเป็นสําหรับการร้องขอข้อมูล (ผ่าน OAuth 2-Legged) และต่อไปนี้ใช้ไม่ได้

การอนุญาตที่เริ่มดําเนินการที่ไซต์ของบุคคลภายนอก

ในการเริ่มการอนุญาตจากไซต์ของบุคคลที่สามดังที่แสดงในแผนภาพแรกข้างต้น จะมีการขอรหัสการอนุญาตโดยเปลี่ยนเส้นทางเบราว์เซอร์ของลูกค้าจากไซต์ของบุคคลที่สามของคุณไปยัง URL ของจุดยุติการอนุญาตเซิร์ฟเวอร์ของ PG&E ด้วยพารามิเตอร์คําขอที่เหมาะสมดังตัวอย่างด้านล่าง เมื่อมีการเปลี่ยนเส้นทาง ลูกค้าจะได้รับหน้าเข้าสู่ระบบของ PG&E สําหรับการรับรองความถูกต้อง ตามด้วยหน้าการอนุญาตสําหรับการอนุญาตให้เข้าถึงข้อมูลไปยังบุคคลที่สามของคุณ:

authorizationServerAuthorizationEndpoint URI (พร้อมพารามิเตอร์คําขอ)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• พารามิเตอร์คําขอที่บังคับ:
  • Client_id = Client ID จากขั้นตอนการลงทะเบียน Share My Data ของคุณ (เช่น Client_id/client_secret pair)
  • redirect_uri = URL เปลี่ยนเส้นทางที่คุณระบุไว้ในการลงทะเบียนแชร์ข้อมูลของฉัน (URL ต้องตรงกัน)
    หมายเหตุ: เราขอแนะนําให้ใช้การเข้ารหัส URL กับ redirect_uri ตามตัวอย่างด้านล่าง
  • การตอบสนอง_ประเภท = รหัส (ค่าคงที่)
• พารามิเตอร์คําขอทางเลือก (ต่างๆ):
  • สถานะ = พารามิเตอร์สถานะทึบแสงที่เป็นทางเลือกตามที่มาตรฐาน OAuth 2.0 อนุญาต ซึ่งถูกส่งกลับพร้อมรหัสการอนุญาตเพื่อช่วยคงสถานะไว้ ตัวอย่างเช่น บุคคลภายนอกอาจใช้พารามิเตอร์สถานะเพื่อระบุต้นกําเนิดของลูกค้าที่ไม่ซ้ํากันและเพื่อป้องกันการปลอมแปลงข้ามไซต์
  • เข้าสู่ระบบ={guest} ให้ตัวเลือกสําหรับบุคคลที่สามในการเปลี่ยนทิศทางลูกค้าไปยังการเข้าสู่ระบบ My Energy ของ PG&E หรือแท็บ Guest Access ซึ่งเป็นส่วนหนึ่งของขั้นตอนการอนุมัติทางออนไลน์

ตัวอย่าง: คําขอรหัส Auth

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

หมายเหตุ: ตัวอย่างพารามิเตอร์ redirect_uri ข้างต้นมีการเข้ารหัส URL ที่ใช้ (เช่น การเข้ารหัส URL ของ 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;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

หมายเหตุ: รหัสการอนุญาตมีอายุสั้น (หมดอายุใน 600 วินาที) และต้องแลกเปลี่ยนเป็นคู่โทเค็นการเข้าถึง/รีเฟรชโทเค็นในภายหลังเพื่อให้การอนุญาตเสร็จสมบูรณ์และอนุญาตให้เข้าถึงข้อมูลได้อย่างต่อเนื่อง ดูส่วนถัดไป (ส่วนที่ 2) สําหรับรายละเอียดเกี่ยวกับคําขอโทเค็นการเข้าถึง/รีเฟรชโทเค็น

พารามิเตอร์ขอบเขต (ที่ได้รับอนุญาต) ที่เป็นตัวอย่างข้างต้นจะถูกส่งกลับโดยเป็นส่วนหนึ่งของการตอบสนองต่อคําขอรหัสการอนุมัติ คําขอโทเค็นการเข้าถึง รวมถึง API การอนุญาต พารามิเตอร์ขอบเขตนี้ช่วยให้สามารถสื่อสารขอบเขตสุดท้ายของการอนุญาตของลูกค้าได้ โดยเฉพาะอย่างยิ่ง พารามิเตอร์ขอบเขตจะรวมถึงค่า "ขอบเขตเพิ่มเติม" ที่แม็ปกับการเลือกกลุ่มข้อมูลที่ได้รับอนุญาตของลูกค้าที่สนับสนุนโดย PG&E (เช่น "การใช้งาน" "การเรียกเก็บเงิน" "พื้นฐาน" "บัญชี" "การลงทะเบียนโปรแกรม") ค่าพารามิเตอร์ขอบเขตจะถูกบันทึกเพิ่มเติมตามเอกสารอ้างอิงต่อไปนี้:ดาวน์โหลดสตริงบล็อคฟังก์ชันที่รองรับ คลิก Thru 2.0 (PDF, 222 KB)

สถานการณ์ข้อผิดพลาด

ข้อผิดพลาดในการดําเนินการของบุคคลที่สาม: หากพารามิเตอร์คําขอที่จําเป็นของ Client_id หรือ redirect_uri ไม่ถูกต้องหรือขาดหายไปเมื่อขอรหัสการอนุญาต ลูกค้าจะแสดงข้อความอธิบายพร้อมกับข้อผิดพลาดมาตรฐาน HTTP 400 series ในทํานองเดียวกัน หากพารามิเตอร์คําขอที่จําเป็นของ Response_type ขาดหายไปหรือไม่ถูกต้อง ลูกค้าจะถูกนํากลับไปยัง redirect_uri ของคุณด้วยพารามิเตอร์ข้อผิดพลาด "invalid_request" ที่กําหนดไว้ของ OAuth 2.0 รวมถึงพารามิเตอร์สถานะทางเลือกหากได้ให้ไว้ครั้งแรกเป็นส่วนหนึ่งของคําขอรหัสการอนุญาตเดิม

ลูกค้าปฏิเสธที่จะอนุมัติ: เมื่อบุคคลที่สามเปลี่ยนเส้นทางลูกค้าให้อนุมัติกับ PG&E ลูกค้ามีตัวเลือกในการปฏิเสธผ่านปุ่ม "ยกเลิก" ทั้งในหน้าเข้าสู่ระบบและหน้าการอนุญาต ในกรณีดังกล่าว ลูกค้าจะถูกนํากลับไปยัง redirect_uri ของคุณโดยมีพารามิเตอร์ข้อผิดพลาด "access_denied" ที่กําหนดไว้ของ OAuth 2.0 ที่เพิ่มเข้ามาเพื่อระบุว่าลูกค้าปฏิเสธที่จะอนุมัติ นอกจากนี้ พารามิเตอร์สถานะทางเลือกจะถูกส่งคืนหากให้ไว้ครั้งแรกโดยเป็นส่วนหนึ่งของคําขอรหัสการอนุญาตเดิม

การอนุญาตเริ่มต้นที่ PG&E

เมื่อลูกค้าเริ่มต้นในเว็บพอร์ทัลลูกค้าของ PG&E "บัญชีของคุณ" แล้วไปยังหน้าแรกของแชร์ข้อมูลของฉัน พวกเขาจะแสดงรายการแบบเลื่อนลงของบุคคลที่สามที่ลงทะเบียนและมองเห็นได้ ดังที่แสดงในแผนภาพที่สองข้างต้น เมื่อลูกค้าเลือกบุคคลภายนอกจากรายการบุคคลภายนอกที่ลงทะเบียนและเลือก "ถัดไป" ลูกค้าจะถูกนําไปยัง "URI พอร์ทัลบุคคลภายนอก" ที่ลงทะเบียนไว้ของบุคคลภายนอก ซึ่งเป็นจุดที่ลูกค้าสามารถดําเนินการตามกระบวนการ OAuth ที่ริเริ่มโดยบุคคลภายนอกดังที่อธิบายไว้ในหัวข้อก่อนหน้านี้

หมายเหตุ: บุคคลที่สามบางรายได้สอบถามเกี่ยวกับวิธีการปรับปรุงประสบการณ์ของลูกค้าสําหรับกรณีการใช้งานนี้ (กล่าวคือ การอนุญาตที่เริ่มต้นบนเว็บไซต์ของ PG&E) เพื่อให้ลูกค้าดูเหมือนว่าพวกเขาจะถูกนําไปยังหน้าการอนุญาตโดยตรงเมื่อเลือกบุคคลที่สามจากรายการแบบเลื่อนลง เพื่ออํานวยความสะดวกให้กับประสบการณ์ของลูกค้าดังกล่าว บุคคลที่สามสามารถเลือกที่จะตั้งค่า "พอร์ทัลบุคคลที่สาม URI" ของตน (ผ่านหน้า แบ่งปันข้อมูลของฉัน จัดการการลงทะเบียน) ไปยังปลายทางที่นําลูกค้ากลับไปยัง PG&E โดยอัตโนมัติ ซึ่งเป็นส่วนหนึ่งของคําขอรหัสการอนุญาต เมื่อเปลี่ยนเส้นทางโดยอัตโนมัติไปยังจุดยุติการอนุญาตเซิร์ฟเวอร์ของ PG&E ลูกค้าจะข้ามหน้าเข้าสู่ระบบของลูกค้า (เนื่องจากเข้าสู่ระบบแล้ว) และจะไปที่หน้าการอนุญาตโดยตรง สําหรับบุคคลที่สามบางรายที่ได้ลงทะเบียนก่อนการเปิดตัว Share My Data คลิก Thru 2.0 ในปลายเดือนมิถุนายน 2018 สามารถทําได้โดยเพียงแค่กําหนด URI พอร์ทัลบุคคลที่สามให้เท่ากับ "หน้าจอการเลือกขอบเขตของบุคคลที่สาม" URI ที่ไม่ได้ใช้อีกต่อไป (ฟิลด์ที่จะเกษียณในการเปิดตัวในอนาคต)

ในทางตรงกันข้าม บุคคลที่สามบางรายอาจต้องการว่าจ้างและคัดกรองลูกค้าในด้านของตนก่อนเมื่อลูกค้าถูกเปลี่ยนเส้นทางไปยัง URI ของ "พอร์ทัลบุคคลที่สาม" ก่อนที่จะขอรหัสอนุญาต ดังนั้นวิธีการข้างต้นจึงเป็นเพียงคําแนะนําเท่านั้น

ในการรับโทเค็นการเข้าถึง ให้ใช้รหัสการอนุญาตที่ได้รับและโทรหาจุดสิ้นสุดด้านล่างพร้อมพารามิเตอร์การร้องขอตามที่อธิบายไว้ด้านล่าง ตามที่อธิบายไว้ข้างต้น รหัสการอนุญาตมีอายุใช้งานสั้น ๆ และจะหมดอายุหลังจาก 10 นาที (600 วินาที) ดังนั้นโปรดตรวจสอบให้แน่ใจว่าได้ขอโทเค็นการเข้าถึงทันทีเมื่อได้รับรหัสการอนุญาต

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

• พารามิเตอร์คําขอที่บังคับ:
  • grant_type = authorization_code (ค่าคงที่)
  • รหัส = รหัสการอนุญาตที่ได้รับเพื่อตอบสนองต่อคําขอรหัสการอนุญาต
  • redirect_uri = URL เปลี่ยนเส้นทางที่คุณระบุไว้ในการลงทะเบียนแชร์ข้อมูลของฉัน (URL ต้องตรงกัน)
    หมายเหตุ: เช่นเดียวกับคําขอรหัสการอนุญาต เราขอแนะนําให้ใช้การเข้ารหัส URL กับ redirect_uri

ตัวอย่าง: เข้าถึงคําขอโทเค็น
โพสต์: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

เพิ่มพารามิเตอร์ส่วนหัวการอนุมัติพื้นฐานด้วยการเข้ารหัส Base64 ที่ใช้ "clientID:clientSecret"

หมายเหตุ: ค่า ClientId:clientSecret สอดคล้องกับค่า ClientID ที่ให้ไว้ในเหตุการณ์สําคัญในการลงทะเบียน Share My Data ของคุณ
พารามิเตอร์ส่วนหัวจะอยู่ในรูปแบบต่อไปนี้:
ชื่อ Param : การอนุญาต
ค่าพาราม : "สตริงที่เข้ารหัสbase64" พื้นฐาน

คําตอบที่ประสบความสําเร็จจะมีลักษณะดังนี้:

774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
998c6654-5b3b-4385-af4f-4e5c46c1bb04
<ขอบเขต> scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollmentระยะเวลาระหว่างช่วง=900_3600;ระยะเวลาการล็อก=ทุกวัน;ความยาวประวัติ={3P ความยาวประวัติที่ลงทะเบียน};การสะสมบัญชี={จํานวน SA ที่ได้รับอนุญาต};BR={ID บุคคลที่สาม};รหัสผู้พิทักษ์ข้อมูล=PGE
resourceURI:{ResourceURI} เช่น: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} เช่น: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
CustomerResourceURI:{customerResourceURI} เช่น:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

หมายเหตุ: โทเค็นการเข้าถึงจะหมดอายุใน 3600 วินาที (1 ชั่วโมง) ในขณะที่โทเค็นรีเฟรชที่เกี่ยวข้องจะหมดอายุใน 1 ปี ดูข้อ 3 ถัดไปสําหรับรายละเอียดเกี่ยวกับการรับคู่โทเค็นการเข้าถึง/โทเค็นรีเฟรชใหม่

บันทึกการเข้าถึงและรีเฟรชคู่โทเค็น
หากต้องการขอข้อมูลประวัติเบื้องต้นและข้อมูลประจําวันต่อเนื่อง โปรดไปที่ การเข้าถึงข้อมูล

ตามแนวทางปฏิบัติที่ดีที่สุด โทเค็นการเข้าถึงเป็นโทเค็นที่มีอายุการใช้งานสั้น (1 ชั่วโมง) ในขณะที่โทเค็นรีเฟรชที่เกี่ยวข้องเป็นโทเค็นที่มีอายุการใช้งานยาวนาน (1 ปี) ที่คุณสามารถใช้เพื่อได้รับคู่โทเค็นการเข้าถึง/โทเค็นรีเฟรชใหม่เมื่อโทเค็นการเข้าถึงหมดอายุ หากต้องการขอรับ Access Token ใหม่และคู่ Refresh Token สําหรับการอนุญาตที่ยังไม่หมดอายุที่มีอยู่ ให้ใช้ "โทเค็นรีเฟรชปัจจุบัน" และโทรหาจุดสิ้นสุดด้านล่างพร้อมพารามิเตอร์ตามที่อธิบายไว้ด้านล่าง

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

ตัวอย่าง: รีเฟรชคําขอโทเค็น
โพสต์: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

เพิ่มพารามิเตอร์ส่วนหัวการอนุมัติพื้นฐานด้วยการเข้ารหัส Base64 ที่ใช้ "clientID:clientSecret"

หมายเหตุ: ค่า ClientId:clientSecret สอดคล้องกับค่า ClientID ที่ให้ไว้ในเหตุการณ์สําคัญในการลงทะเบียน Share My Data ของคุณ
พารามิเตอร์ส่วนหัวจะอยู่ในรูปแบบต่อไปนี้:
ชื่อ Param : การอนุญาต
ค่าพาราม : "สตริงที่เข้ารหัสbase64" พื้นฐาน

คําตอบที่ประสบความสําเร็จจะมีลักษณะดังนี้:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"ประเภท_โทเค็น": "Bearer",
"expires_in": 3600,
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"ขอบเขต": "scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_
โปรแกรมการลงทะเบียน;ระยะเวลาระหว่างรอบ=900_3600;ระยะเวลาล็อก=ทุกวัน;ระยะเวลาประวัติ={ความยาวประวัติที่ลงทะเบียน 3P};การสะสมบัญชี={จํานวน SA ที่ได้รับอนุญาต};BR={ThirdPartyID};dataCustodianId=PGE",
"ทรัพยากรURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
"การอนุญาตURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

หมายเหตุ: ในทํานองเดียวกัน โทเค็นการเข้าถึงไคลเอ็นต์เป็นโทเค็นที่มีอายุการใช้งานสั้น (1 ชั่วโมง) ในขณะที่โทเค็นรีเฟรชที่สอดคล้องกันเป็นโทเค็นที่มีอายุการใช้งานยาวนาน (1 ปี) ที่คุณสามารถใช้เพื่อได้รับคู่โทเค็นการเข้าถึงไคลเอ็นต์/โทเค็นรีเฟรชเมื่อโทเค็นการเข้าถึงไคลเอ็นต์หมดอายุ หากต้องการรับคู่โทเค็นการเข้าถึงไคลเอ็นต์/โทเค็นรีเฟรชใหม่ ให้อ้างอิงขั้นตอนเดียวกับที่อธิบายไว้ข้างต้น

ลูกค้าจะสามารถปรับปรุงการอนุญาตของตนได้โดยดําเนินการดังต่อไปนี้:

• การลบ ID บริการออกจากการอนุญาต
• การขยายวันที่สิ้นสุดของระยะเวลาการอนุญาต
• การยกเลิกการอนุญาต

หมายเหตุ: ลูกค้าจะสามารถทําการเปลี่ยนแปลงการอนุญาตของตนได้โดยการเข้าสู่ระบบบัญชีออนไลน์ของ PG&E และปฏิบัติตามขั้นตอนที่กําหนดเท่านั้น หากมีการดําเนินการใด ๆ เหล่านี้ เราจะแจ้งให้คุณทราบผ่านการแจ้งเตือน URI ที่คุณได้ให้ไว้ในระหว่างการลงทะเบียน

มีตัวเลือกสําหรับการจัดการและการดูรายละเอียดการอนุญาตของลูกค้าของคุณ:

• คุณสามารถโทรติดต่อ API การอนุญาต (การดําเนินการ http GET) โดยใช้ client_access_token ของคุณในระดับบุคคลที่สาม (สําหรับรายละเอียดเกี่ยวกับการอนุญาตทั้งหมด) ที่ https://api.pge.com/GreenButtonConnect /espi/1_1/ทรัพยากร/การอนุญาต หรือที่ระดับการอนุญาตของลูกค้าแต่ละรายที่ https://api.pge.com/GreenButtonConnect /espi/1_1/ทรัพยากร/การอนุญาต/{AuthorizationID}
• นอกจากนี้ คุณยังสามารถดูรายละเอียดการอนุญาตส่วนบุคคลด้วยตนเองได้โดยการเข้าสู่ระบบบัญชี Share My Data ของคุณผ่านพอร์ทัลของบุคคลที่สามและป้อนรหัสการสมัครสําหรับการอนุญาตที่คุณกําลังค้นหา

หากคุณไม่ต้องการเข้าถึงข้อมูลที่เกี่ยวข้องกับการอนุญาตอีกต่อไป มีวิธีการทางเลือกในการยกเลิกการอนุญาต:

• คุณสามารถเรียกใช้ API การเพิกถอนการอนุญาต (การดําเนินการ http DELETE) โดยใช้ client_access_token ของคุณที่ https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
• หรืออีกวิธีหนึ่ง คุณสามารถยกเลิกการอนุญาตได้ด้วยตนเองโดยเข้าสู่ระบบบัญชี Share My Data ของคุณผ่านทางพอร์ทัลของบุคคลที่สามและป้อนรหัสการสมัครสมาชิกสําหรับการอนุญาตที่คุณต้องการยกเลิก

หมายเหตุ: ลูกค้าจะได้รับแจ้งว่าคุณเลือกที่จะยกเลิกการอนุญาตของพวกเขา นอกจากนี้ เมื่อยกเลิกการอนุญาตแล้ว จะไม่สามารถย้อนกลับการดําเนินการได้

• PG&E จะส่งการแจ้งเตือนไปยัง URI ของคุณที่ให้ไว้ในระหว่างการลงทะเบียน การแจ้งเตือนประกอบด้วย URI ที่สอดคล้องกับข้อมูลที่บรรจุไว้ล่วงหน้าแล้วพร้อมให้คุณกลับมาและขอที่ URL ที่ให้ไว้ ข้อมูลจะถูกบรรจุไว้ล่วงหน้าและการแจ้งเตือนจะถูกส่งออกไปในสองสถานการณ์ต่อไปนี้: (1) คุณได้เลือก "แจ้งให้ฉันทราบเมื่อข้อมูลพร้อม" ในโปรไฟล์การลงทะเบียนของคุณ ซึ่งในกรณีนี้เราจะบรรจุข้อมูลประจําวันล่าสุดพร้อมการแก้ไขใด ๆ สําหรับวันที่ที่ผ่านมา หรือ (2) คุณได้ส่งคําขออะซิงโครนัสเฉพาะกิจก่อนหน้านี้ซึ่งข้อมูลที่ร้องขอพร้อมแล้ว
• สถานการณ์ที่ 1 แสดงไว้ภายใต้หัวข้อ "การเข้าถึงของDATA: การสมัครสมาชิกรายวัน" ของแผนภาพวิธีการเข้าถึงข้อมูลด้านล่าง และสถานการณ์จําลอง 2 แสดงอยู่ใต้ "การเข้าถึงดาต้า: AD HOC REQUEST (ASYNCHRONOUS)" ของแผนภาพเดียวกันด้านล่าง

โปรดคํานึงถึงอายุการใช้งานของโทเค็นของโทเค็นการเข้าถึง โทเค็นการเข้าถึงไคลเอ็นต์ และโทเค็นรีเฟรชที่เกี่ยวข้องที่ใช้ในการร้องขอข้อมูล ตามแนวทางปฏิบัติที่ดีที่สุด โทเค็นการเข้าถึงเป็นโทเค็นที่มีอายุการใช้งานสั้น (1 ชั่วโมง) ในขณะที่โทเค็นรีเฟรชเป็นโทเค็นที่มีอายุการใช้งานยาวนาน (1 ปี) ที่คุณสามารถใช้เพื่อได้รับคู่โทเค็นการเข้าถึง/โทเค็นรีเฟรชใหม่เมื่อโทเค็นการเข้าถึงหมดอายุ ในทํานองเดียวกัน โทเค็นการเข้าถึงไคลเอ็นต์เป็นโทเค็นที่มีอายุการใช้งานสั้น (1 ชั่วโมง) ในขณะที่โทเค็นรีเฟรชที่สอดคล้องกันเป็นโทเค็นที่มีอายุการใช้งานยาวนาน (1 ปี) ที่คุณสามารถใช้เพื่อได้รับคู่โทเค็นการเข้าถึงไคลเอ็นต์/โทเค็นรีเฟรชเมื่อโทเค็นการเข้าถึงไคลเอ็นต์หมดอายุ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการรับคู่โทเค็นใหม่ โปรดดูขั้นตอนที่ 3 การขอโทเค็นการเข้าถึงใหม่ ในแท็บรายละเอียดการอนุญาตของเรา ไปที่รายละเอียดการอนุญาต

หากคุณได้รับอนุญาตจากลูกค้าให้รับ "ข้อมูลบัญชี" (รหัสบัญชี รหัสข้อตกลงการให้บริการ และวันที่เริ่มต้นบริการ) และ/หรือ "ข้อมูลพื้นฐาน" (กล่าวคือ ชื่อลูกค้า และที่อยู่บริการ) คุณสามารถขอข้อมูลลูกค้าดังกล่าวผ่าน API ของ RetailCustomer ที่กําหนดไว้ตาม ESPI ซึ่งข้อมูลสอดคล้องกับสคีมา, retailCustomer.xsd ที่ระบุไว้ข้างต้น

ซิงโครนัส (บุคคลที่สามมาตรฐานและ EEF)

วิธีการหนึ่งในการขอข้อมูลลูกค้าคือการใช้ API แบบซิงโครนัสสําหรับการขอข้อมูลลูกค้าสําหรับการอนุญาตลูกค้ารายเดียวสําหรับข้อมูลลูกค้า (เช่น ลูกค้าปลีก):

ตัวอย่าง URL คําขอแบบซิงโครนัส:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID ที่คุณได้รับเมื่อสิ้นสุดลําดับการอนุญาต OAuth เพื่อรับโทเค็นการเข้าถึง RetailCustomerID เป็นส่วนหนึ่งของพารามิเตอร์เส้นทางทรัพยากรของลูกค้าในการตอบสนองโทเค็น (RetailCustomerID=SubscriptionID)

ส่วนหัวของ HTTP = การอนุญาต:ผู้รับ {โทเค็นการเข้าถึงสําหรับการอนุญาตนี้}

คําตอบ = คุณจะได้รับข้อมูลกลับมาพร้อมกันสําหรับ RetailCustomerID นั้น ข้อมูลสอดคล้องกับ retailCustomer.xsd

หมายเหตุ: API ลูกค้ารายย่อยซิงโครนัสอยู่ที่ระดับลูกค้ารายย่อยแต่ละรายซึ่งสอดคล้องกับการอนุญาตของลูกค้ารายเดียว

สําหรับการอ้างอิง: แผนผังลําดับชั้นด้านล่างแสดงลําดับชั้นความสัมพันธ์สําหรับองค์ประกอบข้อมูล ESPI ในการสร้างแบบจําลองข้อมูลลูกค้า PG&E

คุณยังสามารถร้องขอข้อมูลลูกค้าผ่าน API แบบอะซิงโครนัสสําหรับการร้องขอข้อมูลลูกค้าสําหรับการอนุญาตข้อมูลลูกค้าทั้งหมดของคุณ (เช่น ลูกค้าปลีก)

เพื่อสนับสนุนคําขออะซิงโครนัส แอปพลิเคชันของคุณจะต้องสนับสนุนการแจ้งเตือนภายหลังที่เราจะส่งให้คุณ (ตาม URL การแจ้งเตือนที่คุณให้ไว้ในระหว่างการลงทะเบียน)

ตัวอย่าง URL คําขออะซิงโครนัส:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID ที่ให้ไว้ใน ApplicationInformation Resource ที่เรียกใช้ในระหว่างการทดสอบการลงทะเบียน (BulkID=ClientID)

ส่วนหัวของ HTTP = การอนุญาต:Bearer {โทเค็นการเข้าถึงของลูกค้าได้รับในระหว่างการทดสอบการลงทะเบียน}

คําตอบ = รหัสสถานะ HTTP 202 (นี่เป็นคําขอแบบอะซิงโครนัสที่คําตอบจะถูกโพสต์ไปยัง URL การแจ้งเตือนเมื่อข้อมูลพร้อม) เมื่อข้อมูลพร้อมแล้ว เราจะโพสต์การแจ้งเตือนไปยัง URI ที่คุณแจ้งไว้พร้อมการโหลด URL ที่แอปพลิเคชันของคุณสามารถกลับมาเพื่อรับพัสดุล่วงหน้า ตัวอย่างการแจ้งเตือนโพสต์มีลักษณะดังนี้

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

ดําเนินการ GET บน URL ด้านบนด้วยโทเค็นการเข้าถึงไคลเอ็นต์เพื่อรับข้อมูล

สําหรับการอ้างอิง: แผนผังลําดับชั้นด้านล่างแสดงลําดับชั้นความสัมพันธ์สําหรับองค์ประกอบข้อมูล ESPI ในการสร้างแบบจําลองข้อมูลลูกค้า PG&E

สุดท้ายนี้ คุณสามารถรับข้อมูลลูกค้าล่าสุดในแต่ละวันโดยใช้รูปแบบการสมัครสมาชิกรายวัน (เช่น โดยการเลือกช่องทําเครื่องหมาย "แจ้งให้ฉันทราบเมื่อข้อมูลพร้อม (ทุกวัน)" ในระหว่างการลงทะเบียน)

เพื่อสนับสนุนรูปแบบการสมัครใช้บริการรายวัน แอปพลิเคชันของคุณจะต้องสนับสนุนการแจ้งเตือนภายหลังที่เราจะส่งให้คุณ (ตาม URL การแจ้งเตือนที่คุณให้ไว้ในระหว่างการลงทะเบียน)

เมื่อข้อมูลพร้อมแล้ว เราจะโพสต์การแจ้งเตือนไปยัง URI ที่คุณแจ้งไว้พร้อมการโหลด URL ที่แอปพลิเคชันของคุณสามารถกลับมาเพื่อรับพัสดุล่วงหน้า ตัวอย่างการแจ้งเตือนหลังจะมีลักษณะดังนี้:

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

ดําเนินการ GET บน URL ด้านบนด้วยโทเค็นการเข้าถึงไคลเอ็นต์เพื่อรับข้อมูล

สําหรับการอ้างอิง แผนผังลําดับชั้นด้านล่างแสดงลําดับชั้นความสัมพันธ์สําหรับองค์ประกอบข้อมูล ESPI ในการสร้างแบบจําลองข้อมูลลูกค้า PG&E

หากคุณได้รับอนุญาตจากลูกค้าให้รับ "ข้อมูลการใช้งาน" และ/หรือ "ข้อมูลการเรียกเก็บเงิน" คุณสามารถร้องขอข้อมูลนี้ผ่าน API การสมัครสมาชิกซึ่งข้อมูลสอดคล้องกับสคีมา espiDerived.xsd ตามที่ระบุไว้ข้างต้น

คําขอเฉพาะกิจที่สอดคล้องกัน (บุคคลที่สามมาตรฐานและ EEF)

ในการร้องขอข้อมูลประวัติ (สําหรับทั้งข้อมูลการใช้ช่วงและข้อมูลการเรียกเก็บเงิน) วิธีการหนึ่งคือการใช้ API ซิงโครนัสที่มีการรวมพารามิเตอร์การร้องขอวันที่เริ่มต้นและวันที่สิ้นสุดที่เหมาะสมในเวลาซูลู

URL คําขอแบบซิงโครนัสตัวอย่าง:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}? published-min={startDate}& published-max={endDate}

เผยแพร่แล้ว-นาที = วันที่เริ่มต้นที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล วันที่อยู่ในเวลา Zulu ของ yyyy-MM-ddTHH:mm:ssZ (รูปแบบ RFC 3339)

เผยแพร่สูงสุด = วันที่สิ้นสุดที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล วันที่อยู่ในเวลา Zulu ของ yyyy-MM-ddTHH:mm:ssZ (รูปแบบ RFC 3339)

หมายเหตุ: สําหรับคําขอ API ที่ยอมรับพารามิเตอร์วันที่เผยแพร่สูงสุดและวันที่เผยแพร่ต่ําสุด ค่าเริ่มต้นคือ T-1 (วันที่ส่งคําขอลบ 1 วัน) สําหรับคําขอสรุปการใช้งาน (เช่น .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary) เราขอแนะนําให้ระบุช่วง 30 วันขึ้นไปเพื่อให้แน่ใจว่ามีใบเรียกเก็บเงินที่ทับซ้อนกับช่วงเวลานั้น มิฉะนั้นจะไม่มีการส่งคืนข้อมูล

ID การสมัครสมาชิก = SubscriptionID ที่คุณได้รับเมื่อสิ้นสุดลําดับการอนุญาต OAuth เพื่อรับโทเค็นการเข้าถึง ID การสมัครสมาชิกเป็นส่วนหนึ่งของพารามิเตอร์ resourceURI ในการตอบสนองของโทเค็น (SubscriptionID=RetailCustomerID)

UsagePointID = UsagePoint ภายใต้ ID การสมัครสมาชิกข้างต้น คุณสามารถรับจุดใช้งานทั้งหมดสําหรับการสมัครสมาชิกที่กําหนดได้โดยโทรไปที่ API URL ด้านล่างและจัดหาโทเค็นการเข้าถึงสําหรับการสมัครสมาชิกนั้นในส่วนหัวของการอนุญาต: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

ส่วนหัวของ HTTP = การอนุญาต:ผู้เรียนรู้ {โทเค็นการเข้าถึงสําหรับการสมัครสมาชิกนี้}

การตอบสนอง = คุณจะได้รับข้อมูลกลับมาพร้อมกันสําหรับจุดการใช้งานนั้นสําหรับช่วงเวลาที่ร้องขอ โดยจะมีทั้งข้อมูลการใช้ตามช่วงเวลา () และข้อมูลการเรียกเก็บเงิน ()

API การใช้งานที่สอดคล้องกัน (ตามที่ระบุโดยการสร้าง URL ซึ่งลงท้ายด้วยรหัสจุดการใช้งาน) อยู่ที่ระดับจุดการใช้งานแต่ละจุด (เช่น ระดับข้อตกลงการให้บริการ) ดังนั้นแอปพลิเคชันจะวนรอบคําขอผ่านรหัสจุดการใช้งานแต่ละจุดที่เป็นของการอนุญาตของลูกค้าที่กําหนด (เช่น การสมัครสมาชิก)

การตอบสนองต่อคําขอแบบซิงโครนัสจะส่งคืนทั้งข้อมูลช่วง (ภายใต้) ที่เกี่ยวข้องกับช่วงวันที่ที่ร้องขอ รวมถึงยอดรวมการใช้งานรายเดือนและใบเรียกเก็บเงินที่ทับซ้อนกับช่วงวันที่ที่ร้องขอ (ภายใต้ )

• IntervalReading ประกอบด้วยข้อมูลการใช้ไฟฟ้าและก๊าซแบบช่วงห่าง (15 นาที/ชั่วโมง) (รายวัน)
• สรุปการใช้งานประกอบด้วยยอดรวมการใช้งานรายเดือนและรายละเอียดใบแจ้งหนี้ (หากได้รับอนุญาต)

ภายในคําตอบ คุณจะพบองค์ประกอบข้อมูลที่สอดคล้องกับตารางการแมปองค์ประกอบข้อมูล ESPI ของเรา

สําหรับการอ้างอิง แผนผังลําดับชั้นด้านล่างแสดงลําดับชั้นความสัมพันธ์สําหรับองค์ประกอบข้อมูล ESPI ในการสร้างแบบจําลองข้อมูลลูกค้า PG&E

ต่อไปนี้เป็นคําชี้แจงที่สําคัญบางประการเกี่ยวกับองค์ประกอบของข้อมูลเหล่านี้:

• ช่วงเวลาบล็อกสําหรับ 1 วัน
• IntervalReading (ใต้ Interval Block) มีค่าการใช้ไฟฟ้าจริง 15 นาที/ชั่วโมง และค่าการใช้ก๊าซรายวัน
• สําหรับลูกค้าไฟฟ้าที่มีการสร้างในสถานที่ (เช่น พลังงานแสงอาทิตย์) องค์ประกอบ flowDirection จะระบุข้อมูลการใช้งาน (อุปทาน) ที่ส่งมอบและที่ได้รับ (รุ่น) สําหรับลูกค้าที่มีมิเตอร์ที่ได้รับการกําหนดค่าให้อ่านเฉพาะการใช้งานสุทธิ (เช่น ไม่มีการสร้างในสถานที่) องค์ประกอบ flowDirection บ่งชี้ว่าการใช้งานเป็นปริมาณสุทธิ (ความแตกต่างของการส่งลบที่ได้รับ):
  • ทิศทางการไหล 1 = ส่งมอบ (พลังงานที่จ่ายให้กับลูกค้า)
  • ทิศทางการไหล 19 = ได้รับ (การสร้างสุทธิไหลกลับเข้าสู่ตาราง PG&E) (หมายเหตุ ค่าสัมบูรณ์)
  • ทิศทางการไหลเท่ากับ 4 = สุทธิ (ส่งมอบลบ – ได้รับ)
• ให้ความสนใจเป็นพิเศษกับตัวคูณ Power ofสิบและหน่วยวัด (uom) เพื่อให้แน่ใจว่าการอ่านการใช้งานถูกต้อง

การสมัครสมาชิกแบบแบตช์ (บุคคลที่สามแบบมาตรฐานและ EEF)

คุณยังสามารถขอข้อมูลการใช้งานผ่าน API แบบอะซิงโครนัสสําหรับคะแนนการใช้งานทั้งหมดที่เป็นของการอนุญาตของลูกค้ารายเดียวสําหรับข้อมูลการใช้งาน/การเรียกเก็บเงิน (เช่น การสมัครสมาชิก)

เพื่อสนับสนุนคําขอ Ad Hoc Asynchronous (กล่าวคือ สําหรับจุดการใช้งานมากกว่าหนึ่งจุดในแต่ละครั้ง) แอปพลิเคชันของคุณจะต้องสนับสนุนการแจ้งเตือนภายหลังที่เราจะส่งให้คุณ (ตาม URL การแจ้งเตือนที่คุณให้ไว้ในระหว่างการลงทะเบียน)

ตัวอย่าง URL คําขออะซิงโครนัส
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}? published-min={startDate}& published-max={endDate}

ID การสมัครสมาชิก = SubscriptionID ที่คุณได้รับเมื่อสิ้นสุดลําดับ OAuth เพื่อรับโทเค็นการเข้าถึง ID การสมัครสมาชิกเป็นส่วนหนึ่งของพารามิเตอร์ resourceURI ในการตอบสนองของโทเค็น

เผยแพร่แล้ว-นาที = วันที่เริ่มต้นที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

เผยแพร่สูงสุด = วันที่สิ้นสุดที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

ส่วนหัวของ HTTP = การอนุญาต:ผู้เรียนรู้ {โทเค็นการเข้าถึงสําหรับการสมัครสมาชิกนี้}

คําตอบ = รหัสสถานะ HTTP 202 (นี่เป็นคําขอแบบอะซิงโครนัสที่คําตอบจะถูกโพสต์ไปยัง URL การแจ้งเตือนเมื่อข้อมูลพร้อม)

เมื่อข้อมูลพร้อมแล้ว เราจะโพสต์การแจ้งเตือนไปยัง URI ที่คุณแจ้งไว้ พร้อมด้วย URL ที่แอปพลิเคชันของคุณสามารถกลับมาเพื่อรับพัสดุล่วงหน้า ตัวอย่างการแจ้งเตือนโพสต์มีลักษณะดังนี้:

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

ดําเนินการ GET บน URL ด้านบนด้วยโทเค็นการเข้าถึงเพื่อรับข้อมูล ซึ่งจะประกอบด้วยข้อมูลการใช้งานตามช่วงเวลา () และข้อมูลการเรียกเก็บเงิน () สําหรับช่วงเวลาที่ร้องขอ

การสมัครสมาชิกแบบแบตช์ (บุคคลที่สามแบบมาตรฐานและ EEF)
คุณยังสามารถร้องขอข้อมูลการใช้งานและการเรียกเก็บเงินผ่าน API แบบอะซิงโครนัสแบบกลุ่มสําหรับการอนุญาตของลูกค้าของคุณทั้งหมดสําหรับข้อมูลการใช้งาน/การเรียกเก็บเงิน (เช่น การสมัครสมาชิก)

ตัวอย่าง URL คําขอเป็นกลุ่ม
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}? published-min={startDate}& publishedmax={endDate}

BulkID = BulkID ที่ให้ไว้ใน ApplicationInformation Resource ที่เรียกใช้ในระหว่างการทดสอบการลงทะเบียน (BulkID=ClientID)

เผยแพร่แล้ว-นาที = วันที่เริ่มต้นที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

เผยแพร่สูงสุด = วันที่สิ้นสุดที่จะใช้กับคําขอนี้สําหรับการดึงข้อมูล (RFC 3339 format zulu time. yyyy-MM-ddTHH:mm:ssZ)

ส่วนหัว HTTP = การอนุญาต:Bearer {โทเค็นการเข้าถึงไคลเอ็นต์}

คําตอบ = รหัสสถานะ HTTP 202 (นี่เป็นคําขอแบบอะซิงโครนัสที่คําตอบจะถูกโพสต์ไปยัง URL การแจ้งเตือนเมื่อข้อมูลพร้อม)

เมื่อข้อมูลพร้อมแล้ว เราจะโพสต์การแจ้งเตือนไปยัง URI ที่คุณแจ้งไว้ พร้อมด้วย URL ที่แอปพลิเคชันของคุณสามารถกลับมาเพื่อรับพัสดุล่วงหน้า ตัวอย่างการแจ้งเตือนโพสต์มีลักษณะดังนี้:

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

ดําเนินการ GET บน URL ด้านบนด้วยโทเค็นการเข้าถึงเพื่อรับข้อมูล ซึ่งจะประกอบด้วยข้อมูลการใช้งานตามช่วงเวลา () และข้อมูลการเรียกเก็บเงิน () สําหรับช่วงเวลาที่ร้องขอ

สุดท้ายนี้ คุณสามารถรับข้อมูลการใช้งานและการเรียกเก็บเงินล่าสุด รวมถึงการแก้ไขวันที่ที่ผ่านมาภายในระยะเวลาการอนุญาตของลูกค้าเป็นประจําทุกวัน โดยใช้รูปแบบการสมัครสมาชิกประจําวัน (กล่าวคือ โดยการเลือกช่องทําเครื่องหมาย "แจ้งให้ฉันทราบเมื่อข้อมูลพร้อม (ทุกวัน)" ในระหว่างการลงทะเบียน)

เพื่อสนับสนุนรูปแบบการสมัครใช้บริการรายวัน แอปพลิเคชันของคุณจะต้องสนับสนุนการแจ้งเตือนภายหลัง เราจะส่งให้คุณ (ตาม URL การแจ้งเตือนที่คุณให้ไว้ในระหว่างการลงทะเบียน)

เมื่อข้อมูลพร้อมแล้ว เราจะโพสต์การแจ้งเตือนไปยัง URI ที่คุณแจ้งไว้ พร้อมด้วย URL ที่แอปพลิเคชันของคุณสามารถกลับมาเพื่อรับพัสดุล่วงหน้า ตัวอย่างการแจ้งเตือนโพสต์มีลักษณะดังนี้:

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

ดําเนินการ GET บน URL ด้านบนด้วยโทเค็นการเข้าถึงเพื่อรับข้อมูล ซึ่งจะประกอบด้วยข้อมูลการใช้งานตามช่วงเวลา () และข้อมูลการเรียกเก็บเงิน () สําหรับช่วงเวลาที่ร้องขอ

20 มิถุนายน 2024

แพลตฟอร์มแชร์ข้อมูลของฉัน (SMD) ของ PG&E สําหรับการแบ่งปันข้อมูลที่ได้รับอนุญาตจากลูกค้ากับผู้ให้บริการบุคคลที่สามที่ปล่อยระยะที่ 2 ของการปรับปรุง ID มิเตอร์ของเรา ซึ่งช่วยให้สามารถระบุ ID มิเตอร์แต่ละรายการที่เชื่อมโยงกับข้อมูลมิเตอร์ช่วงเวลาไฟฟ้าได้  

การปรับปรุงนี้มีประโยชน์อย่างยิ่งสําหรับสถานการณ์ผู้ใช้ที่มีหลายมิเตอร์เกี่ยวข้องกับข้อตกลงการให้บริการฉบับเดียว

ระยะที่ 1:  เปิดตัวเมื่อเดือนมีนาคม 2023 - แก้ไข API ที่ได้รับผลกระทบเพื่อเริ่มเพิ่มค่า พร้อมกับค่า ในการตอบกลับ ภายใต้แท็ก มีการโต้ตอบแบบตัวต่อตัวระหว่างค่าหมายเลขซีเรียลและค่า utcNumber

ข้อมูลนี้ช่วยให้ผู้ขายที่ใช้ API เหล่านี้สามารถสร้างการจัดเก็บบันทึกด้วย utcNumber พร้อมกับค่าหมายเลขซีเรียลที่เกี่ยวข้องกับมิเตอร์ที่กําหนดสําหรับฐานลูกค้าของตนก่อนที่จะปล่อยการปรับปรุงเฟส 2

ระยะที่ 2: นําออกใช้เมื่อวันที่ 20 มิถุนายน 2024 - แทนที่ค่า MeterReadingID จากรูปแบบการเข้ารหัสปัจจุบัน64 ของค่าเชิงพรรณนาของมิเตอร์ด้วย utcNumber เมื่อการเปลี่ยนแปลงเหล่านี้ถูกนํามาใช้อย่างสมบูรณ์แล้ว ผู้ใช้ข้อมูลของฉันจะสามารถปรับปรุงความสามารถในการเชื่อมโยงกับการใช้ช่วงมิเตอร์เฉพาะ ในกรณีที่มีหลายเมตรของสินค้าโภคภัณฑ์เดียวกันที่เชื่อมโยงกับข้อตกลงการให้บริการเดียวในสถานที่ กับ ID มิเตอร์เฉพาะที่สร้างการใช้งาน 

API ต่อไปนี้ได้รับผลกระทบจากการเปลี่ยนแปลงระยะที่ 2

API ที่ได้รับผลกระทบ:

.../espi/1_1/ทรัพยากร/การสมัครสมาชิก/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

.../espi/1_1/ทรัพยากร/การสมัครสมาชิก/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}

.../espi/1_1/ทรัพยากร/การสมัครสมาชิก/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock

.../espi/1_1/ทรัพยากร/การสมัครสมาชิก/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock/{IntervalBlockID}

API อื่น ๆ ทั้งหมดที่มีการอ่านช่วงจะไม่มีการเปลี่ยนแปลงและแสดงถึง SUM ของช่วงมิเตอร์ทั้งในทิศทางการไหลและมิเตอร์ทั้งหมดภายใต้ข้อตกลงการให้บริการ

ก่อนปล่อย เขตข้อมูล MeterReadingID ถูกเข้ารหัส Base64 และค่าที่ส่งคืนจะแสดงดังนี้:

MeterReadingID= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

ถอดรหัสจากรูปแบบ Base64 เป็น:  NzI6bnVsbDozNjAwOjE =:1:1

นี่แสดงการอ่านTypeID:rownum:count และการอ่านค่าTypeID จะถูกถอดรหัสจาก Base64 อีกครั้งเป็น:

72:null:3600:1 ที่ซึ่งค่าเป็น uom:phase:intervalLength:flowDir

UOM=72, เฟส=null, intervalLength=3600, และ flowDir=1 (นําส่ง)

ในระยะที่ 2 ช่อง MeterReadingID จะถูกเพิ่มด้วยอักขระเพิ่มเติม และหลังจากผ่านการถอดรหัสครั้งแรก ผลลัพธ์ตัวอย่างต่อไปนี้จะส่งกลับ

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

ถอดรหัสจาก Base64 หนึ่งครั้ง:  NzI6bnVsbDozNjAwOjE =:1:1:4411310546, 

ซึ่งแสดงมิเตอร์_UUID คือ 4411310546 และค่านี้ควรตรงกับค่า ที่มีอยู่ใน RetailCustomer API ภายใต้แท็ก

ค่าของ “NzI6bnVsbDozNjAwOjE=:1:1:” คือการอ่านTypeID:rownum:count กล่าวคือหมายเลขแถวคือ 1 และการนับคือ 1 เกี่ยวข้องกับบันทึกฐานข้อมูลภายในของ PG&E การอ่านTypeID จะถูกถอดรหัสอีกครั้งเป็น:

72:นัล:3600:1, ที่ซึ่งค่าคือ uom:phase:intervalLength:flowDir

UOM=72, เฟส=null, intervalLength=3600, และ flowDir=1 (นําส่ง)

การเปลี่ยนแปลงนี้ช่วยให้ผู้ใช้สามารถระบุมิเตอร์ทางกายภาพและทิศทางการไหลที่สนใจในการอ่านช่วง โปรดทราบว่าไฟล์ XML ทั้งหมดในขณะนี้จะมีค่า MeterReadingID ใหม่และจะใช้รูปแบบการเข้ารหัสใหม่ระยะที่ 2 แชร์ข้อมูลของฉันจะแนะนําผู้ขายทั้งหมดที่ใช้การโทร API โดยใช้ MeterReadingID โทร API ต่อไปนี้เพื่อรับ MeterReadingID ใหม่: .../espi/1_1/resource/SubscriptionID}/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

20 มีนาคม 2023

มีอะไรใหม่:

1. การปล่อยรหัสการตอบสนอง API HTTP ใหม่ (204) สําหรับทั้งการโทร API แบบซิงโครนัสและอะซิงโครนัสเพื่อระบุว่าเมื่อใดไม่มีข้อมูลสําหรับช่วงที่ร้องขอ
2. การสนับสนุนฉลากส่วนหัวของธุรกรรม x ที่สนับสนุนความสามารถในการเชื่อมโยงการตอบสนองของ PG&E กับการโทร API แบบอะซิงโครนัสที่เฉพาะเจาะจง โดยการส่งคืนค่านี้พร้อมกับรหัสความสัมพันธ์เมื่อไฟล์ที่ร้องขอพร้อม
3. ปรับปรุงความละเอียดข้อมูลเพิ่มเติมให้กับ UsagePoint/MeterReadingID API โดยการให้ข้อมูลช่วงห่างไฟฟ้าสําหรับสถานการณ์ข้อตกลงการให้บริการหลายเมตรถึงหนึ่งเดียว
4. ให้ความชัดเจนเพิ่มเติมในการอ่านค่าตัวบ่งชี้คุณภาพสําหรับข้อมูลช่วงโดยประมาณเพื่ออธิบายประเภทของการประมาณที่ใช้สําหรับช่วงนั้น ค่าใหม่ที่ระบุตรรกะของการประมาณค่าถูกใช้อยู่ด้านล่าง:
   
   

5. ค่า RQI และคําอธิบาย

   0 - ถูกต้อง: ข้อมูลที่ผ่านการตรวจสอบความถูกต้องที่จําเป็นทั้งหมด และผ่านการตรวจสอบความถูกต้องแล้ว

   7 - แก้ไขด้วยตนเอง: แทนที่หรืออนุมัติโดยมนุษย์

   8 - ประมาณค่าโดยใช้วันอ้างอิง: ค่าข้อมูลถูกแทนที่ด้วยค่าที่คํานวณโดยเครื่องตามการวิเคราะห์ข้อมูลในอดีตโดยใช้การวัดประเภทเดียวกัน

   9 - ประมาณค่าโดยใช้การประมาณค่าเชิงเส้น: ค่าข้อมูลถูกคํานวณโดยใช้การประมาณค่าเชิงเส้นตามค่าที่อ่านก่อนและหลัง

   10 - น่าสงสัย: ข้อมูลที่ไม่ผ่านการตรวจสอบอย่างน้อยหนึ่งรายการ

   11 - ได้รับ: ข้อมูลที่ได้รับการคํานวณ (โดยใช้การปฏิบัติการทางตรรกะหรือทางคณิตศาสตร์) ไม่จําเป็นต้องวัดโดยตรง

   12 - การคาดการณ์ (การคาดการณ์): ข้อมูลที่ได้รับการคํานวณเป็นการคาดการณ์หรือการคาดการณ์สําหรับการอ่านค่าในอนาคต

   13 - ผสม: บ่งชี้ว่าคุณภาพของการอ่านนี้มีลักษณะผสมกัน

   14 - ดิบ: ข้อมูลที่ยังไม่ผ่านกระบวนการตรวจสอบความถูกต้อง การแก้ไข และการประมาณการ หมายเหตุ ตัวบ่งชี้ RQI ของมิเตอร์ MV90 จะยังคงอยู่ใน 14 เป็นสถานะ RQ สุดท้าย

   15 - ปรับให้เป็นปกติสําหรับสภาพอากาศ: ปรับค่าให้สอดคล้องกับสภาพอากาศ เพื่อเปรียบเทียบการใช้งานในสภาพอากาศที่แตกต่างกัน

   16 - อื่น ๆ: ระบุว่าคุณลักษณะนั้น ๆ มีผลบังคับใช้นอกเหนือจากที่กําหนดไว้

   17 - ได้รับการตรวจสอบความถูกต้อง: ข้อมูลที่ได้รับการตรวจสอบความถูกต้องแล้วและอาจถูกแก้ไขและ/หรือประมาณค่าตามขั้นตอนที่ได้รับอนุมัติ

   18 - ตรวจสอบความถูกต้อง: ข้อมูลที่ไม่ผ่านการตรวจสอบความถูกต้องที่กําหนดอย่างน้อยหนึ่งรายการ แต่ถูกตัดสินว่าแสดงถึงการใช้งานจริง

   19 - คุณภาพรายได้: ถูกต้องและเป็นที่ยอมรับสําหรับวัตถุประสงค์ในการเรียกเก็บเงิน [ส่วนขยายที่เป็นไปได้สําหรับมาตรฐาน ESPI และไม่ใช่ส่วนหนึ่งของ ESPI เดิม]

    

6. การปล่อยตัววัดการใช้งาน API ของผู้ขายในพอร์ทัล แบ่งปันข้อมูลของฉัน สําหรับผู้ขายบุคคลที่สาม

15 พฤศจิกายน 2018

มีอะไรใหม่:

1. เพิ่มตัวบ่งชี้ระดับลูกค้าแล้ว SAID แต่ละรายการที่ได้รับอนุญาตจะถูกระบุว่าเป็น RES, AGR, COM/IND หรืออื่นๆ
2. API การเรียกเก็บเงินและการใช้จะได้รับการปรับปรุงเพื่อยอมรับพารามิเตอร์การสืบค้นข้อมูลที่ปรับปรุง-สูงสุดและที่อัปเดต-ต่ําสุด (เป็นทางเลือกแทนข้อมูลที่เผยแพร่-ต่ําสุดและที่ตีพิมพ์-สูงสุด) ข้อมูลที่ส่งคืนจะเป็นการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นภายในพารามิเตอร์ค่าสูงสุดและค่าต่ําสุดที่อัพเดต
3. การเปลี่ยนการใช้รหัสสินค้าจํานวนมาก 5 หลักของบุคคลที่สามด้วยรหัสลูกค้าของบุคคลที่สามสําหรับขั้นตอนการอนุมัติออนไลน์
4. การให้ตัวเลือกสําหรับบุคคลที่สามในการเปลี่ยนทิศทางลูกค้าไปยังการเข้าสู่ระบบบัญชีของ PG&E หรือแท็บ Guest Access ซึ่งเป็นส่วนหนึ่งของขั้นตอนการอนุมัติทางออนไลน์
5. การปรับปรุงแดชบอร์ดลูกค้า Share My Data ของ PG&E เพื่อให้ลูกค้าดูการอนุญาตการแบ่งปันข้อมูลที่มีอยู่กับบุคคลที่สามได้ง่ายขึ้น

27 กันยายน 2018

มีอะไรใหม่:

PG&E ได้เพิ่มองค์ประกอบข้อมูลใหม่ลงในชุดข้อมูลของกฎข้อ 24 ซึ่งเป็นส่วนหนึ่งของโครงการชุดข้อมูลที่ขยายขึ้น (EDS) ของ PG&E และองค์ประกอบข้อมูลใหม่ที่สอดคล้องกันจะถูกนํามารวมไว้ในชุดข้อมูลของกฎข้อ 25 องค์ประกอบข้อมูลที่เฉพาะเจาะจงซึ่งประกอบไปด้วยชุดข้อมูล Rule 25 ที่ขยายเพิ่มเติมของ PG&E ได้ระบุไว้ด้านล่างพร้อมการกําหนด EDS:

องค์ประกอบข้อมูลตามกฎข้อที่ 25

หมายเหตุ
องค์ประกอบบัญชี
ชื่อบัญชี
ที่อยู่บัญชี
ID บัญชี
EDS: บล็อคไฟฟ้าดับ
องค์ประกอบการบริการ
UUID ของ PG&E
ID บริการ
การเปลี่ยนแปลงสถานะการให้บริการในอนาคต
สถานะ SA
วันที่เริ่มต้นบริการ
ที่อยู่บริการ
ภาษีบริการปัจจุบัน
ประวัติภาษีบริการเรียกเก็บเงิน
ตัวเลือกภาษี (Medical Baseline, CARE, FERA, TBS, CCA_TBS, Solar Choice
แรงดันไฟฟ้าบริการปัจจุบันและแรงดันไฟฟ้าบริการในอดีตของสินค้าโภคภัณฑ์
หมายเลขมิเตอร์บริการ
จํานวนมิเตอร์บริการ
ประเภทมิเตอร์
รอบการอ่านมิเตอร์ปัจจุบัน
ประวัติรอบการอ่านมิเตอร์ที่เรียกเก็บเงิน
ตัวเลือกอัตราสแตนด์บายปัจจุบันหากตัวบ่งชี้การสร้างในสถานที่
ตัวเลือกอัตราสแตนด์บายที่เรียกเก็บเงินในอดีต
EDS: ตัวบ่งชี้ระดับชั้นของลูกค้า
องค์ประกอบการเรียกเก็บเงินในอดีต
วันที่เริ่มต้นการเรียกเก็บเงิน
วันที่สิ้นสุดการเรียกเก็บเงิน
ยอดรวมบิล ($)
ยอดรวมบิล kWh
EDS: ชื่อผู้ให้บริการ
ประวัติรายละเอียดระดับชั้นการเรียกเก็บเงิน (ถ้ามี)
EDS: รอบการเรียกเก็บเงินรายการ
EDS: ชื่อ (มากกว่าระดับอ้างอิง 1%-30%)
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($100.23)
การแบ่งย่อย kWh ของบิล TOU ในอดีต (ยกเว้นบิล ABS-TX ที่เรียกเก็บเงิน)
EDS: ระยะเวลาใบเรียกเก็บรายการ (สําหรับการแบ่ง TOU)
EDS: ชื่อ (ของค่าธรรมเนียม TOU)
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($100.23)
การแบ่งความต้องการบิลในอดีต
EDS: ช่วงเวลาการออกบิลรายการ (สําหรับการแบ่งความต้องการ)
EDS: ชื่อ
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($100.23)
ประวัติรายการบรรทัดบิล
EDS: รอบการเรียกเก็บเงินรายการ
EDS: ชื่อค่าธรรมเนียม (DWR Bond Charge)
EDS: ปริมาตร (1234.2)
EDS: หน่วย (kWh)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($100.23)
ช่วงเวลาการใช้งานที่ผ่านมา
เริ่มการใช้ช่วงเวลา
ระยะเวลาช่วงเวลาเริ่มต้น (เป็นวินาที)
ปริมาณการใช้ช่วง (1234.2)
หน่วย (กิโลวัตต์/ชั่วโมง)
โปรแกรมตอบสนองความต้องการสาธารณูปโภค
(DR) ชื่อโปรแกรม
วันที่สิ้นสุดที่เร็วที่สุดโดยไม่มีภาระผูกพันทางการเงิน
วันที่สิ้นสุดที่เร็วที่สุดโดยไม่คํานึงถึงข้อผูกพันทางการเงิน
สถานะโปรแกรม DR
วันที่ลงทะเบียนโปรแกรม DR
วันที่ยกเลิกการลงทะเบียนโปรแกรม DR
องค์ประกอบข้อมูล
สินค้าโภคภัณฑ์
พารามิเตอร์เวลาท้องถิ่น (รายละเอียด DST)
คุณภาพข้อมูลเริ่มต้น
ทิศทางพลังงาน
กําลังของตัวคูณสิบตัว (สําหรับค่าการใช้ช่วง)
พลังของตัวคูณสิบตัว (สําหรับความต้องการที่เรียกเก็บเงิน)
Power of Ten Multiplier (สําหรับการใช้งานทั้งหมดที่เรียกเก็บเงิน)
ความยาวของช่วงเวลา(ของการอ่านการใช้งาน)
สกุลเงินของค่าใช้จ่ายทั้งหมด
ตัวบ่งชี้ TOU ช่วงเวลาไฟฟ้า

28 มิถุนายน 2018

PG&E ได้เปิดตัว Click-Through Phase 2 เมื่อวันที่ 28 มิถุนายน 2018 โดยเป็นส่วนหนึ่งของโครงการ Click-Through และการปรับปรุงแพลตฟอร์ม Share My Data Platform อย่างต่อเนื่อง

มีอะไรใหม่:

การเปลี่ยนแปลงที่สําคัญที่สุดที่ส่งผลกระทบต่อบุคคลที่สามคือการเปลี่ยนแปลงเพื่อให้สอดคล้องกับโปรโตคอลOAuth 2.0 (PG&E ขจัดชุดเริ่มต้นของการเปลี่ยนเส้นทาง) ดูรายละเอียดด้านล่าง

สิ่งสําคัญ: บุคคลที่สามจําเป็นต้องเปลี่ยนแปลงการดําเนินการ OAuth ที่มีอยู่ การเปลี่ยนแปลงระยะที่ 2 แบบคลิกผ่านของ PG&E ไม่สามารถใช้งานร่วมกันได้ ดังนั้นจึงมีความจําเป็นที่บุคคลที่สามจะต้องดําเนินการเปลี่ยนแปลงพร้อมกับการดําเนินการของ PG&E หากไม่มีการดําเนินการ กระบวนการอนุญาตของลูกค้าในปัจจุบันจะหยุดทํางานในวันที่ตัดยอดในวันที่ 29 มิถุนายน 2018 อย่างไรก็ตาม การอนุญาตที่มีอยู่จะไม่ได้รับผลกระทบ

1. เพื่อให้สอดคล้องกับโครงร่างการวิจัย OAuth 2.0 PG&E ได้ลดจํานวนขั้นตอนการเปลี่ยนทิศทางเพื่อการอนุมัติ การเปลี่ยนเส้นทางเริ่มต้นไปยัง PG&E สําหรับลูกค้าเพื่อเข้าสู่ระบบและส่งการอนุญาตได้รวมกับคําขอรหัสการอนุญาตดังต่อไปนี้:
   • ตามที่แสดงในตัวอย่างด้านล่าง คําขอรหัสการอนุญาตของบุคคลที่สามในตอนนี้ประกอบด้วยการเปลี่ยนเส้นทางของเบราว์เซอร์ของลูกค้าไปยัง authorizationServerAuthorizationEndpoint URI พร้อมกับพารามิเตอร์คําขอที่เหมาะสม:
     รับ https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&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 หรือจําเป็นต้องเปลี่ยนขอบเขตของการอนุญาตเดิมตามการอนุมัติของลูกค้า
   • สําหรับคําร้องขอการอนุญาตอีกครั้ง ลูกค้าจะเห็นหน้าการอนุญาตใหม่แทนหน้า "การจัดการการอนุญาต" เมื่อบุคคลที่สามส่งเรื่องไปยัง PG&E เพื่อการอนุญาต
   • เมื่อได้รับอนุญาตจากลูกค้า บุคคลที่สามจะได้รับการแจ้งเตือนไปยัง URL การแจ้งเตือนที่ลงทะเบียนว่า ID การสมัครสมาชิกเก่าถูกยกเลิก (การแจ้งเตือนประกอบด้วยปลายทาง API การอนุญาต URL สําหรับ ID การสมัครสมาชิกเก่า)
     
4. ความสามารถของลูกค้าในการออกผ่านปุ่ม "ยกเลิก" ในหน้าการรับรองความถูกต้องหรือหน้าการอนุญาตที่มีการเปลี่ยนเส้นทางกลับไปที่ redirect_uri ของบุคคลที่สามด้วยพารามิเตอร์ข้อผิดพลาด "access_denied" (ใช้กับ redirect_uri)
5. สําหรับบุคคลที่สามที่ลงทะเบียนด้วยการตั้งค่า "การมองเห็น" บน และดังนั้นจึงรวมอยู่ในรายชื่อลูกค้าบุคคลที่สามที่ลงทะเบียนแล้ว จะเห็นเมื่อพวกเขาไปที่บัญชีออนไลน์ของ PG&E และไปที่หน้าเริ่มต้นของแชร์ข้อมูลของฉัน:
   • สําหรับลูกค้าที่เข้าสู่ระบบบัญชีออนไลน์ของ PG&E และไปที่หน้าเริ่มต้นของแชร์ข้อมูลของฉัน จากนั้นระบบจะนําคุณไปยัง "URI พอร์ทัลบุคคลที่สาม" ที่ลงทะเบียนไว้ของบุคคลที่สาม เมื่อเลือกบุคคลที่สามจากรายการของบุคคลที่สามที่ลงทะเบียนไว้ ณ จุดนั้น ลูกค้าสามารถดําเนินการตามกระบวนการ OAuth ที่ริเริ่มโดยบุคคลที่สามได้ เมื่อผ่านเส้นทางนี้ ลูกค้าจะไม่แสดงหน้าการอนุญาตอีกต่อไปเมื่อเลือกบุคคลที่สามจากรายการแบบเลื่อนลงของบุคคลที่สาม แต่จะถูกเปลี่ยนเส้นทางไปยัง "URI พอร์ทัลบุคคลที่สาม" ที่ลงทะเบียนของบุคคลที่สามแทน ซึ่งพวกเขาสามารถเริ่มต้นกระบวนการ OAuth ที่ริเริ่มโดยบุคคลที่สามได้
   • หมายเหตุ: บุคคลที่สามบางรายได้สอบถามเกี่ยวกับวิธีการปรับปรุงประสบการณ์ของลูกค้าสําหรับกรณีการใช้งานนี้ (กล่าวคือ การอนุญาตที่เริ่มต้นบนเว็บไซต์ของ PG&E) เพื่อให้ดูเหมือนว่าพวกเขาจะถูกนําไปยังหน้าการอนุญาตโดยตรงเมื่อเลือกบุคคลที่สามจากรายการแบบเลื่อนลง เพื่ออํานวยความสะดวกให้กับประสบการณ์ของลูกค้าดังกล่าว บุคคลที่สามสามารถเลือกที่จะตั้งค่า "พอร์ทัลบุคคลที่สาม URI" ของตน (ผ่านหน้า แบ่งปันข้อมูลของฉัน จัดการการลงทะเบียน) ไปยังปลายทางที่นําลูกค้ากลับไปยัง PG&E โดยอัตโนมัติ ซึ่งเป็นส่วนหนึ่งของคําขอรหัสการอนุญาต เมื่อเปลี่ยนเส้นทางโดยอัตโนมัติไปยังการอนุญาตของ authorizationServerAuthorizationEndpointลูกค้าจะข้ามหน้าเข้าสู่ระบบของลูกค้า (เนื่องจากเข้าสู่ระบบแล้ว) และจะไปยังหน้าการอนุญาตโดยตรง สําหรับบุคคลที่สามบางรายที่ได้ลงทะเบียนก่อนการเปิดตัว Share My Data คลิก Thru 2.0 สามารถทําได้โดยเพียงแค่กําหนด URI ของพอร์ทัลบุคคลที่สามให้เท่ากับ "หน้าจอการเลือกขอบเขตของบุคคลที่สาม"URI (ฟิลด์การลงทะเบียน SMD เก่าที่จะเกษียณในอนาคต)
     ในทางตรงกันข้าม บุคคลที่สามบางรายอาจต้องการว่าจ้างและคัดกรองลูกค้าในด้านของตนเมื่อลูกค้าถูกเปลี่ยนเส้นทางไปยัง URI ของ 'พอร์ทัลบุคคลที่สาม' ก่อนที่จะขอรหัสการอนุญาต ดังนั้นวิธีการข้างต้นเป็นเพียงคําแนะนําเท่านั้น
     
6. ตอนนี้ SMD จะให้รายละเอียดพารามิเตอร์ Scope ที่ปรับปรุงแล้ว ซึ่งเป็นส่วนหนึ่งของการตอบสนองต่อคําขอรหัสการอนุมัติ คําขอโทเค็นการเข้าถึง และ API การอนุญาต พารามิเตอร์ขอบเขตที่ได้รับการปรับปรุงช่วยให้สามารถสื่อสารขอบเขตสุดท้ายของการอนุญาตของลูกค้าได้ โดยเฉพาะอย่างยิ่ง พารามิเตอร์ขอบเขตจะรวมถึงค่า "ขอบเขตเพิ่มเติม" ที่แมปกับการเลือกกลุ่มข้อมูลที่ได้รับอนุญาตของลูกค้าที่สนับสนุนโดย PG&E (เช่น "การใช้งาน" "การเรียกเก็บเงิน" "พื้นฐาน" "บัญชี" "การลงทะเบียนโปรแกรม") ค่าพารามิเตอร์ขอบเขตจะถูกบันทึกเพิ่มเติมตามเอกสารต่อไปนี้:ดาวน์โหลดสตริงบล็อคฟังก์ชันที่รองรับ คลิก Thru 2.0 (PDF)
   
   ตัวอย่างการตอบสนองของโทเค็นด้านล่างแสดงค่าพารามิเตอร์ขอบเขตที่เป็นไปได้บางส่วน
   • ตัวอย่างการตอบกลับโทเค็น:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     <ขอบเขต>scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollmentระยะเวลาระหว่างช่วง=900_3600;ระยะเวลาการล็อก=ทุกวัน;ความยาวประวัติ={3P ความยาวประวัติที่ลงทะเบียน};การสะสมบัญชี={จํานวน SA ที่ได้รับอนุญาต};BR={ID บุคคลที่สาม};รหัสผู้พิทักษ์ข้อมูล=PGE
     resourceURI:{ResourceURI} เช่น: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} เช่น: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     CustomerResourceURI:{customerResourceURI} เช่น:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. ขณะนี้บุคคลที่สามสามารถลงทะเบียนเพื่อรับข้อมูลการลงทะเบียนโปรแกรมที่ได้รับอนุญาตผ่านกลุ่มข้อมูล "การลงทะเบียนโปรแกรม" ใหม่ ทั้งลูกค้าที่มีการวัดช่วงและลูกค้าที่ไม่มีการวัดช่วงจะมีคุณสมบัติเหมาะสมที่จะอนุญาตให้มีการแบ่งปันข้อมูลสําหรับระยะที่ 2 ของการคลิกผ่าน SMD ข้อมูลสรุประดับสูงขององค์ประกอบข้อมูลที่มีใหม่ซึ่งจัดเตรียมโดยกลุ่มข้อมูลการลงทะเบียนโปรแกรมมีดังนี้:
   • การลงทะเบียนโปรแกรม (ชื่อ/สถานะของโปรแกรมการตอบสนองความต้องการ PG&E และข้อมูล CAISO):
   • (การเรียกเก็บเงิน) ที่อยู่บัญชี
   • สถานะข้อตกลงการให้บริการ
   • ค่าธรรมเนียมบริการ (ปัจจุบัน)
   • (ปัจจุบัน) แรงดันไฟฟ้าบริการ (ไฟฟ้าเท่านั้น)
   • หมายเลขมิเตอร์บริการ (ถ้ามี)
   • ประเภทมิเตอร์
   • รอบการอ่านมิเตอร์ (ปัจจุบัน)
   • (ปัจจุบัน) ตัวเลือกอัตราสแตนด์บายหากตัวบ่งชี้การสร้างในสถานที่
   • (การใช้ช่วงเริ่มต้น) ระยะเวลา (ความยาวเป็นวินาที)
   • ชื่อโปรแกรม (Enrolled PG&E Demand Response) (ถ้ามี)
   • วันที่สิ้นสุดที่เร็วที่สุดจากโปรแกรมการตอบสนองความต้องการ (DR) ที่ลงทะเบียนโดย PG&E โดยไม่มีภาระผูกพันทางการเงิน
   • วันที่สิ้นสุดที่เร็วที่สุดจากโปรแกรมการตอบสนองความต้องการ (DR) ที่ลงทะเบียนของ PG&E โดยไม่คํานึงถึงข้อผูกพันทางการเงิน
   • สถานะโครงการตอบสนองความต้องการ (DR) ของ PG&E (การลงทะเบียน)
   • วันที่ลงทะเบียนโปรแกรมการตอบสนองความต้องการ (DR) ของ PG&E
   • วันที่ยกเลิกการลงทะเบียนโปรแกรมการตอบสนองความต้องการ (DR) ของ PG&E
   • การทําแผนที่ Atom XML XSD (XML Schema Definition) สําหรับองค์ประกอบข้อมูลใหม่เหล่านี้จะถูกบันทึกตามเอกสารต่อไปนี้:
     ดาวน์โหลดองค์ประกอบข้อมูลที่รองรับ (PDF)
   • แบบจําลองลําดับชั้นข้อมูลที่เกี่ยวข้องมีสรุปไว้ดังต่อไปนี้:
     ดาวน์โหลดแบบจําลองข้อมูล PGE ESPI (PDF)
   • UsagePoint (หรือ SA UUID)
     • ServiceDeliveryPoint\tariffProfile(กําหนดอัตราภาษีบริการปัจจุบัน AKA รวมถึงตัวเลือกอัตราสแตนด์บาย หากมี)
     • readCycle (รอบการอ่านมิเตอร์ปัจจุบัน)สรุปการใช้งาน
     • readCycle (รอบการบํารุงรักษาการเรียกเก็บเงิน)
     • สินค้าโภคภัณฑ์ (รวมถึงระดับแรงดันไฟฟ้าที่เรียกเก็บสําหรับไฟฟ้า)
     • ภาษีศุลกากรโปรไฟล์ (ภาษีบริการเรียกเก็บเงินรวมถึงตัวเลือกอัตราสแตนด์บาย หากมี
   • ประเภทการอ่าน
     • สินค้าโภคภัณฑ์ (รวมถึงระดับแรงดันไฟฟ้าปัจจุบันสําหรับไฟฟ้าและคํานําหน้าสําหรับตัวเลือกอัตราสแตนด์บาย หากมี)
   • บัญชีลูกค้า
     • (ตามที่อยู่สําหรับเรียกเก็บเงิน):
     • ที่อยู่หลัก/ถนนรายละเอียด...
     • ที่อยู่หลัก/ทาวน์รายละเอียด...
     • ที่อยู่หลัก/รหัสไปรษณีย์...
   • ข้อตกลงของลูกค้า
     • สถานะ\ค่า (สถานะ SA
   • โปรแกรมการตอบสนองความต้องการ
     • ชื่อโปรแกรม
     • การลงทะเบียนสถานะ
     • วันที่/โปรแกรมวันที่
     • โปรแกรมวันที่/โปรแกรมวันที่คําอธิบาย
   • มิเตอร์
     • หมายเลขซีเรียล (รหัสมิเตอร์)
     • ประเภท (ประเภทมิเตอร์)
     • ความยาวช่วง (กระแสไฟฟ้า)
   • คําจํากัดความของสคีมาล่าสุดของ ESPI xml (XSD) ที่ใช้สําหรับองค์ประกอบข้อมูลใหม่เหล่านี้มีสรุปไว้ดังต่อไปนี้:
     ดาวน์โหลด XSDs (ZIP)
     หมายเหตุ: XSDs สามารถใช้งานได้กับรุ่นเก่า
   • บุคคลภายนอกจะสามารถเปลี่ยนแปลงการลงทะเบียนของตนเพื่อให้ลูกค้าสามารถเลือกกลุ่มข้อมูลนี้ในระหว่างเวลาที่ได้รับอนุญาตผ่านพอร์ทัลของบุคคลภายนอกภายใต้การจัดการการลงทะเบียน >แก้ไข > ส่วน: ระบุข้อมูลลูกค้าที่คุณต้องการ" เลือกกล่องกาเครื่องหมาย การลงทะเบียนโปรแกรม
   • หมายเหตุ:สิ่งนี้จะใช้กับการอนุญาตของลูกค้าใหม่เท่านั้น
     
   • API ใหม่ที่จะเรียกข้อมูลการลงทะเบียน DR มีอยู่ที่ระดับบุคคลที่ 3 แบบกลุ่ม และที่ระดับการอนุญาตของลูกค้าแต่ละราย (ระดับรหัสลูกค้าค้าปลีก) ที่ระบุดังต่อไปนี้:
     ดาวน์โหลด API ที่รองรับ PGE ใหม่ (PDF)
   • API แบบอะซิงโครนัสสําหรับการขอข้อมูลการลงทะเบียน DR สําหรับการอนุญาตทั้งหมดแก่บุคคลที่สาม
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • API แบบซิงโครนัสสําหรับการขอข้อมูลการลงทะเบียน DR ที่ระดับการอนุญาตของลูกค้าแต่ละราย
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

โปรดทราบ: นอกจากการเปลี่ยนแปลงกระบวนการอนุญาตของลูกค้าแล้ว การเปลี่ยนแปลงอื่นๆ ยังสามารถเข้ากันย้อนหลังได้ และเป็นการปรับปรุงโดยสมัครใจที่บุคคลที่สามสามารถเลือกที่จะสนับสนุนได้

หากคุณมีคําถามหรือต้องการความช่วยเหลือเพิ่มเติม โปรดส่งอีเมลไปที่ sharemydata@pge.com

มีอะไรใหม่:

1. ตอนนี้ลูกค้าสามารถได้รับประโยชน์จากกระบวนการอนุญาตคลิก-ผ่านที่มีประสิทธิภาพ
   • เราได้อัปเดตรายละเอียดเกี่ยวกับวิธีที่ลูกค้าสามารถแบ่งปันข้อมูลกับบริษัทของคุณได้
     เรียนรู้วิธีที่ลูกค้าแบ่งปันข้อมูลกับบริษัท
     
     หมายเหตุ: การเปลี่ยนแปลงเหล่านี้ โดยเฉพาะอย่างยิ่งการปรับปรุง UI การอนุญาตของเรา ได้รับการปรับให้เหมาะสมสําหรับอุปกรณ์มือถือ (เช่น โทรศัพท์หรือแท็บเล็ต)
   • มีการเปลี่ยนแปลงในกระบวนการอนุญาตการจัดการที่ลูกค้าสามารถเข้าถึงได้ผ่านบัญชีออนไลน์ของ PG&E:
     • ลูกค้ายังสามารถลบ SAID ออกจากการอนุญาตที่มีอยู่ ขยายวันที่สิ้นสุดการอนุญาต และ/หรือยกเลิกการอนุญาตได้ตลอดเวลา อย่างไรก็ตาม หากต้องการเพิ่ม SAID เพิ่มเติมและ/หรือเปลี่ยนแปลงองค์ประกอบข้อมูลที่ได้รับอนุญาต จําเป็นต้องยกเลิกการอนุญาตที่มีอยู่และต้องสร้างการอนุญาตใหม่
2. หากต้องการ ตอนนี้บุคคลที่สามสามารถใช้ API นี้เพื่อเพิกถอนการอนุญาตของลูกค้าแต่ละรายโดยใช้โทเค็นการเข้าถึงของลูกค้าของบุคคลที่สาม (ที่ให้ไว้ในระหว่างกระบวนการลงทะเบียนบุคคลที่สามของ SMD เบื้องต้น) ผ่านการดําเนินการลบ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   หมายเหตุ 1:สําหรับการดําเนินการของ PG&E พารามิเตอร์ AuthorizationID มีค่าเท่ากับ SubscriptionID
   
   หมายเหตุ 2: API ใหม่ช่วยให้บุคคลที่สามสามารถเพิกถอน (ยกเลิก) การอนุญาตได้ อย่างไรก็ตาม เฉพาะลูกค้าเท่านั้นที่สามารถลบ SA ID และ/หรืออัปเดตวันที่สิ้นสุดการอนุญาตผ่านหน้าการจัดการการอนุญาต SMD ของเรา
   
   การแจ้งเตือน:เช่นเดียวกับคําขอข้อมูล API ทั้งหมด บุคคลที่สามต้องขอ Token Pair ใหม่ (การเข้าถึงของลูกค้า + รีเฟรชโทเค็น) โดยใช้โทเค็นการรีเฟรชล่าสุดของพวกเขาก่อน
   
   การแจ้งเตือนถึงระยะเวลาหมดอายุของโทเค็น:
   • โทเค็นการเข้าถึง:1 ชั่วโมง
   • โทเค็นการเข้าถึงของลูกค้า: 5 นาที
   • โทเค็นการรีเฟรชที่สอดคล้องกัน: 1Yr
3. ขณะนี้บุคคลที่สามสามารถสร้างการลงทะเบียน Share My Data (SMD) ได้หลายรายการโดยใช้ชื่อบริษัทและหมายเลขประจําตัวผู้เสียภาษีเดียวกันหากจําเป็น อย่างไรก็ตาม ชื่อที่แสดง (ซึ่งลูกค้าเห็นเมื่ออนุญาต) ยังคงต้องไม่ซ้ํากัน
   
   หมายเหตุ:การเปลี่ยนแปลงทั้งหมดข้างต้นสามารถเข้ากันได้และเป็นการปรับปรุงโดยสมัครใจที่บุคคลที่สามสามารถเลือกที่จะสนับสนุนได้ ดาวน์โหลดเอกสารสนับสนุนสําหรับรุ่นนี้:
   
   SUPPORT_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORT_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORT_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

20 ธันวาคม 2015

การเปลี่ยนแปลงที่จําเป็น:การอัปเดต SMD 2.0 ต่อไปนี้จําเป็นต้องมีการเปลี่ยนแปลงในส่วนของบุคคลที่สาม

1. เพื่อเป็นการตอบแทนบุคคลที่สามที่มีการใช้งาน GBCMD (Green Button Connect My Data) ที่สาธารณูปโภคหลายแห่งนอกเหนือจาก PG&E เราจะส่งต่อข้อมูลกลับมา ID ศุลกากร (กล่าวคือ dataCustodianID=PGE) ในการเปลี่ยนทิศทางไปยังบุคคลที่สามหน้าจอการเลือกขอบเขตของบุคคลที่สามURI ในระหว่างลําดับการอนุญาต OAuth
2. คําขอ API ที่ยอมรับพารามิเตอร์วันที่ (เช่น คําขอแบบกลุ่ม) ต้องใช้พารามิเตอร์ข้อมูล Zulu (เช่น เผยแพร่สูงสุด/เผยแพร่ต่ําสุด) รูปแบบวันที่อื่น ๆ สําหรับพารามิเตอร์วันที่ในคําขอ API จะไม่ได้รับการสนับสนุน
   • API ที่ยอมรับพารามิเตอร์วันที่จะได้รับการบันทึกตาม APIs.xlsx ที่รองรับที่แนบมา
3. ตัวบ่งชี้ TOU ตามช่วงเวลาที่รวมอยู่ในข้อมูลการใช้ไฟฟ้าที่วัดตามช่วงเวลา (ตามที่เกี่ยวข้อง ตัวบ่งชี้ว่าช่วงเวลา TOU แต่ละช่วงสอดคล้องกับอะไร)
   • โปรดอ้างอิงการแมป ID ของโปรแกรมแบบคงที่ โดยให้รายละเอียดว่าตัวเลข TOU แต่ละช่วงนั้นสอดคล้องกับอะไร (เช่น 1 = ช่วงฤดูร้อน ฯลฯ) (ดูเอกสารแนบ ส่วนประกอบข้อมูลที่รองรับ.xlsx )
4. Client_id ตามที่พบในข้อมูลCustodianScopeSelectionScreenURI (ใช้สําหรับ OAuth ที่ริเริ่มโดยบุคคลภายนอก) และที่ให้ไว้ในคําขอจากบุคคลภายนอกของทรัพยากรข้อมูลแอปพลิเคชันในระหว่างการทดสอบการลงทะเบียนจะได้รับการปรับปรุงเป็น 5 หลักหากยังไม่ได้ทํา (เช่น การเพิ่มเลขศูนย์นําหน้า ฯลฯ) นอกจากนี้ URL จะไม่รวมถึง '&verified=true' ในตอนท้ายอีกต่อไป บุคคลที่สามจะต้องอัปเดต URL ของตนตามนั้น
   • เพื่ออธิบายเพิ่มเติม ข้อมูลCustodianScopeSelectionScreenURI มีลักษณะดังนี้: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX คือ ClientID)
   • ดังนั้น ClientID ปัจจุบันที่ 123 จะเปลี่ยนเป็นบางอย่างเช่น 00123 ซึ่งหมายถึงข้อมูลใหม่ของพวกเขาCustodianScopeSelectionScreenURI จะเป็นดังนี้:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (URL เก่ามีดังต่อไปนี้: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. บุคคลที่สามที่ลงทะเบียนเป็น "ESP" หรือ "ผู้ให้บริการพลังงาน" เปลี่ยนเป็นประเภทผู้ใช้มาตรฐาน ไม่มีการเปลี่ยนแปลงที่ใช้งานได้ เฉพาะในชื่อประเภทผู้ใช้เท่านั้น การแยกประเภทผู้ใช้ ESP (จากประเภทผู้ใช้มาตรฐาน) เป็นการแยกความแตกต่างที่ไม่จําเป็น ทําให้เกิดความสับสนระหว่างขั้นตอนการลงทะเบียนโดยไม่ต้องให้ฟังก์ชันการทํางานที่แตกต่าง ดังนั้นจึงถูกยกเลิก

การปรับปรุงเพิ่มเติมที่เป็นทางเลือก: การเปลี่ยนแปลงต่อไปนี้สามารถเข้ากันได้ และเป็นการปรับปรุงโดยสมัครใจที่บุคคลที่สามสามารถเลือกที่จะสนับสนุนได้

1. บุคคลภายนอกจะสามารถเปลี่ยนแปลง/อัปเดตใบรับรอง SSL ของตนโดยอัตโนมัติ ซึ่งพวกเขาได้แจ้งไว้ตั้งแต่แรกในระหว่างการลงทะเบียน (เช่น เมื่อใบรับรองใกล้หมดอายุ) ผ่านพอร์ทัลของบุคคลภายนอกภายใต้การจัดการการลงทะเบียน >แก้ไข > ส่วนใหม่: ข้อมูลใบรับรอง SSL (ตัวเลือกการอัปเดต)
2. บุคคลที่สามสามารถลงทะเบียนเพื่อรับข้อมูลการเรียกเก็บเงินพื้นฐาน ข้อมูลลูกค้า และข้อมูลก๊าซที่ได้รับอนุญาต  ทั้งลูกค้าที่มีการวัดช่วงและลูกค้าที่ไม่มีการวัดช่วงจะมีสิทธิอนุญาตการแบ่งปันข้อมูลสําหรับ SMD 2.0 ข้อมูลสรุประดับสูงขององค์ประกอบข้อมูลที่มีอยู่ใหม่มีดังนี้:
   • ข้อมูลการเรียกเก็บเงิน: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงและที่ไม่ใช่ช่วง)
     • ตารางอัตรา การเรียกเก็บเงิน $ ทั้งหมด การใช้งานแบบแบ่งระดับ (ตามที่เกี่ยวข้อง) อุปสงค์ (ตามที่เกี่ยวข้อง) ยอดรวม TOU (ตามที่เกี่ยวข้อง)
     • หมายเหตุ: สําหรับลูกค้าที่มิเตอร์แบบไม่ประจําที่ได้รับอนุญาต บุคคลที่สามจะได้รับยอดรวมการใช้การเรียกเก็บเงินเท่านั้น (เช่น ในสรุปการใช้งาน) และไม่มีการอ่านค่าการใช้ช่วงห่าง (เช่น การอ่านค่ารายชั่วโมง/รายวันเนื่องจากไม่มีการอ่านค่าเหล่านี้)
   • ข้อมูลลูกค้า: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงห่างและที่ไม่ใช่ช่วง)
     • ชื่อลูกค้า, ที่อยู่บริการ, ID บัญชี, ID ข้อตกลงบริการ, วันที่เริ่มต้นบริการข้อตกลงบริการ
   • ข้อมูลการใช้ก๊าซตามช่วงเวลา: ( SA ก๊าซที่วัดได้ระหว่างรอบเท่านั้น)
     • การอ่านค่าก๊าซในช่วง (เช่น ทุกวัน)
   • องค์ประกอบข้อมูลใหม่จะถูกทําแผนภาพตามองค์ประกอบข้อมูลที่รองรับที่แนบมาxlsx
   • ลําดับชั้นข้อมูลที่เกี่ยวข้องมีสรุปไว้ในแบบจําลองข้อมูล ESPI ของ PGE.xlsx ที่แนบมา
   • คําจํากัดความสคีมาล่าสุดของ ESPI xml (XSD) ที่ใช้สําหรับองค์ประกอบข้อมูลใหม่เหล่านี้เป็นไปตาม XSD ที่แนบมา หมายเหตุ: XSD สามารถใช้งานร่วมกับรุ่นเก่าได้:
     • espiDerived.xsd (การใช้งานระหว่างกาลและข้อมูลการเรียกเก็บเงิน)
     • Retailcustomer.xsd (ข้อมูลลูกค้า)

หากคุณมีข้อสงสัยหรือต้องการความช่วยเหลือเพิ่มเติม โปรดติดต่อเราได้ที่ ShareMyData@pge.com

18 ธันวาคม 2015
 

การเปลี่ยนแปลงที่จําเป็น: การอัปเดต SMD 2.0 ต่อไปนี้จําเป็นต้องมีการเปลี่ยนแปลงในส่วนของผู้ใช้ที่เข้าถึงข้อมูลของตนเอง:

1. คําขอ API ที่ยอมรับพารามิเตอร์วันที่ (เช่น คําขอแบบกลุ่ม) ต้องใช้พารามิเตอร์ข้อมูล Zulu (เช่น เผยแพร่สูงสุด/เผยแพร่ต่ําสุด) รูปแบบวันที่อื่น ๆ สําหรับพารามิเตอร์วันที่ในคําขอ API จะไม่ได้รับการสนับสนุน
   • API ที่ยอมรับพารามิเตอร์วันที่จะได้รับการบันทึกตาม APIs.xlsx ที่รองรับที่แนบมา
2. ตัวบ่งชี้ช่วงเวลาการใช้งาน (TOU) ที่รวมอยู่ในข้อมูลการใช้ไฟฟ้าที่วัดระยะห่าง (ตามที่เกี่ยวข้อง ตัวบ่งชี้ว่าช่วงเวลา TOU ใดที่สอดคล้องกับแต่ละระยะห่าง)
   • โปรดอ้างอิงการแมป ID ของโปรแกรมแบบคงที่ โดยให้รายละเอียดว่าตัวเลข TOU แต่ละช่วงนั้นสอดคล้องกับอะไร (เช่น 1 = ช่วงฤดูร้อน ฯลฯ) (ดูเอกสารแนบ ส่วนประกอบข้อมูลที่รองรับ.xlsx )

การปรับปรุงเพิ่มเติมที่เป็นทางเลือก: การเปลี่ยนแปลงต่อไปนี้สามารถเข้ากันได้ และเป็นการปรับปรุงโดยสมัครใจที่บุคคลที่สามสามารถเลือกที่จะสนับสนุนได้

1. ผู้ใช้ที่สามารถเข้าถึงด้วยตนเองจะสามารถเปลี่ยนแปลง/อัปเดตใบรับรอง SSL ของตนโดยอัตโนมัติ ซึ่งผู้ใช้ได้แจ้งไว้ตั้งแต่แรกในระหว่างการลงทะเบียน (เช่น เมื่อใบรับรองใกล้หมดอายุ) ผ่านทางพอร์ทัลของบุคคลที่สามภายใต้การจัดการการลงทะเบียน > แก้ไข > ส่วนใหม่: ข้อมูลใบรับรอง SSL (ตัวเลือกการอัปเดต)
2. การลงทะเบียนผู้ใช้แบบเข้าถึงด้วยตนเองจะได้รับการอัปเดตเพื่อรวมข้อมูลการเรียกเก็บเงินพื้นฐานที่ได้รับอนุญาต ข้อมูลลูกค้า และข้อมูลก๊าซ ทั้งช่วงการวัดที่เท่ากับข้อตกลงการให้บริการที่วัดแบบไม่ช่วงการวัดจะมีสิทธิ์ได้รับ (ด้วยตนเอง) การอนุญาตสําหรับ SMD 2.0 ข้อมูลสรุประดับสูงขององค์ประกอบข้อมูลที่มีอยู่ใหม่มีดังนี้:
   • ข้อมูลการเรียกเก็บเงิน: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงและที่ไม่ใช่ช่วง)
     • ตารางอัตรา การเรียกเก็บเงิน $ ทั้งหมด การใช้งานแบบแบ่งระดับ (ตามที่เกี่ยวข้อง) อุปสงค์ (ตามที่เกี่ยวข้อง) ยอดรวม TOU (ตามที่เกี่ยวข้อง)
     • หมายเหตุ: สําหรับลูกค้าที่มิเตอร์แบบไม่ประจําที่ได้รับอนุญาต บุคคลที่สามจะได้รับยอดรวมการใช้การเรียกเก็บเงินเท่านั้น (เช่น ในสรุปการใช้งาน) และไม่มีการอ่านค่าการใช้ช่วงห่าง (เช่น การอ่านค่ารายชั่วโมง/รายวันเนื่องจากไม่มีการอ่านค่าเหล่านี้)
   • ข้อมูลลูกค้า: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงห่างและที่ไม่ใช่ช่วง)
     • ชื่อลูกค้า, ที่อยู่บริการ, ID บัญชี, ID ข้อตกลงบริการ, วันที่เริ่มต้นบริการข้อตกลงบริการ
   • ข้อมูลการใช้ก๊าซตามช่วงเวลา: ( SA ก๊าซที่วัดได้ระหว่างรอบเท่านั้น)
     • การอ่านค่าก๊าซในช่วง (เช่น ทุกวัน)
   • องค์ประกอบข้อมูลใหม่จะถูกทําแผนภาพตามองค์ประกอบข้อมูลที่รองรับที่แนบมาxlsx
   • ลําดับชั้นข้อมูลที่เกี่ยวข้องมีสรุปไว้ในแบบจําลองข้อมูล ESPI ของ PGE.xlsx ที่แนบมา
   • คําจํากัดความสคีมาล่าสุดของ ESPI xml (XSD) ที่ใช้สําหรับองค์ประกอบข้อมูลใหม่เหล่านี้เป็นไปตาม XSD ที่แนบมา หมายเหตุ: XSD สามารถใช้งานร่วมกับรุ่นเก่าได้:
     • espiDerived.xsd (การใช้งานระหว่างกาลและข้อมูลการเรียกเก็บเงิน)
     • Retailcustomer.xsd (ข้อมูลลูกค้า)

หากคุณมีข้อสงสัยหรือต้องการความช่วยเหลือเพิ่มเติม โปรดติดต่อเราได้ที่ ShareMyData@pge.com

18 ธันวาคม 2015
 

การเปลี่ยนแปลงที่จําเป็น: การอัปเดต SMD 2.0 ต่อไปนี้จําเป็นต้องมีการเปลี่ยนแปลงในส่วนของการดําเนินการ CCA

1. คําขอเฉพาะกิจ (เช่น สําหรับข้อมูลในอดีต) ต้องดําเนินการโดยใช้พารามิเตอร์วันที่ของเวลา Zulu รูปแบบวันที่อื่น ๆ สําหรับพารามิเตอร์วันที่ในคําขอ API จะไม่ได้รับการสนับสนุน
2. ฟีดการใช้งานจํานวนมากรายวันจะเริ่มรวมข้อมูลการเรียกเก็บเงินพื้นฐาน ในขณะที่ฟีดลูกค้าจํานวนมากรายวันจะมีข้อมูลลูกค้าเพิ่มเติม ข้อมูลใหม่นี้จะได้รับทั้งสําหรับลูกค้าที่ตรวจวัดช่วงที่พวกเขาได้รับข้อมูลในปัจจุบัน และสําหรับลูกค้าที่ตรวจวัดช่วงไม่ได้ในเขตการขายของพวกเขาที่พวกเขาไม่ได้รับข้อมูลในปัจจุบัน สุดท้าย ค่าการใช้ตามช่วงเวลาที่ให้ไว้ในฟีดการใช้งานจํานวนมากรายวันจะรวมถึงตัวบ่งชี้ TOU ตามช่วงเวลา หากมี ข้อมูลสรุประดับสูงขององค์ประกอบข้อมูลใหม่มีดังต่อไปนี้:
   • ข้อมูลการเรียกเก็บเงิน: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงและที่ไม่ใช่ช่วง)
     • ตารางอัตรา การเรียกเก็บเงิน $ ทั้งหมด การใช้งานแบบแบ่งระดับ (ตามที่เกี่ยวข้อง) อุปสงค์ (ตามที่เกี่ยวข้อง) ยอดรวม TOU (ตามที่เกี่ยวข้อง)
   • (เพิ่มเติม) ข้อมูลลูกค้า: (สําหรับทั้ง SA ที่ตรวจวัดแบบช่วงห่างและที่ไม่ใช่ช่วง)
     • ชื่อลูกค้า, ที่อยู่บริการ, วันที่เริ่มต้นบริการของข้อตกลงบริการ, ID บัญชี
   • ตัวบ่งชี้ TOU ตามช่วงเวลาที่รวมอยู่ในข้อมูลการใช้ไฟฟ้าที่วัดตามช่วงเวลา (ตามที่เกี่ยวข้อง ตัวบ่งชี้ว่าช่วงเวลา TOU แต่ละช่วงสอดคล้องกับอะไร)
     • โปรดอ้างอิงการแมป ID ของโปรแกรมแบบคงที่ โดยให้รายละเอียดว่าตัวเลข TOU แต่ละช่วงนั้นสอดคล้องกับอะไร (เช่น 1 = ช่วงฤดูร้อน ฯลฯ) (ดูเอกสารแนบ ส่วนประกอบข้อมูลที่รองรับ.xlsx )
   • คําจํากัดความสคีมาล่าสุดของ ESPI xml (XSD) ที่ใช้สําหรับองค์ประกอบข้อมูลใหม่เหล่านี้เป็นไปตาม XSD ที่แนบมา หมายเหตุ XSD สามารถใช้งานร่วมกันได้แบบย้อนหลัง:
     • espiDerived.xsd (การใช้งานระหว่างกาลและข้อมูลการเรียกเก็บเงิน)
     • Retailcustomer.xsd (ข้อมูลลูกค้า)
   • องค์ประกอบข้อมูลใหม่จะถูกทําแผนภาพตามองค์ประกอบข้อมูลที่รองรับที่แนบมาxlsx
   • ลําดับชั้นข้อมูลที่เกี่ยวข้องมีสรุปไว้ในแบบจําลองข้อมูล ESPI ของ PGE.xlsx ที่แนบมา

การปรับปรุงเพิ่มเติมที่เป็นทางเลือก: การเปลี่ยนแปลงต่อไปนี้สามารถเข้ากันได้ และเป็นการปรับปรุงโดยสมัครใจที่บุคคลที่สามสามารถเลือกที่จะสนับสนุนได้

1. CCA สามารถร้องขอข้อมูลลูกค้าแบบเฉพาะกิจได้ที่: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (ส่งสแนปช็อตล่าสุดของข้อมูลลูกค้า ณ เวลาที่ร้องขอ) นอกเหนือจากการแจ้งเตือนรายวันที่ได้รับ
2. CCA จะสามารถเปลี่ยนแปลงใบรับรอง SSL ของตนโดยอัตโนมัติ ซึ่งได้จัดเตรียมไว้ตั้งแต่แรกในระหว่างการลงทะเบียน (เช่น เมื่อใบรับรองใกล้หมดอายุ) ผ่านพอร์ทัลของบุคคลที่สาม ภายใต้การจัดการการลงทะเบียน > แก้ไข > ส่วนใหม่: ข้อมูลใบรับรอง SSL (ตัวเลือกการอัปเดต)

หากคุณมีข้อสงสัยหรือต้องการความช่วยเหลือเพิ่มเติม โปรดติดต่อเราได้ที่ ShareMyData@pge.com

21 สิงหาคม 2558
 

มีอะไรใหม่:

1. การเปลี่ยนแปลงพารามิเตอร์ของสถานะและทรัพยากร URI ในคําตอบ Oauth
   • ในฐานะที่เป็นส่วนหนึ่งของคําขอรหัสการอนุญาต OAuth บุคคลที่สามมีตัวเลือกในการส่งพารามิเตอร์สถานะซึ่ง PG&E จะส่งกลับไปยังบุคคลที่สาม นอกจากนี้ PG&E จะส่งรหัสการอนุญาตเมื่อการอนุญาตเสร็จสมบูรณ์ สามารถใช้พารามิเตอร์สถานะที่เป็นทางเลือกนี้เพื่อช่วยให้บุคคลที่สามสามารถระบุตําแหน่งที่เริ่มต้นคําขอ และเพื่อเชื่อมโยงคําขอกลับไปยังการอนุญาตที่พวกเขาเริ่มต้น
   • ในฐานะที่เป็นส่วนหนึ่งของการสําเร็จตามคําขอโทเค็น เราแบ่งปันทรัพยากร URL และการอนุมัติ URL กลับแยกต่างหากจากข้อมูลโทเค็น ปัจจุบัน URI เหล่านี้ถูกพลิกและเป็นส่วนหนึ่งของการเผยแพร่นี้ เราจะแก้ไขให้ถูกต้อง

ข้อบกพร่องคงที่:

1. วันที่เริ่มต้นที่เผยแพร่-สูงสุดและต่ําสุดที่เผยแพร่
   ขณะนี้ PG&E กําหนดให้บุคคลที่สามส่งพารามิเตอร์ที่ตีพิมพ์ในนาทีและสูงสุดในวินาทีที่ตีพิมพ์สําหรับการร้องขอข้อมูลแต่ละครั้งเพื่อแจ้งให้ PG&E ทราบถึงระยะเวลาที่พวกเขาขอข้อมูล เรากําลังดําเนินการเปลี่ยนแปลงเพื่อจัดการคําขอสําหรับสถานการณ์ต่อไปนี้:
   • ไม่มีค่าต่ําสุดและค่าสูงสุดที่เผยแพร่
   • ค่าต่ําสุดและค่าสูงสุดที่เผยแพร่อยู่ใน UTC
   • ค่าต่ําสุดและค่าสูงสุดที่ตีพิมพ์อยู่ใน epoch วินาที
   ในกรณีที่พารามิเตอร์หายไป PG&E จะส่งคืนวันที่เริ่มต้น ซึ่งตรงข้ามกับข้อความแสดงข้อผิดพลาดที่ส่งคืนก่อนการเปลี่ยนแปลงนี้ ค่าเริ่มต้น ในกรณีของเรา คือข้อมูลหนึ่งวันสําหรับวันที่ T-2 หากมีพารามิเตอร์และจัดรูปแบบอย่างถูกต้อง เราจะยังคงปฏิบัติตามพารามิเตอร์ต่อไป
2. แก้ไขวันที่ในการอนุญาต xml
   ขณะนี้อยู่ในการอนุญาต xml เราได้แบ่งปันวันที่เผยแพร่และวันที่อนุญาต วันที่เหล่านี้เป็นมิลลิวินาทีเมื่อเทียบกับวินาทีซึ่งเป็นมาตรฐาน เรากําลังแก้ไขมันเพื่อส่งกลับมาในวินาทีอีพอชแทนที่จะเป็นมิลลิวินาที
3. XML ที่ไม่ถูกต้องที่ส่งคืนสําหรับ /ทรัพยากร/การสมัครสมาชิก/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   ขณะนี้เรากําลังส่งกลับการตอบสนองที่ไม่ถูกต้องสําหรับ GET ระดับทรัพยากรข้างต้นซึ่งโครงสร้างของ XML ไม่ถูกต้องและเรากําลังทําซ้ํารายการสําหรับแต่ละช่วงเวลาแทนที่จะสร้างบล็อกระยะห่างเดียวเป็นระยะเวลา 24 ชั่วโมง
   
   กําลังได้รับการแก้ไขและจะมีการส่งคืนบล็อกระยะห่างเพียงบล็อกเดียวสําหรับบล็อกระยะห่าง 24 บล็อก

มีคําถามหรือข้อกังวลหรือไม่ โปรดติดต่อ ShareMyData@pge.com

• ลูกค้าอนุญาตให้คุณเข้าถึงข้อมูลของพวกเขาผ่าน My Energy ซึ่งเป็นบัญชีออนไลน์ของ PG&E สําหรับภาพรวมโดยละเอียดเกี่ยวกับวิธีที่ลูกค้าสามารถอนุญาตให้บุคคลที่สามหรือหน่วยงานอื่นเข้าถึงข้อมูลของพวกเขา โปรดดูภาพรวมบุคคลที่สามของการแบ่งปันข้อมูลของฉัน

ไปที่รายละเอียดการอนุญาต

• ขณะนี้ไม่มีข้อจํากัด

• ลูกค้าสามารถเลือกระยะเวลาที่คุณสามารถเข้าถึงข้อมูลของตนได้ หรือสามารถเปิดระยะเวลาการอนุญาตไว้ได้
• แอปพลิเคชันของคุณสามารถตรวจสอบวันที่สิ้นสุดของการอนุญาตของลูกค้าพร้อมกับรายละเอียดการอนุญาตอื่น ๆ โดยโทรไปที่ API ทรัพยากรการอนุญาต (เช่น .../espi/1_1/resource/Authorization และ/หรือ.../espi/1_1/resource/Authorization/{AuthorizationID})
• หรือคุณสามารถตรวจสอบวันที่สิ้นสุดการอนุญาตด้วยตนเองได้โดยเข้าสู่ระบบบัญชีของคุณและเลือก จัดการการอนุญาต

• หากลูกค้าเลือกระยะเวลาการอนุญาตที่กําหนดไว้ การอนุญาตของพวกเขาจะหมดอายุเมื่อสิ้นสุดระยะเวลาดังกล่าว หากพวกเขายกเลิกการอนุญาต การอนุญาตของพวกเขาจะหมดอายุในวันหลังจากที่ยกเลิกการอนุญาต
• หากลูกค้าเลือก ไม่จํากัด เป็นระยะเวลาการอนุญาต การอนุญาตของลูกค้าจะไม่หมดอายุ หมายเหตุ ในการพิจารณาของผู้ให้บริการการตอบสนองอุปสงค์ตามกฎข้อ 24 และโปรแกรมอื่น ๆ ที่ใช้ Share My Data อาจมีการให้การแก้ไขภายหลังข้อเท็จจริงสําหรับช่วงวันที่ที่ได้รับอนุญาตก่อนหน้านี้แก่บุคคลที่สามเป็นเวลาสูงสุดสามปีหลังจากหมดอายุการอนุญาต
• ดู “จะดําเนินการแก้ไขข้อมูลอย่างไร” สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการรับการแก้ไข

• ลูกค้า PG&E รายใดที่มี ID บริการสําหรับแก๊สหรือไฟฟ้าที่ใช้งานได้ในปัจจุบันสามารถอนุญาตให้คุณเข้าถึงข้อมูลของพวกเขาโดยใช้เครื่องมือแชร์ข้อมูลของฉันใหม่

• ลูกค้าที่สนใจจะแบ่งปันข้อมูลผ่านโปรแกรมแชร์ข้อมูลของฉัน จะได้รับการสนับสนุนให้ลงทะเบียนบัญชี My Energy ซึ่งจะทําให้กระบวนการทั้งหมดมีประสิทธิภาพมากขึ้น และยังช่วยให้พวกเขาสามารถจัดการการอนุญาตทางออนไลน์ได้
• ลูกค้าสามารถสมัครบัญชี My Energy ได้ในระหว่างขั้นตอนการอนุญาต
• มีกระบวนการแบบแมนวลสําหรับลูกค้าเพื่อขอรับแบบฟอร์มการอนุญาตแชร์ข้อมูลของฉันทางออนไลน์และส่งแบบฟอร์มที่กรอกข้อมูลแล้วทางอีเมล
• สําหรับข้อมูลเพิ่มเติมเกี่ยวกับกระบวนการแบบแมนนวล โปรดติดต่อเราที่ ShareMyData@pge.com

• ลูกค้าต้องให้อนุญาตด้วยตนเองทางออนไลน์ผ่านบัญชีออนไลน์ของ PG&E อย่างไรก็ตาม หากพวกเขากรอกและลงนามในแบบฟอร์มการอนุญาตแชร์ข้อมูลของฉัน คุณสามารถส่งแบบฟอร์มดังกล่าวให้แก่ PG&E ในนามของพวกเขา

ดาวน์โหลดแบบฟอร์มการอนุญาตหรือการเพิกถอนการอนุญาตของลูกค้าสําหรับการแชร์ข้อมูลของฉัน (PDF, 308 KB)

• คุณสามารถอัปเดต OAuth URI ของคุณได้โดยการเข้าสู่ระบบบัญชีของคุณ นําทางไปยัง จัดการการลงทะเบียน > แก้ไข > และอัปเดตฟิลด์ภายใต้หัวข้อข้อมูล OAuth 2.0

• คุณสามารถอัปเดต URI การแจ้งเตือนของคุณโดยเข้าสู่ระบบบัญชีของคุณ ไปที่ จัดการการลงทะเบียน > แก้ไข > และอัปเดตฟิลด์ภายใต้หัวข้อ ข้อมูลการเข้าถึงข้อมูล

• คุณสามารถอัปเดตใบรับรอง SSL ของคุณได้โดยเข้าสู่ระบบบัญชีของคุณ ไปที่ จัดการการลงทะเบียน > แก้ไข > และเลือก "อัปเดต" ในส่วน ข้อมูลใบรับรอง SSL โปรดทราบว่าสําหรับการอัปโหลดใบรับรองใหม่ การอัปเดตระบบ PG&E ด้วยใบรับรองใหม่อาจใช้เวลาหลายวัน  
• อีเมลยืนยันจากทีมสนับสนุน Share My Data จะถูกส่งเมื่อใบรับรองใหม่ถูกนําไปใช้

• เมื่อคุณได้รับอีเมลแจ้งว่าการลงทะเบียนของคุณได้รับการยอมรับแล้ว คุณจะสามารถเข้าสู่ระบบบัญชี Share My Data ของคุณและดาวน์โหลดใบรับรอง SSL ของเราผ่านหน้าดาวน์โหลดใบรับรอง PG&E SSL

เข้าสู่ระบบเพื่อแบ่งปันข้อมูลของฉัน

• แบ่งปันข้อมูลของฉันเป็นไปตามข้อตกลงการใช้งาน Green Button Connect My Data Share My Data ยังใช้ OAuth 2.0 เพื่อขออนุญาต Transport Layer Security (TLS) 1.2 และชุดโปรโตคอลการรักษาความปลอดภัยทางไซเบอร์ขั้นต่ําที่ได้รับอนุมัติจาก NIST (สถาบันมาตรฐานและเทคโนโลยีแห่งชาติ) เพื่อไม่ให้มีการแลกเปลี่ยนข้อมูลอย่างชัดเจน

• การปกป้องข้อมูลของลูกค้าเป็นสิ่งสําคัญที่สุดสําหรับ PG&E PG&E ปฏิบัติต่อข้อมูลเกี่ยวกับลูกค้าของพวกเขา รวมถึงข้อมูลส่วนบุคคล อย่างเป็นความลับ สอดคล้องกับข้อกําหนดทางกฎหมายและระเบียบข้อบังคับทั้งหมด รวมถึงข้อกําหนดที่คณะกรรมาธิการสาธารณูปโภคแห่งรัฐแคลิฟอร์เนียกําหนดไว้และอื่น ๆ  
• เป็นเวลากว่าสองทศวรรษแล้วที่ PG&E และสาธารณูปโภคอื่น ๆ ที่นักลงทุนเป็นเจ้าของในแคลิฟอร์เนียได้อยู่ภายใต้กฎระเบียบ CPUC ที่เข้มงวดมาก ซึ่งห้ามพวกเขาไม่ให้เปิดเผยข้อมูลเฉพาะของลูกค้า เช่น ข้อมูลการเรียกเก็บเงิน แก่บุคคลที่สามโดยไม่ได้รับความยินยอมโดยชัดแจ้งจากลูกค้า  
• เมื่อลูกค้าอนุญาตให้เปิดเผยข้อมูล ถือเป็นความรับผิดชอบของลูกค้าและบุคคลที่สามในการปกป้องข้อมูลดังกล่าว
• ลูกค้าสามารถเลือกที่จะหยุดแบ่งปันข้อมูลกับบุคคลที่สามได้ทุกเมื่อ โดยการเข้าสู่ระบบบัญชีออนไลน์ของ PG&E และยกเลิกการอนุญาต นโยบายความเป็นส่วนตัวฉบับสมบูรณ์ของ PG&E และประกาศการเข้าถึง การเก็บรวบรวม การจัดเก็บ การใช้ และการเปิดเผยข้อมูลการใช้พลังงาน สามารถดูได้ที่ pge.com/privacy

• ภายในขอบเขตของโปรแกรม Share My Data บุคคลภายนอกจะอยู่ภายใต้กฎความเป็นส่วนตัวและการคุ้มครองข้อมูลลูกค้าที่ระบุไว้ในข้อกําหนดและเงื่อนไขของแพลตฟอร์ม Share My Data และตามข้อกําหนดที่รวมอยู่ในอัตราภาษีการเข้าถึงข้อมูลลูกค้า
• บุคคลที่สามยังอยู่ภายใต้กฎหมายและข้อบังคับอื่น ๆ ทั้งหมดที่เกี่ยวข้องกับการปกป้องความเป็นส่วนตัวของลูกค้า ซึ่งรวมถึงแต่ไม่จํากัดเพียงกฎเกี่ยวกับความเป็นส่วนตัวและการคุ้มครองความปลอดภัยสําหรับข้อมูลการใช้พลังงานที่ CPUC นํามาใช้เป็นเอกสารแนบ D ในการตัดสินใจ 11-07-056 (ไฟฟ้า) ซึ่งสรุปไว้ในกฎไฟฟ้าข้อที่ 27 ของ PG&E และประมวลกฎหมายแพ่งแคลิฟอร์เนียมาตรา 1798.80 – 1798.84
• สําหรับข้อมูลเพิ่มเติม โปรดเลือกลิงก์ด้านล่าง:
  ข้อกําหนดและเงื่อนไขการแบ่งปันข้อมูลของฉัน (PDF, 190 KB)
  กฎทางไฟฟ้าข้อที่ 27 (PDF, 1.6 MB)
  เอกสารแนบ ง. ในการตัดสินใจ 11-07-056 (PDF)
  ค้นหาข้อมูลเพิ่มเติม:ประมวลกฎหมายแพ่งแคลิฟอร์เนีย มาตรา 1798.80 – 1798.84

• โปรดดูลิงก์ด้านล่างสําหรับรายการโดยละเอียดขององค์ประกอบข้อมูลที่รองรับ

รับข้อมูลเพิ่มเติมเกี่ยวกับการเข้าถึงข้อมูล

• ในบางครั้ง ข้อมูลการใช้ช่วงห่างหายไปเนื่องจากกระบวนการตรวจสอบความถูกต้องของข้อมูลต้นน้ําของเราพบว่ามีข้อมูลที่ขาดหายไปหรือไม่ถูกต้องซึ่งอาจจําเป็นต้องมีการประมวลผลเพิ่มเติม (การแก้ไขและหรือการประมาณการ)
• สําหรับลูกค้าที่เรียกเก็บเงินตามช่วงเวลา (เช่น ลูกค้าที่มีข้อพิจารณาเกี่ยวกับการเรียกเก็บเงินตามช่วงเวลาการใช้งาน) อินสแตนซ์เหล่านี้จะได้รับการแก้ไขตามเวลาที่กําหนดเพื่อให้แน่ใจว่าการคํานวณบิลถูกต้องในบิลรายเดือนที่จะมาถึง

• หากคุณต้องการรับการแก้ไขข้อมูล โปรดตรวจสอบให้แน่ใจว่าคุณทําเครื่องหมายในช่อง แจ้งฉัน เนื่องจากข้อมูลคือ พร้อมสําหรับการลงทะเบียน หรือโดยการล็อกอินเข้าสู่บัญชีออนไลน์ของคุณและเลือกช่องทําเครื่องหมายนี้ภายใต้ แก้ไขโปรไฟล์ จากนั้นเราจะรวมการแก้ไขข้อมูลที่ระบบของเราได้บันทึกไว้ในช่วง 24 ชั่วโมงที่ผ่านมา ซึ่งเป็นส่วนหนึ่งของฟีดการใช้งานประจําวัน สําหรับข้อมูลใดก็ตามที่คุณได้รับอนุญาตให้เข้าถึง
• การแก้ไขข้อมูลจะครอบคลุมการเปลี่ยนแปลงใด ๆ สําหรับระยะเวลาที่ได้รับอนุญาตสูงสุดสามปี

หมายเหตุ: ในการพิจารณาของผู้ให้บริการการตอบสนองอุปสงค์ตามกฎข้อ 24 และโปรแกรมอื่น ๆ ที่ใช้ Share My Data อาจมีการให้การแก้ไขภายหลังข้อเท็จจริงสําหรับช่วงวันที่ที่ได้รับอนุญาตก่อนหน้านี้แก่บุคคลที่สามเป็นเวลาสูงสุดสามปีหลังจากหมดอายุการอนุญาต

• PG&E จะส่งการแจ้งเตือนไปยัง URL การแจ้งเตือนของคุณที่ให้ไว้ในระหว่างการลงทะเบียน หากมี การแจ้งเตือนประกอบด้วย URL ที่สอดคล้องกับข้อมูลที่บรรจุไว้ล่วงหน้าแล้วพร้อมให้คุณกลับมาและขอที่ URL ที่ให้ไว้ ข้อมูลจะถูกบรรจุไว้ล่วงหน้าและการแจ้งเตือนจะถูกส่งออกไปในสองสถานการณ์ต่อไปนี้: (1) คุณได้เลือก "แจ้งให้ฉันทราบเมื่อข้อมูลพร้อม" ในโปรไฟล์การลงทะเบียนของคุณ ซึ่งในกรณีนี้เราจะบรรจุข้อมูลประจําวันล่าสุดพร้อมการแก้ไขใด ๆ สําหรับวันที่ที่ผ่านมา หรือ (2) คุณได้ส่งคําขออะซิงโครนัสเฉพาะกิจก่อนหน้านี้ซึ่งข้อมูลที่ร้องขอพร้อมแล้ว สถานการณ์ที่ 1 แสดงไว้ภายใต้หัวข้อ "การเข้าถึงของDATA: การสมัครสมาชิกรายวัน" ของแผนภาพวิธีการเข้าถึงข้อมูลในหน้าการเข้าถึงข้อมูล และสถานการณ์จําลองที่ 2 แสดงอยู่ใต้ "การเข้าถึงดาต้า: AD HOC REQUEST (ASYNCHRONOUS)" ของแผนภาพเดียวกันยังอยู่บนหน้าการเข้าถึงข้อมูล

การเข้าถึงข้อมูลการนัดตรวจข้างต้น

• ข้อมูลการใช้ไฟฟ้าที่ได้รับจาก Share My Data ไม่ใช่ข้อมูลมิเตอร์คุณภาพค่ายอมความ (SQMD) ตามที่ระบุโดย California Independent System Operator (CAISO) SQMD ถูกสร้างขึ้นโดยการคูณข้อมูลเครื่องวัดคุณภาพรายได้ (RQMD) ด้วยปัจจัยการสูญเสียการจ่าย (DLF) ที่ใช้กับระดับแรงดันไฟฟ้าของลูกค้าสําหรับช่วงเวลานั้น การแปลงช่วงการวัดเป็นช่วงเวลาที่กําหนดโดย CAISO แล้วจึงสรุปผลสําหรับแต่ละช่วงเวลาเป็นระดับรวมที่กําหนดโดย CAISO
  
• PG&E กําลังดําเนินการธงประเภท "QualityOfReading" (QOR) ที่จัดทําโดยมาตรฐาน ESPI เพื่อสื่อสารว่าข้อมูลเป็นคุณภาพรายได้หรือไม่ ประเภท QOR จะบันทึกค่าคุณภาพที่เป็นไปได้ที่แตกต่างกันสําหรับข้อมูลการใช้งาน รวมถึงค่าที่ชัดเจนสําหรับ “ข้อมูลมิเตอร์วัดคุณภาพรายได้” หรือ “RQMD” PG&E จะใช้ประเภท QOR นี้ในการส่งข้อมูลดังนี้:
  • PG&E สนับสนุน ESPI ที่จัดให้ในคลาส "สรุปการใช้งาน" ซึ่งจะใช้เพื่อระบุวันที่ที่ข้อตกลงบริการถูกเรียกเก็บเงิน จํานวนการใช้งานที่เรียกเก็บเงิน และคุณภาพข้อมูลการใช้งาน ณ เวลาที่ร้องขอ สรุปการใช้งานจะปรากฏขึ้นเมื่อใบแจ้งหนี้พร้อมสําหรับข้อมูลที่ขอและจะมีธงสองธง (องค์ประกอบ) ของประเภท QOR:
    • การใช้งานสรุปคุณภาพองค์ประกอบการอ่าน (ที่ระดับการใช้งานสรุป) ที่ระบุคุณภาพ ณ เวลาที่ขอค่าการใช้ช่วงเวลาล่าสุดที่ให้ไว้บวกกับการแก้ไขที่สอดคล้องกับการใช้งานสรุปการเรียกเก็บเงินวันที่ของช่วงเวลา
    • องค์ประกอบคุณภาพเริ่มต้นสําหรับการบริโภคโดยรวมระยะเวลาสุดท้าย (เป็นส่วนหนึ่งของการใช้งานสรุป การใช้งานโดยรวมระยะเวลาสุดท้ายการอ่านประเภทอ้างอิง) ที่ระบุคุณภาพของการใช้งานที่เรียกเก็บทั้งหมด
  • นอกจากนี้ PG&E ยังจะสื่อสารคุณภาพของข้อมูลการใช้งานที่ระดับช่วงเวลา ณ เวลาที่ร้องขอโดยใช้ IntervalReading.ReadingQuality.Quality element

• ในระหว่างการลงทะเบียน คุณสามารถเลือกจํานวนข้อมูลประวัติที่คุณต้องการได้ 24, 36 หรือ 48 เดือน ภายใต้เมนูดร็อปดาวน์ "ข้อมูลทางประวัติศาสตร์ที่ร้องขอมีจํานวนเท่าใด"
• ในฐานะที่เป็นส่วนหนึ่งของการอนุญาตของลูกค้าที่อนุญาตให้คุณเข้าถึงข้อมูลของพวกเขา ระยะเวลาการอนุญาตในอดีตจะถูกตั้งค่าเริ่มต้นเป็นการเลือกการลงทะเบียนของคุณสําหรับ Service ID (คะแนนการใช้งาน) ที่รวมอยู่ในการอนุญาต
• คุณสามารถอัปเดตข้อมูลประวัติที่คุณร้องขอ โดยเข้าสู่ระบบบัญชีของคุณ ไปที่ จัดการการลงทะเบียน > แก้ไข > และเลือกจากรายการแบบเลื่อนลงที่ชื่อ "ข้อมูลประวัติที่ร้องขอมีจํานวนเท่าใด"
• โปรดทราบว่าข้อมูลที่ให้ไว้ในคําขอในอดีตจะเริ่มต้นด้วยวันที่ที่ลูกค้าทําการอนุญาต ตรงข้ามกับวันที่ที่คุณส่งคําขอไปยัง API

หมายเหตุ: การเปลี่ยนแปลงข้อมูลประวัติที่คุณร้องขอจะส่งผลต่อการอนุญาตของลูกค้าใหม่เท่านั้น ในขณะที่การอนุญาตของลูกค้าก่อนหน้านี้จะแสดงการเลือกของคุณในเวลาที่อนุญาต

• ตามมาตรฐาน ESPI คําตอบจะใช้มาตรฐานการเผยแพร่ Atom โปรดเลือกลิงก์ด้านล่างเพื่อดูรายการ API ทั้งหมดที่รองรับ พร้อมกับองค์ประกอบข้อมูลที่มีอยู่

รับข้อมูลเพิ่มเติมเกี่ยวกับการเข้าถึงข้อมูล

• ID บริการไฟฟ้าและก๊าซที่ใช้งานซึ่งติดตั้งและอ่านโดย PG&E จะมีสิทธิ์ในการอนุญาตผ่านแพลตฟอร์ม Share My Data
• หาก Service ID ที่เกี่ยวข้องกับการเปลี่ยนแปลงการอนุญาตเนื่องจากเหตุผลใดเหตุผลหนึ่งต่อไปนี้ การอนุญาตจะเปลี่ยนเป็น Service ID ใหม่และการเข้าถึงข้อมูลการใช้งานตามช่วงเวลาในอดีตจะยังคงดําเนินต่อไป:
  • ปิดชั่วคราวเนื่องจากไม่มีการชําระเงิน
  • ย้ายไปที่การเรียกเก็บเงินตามช่วงเวลา
  • การแลกเปลี่ยนเครื่องวัด
  • การเปลี่ยนแปลงอัตรา
• สถานการณ์อื่น ๆ ที่ส่งผลให้เกิดการเปลี่ยนแปลงใน ID บริการ เช่น การย้ายสถานที่หรือการเปลี่ยนแปลงบริษัท จะทําให้การเข้าถึงสิ้นสุดลง นอกจากนี้ หากบัญชีถูกยกเลิกการเชื่อมโยงจากบัญชี My Energy ของคุณ ID บริการพื้นฐานทั้งหมดที่ได้รับอนุญาตผ่าน Share My Data จะไม่ได้รับอนุญาต

• ในการกําหนดความละเอียดของข้อมูลระยะห่างที่ได้รับอนุญาต โปรดอ้างอิงองค์ประกอบความยาวของระยะห่างตามที่ให้ไว้ในมาตรฐาน ESPI
• PG&E กําลังให้ข้อมูลการใช้งานตามช่วงต่าง ๆ ที่ละเอียดเหมือนกับที่เก็บรวบรวมเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน ซึ่งโดยทั่วไปจะเป็นรายชั่วโมงหรือ 15 นาทีสําหรับข้อมูลไฟฟ้าและรายวันสําหรับข้อมูลก๊าซสําหรับลูกค้าที่มีมิเตอร์วัดช่วง ในขณะที่อาจแตกต่างกันไปตามลูกค้า การใช้มิเตอร์วัดช่วงเวลาไฟฟ้าโดยทั่วไปจะพร้อมให้บริการในระดับรายชั่วโมงสําหรับลูกค้าที่พักอาศัยส่วนใหญ่ และในระดับช่วงเวลา 15 นาทีสําหรับลูกค้าเชิงพาณิชย์ส่วนใหญ่ และการใช้มิเตอร์วัดช่วงเวลาก๊าซโดยทั่วไปจะพร้อมให้บริการในระดับรายวันสําหรับลูกค้าส่วนใหญ่
• สําหรับมิเตอร์ที่ไม่ใช่อินเตอร์วัล จะมีการให้ข้อมูลเมื่อมีข้อมูล

• สําหรับลูกค้าของ PG&E ส่วนใหญ่ที่มี Smart Meter ติดตั้งอยู่ ข้อมูลการใช้ช่วงห่างของกระแสไฟฟ้าและก๊าซจะพร้อมใช้งานภายในสิ้นวันถัดไปผ่านแพลตฟอร์ม Share My Data
• ลูกค้าไฟฟ้าของ PG&E ขนาดเล็กที่มีผู้ให้บริการสายไฟติดตั้งมิเตอร์ MV90 อาจต้องใช้เวลาเพิ่มเติมเพื่อให้ข้อมูลพร้อมใช้งาน

• แม้ว่าเราไม่สามารถสนับสนุนการตั้งค่า API ของคุณได้โดยตรง แต่เรามีทรัพยากรมากมายที่พร้อมให้ความช่วยเหลือด้าน IT และทรัพยากรทางเทคนิคของคุณในกระบวนการพัฒนา โปรดดูหน้าเอกสาร API ของเราเพื่อเรียนรู้เพิ่มเติม โปรดติดต่อShareMyData@pge.comหากมีคําถามเพิ่มเติมใด ๆ

สําหรับข้อมูลเพิ่มเติม โปรดไปที่ส่วนติดต่อของการตั้งโปรแกรมแอปพลิเคชัน (API)