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

เพื่อให้สอดคล้องกับมาตรฐานการอนุญาตปัจจุบันของ 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 ตามตัวอย่างด้านล่าง
  • response_type = รหัส (ค่าคงที่)
• พารามิเตอร์คําขอทางเลือก (ต่างๆ):
  • สถานะ = พารามิเตอร์สถานะทึบแสงที่เป็นทางเลือกตามที่มาตรฐาน 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_476AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollmentระยะเวลา=900_3600;BlockDuration=ทุกวัน;HistoryLength={3P Registered historical length};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} เช่น: https://เอพีพีจีการอนุญาต com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
URI:{AuthorizationURI} เช่น: https://เอพีพีจีcom/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
ลูกค้าทรัพยากรURI:{CustomerResourceURI} เช่น:https://เอพีพีจีcom/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

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

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

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

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

ตัวอย่าง: รีเฟรชคําขอ
โทเค็น POST: 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",
"token_type": "Bearer",
"expires_in": 3600
"Reresh_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;BlockDuration=ทุกวัน;HistoryLength={3P Registered historical length};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
"URI ทรัพยากร": "https://เอพีพีจีcom/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ",
"การอนุญาตURI": "https://เอพีพีจี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 แสดงอยู่ใต้ "การเข้าถึงDATA: 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}& publisheded-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}

รหัสการสมัครสมาชิก = 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}& publishededmax={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 มีนาคม 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. การเปลี่ยนการใช้ ID จํานวนมาก 5 หลักของบุคคลที่สามด้วย ID ลูกค้าของบุคคลที่สามสําหรับขั้นตอนการอนุมัติออนไลน์
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: องค์ประกอบของ
บริการบล็อก
ไฟดับ PG&E UUID
Service ID
การเปลี่ยนแปลงในอนาคตไปเป็นสถานะของบริการ
SA สถานะ
บริการ
วันที่เริ่มต้นบริการ ที่อยู่
บริการ พิกัดอัตรา
ภาษีปัจจุบัน พิกัดอัตราภาษี
บริการในอดีต (Medical Baseline, ใส่ใจ FERA TBS CCA_TBS, แรงดันไฟฟ้าและสินค้าโภคภัณฑ์ในปัจจุบันของ Solar Choice
หมายเลข
มิเตอร์วัดแรงดันไฟฟ้า
ของการบริการที่เรียกเก็บเงินในอดีต จํานวนมิเตอร์วัด
กระแสไฟฟ้า ประเภท
มิเตอร์ รอบ
การอ่านที่ผ่านมา มิเตอร์
ที่เรียกเก็บเงินในอดีต ตัวเลือกอัตราสแตนด์บายปัจจุบัน หากตัวบ่งชี้
การสร้างในสถานที่ ตัวเลือกอัตรา
สแตนด์บายที่เรียกเก็บเงินในอดีต EDS:
ประวัติวันที่
เริ่มบิลองค์ประกอบ
การเรียกเก็บเงิน วันที่สิ้นสุด
การเรียกเก็บเงิน ค่าใช้จ่ายรวม ($)
ยอดรวมบิล kWh
EDS: ชื่อของประวัติการเรียกเก็บเงินตามระดับชั้นของผู้ให้บริการ
(ถ้ามี)
EDS: ระยะเวลาในการ
ออกบิลของรายการ EDS: ชื่อ (มากกว่าระดับอ้างอิง 1%-30%)
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($10023)
รายละเอียดของบิล TOU kWh ในอดีต (ยกเว้นบิล ABS-TX ที่เรียกเก็บเงิน)
EDS: ระยะเวลาใบเรียกเก็บรายการ (สําหรับการแบ่ง TOU)
EDS: ชื่อ (ของค่าธรรมเนียม TOU)
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($10023)
ประวัติการแยก
อุปสงค์ของบิล EDS: ช่วงเวลาการออกบิลรายการ (สําหรับการแบ่งความต้องการ)
EDS: ชื่อ
EDS: ปริมาตร (1234.2)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($10023)
ประวัติรายการ
บรรทัดใบแจ้งหนี้ EDS: ระยะเวลาในการ
ออกบิลของรายการ EDS: ชื่อค่าธรรมเนียม (DWR Bond Charge)
EDS: ปริมาตร (1234.2)
EDS: หน่วย (kWh)
EDS: อัตรา ($0.032/kWh)
EDS: ค่าใช้จ่าย ($10023)
ช่วงเวลา
การใช้งานที่ผ่านมา ระยะเวลาช่วงเวลาการใช้งานเริ่มต้น
(เป็นวินาที)
ปริมาณการใช้ช่วงเวลา (1234.2)
หน่วย (kWh/Therms)
ชื่อโปรแกรม
การตอบสนองความต้องการสาธารณูปโภค (DR)
วันที่สิ้นสุดที่เร็วที่สุดโดยไม่มีภาระผูกพัน
ทางการเงินวันที่สิ้นสุดที่เร็วที่สุดโดยไม่คํานึงถึงภาระผูกพัน
ทางการเงิน สถานะ
โปรแกรม DR วันที่
ลงทะเบียนโปรแกรม DR วันที่
ยกเลิกการลงทะเบียนองค์ประกอบ
ข้อมูล ค่าเวลาท้องถิ่นของ
สินค้าโภคภัณฑ์ (รายละเอียด DST)
ทิศทาง
พลังงานคุณภาพ
ข้อมูลเริ่มต้นอํานาจของตัวคูณสิบ (สําหรับค่าการใช้งานตามช่วงเวลา)
พลังของตัวคูณสิบตัว (สําหรับความต้องการที่เรียกเก็บเงิน)
พลังของตัวคูณสิบตัว (สําหรับการใช้งานทั้งหมดที่เรียกเก็บเงิน)
ความยาวช่วงเวลา(ของการอ่านการใช้งาน)
สกุลเงินของต้นทุน
รวมบิล ตัวบ่งชี้ช่วงเวลาไฟฟ้า 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_47AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollmentระยะเวลา=900_3600;BlockDuration=ทุกวัน;HistoryLength={3P Registered historical length};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} เช่น: https://เอพีพีจีการอนุญาต com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     URI:{AuthorizationURI} เช่น: https://เอพีพีจีcom/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     ลูกค้าทรัพยากรURI:{CustomerResourceURI} เช่น:https://เอพีพีจี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, 49 KB)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) ในการเปลี่ยนทิศทางไปยัง ThirdPartyScopeSelectionScreenURI ในระหว่างลําดับการอนุญาต 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 (URI เก่าเป็นดังนี้: 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 และการอนุมัติ URLI กลับแยกต่างหากจากข้อมูลโทเค็น ปัจจุบัน URI เหล่านี้ถูกพลิกและเป็นส่วนหนึ่งของการเผยแพร่นี้ เราจะแก้ไขให้ถูกต้อง

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

1. วันที่เริ่มต้นที่เผยแพร่-สูงสุดและต่ําสุดที่เผยแพร่
   ในปัจจุบัน PG&E บังคับให้บุคคลที่สามส่งพารามิเตอร์ต่ําสุดที่เผยแพร่และสูงสุดที่เผยแพร่ในหน่วยวินาทีอีพอคสําหรับการร้องขอข้อมูลแต่ละครั้งเพื่อแจ้ง PG&E เกี่ยวกับระยะเวลาที่พวกเขาขอข้อมูล เรากําลังดําเนินการเปลี่ยนแปลงเพื่อจัดการคําขอสําหรับสถานการณ์ต่อไปนี้:
   • ไม่มีค่าต่ําสุดและค่าสูงสุดที่เผยแพร่
   • ค่าต่ําสุดและค่าสูงสุดที่เผยแพร่อยู่ใน UTC
   • ค่าต่ําสุดและค่าสูงสุดที่ตีพิมพ์อยู่ใน epoch วินาที
   ในกรณีที่พารามิเตอร์หายไป PG&E จะส่งคืนวันที่เริ่มต้น ซึ่งตรงข้ามกับข้อความแสดงข้อผิดพลาดที่ส่งคืนก่อนการเปลี่ยนแปลงนี้ ค่าเริ่มต้น ในกรณีของเรา คือข้อมูลหนึ่งวันสําหรับวันที่ T-2 หากมีพารามิเตอร์และจัดรูปแบบอย่างถูกต้อง เราจะยังคงปฏิบัติตามพารามิเตอร์ต่อไป
2. แก้ไขวันที่ในการอนุญาต xml
   ปัจจุบันในการอนุญาต xml เราได้แบ่งปันวันที่เผยแพร่และวันที่อนุญาต วันที่เหล่านี้เป็นมิลลิวินาทีเมื่อเทียบกับวินาทีซึ่งเป็นมาตรฐาน เรากําลังแก้ไขเพื่อส่งกลับมาในวินาทีอีพอชแทนที่จะเป็นมิลลิวินาที
3. XML ที่ไม่ถูกต้องที่ส่งคืนสําหรับ /resource/Subscription/{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

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

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

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

• ภายในขอบเขตของโปรแกรม Share My Data บุคคลภายนอกจะอยู่ภายใต้กฎความเป็นส่วนตัวและการปกป้องข้อมูลของลูกค้าที่ระบุไว้ในข้อกําหนดและเงื่อนไขของแพลตฟอร์ม Share My Data และตามข้อกําหนดที่รวมอยู่ในอัตราภาษีการเข้าถึงข้อมูลลูกค้า
• บุคคลที่สามยังอยู่ภายใต้กฎหมายและระเบียบข้อบังคับอื่น ๆ ทั้งหมดที่เกี่ยวข้องกับการปกป้องความเป็นส่วนตัวของลูกค้า รวมถึงแต่ไม่จํากัดเพียงแต่ กฎระเบียบเกี่ยวกับความเป็นส่วนตัวและการรักษาความปลอดภัยสําหรับข้อมูลการใช้พลังงานที่ CPUC นํามาใช้เป็นเอกสารแนบ ง. ถึงการตัดสินใจ 11-07-056 (ไฟฟ้า) ซึ่งสรุปไว้ในกฎระเบียบทางไฟฟ้า 27 ของ PG&E และประมวลกฎหมายแพ่งแคลิฟอร์เนีย มาตรา 1798.80 – 1798.84
• สําหรับข้อมูลเพิ่มเติม โปรดเลือกลิงก์ด้านล่าง:
  แบ่งปันข้อกําหนดและเงื่อนไขข้อมูลของฉัน (PDF, 190 KB)
  กฎทางไฟฟ้าข้อที่ 27 (PDF, 1.6 MB)
  เอกสารแนบ D ในการตัดสินใจ 11-07-056 (PDF)
  ค้นหาข้อมูลเพิ่มเติม:California Civil Code มาตรา 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 Publishing Standard โปรดเลือกลิงก์ด้านล่างเพื่อดูรายการ 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 ของคุณได้โดยตรง แต่เรามีทรัพยากรมากมายที่พร้อมให้ความช่วยเหลือด้านไอทีและทรัพยากรทางเทคนิคของคุณในกระบวนการพัฒนา โปรดดูหน้าเอกสาร API ของเราเพื่อเรียนรู้เพิ่มเติม โปรดติดต่อ ShareMyData@pge.comหากมีคําถามเพิ่มเติม

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