Chia sẻ Dữ liệu của Tôi cho bên thứ ba

Để tuân thủ tiêu chuẩn ủy quyền hiện hành của Ủy ban Tiêu chuẩn Năng lượng Bắc Mỹ (NAESB) Giao diện Nhà cung cấp Dịch vụ Năng lượng (ESPI), PG&E đã triển khai khung Ủy quyền OAuth 2.0 để ủy quyền truy cập dữ liệu. Sơ đồ dưới đây minh họa cách khách hàng khởi tạo ủy quyền, chọn các thông số phạm vi và sau đó gửi ủy quyền của họ.

Tài liệu tham khảo bổ sung ngoài thông tin dưới đây:

Tải xuống Sơ đồ Trình tự ESPI OAuth 2.0 (PDF, 193 KB)
Xem SDK dữ liệu Nút Xanh tại Github

Lưu ý: Đối với Community Choice Aggregators, chỉ có client_access_token là cần thiết để yêu cầu dữ liệu (thông qua OAuth 2-Legged) và những điều sau đây không áp dụng.

Ủy quyền được khởi tạo tại trang web của bên thứ ba

Để bắt đầu ủy quyền từ trang web của bên thứ ba như minh họa trong sơ đồ đầu tiên ở trên, yêu cầu mã ủy quyền được thực hiện bằng cách chuyển hướng trình duyệt của khách hàng từ trang web của bên thứ ba của bạn đến URL Điểm cuối Ủy quyền của Máy chủ Ủy quyền của PG&E với các thông số yêu cầu thích hợp như được ví dụ dưới đây. Sau khi chuyển hướng, khách hàng sẽ được xuất trình trang đăng nhập PG&E để xác thực, sau đó là trang ủy quyền để ủy quyền truy cập dữ liệu cho bên thứ ba của quý vị:

authorizationServerAuthorizationEndpoint URI (với các thông số yêu cầu)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={tùy chọnTiểu bang}

• Thông số Yêu cầu Bắt buộc:
  • client_id = ID khách hàng từ các mốc đăng ký Share My Data của bạn (tức là cặp client_id/client_secret).
  • redirect_uri = chuyển hướng URL mà bạn đã chỉ định trong đăng ký Chia sẻ Dữ liệu của Tôi (URL phải khớp).
    Lưu ý: Chúng tôi khuyên bạn nên áp dụng mã hóa URL cho redirect_uri theo ví dụ bên dưới.
  • response_type = mã (giá trị tĩnh)
• (Các) Tham số Yêu cầu Tùy chọn:
  • trạng thái = thông số trạng thái mờ đục tùy chọn như được cho phép bởi tiêu chuẩn OAuth 2.0 được trả lại với mã ủy quyền để giúp duy trì trạng thái. Ví dụ: thông số trạng thái có thể được bên thứ ba sử dụng để xác định duy nhất nguồn gốc khách hàng và để ngăn chặn giả mạo liên trang.
  • login={khách} Cung cấp tùy chọn cho bên thứ ba để chuyển hướng khách hàng sang đăng nhập My Energy của PG&E hoặc đến tab Guest Access như một phần của quy trình ủy quyền trực tuyến.

VÍ DỤ: Yêu cầu mã xác thực

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

Lưu ý: ví dụ redirect_uri parameter ở trên có mã hóa URL được áp dụng (tức là mã hóa URL của https://thirdparty.com/redirectUrl)

Nếu bạn đưa ra yêu cầu hợp lệ như trên và khách hàng xác thực và ủy quyền thành công, khách hàng sau đó sẽ được chuyển hướng đến redirect_uri của bạn với mã ủy quyền, thông số phạm vi (được ủy quyền) và thông số trạng thái tùy chọn (nếu được cung cấp như một phần của yêu cầu ủy quyền) như được ví dụ dưới đây:

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=pge12advertisementement

Lưu ý: Mã Ủy quyền chỉ tồn tại trong thời gian ngắn (hết hạn trong 600 giây) và sau đó phải được trao đổi thành một cặp mã thông báo truy cập/làm mới để hoàn thành ủy quyền và cho phép truy cập dữ liệu đang diễn ra. Xem phần tiếp theo (Phần 2) để biết chi tiết về yêu cầu Mã thông báo Truy cập/Mã thông báo Làm mới.

Tham số phạm vi (được cho phép) được nêu ở trên được trả lại như một phần của phản hồi đối với Yêu cầu Mã Ủy quyền, Yêu cầu Mã Xác thực Truy cập, cũng như API Ủy quyền. Thông số phạm vi này cho phép truyền đạt phạm vi ủy quyền cuối cùng của khách hàng. Cụ thể, tham số phạm vi bao gồm giá trị "Phạm vi Bổ sung" ánh xạ tới các lựa chọn ủy quyền khách hàng được hỗ trợ của PG&E gồm các nhóm dữ liệu (ví dụ: "Sử dụng", "Thanh toán", "Cơ bản", "Tài khoản", "Đăng ký Chương trình"). Các giá trị tham số phạm vi được ghi lại thêm theo tài liệu tham khảo sau:Tải xuống Ánh xạ Chuỗi Phạm vi Khối Chức năng Được Hỗ trợ Nhấp vào Thru 2.0 (PDF, 222 KB).

Tình huống Lỗi

Lỗi thực hiện của bên thứ ba: Nếu các thông số yêu cầu bắt buộc của client_id hoặc redirect_uri không hợp lệ hoặc bị thiếu khi yêu cầu mã ủy quyền, khách hàng sẽ được hiển thị một thông báo giải thích cùng với lỗi chuỗi HTTP 400 tiêu chuẩn. Tương tự, nếu thông số yêu cầu bắt buộc của response_type bị thiếu hoặc không hợp lệ, khách hàng sẽ được chuyển hướng trở lại redirect_uri của bạn với thông số lỗi "không hợp lệ_request" được xác định bởi OAuth 2.0 cũng như thông số trạng thái tùy chọn nếu được cung cấp lần đầu như một phần của yêu cầu mã ủy quyền ban đầu.

Khách hàng Từ chối Ủy quyền: Khi bên thứ ba chuyển hướng khách hàng ủy quyền với PG&E, khách hàng có tùy chọn từ chối thông qua nút "hủy" ở cả trang đăng nhập và trang ủy quyền. Trong những trường hợp như vậy, khách hàng sẽ được chuyển hướng trở lại redirect_uri của bạn với thông số lỗi "truy cập_từ chối" được xác định OAuth 2.0 được thêm vào để cho biết khách hàng từ chối ủy quyền. Ngoài ra, thông số trạng thái tùy chọn sẽ được trả lại nếu được cung cấp lần đầu như một phần của yêu cầu mã ủy quyền ban đầu.

Ủy quyền được Khởi tạo tại PG&E

Khi khách hàng bắt đầu trên cổng thông tin web dành cho khách hàng của PG&E, "Tài khoản của bạn" và sau đó điều hướng đến trang đích Chia sẻ dữ liệu của tôi, họ sẽ được trình bày một danh sách thả xuống các bên thứ ba đã đăng ký và hiển thị. Như minh họa trong sơ đồ thứ hai ở trên, khi khách hàng chọn bên thứ ba từ danh sách các bên thứ ba đã đăng ký và chọn "Tiếp theo", khách hàng sẽ được chuyển hướng đến "URI Cổng thông tin Bên thứ ba" đã đăng ký của bên thứ ba, tại thời điểm đó khách hàng có thể tiếp tục quy trình OAuth do bên thứ ba khởi tạo được mô tả trong phần trước.

Lưu ý: Một số bên thứ ba đã hỏi về cách sắp xếp hợp lý trải nghiệm khách hàng cho trường hợp sử dụng này (tức là ủy quyền được khởi tạo trên trang web của PG&E) sao cho khách hàng có vẻ như họ được đưa trực tiếp đến trang ủy quyền khi chọn bên thứ ba từ danh sách thả xuống. Để tạo điều kiện cho trải nghiệm khách hàng như vậy, các bên thứ ba có thể chọn đặt "URI Cổng thông tin Bên thứ ba" của họ (thông qua trang đăng ký quản lý Chia sẻ Dữ liệu của Tôi) đến một điểm cuối tự động chuyển hướng khách hàng trở lại PG&E như một phần của yêu cầu mã ủy quyền. Khi tự động chuyển hướng trở lại Điểm cuối Ủy quyền Máy chủ của PG&E, khách hàng sẽ bỏ qua trang đăng nhập của khách hàng (vì họ đã đăng nhập) và sẽ trực tiếp đến trang ủy quyền. Đối với một số bên thứ ba đã đăng ký trước khi phát hành Chia sẻ Dữ liệu của Tôi Nhấp vào Thru 2.0 vào cuối tháng 6 năm 2018, điều này có thể được thực hiện bằng cách chỉ xác định URI Cổng thông tin của Bên thứ ba để bằng URI "Màn hình Lựa chọn Phạm vi Bên thứ ba" không còn được sử dụng nữa (trường sẽ được ngừng phát hành trong tương lai).

Ngược lại, một số bên thứ ba có thể muốn trước tiên thu hút và sàng lọc khách hàng về phía họ khi khách hàng được chuyển hướng đến URI "Cổng thông tin bên thứ ba" của họ trước khi yêu cầu mã ủy quyền, vì vậy cách tiếp cận trên đây chỉ là một gợi ý.

Để có được Mã Truy cập, hãy sử dụng Mã Ủy quyền nhận được và gọi cho điểm cuối dưới đây với các thông số yêu cầu như được mô tả bên dưới. Như đã mô tả ở trên, Mã Ủy quyền có thời hạn ngắn, hết hạn sau 10 phút (600 giây), vì vậy vui lòng đảm bảo Mã Truy cập được yêu cầu ngay khi nhận được Mã Ủy quyền.

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

• Thông số Yêu cầu Bắt buộc:
  • grant_type = authorization_code (giá trị tĩnh)
  • mã = mã ủy quyền nhận được để phản hồi yêu cầu mã ủy quyền
  • redirect_uri = chuyển hướng URL mà bạn đã chỉ định trong đăng ký Chia sẻ Dữ liệu của Tôi (URL phải khớp).
    Lưu ý: Như với yêu cầu mã ủy quyền, chúng tôi khuyên bạn nên áp dụng mã hóa URL cho redirect_uri.

VÍ DỤ: Truy cập Token request
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={ authorizationcode}&redirect_uri={redirect_uri}

Thêm tham số tiêu đề Ủy quyền cơ bản với mã hóa Base64 được áp dụng "clientID:clientSecret"

Lưu ý: Các giá trị clientId:clientSecret tương ứng với các giá trị clientID được cung cấp trong các mốc đăng ký Share My Data của bạn.
Thông số tiêu đề sẽ ở định dạng sau:
Tên thông số : Giá trị Thông số Ủy quyền
: "Chuỗi được mã hóa cơ sở64" cơ bản

Một câu trả lời thành công sẽ như sau:

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_18_1_1_3_3_3_3_3_3_3_4_4_3_4_1_4_3_4_4_4_1_4_1AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ;Khoảng Thời Gian=900_3600;BlockDuration=Hàng ngày;Lịch sửChiều dài={3P Chiều dài lịch sử đã đăng ký};Thu Tài Khoản={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} ví dụ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} ví dụ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{ authorizationID}
customerResourceURI:{CustomerResourceURI} ví dụ:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Lưu ý: Mã thông báo Truy cập hết hạn sau 3600 giây (1 giờ), trong khi Mã thông báo Làm mới tương ứng hết hạn sau 1 năm. Xem phần 3 tiếp theo để biết chi tiết về việc mua một cặp Mã thông báo Truy cập/Mã thông báo Làm mới mới.

Lưu cặp mã thông báo truy cập và làm mới.
Để yêu cầu dữ liệu lịch sử ban đầu và dữ liệu hàng ngày đang diễn ra,hãy truy cập dữ liệu .

Theo thực hành tốt nhất, Mã thông báo Truy cập là mã thông báo ngắn hạn (1 giờ) trong khi Mã thông báo Làm mới tương ứng là mã thông báo dài hạn (1 năm) mà bạn có thể sử dụng để mua một cặp Mã thông báo Truy cập/Mã thông báo Làm mới mới mới khi Mã thông báo Truy cập hết hạn. Để có được một cặp Mã thông báo Truy cập và Mã thông báo Làm mới mới cho các ủy quyền chưa hết hạn hiện có, hãy sử dụng "Mã thông báo Làm mới hiện tại" và gọi cho điểm cuối dưới đây với các thông số như được mô tả bên dưới.

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

VÍ DỤ: Yêu cầu
làm mới Token POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Thêm tham số tiêu đề Ủy quyền cơ bản với mã hóa Base64 được áp dụng "clientID:clientSecret"

Lưu ý: Các giá trị clientId:clientSecret tương ứng với các giá trị clientID được cung cấp trong các mốc đăng ký Share My Data của bạn.
Thông số tiêu đề sẽ ở định dạng sau:
Tên thông số : Giá trị Thông số Ủy quyền
: "Chuỗi được mã hóa cơ sở64" cơ bản

Câu trả lời thành công sẽ như sau:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"token_type": "Người mang",
"expires_in": 3600,
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"phạm vi": "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_
ProgramĐăng ký;Khoảng Thời Gian=900_3600;BlockDuration=Hàng ngày;Lịch sửChiều dài={3P Chiều dài lịch sử đã đăng ký};Thu Tài Khoản={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
"tài nguyênURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ",
"ủy quyềnURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test "
}

Lưu ý: Tương tự, Mã thông báo Truy cập Khách hàng là mã thông báo ngắn hạn (1 giờ) trong khi Mã thông báo Làm mới tương ứng là mã thông báo dài hạn (1 năm) mà bạn có thể sử dụng để mua một cặp Mã thông báo Truy cập Khách hàng/Mã thông báo Làm mới mới khi Mã thông báo Truy cập Khách hàng hết hạn. Để có được một cặp Mã Thông Báo Tiếp Cận Khách Hàng/Mã Thông Báo Làm Mới mới, hãy tham khảo các bước tương tự được mô tả ở trên.

Khách hàng sẽ có thể cập nhật ủy quyền của họ bằng cách làm như sau:

• Xóa ID Dịch vụ khỏi ủy quyền của họ
• Gia hạn ngày kết thúc của thời hạn ủy quyền
• Hủy ủy quyền

Lưu ý: Khách hàng sẽ chỉ có thể thực hiện thay đổi đối với ủy quyền của họ bằng cách đăng nhập vào tài khoản PG&E trực tuyến của họ và làm theo các bước bắt buộc. Nếu bất kỳ hành động nào trong số này được thực hiện, chúng tôi sẽ thông báo cho bạn qua Notification URI mà bạn đã cung cấp trong quá trình đăng ký.

Có các tùy chọn để quản lý và xem chi tiết về ủy quyền khách hàng của bạn:

• Bạn có thể gọi API ủy quyền (vận hành http GET) bằng cách sử dụng client_access_token của bạn ở cấp bên thứ ba (để biết chi tiết về tất cả các ủy quyền) tại https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization hoặc ở cấp ủy quyền khách hàng cá nhân tại https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Ngoài ra, quý vị cũng có thể xem chi tiết ủy quyền cá nhân theo cách thủ công bằng cách đăng nhập vào tài khoản Chia sẻ Dữ liệu của tôi thông qua cổng thông tin của bên thứ ba và nhập ID Đăng ký cho ủy quyền mà quý vị đang tìm kiếm.

Nếu quý vị không còn muốn truy cập dữ liệu liên quan đến ủy quyền, có các phương pháp tùy chọn để hủy ủy quyền:

• Bạn có thể gọi cho API hủy bỏ ủy quyền (vận hành http DELETE) bằng cách sử dụng client_access_token tại https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Ngoài ra, bạn có thể hủy ủy quyền theo cách thủ công bằng cách đăng nhập vào tài khoản Chia sẻ Dữ liệu của Tôi thông qua cổng thông tin của bên thứ ba và nhập ID Đăng ký cho ủy quyền mà bạn muốn hủy.

Lưu ý: Khách hàng sẽ được thông báo rằng bạn đã chọn hủy ủy quyền của họ. Ngoài ra, sau khi hủy ủy quyền, hành động không thể bị đảo ngược.

• PG&E sẽ gửi thông báo đến URI thông báo của bạn được cung cấp trong quá trình đăng ký. Thông báo bao gồm các URI tương ứng với dữ liệu đã đóng gói sẵn sẵn để bạn quay lại và yêu cầu tại các URL được cung cấp. Dữ liệu được đóng gói sẵn và thông báo được gửi trong hai tình huống sau: (1) bạn đã chọn "Thông báo cho tôi khi dữ liệu đã sẵn sàng" trong hồ sơ đăng ký của bạn, trong trường hợp đó chúng tôi sẽ đóng gói dữ liệu hàng ngày mới nhất với bất kỳ sửa đổi nào cho các ngày trong quá khứ, hoặc (2) bạn đã thực hiện một yêu cầu không đồng bộ đặc biệt trước đó mà dữ liệu được yêu cầu hiện đã sẵn sàng.
• Tình huống 1 được minh họa trong "DATA ACCESS: ĐĂNG KÝ HÀNG NGÀY" trong sơ đồ Phương pháp Truy cập Dữ liệu dưới đây và Tình huống 2 được minh họa trong "CẬN TRUY CẬPDATA: Phần YÊU CẦU HOC AD (ĐƯỢC ĐỒNG BỘ)" của cùng một sơ đồ dưới đây.

Vui lòng ghi nhớ tuổi thọ token của Mã thông báo Truy cập, Mã thông báo Truy cập Khách hàng và Mã thông báo Làm mới tương ứng của chúng được sử dụng trong các yêu cầu dữ liệu. Theo thực hành tốt nhất, Mã thông báo Truy cập là mã thông báo tồn tại trong thời gian ngắn (1 giờ) trong khi mã thông báo làm mới là mã thông báo tồn tại trong thời gian dài (1 năm) mà bạn có thể sử dụng để mua một cặp Mã thông báo Truy cập/Mã thông báo Làm mới mới khi Mã thông báo Truy cập hết hạn. Tương tự, Mã Thông Báo Truy Cập Khách Hàng là một mã thông báo ngắn hạn (1 giờ) trong khi Mã Thông Báo Làm Mới tương ứng là một mã thông báo dài hạn (1 năm) mà bạn có thể sử dụng để mua một cặp Mã Thông Báo Truy Cập Khách Hàng/Mã Thông Báo Làm Mới mới khi Mã Thông Báo Truy Cập Khách Hàng hết hạn. Để biết thêm chi tiết về việc có được một cặp mã thông báo mới, hãy tham khảo Bước 3, Yêu cầu một mã thông báo truy cập mới, trong tab chi tiết ủy quyền của chúng tôi. Đi đến chi tiết ủy quyền

Nếu bạn được khách hàng ủy quyền để nhận "Thông tin Tài khoản" (ID Tài khoản, ID Thỏa thuận Dịch vụ và ngày bắt đầu dịch vụ) và/hoặc "Thông tin Cơ bản" (tức là tên khách hàng và địa chỉ dịch vụ), bạn có thể yêu cầu thông tin khách hàng đó thông qua API Khách hàng Bán lẻ do ESPI xác định mà dữ liệu phù hợp với sơ đồ, retailCustomer.xsd, được cung cấp ở trên.

Đồng bộ (Các bên thứ ba Tiêu chuẩn và EEF)

Một cách tiếp cận để yêu cầu dữ liệu khách hàng là sử dụng API đồng bộ để yêu cầu thông tin khách hàng cho một ủy quyền khách hàng duy nhất cho dữ liệu khách hàng (tức là Khách hàng Bán lẻ):

Ví dụ về URL Yêu cầu Đồng bộ:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID bạn nhận được ở cuối chuỗi ủy quyền OAuth để nhận mã thông báo truy cập. RetailCustomerID là một phần của tham số đường dẫn của khách hàngResourceUri trong phản hồi mã thông báo. (RetailCustomerID=SubscriptionID)

Tiêu đề HTTP = Ủy quyền:Người mang {mã thông báo truy cập cho ủy quyền này}

Phản hồi = bạn sẽ nhận lại dữ liệu đồng bộ cho RetailCustomerID đó. Dữ liệu phù hợp với đơn vị bán lẻCustomer.xsd

Lưu ý: API Khách hàng Bán lẻ đồng bộ ở cấp độ Khách hàng Bán lẻ cá nhân tương ứng với một ủy quyền khách hàng duy nhất.

Để tham khảo: sơ đồ phân cấp dưới đây cho thấy hệ thống phân cấp mối quan hệ cho các yếu tố dữ liệu ESPI trong mô hình hóa dữ liệu khách hàng PG&E.

Bạn cũng có thể yêu cầu dữ liệu khách hàng thông qua API không đồng bộ để yêu cầu thông tin khách hàng cho tất cả các ủy quyền khách hàng của bạn đối với dữ liệu khách hàng (tức là Khách hàng Bán lẻ).

Để hỗ trợ các yêu cầu Không đồng bộ, ứng dụng của bạn sẽ cần hỗ trợ Thông báo Sau, chúng tôi sẽ gửi cho bạn (theo URL Thông báo bạn đã cung cấp trong quá trình đăng ký).

Ví dụ về URL Yêu cầu Không đồng bộ:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID được cung cấp trong Tài nguyên Thông tin Ứng dụng được truy xuất trong quá trình kiểm tra đăng ký. (BulkID=ClientID)

Tiêu đề HTTP = Ủy quyền:Người mang {truy xuất mã thông báo truy cập khách hàng trong quá trình kiểm tra đăng ký}

Phản hồi = mã trạng thái HTTP 202 (Đây là một yêu cầu không đồng bộ, trong đó phản hồi sẽ được đăng lên URL thông báo khi dữ liệu đã sẵn sàng). Khi dữ liệu đã sẵn sàng, chúng tôi sẽ ĐĂNG thông báo cho URI thông báo được cung cấp của bạn với tải trọng URL mà ứng dụng của bạn có thể quay lại để đóng gói sẵn. Mẫu thông báo đăng tải như dưới đây

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

Thực hiện GET trên URL ở trên với mã thông báo Truy cập Khách hàng để lấy dữ liệu.

Để tham khảo: sơ đồ phân cấp dưới đây cho thấy hệ thống phân cấp mối quan hệ cho các yếu tố dữ liệu ESPI trong mô hình hóa dữ liệu khách hàng PG&E.

Cuối cùng, bạn có thể nhận thông tin khách hàng mới nhất hàng ngày bằng cách sử dụng mô hình đăng ký hàng ngày (tức là bằng cách chọn hộp kiểm "Thông báo cho tôi khi dữ liệu đã sẵn sàng (hàng ngày)" trong quá trình đăng ký).

Để hỗ trợ mô hình đăng ký hàng ngày, ứng dụng của bạn sẽ cần hỗ trợ Thông báo đăng, chúng tôi sẽ gửi cho bạn (theo URL thông báo bạn đã cung cấp trong quá trình đăng ký).

Khi dữ liệu đã sẵn sàng, chúng tôi sẽ ĐĂNG thông báo cho URI thông báo được cung cấp của bạn với tải trọng URL mà ứng dụng của bạn có thể quay lại để đóng gói sẵn. Mẫu thông báo sau như sau:

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

Thực hiện GET trên URL ở trên với mã thông báo Truy cập Khách hàng để lấy dữ liệu.

Để tham khảo, sơ đồ phân cấp dưới đây cho thấy hệ thống phân cấp mối quan hệ cho các yếu tố dữ liệu ESPI trong mô hình hóa dữ liệu khách hàng PG&E.

Nếu bạn được khách hàng ủy quyền nhận "Thông tin Sử dụng" và/hoặc "Thông tin Thanh toán", bạn có thể yêu cầu dữ liệu này thông qua các API đăng ký mà dữ liệu phù hợp với giản đồ, espiDerived.xsd, được cung cấp ở trên.

Các Yêu cầu Đồng bộ (Các bên thứ ba Tiêu chuẩn và EEF)

Để yêu cầu dữ liệu lịch sử (cho cả dữ liệu sử dụng khoảng thời gian và dữ liệu hóa đơn), một cách tiếp cận là sử dụng các API đồng bộ với việc bao gồm các thông số yêu cầu ngày bắt đầu và ngày kết thúc thích hợp trong thời gian Zulu.

Ví dụ về URL Yêu cầu Đồng bộ:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max={endDate}

published-min = ngày bắt đầu sẽ được áp dụng cho yêu cầu lấy dữ liệu này. Ngày bằng giờ Zulu của yyyy-MM-ddTHH:mm:ssZ (định dạng IETC RFC 3339)

published-max = ngày kết thúc sẽ được áp dụng cho yêu cầu lấy dữ liệu này. Ngày bằng giờ Zulu của yyyy-MM-ddTHH:mm:ssZ (định dạng IETC RFC 3339)

Lưu ý: Đối với các yêu cầu API chấp nhận các tham số ngày tối đa và ngày tối thiểu được công bố, mặc định là T-1 (ngày yêu cầu trừ đi 1 ngày). Đối với các yêu cầu tóm tắt sử dụng (ví dụ: .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/Usage Summary), chúng tôi khuyên bạn nên cung cấp khoảng 30 ngày trở lên để đảm bảo có hóa đơn trùng lặp với khoảng thời gian đó, nếu không sẽ không có dữ liệu nào được trả lại.

ID Đăng ký = ID Đăng ký bạn nhận được ở cuối chuỗi ủy quyền OAuth để nhận mã thông báo truy cập. ID đăng ký là một phần của tham số resourceURI trong phản hồi mã thông báo. (SubscriptionID=RetailCustomerID)

UsagePointID = UsagePoint theo ID đăng ký ở trên. Bạn có thể nhận được tất cả các điểm sử dụng cho một Đăng ký nhất định bằng cách gọi đến URL API bên dưới và cung cấp mã thông báo truy cập cho đăng ký đó trong tiêu đề ủy quyền: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

Tiêu đề HTTP = Ủy quyền:Người mang {mã thông báo truy cập cho Đăng ký này}

Phản hồi = bạn sẽ nhận lại dữ liệu đồng bộ cho điểm sử dụng đó trong khoảng thời gian được yêu cầu. Nó sẽ có cả dữ liệu sử dụng khoảng thời gian () và dữ liệu hóa đơn ().

Các API sử dụng đồng bộ (như được chỉ ra bởi cấu trúc URL kết thúc bằng ID Điểm Sử dụng) ở cấp Điểm Sử dụng riêng lẻ (tức là cấp Thỏa thuận Dịch vụ), vì vậy một ứng dụng sẽ luân chuyển các yêu cầu thông qua từng ID Điểm Sử dụng thuộc về một ủy quyền khách hàng nhất định (tức là đăng ký).

Phản hồi cho các yêu cầu đồng bộ trả về cả dữ liệu khoảng thời gian (dưới) liên quan đến phạm vi ngày được yêu cầu cũng như bất kỳ tổng số lần sử dụng hàng tháng và hóa đơn nào trùng lặp với phạm vi ngày được yêu cầu (dưới ).

• Đọc khoảng thời gian chứa khoảng thời gian (15 phút/giờ) sử dụng điện và dữ liệu sử dụng khí (hàng ngày)
• Tóm tắt Sử dụng chứa tổng số tiền sử dụng hàng tháng và chi tiết hóa đơn (nếu được cho phép)

Trong câu trả lời, bạn sẽ tìm thấy các yếu tố dữ liệu tương ứng với bảng lập bản đồ yếu tố dữ liệu ESPI của chúng tôi

Để tham khảo, sơ đồ phân cấp dưới đây cho thấy hệ thống phân cấp mối quan hệ cho các yếu tố dữ liệu ESPI trong việc mô hình hóa dữ liệu khách hàng PG&E.

Sau đây là một số thông tin làm rõ chính về các yếu tố dữ liệu này:

• Khoảng thời gian chặn là 1 ngày
• Đọc khoảng thời gian (bên dưới Khoảng thời gian) chứa các giá trị sử dụng điện thực tế 15 phút/giờ và các giá trị sử dụng khí đốt hàng ngày
• Đối với khách hàng sử dụng điện có hệ thống phát điện tại chỗ (ví dụ: Năng lượng mặt trời), yếu tố flowDirection cho biết dữ liệu sử dụng được cung cấp (cung cấp) và nhận (thế hệ). Đối với khách hàng có đồng hồ đo được cấu hình để chỉ đọc mức sử dụng ròng (tức là không có thế hệ tại chỗ), phần tử flowDirection cho biết mức sử dụng là số tiền ròng (chênh lệch được chuyển trừ nhận được):
  • Hướng dòng chảy là 1 = được cung cấp (năng lượng được cung cấp cho khách hàng)
  • Hướng dòng chảy là 19 = đã nhận (thế hệ ròng chảy trở lại lưới PG&E). (Lưu ý, các giá trị là tuyệt đối)
  • Hướng dòng chảy là 4 = ròng (được phát trừ – nhận)
• Đặc biệt chú ý đến Công suất của mười hệ số nhân và Đơn vị đo (uom) để đảm bảo đọc đúng cách sử dụng

Đăng ký Lô (Các bên thứ ba Tiêu chuẩn và EEF)

Bạn cũng có thể yêu cầu dữ liệu sử dụng thông qua API không đồng bộ cho tất cả các Điểm Sử dụng thuộc về một ủy quyền khách hàng duy nhất cho dữ liệu sử dụng/gửi hóa đơn (tức là Đăng ký).

Để hỗ trợ các yêu cầu Ad Hoc Asynchronous (tức là, cho nhiều hơn một điểm sử dụng tại một thời điểm), ứng dụng của bạn sẽ cần hỗ trợ Post Notifications chúng tôi sẽ gửi cho bạn (theo URL Thông báo bạn đã cung cấp trong quá trình đăng ký)

Ví dụ về URL
Yêu cầu Không đồng bộ https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

ID Đăng ký = ID Đăng ký bạn nhận được ở cuối chuỗi OAuth để nhận mã thông báo truy cập. ID đăng ký là một phần của tham số resourceURI trong phản hồi mã thông báo

published-min = ngày bắt đầu sẽ được áp dụng cho yêu cầu lấy dữ liệu này. (định dạng RFC 3339 zulu time. yyyy-MM-ddTHH:mm:ssZ)

published-max = ngày kết thúc sẽ được áp dụng cho yêu cầu lấy dữ liệu này. (định dạng RFC 3339 zulu time. yyyy-MM-ddTHH:mm:ssZ)

Tiêu đề HTTP = Ủy quyền:Người mang {mã thông báo truy cập cho Đăng ký này}

Phản hồi = mã trạng thái HTTP 202 (đây là một yêu cầu không đồng bộ, trong đó phản hồi sẽ được đăng lên URL thông báo khi dữ liệu đã sẵn sàng)

Sau khi dữ liệu đã sẵn sàng, chúng tôi sẽ ĐĂNG thông báo cho URI thông báo được cung cấp của bạn với tải trọng URL mà ứng dụng của bạn có thể quay lại để đóng gói sẵn. Mẫu thông báo sau như sau:

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

Thực hiện GET trên URL ở trên với mã thông báo Access để lấy dữ liệu. Thông tin này sẽ chứa cả dữ liệu sử dụng khoảng thời gian () cũng như thông tin hóa đơn () trong khoảng thời gian được yêu cầu.

Đăng ký Lô (Bên thứ ba Tiêu chuẩn và EEF)
Bạn cũng có thể yêu cầu thông tin sử dụng và lập hóa đơn thông qua API không đồng bộ số lượng lớn cho tất cả ủy quyền của khách hàng đối với dữ liệu sử dụng/gửi hóa đơn (tức là Đăng ký).

Ví dụ về URL
Yêu cầu Hàng loạt theo Lô https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate}

BulkID = BulkID được cung cấp trong Tài nguyên Thông tin Ứng dụng được truy xuất trong quá trình kiểm tra đăng ký. (BulkID=ClientID)

published-min = ngày bắt đầu sẽ được áp dụng cho yêu cầu lấy dữ liệu này. (định dạng RFC 3339 zulu time. yyyy-MM-ddTHH:mm:ssZ)

published-max = ngày kết thúc sẽ được áp dụng cho yêu cầu lấy dữ liệu này. (định dạng RFC 3339 zulu time. yyyy-MM-ddTHH:mm:ssZ)

Tiêu đề HTTP = Ủy quyền:Người mang {mã thông báo truy cập khách hàng}

Phản hồi = mã trạng thái HTTP 202 (đây là một yêu cầu không đồng bộ, trong đó phản hồi sẽ được đăng lên URL thông báo khi dữ liệu đã sẵn sàng)

Sau khi dữ liệu đã sẵn sàng, chúng tôi sẽ ĐĂNG thông báo cho URI thông báo được cung cấp của bạn với tải trọng URL mà ứng dụng của bạn có thể quay lại để đóng gói sẵn. Mẫu thông báo sau như sau:

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

Thực hiện GET trên URL ở trên với mã thông báo Access để lấy dữ liệu. Thông tin này sẽ chứa cả dữ liệu sử dụng khoảng thời gian () cũng như thông tin hóa đơn () trong khoảng thời gian được yêu cầu.

Cuối cùng, bạn có thể nhận thông tin sử dụng và lập hóa đơn mới nhất bao gồm các sửa đổi cho các ngày trong quá khứ trong thời hạn ủy quyền của khách hàng hàng ngày bằng cách sử dụng mô hình đăng ký hàng ngày (tức là bằng cách chọn hộp kiểm "Thông báo cho tôi khi dữ liệu đã sẵn sàng (hàng ngày)" trong quá trình đăng ký).

Để hỗ trợ mô hình đăng ký hàng ngày, ứng dụng của bạn sẽ cần hỗ trợ Thông báo đăng, chúng tôi sẽ gửi cho bạn (theo URL thông báo bạn đã cung cấp trong quá trình đăng ký).

Sau khi dữ liệu đã sẵn sàng, chúng tôi sẽ ĐĂNG thông báo cho URI thông báo được cung cấp của bạn với tải trọng URL mà ứng dụng của bạn có thể quay lại để đóng gói sẵn. Mẫu thông báo sau như sau:

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

Thực hiện GET trên URL ở trên với mã thông báo Access để lấy dữ liệu. Thông tin này sẽ chứa cả dữ liệu sử dụng khoảng thời gian () cũng như thông tin hóa đơn () trong khoảng thời gian được yêu cầu.

Ngày 20 tháng 3 năm 2023

Có gì mới:

1. Phát hành mã phản hồi API HTTP mới (204) cho cả các cuộc gọi API đồng bộ và không đồng bộ để cho biết khi nào không có dữ liệu nào khả dụng cho phạm vi được yêu cầu.
2. Hỗ trợ nhãn tiêu đề giao dịch x hỗ trợ khả năng liên kết phản hồi của PG&E với các cuộc gọi API Asynchronous cụ thể bằng cách trả về giá trị này cùng với ID Tương quan khi tệp được yêu cầu sẵn sàng.
3. Đã cải thiện độ chi tiết dữ liệu bổ sung cho API UsagePoint/MeterReadingID bằng cách cung cấp dữ liệu khoảng thời gian điện cho nhiều mét cho các tình huống Thỏa thuận dịch vụ duy nhất.
4. Cung cấp thêm sự rõ ràng cho các giá trị Chỉ số Chất lượng Đọc cho dữ liệu khoảng cách ESTIMATED để mô tả loại ước tính được sử dụng cho khoảng thời gian đó. Các giá trị mới cho biết logic ước tính đã được áp dụng như sau:
   
   

5. Giá trị và mô tả RQI

   0 - Hợp lệ: dữ liệu đã trải qua tất cả các kiểm tra xác thực bắt buộc và đã vượt qua tất cả hoặc đã được xác minh

   7 - Chỉnh sửa thủ công: được thay thế hoặc phê duyệt bởi một người

   8 - Ước tính sử dụng ngày tham chiếu: giá trị dữ liệu được thay thế bằng giá trị tính toán của máy dựa trên phân tích dữ liệu lịch sử sử dụng cùng một loại phép đo

   9 - Ước tính bằng cách sử dụng nội suy tuyến tính: giá trị dữ liệu được tính bằng cách sử dụng nội suy tuyến tính dựa trên các chỉ số trước và sau nó

   10 - Đáng nghi ngờ: dữ liệu đã thất bại trong một hoặc nhiều lần kiểm tra

   11 - Dẫn xuất: dữ liệu đã được tính toán (sử dụng các phép toán hoặc logic), không nhất thiết phải đo trực tiếp

   12 - Dự báo (dự báo): dữ liệu đã được tính toán như một dự báo hoặc dự báo các chỉ số trong tương lai

   13 - Hỗn hợp: chỉ ra rằng chất lượng của chỉ số này có các đặc điểm hỗn hợp

   14 - Raw: dữ liệu chưa trải qua quá trình xác thực, chỉnh sửa và ước tính. LƯU Ý Chỉ báo RQI của MV90 Meters sẽ duy trì ở mức 14 là trạng thái RQ cuối cùng

   15 - Chuẩn hóa cho thời tiết: các giá trị đã được điều chỉnh để tính đến thời tiết, để so sánh việc sử dụng ở các khí hậu khác nhau

   16 - Khác: quy định rằng một đặc điểm áp dụng khác với những đặc điểm được xác định

   17 - Đã xác thực: dữ liệu đã được xác thực và có thể được chỉnh sửa và/hoặc ước tính theo các quy trình đã được phê duyệt

   18 - Đã xác minh: dữ liệu không đạt ít nhất một trong các kiểm tra xác thực bắt buộc nhưng được xác định là đại diện cho việc sử dụng thực tế

   19 - Chất lượng doanh thu: hợp lệ và chấp nhận được cho mục đích thanh toán [có thể gia hạn cho tiêu chuẩn ESPI, và không phải là một phần của ESPI ban đầu]

    

6. Phát hành các chỉ số sử dụng API của nhà cung cấp trong cổng thông tin nhà cung cấp Share My Data Third Party.

Ngày 15 tháng 11 năm 2018

Có gì mới:

1. Chỉ Thị Hạng Khách Hàng đã được thêm vào. Mỗi SAID được ủy quyền sẽ được xác định là RES, AGR, COM/IND hoặc Khác.
2. API Lập hóa đơn và Sử dụng sẽ được cập nhật để chấp nhận các thông số truy vấn cập nhật tối đa và cập nhật tối thiểu (như một sự thay thế cho các thông số truy vấn được công bố tối thiểu và được công bố tối đa). Dữ liệu được trả lại sẽ là tất cả các thay đổi đã xảy ra trong các thông số cập nhật tối đa và cập nhật tối thiểu.
3. Thay thế việc sử dụng ID Khối lượng lớn 5 chữ số của bên thứ ba bằng ID Khách hàng của bên thứ ba cho quy trình ủy quyền trực tuyến.
4. Cung cấp tùy chọn cho bên thứ ba để chuyển hướng khách hàng sang thông tin đăng nhập tài khoản của PG&E hoặc tab Guest Access như một phần của quy trình ủy quyền trực tuyến.
5. Cải thiện bảng điều khiển khách hàng Share My Data của PG&E để giúp khách hàng dễ dàng xem tất cả các ủy quyền chia sẻ dữ liệu hiện có của họ với các bên thứ ba.

Ngày 27 tháng 9 năm 2018

Có gì mới:

PG&E đã thêm các yếu tố dữ liệu mới vào bộ dữ liệu Quy tắc 24 như một phần của dự án Bộ dữ liệu mở rộng (EDS) của PG&E và các yếu tố dữ liệu mới tương ứng được giới thiệu trong bộ dữ liệu Quy tắc 25. Các yếu tố dữ liệu cụ thể bao gồm bộ dữ liệu Quy tắc 25 mở rộng của PG&E được nêu dưới đây với ký hiệu EDS:

Các Yếu tố Dữ liệu Quy tắc 25

ID
Tài khoản Tài khoản Thành
phần
Tài khoản Ghi chú
ID
Tài khoản EDS:
Các thay
đổi trong tương lai về ID
Dịch vụ PG&E UUID
của Dịch vụ
Trạng thái SA
Ngày
Bắt đầu Dịch vụ Địa chỉ
Dịch vụ Biểu thuế
Dịch vụ Hiện tại Tùy chọn Biểu thuế
Dịch vụ Đã Lập hóa đơn (Đường cơ sở Y tế, CARE, FERA, TBS, CCA_TBS, Điện áp dịch vụ hiện tại lựa chọn
năng lượng mặt trời và số đồng hồ đo dịch vụ điện áp
dịch vụ đã lập hóa đơn lịch sử Số
đồng hồ dịch
vụ đồng hồ đo loại
đồng hồ đo hiện tại Chu kỳ
đọc đồng hồ
đo đã lập hóa đơn lịch sử Tùy chọn giá chờ hiện tại nếu Tùy
chọn giá chờ đã lập hóa đơn tại chỗ Tùy chọn
EDS: Ngày bắt đầu
Hóa đơn Thành phần
Thanh toán Lịch sử Chỉ báo
Hạng Khách hàng Ngày
kết thúc Hóa đơn Tổng chi phí($)
Hóa đơn tổng kWh
EDS: Tên của Nhà cung cấp
Dịch vụ Phân tích Cấp Hóa đơn Lịch sử (nếu có)
EDS: EDS Thời hạn
Thanh toán Mục Dòng: Tên (Trên mức cơ bản 1%-30%)
EDS: Thể tích (1234.2)
EDS: Mức giá ($0.032/kWh)
EDS: Chi phí ($100.23)
Chi tiết hóa đơn TOU kWh trước đây (ngoại trừ hóa đơn ABS-TX)
EDS: Thời hạn Thanh toán Mục Hàng (đối với phân tích TOU)
EDS: Tên (phí TOU)
EDS: Thể tích (1234.2)
EDS: Mức giá ($0.032/kWh)
EDS: Chi phí ($100.23)
EDS Phân tích
Nhu cầu Hóa đơn Trước đây: Thời hạn lập hóa đơn mục hàng (đối với phân tích nhu cầu)
EDS: Tên
EDS: Thể tích (1234.2)
EDS: Mức giá ($0.032/kWh)
EDS: Chi phí ($100.23)
Mục
Dòng Hóa Đơn Lịch Sử EDS: EDS Thời hạn
Thanh toán Mục Hàng: Tên phí (Phí Trái phiếu DWR)
EDS: Thể tích (1234.2)
EDS: EDS đơn vị (kWh):
Mức giá ($0.032/kWh)
EDS: Chi phí ($100.23)
Khoảng thời
gian sử dụng lịch sử Khoảng thời gian sử dụng bắt đầu
khoảng thời gian mặc định (tính bằng giây)
Khối lượng sử dụng khoảng thời gian (1234.2)
Đơn vị (kWh/Therms)
Chương trình
đáp ứng nhu cầu tiện ích (DR) Tên
Chương trình Chấm dứt sớm nhất Ngày chấm dứt sớm mà không có Nghĩa vụ
tài chính Ngày chấm dứt sớm nhất bất kể Ngày
ghi danh Chương trình DR Nghĩa vụ
tài chính Ngày
ghi danh Chương trình DR Ngày Ghi danh Các yếu tố
dữ liệu Ngày
Ghi danh Các thông số giờ địa phương Hàng hóa
(Chi tiết DST)
Dữ liệu mặc định Chỉ số
năng lượng chất lượng
mặc định của Mười nhân (cho các giá trị sử dụng khoảng thời gian)
Năng lượng của Mười nhân (cho Nhu cầu lập hóa đơn)
Công suất của Mười nhân (Đối với tổng số sử dụng lập hóa đơn)
Khoảng thời gian (Chỉ số sử dụng)
của Tổng chi phí

Ngày 28 tháng 6 năm 2018

Là một phần của dự án Click-Through và những cải tiến liên tục đối với Nền tảng Chia sẻ Dữ liệu của Tôi, PG&E đã ra mắt Giai đoạn 2 Click-Through vào ngày 28 tháng 6 năm 2018.

Có gì mới:

Những thay đổi quan trọng nhất ảnh hưởng đến bên thứ ba là những thay đổi để phù hợp với giao thứcOAuth 2.0 (PG&E đã loại bỏ chuỗi chuyển hướng ban đầu). Tìm chi tiết bên dưới.

QUAN TRỌNG: Các bên thứ ba BẮT BUỘC phải thực hiện các thay đổi đối với việc triển khai OAuth hiện tại của họ. Các thay đổi trong Giai đoạn 2 của PG&E KHÔNG tương thích ngược, vì vậy các bên thứ ba cần phải thực hiện các thay đổi đồng thời với việc triển khai PG&E. Nếu không thực hiện, quy trình ủy quyền khách hàng hiện tại sẽ ngừng hoạt động vào ngày khóa sổ là ngày 29 tháng 6 năm 2018. Tuy nhiên, các ủy quyền hiện tại không bị ảnh hưởng.

1. Để phù hợp với giao thức OAuth 2.0, PG&E đã giảm số bước chuyển hướng để ủy quyền. Chuyển hướng ban đầu đến PG&E để khách hàng đăng nhập và gửi ủy quyền đã được kết hợp với yêu cầu mã ủy quyền như sau:
   • Như được thể hiện trong ví dụ dưới đây, các yêu cầu mã Ủy quyền của bên thứ ba hiện bao gồm chuyển hướng trình duyệt của khách hàng đến ủy authorizationServerAuthorizationEndpoint URI, cùng với các thông số yêu cầu thích hợp:
     NHẬN https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={tùy chọnTiểu bang}
   • Tiêu chí đánh giá sau đây đã được loại bỏ: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. Các thông báo xử lý lỗi mới cho các yêu cầu mã ủy quyền với các thông số phạm vi bị thiếu hoặc không hợp lệ như sau:
   • Nếu các thông số client_id hoặc redirect_uri yêu cầu bị thiếu hoặc không hợp lệ, lỗi (http 400) với thông báo giải thích được hiển thị cho khách hàng
   • Nếu thông số response_type bắt buộc bị thiếu hoặc không hợp lệ, khách hàng sẽ được chuyển hướng trở lại redirect_uri của bên thứ ba với thông số lỗi "invalid_request" (được thêm vào redirect_uri)
     
3. Đối với khách hàng có ủy quyền trực tuyến hiện có, khả năng bên thứ ba yêu cầu một cặp truy cập mới_token/refresh_token như một phần của ủy quyền mới thay thế ủy quyền hiện có (tức là ủy quyền trực tuyến của cùng một bên thứ ba và tổ hợp khách hàng). Chức năng này giải quyết các tình huống của bên thứ ba mất một cặp access_token/refresh_token hoặc cần thay đổi phạm vi ủy quyền ban đầu theo phê duyệt của khách hàng.
   • Đối với các yêu cầu cấp phép lại, khách hàng sẽ thấy trang cấp phép mới thay vì trang "cấp phép quản lý" khi được bên thứ ba chuyển hướng đến PG&E để cấp phép
   • Sau khi khách hàng cho phép, các bên thứ ba nhận được thông báo cho URL thông báo đã đăng ký của họ rằng ID đăng ký cũ bị hủy (thông báo bao gồm điểm cuối URL API cho phép cho ID đăng ký cũ)
     
4. Khả năng khách hàng thoát qua nút "hủy" trên trang xác thực hoặc trang ủy quyền với chuyển hướng trở lại trang redirect_uri của bên thứ ba với thông số lỗi "access_denied" (được thêm vào redirect_uri)
5. Đối với các bên thứ ba đăng ký cài đặt "khả năng hiển thị" và do đó được bao gồm trong danh sách các bên thứ ba đã đăng ký, khách hàng sẽ thấy khi nào họ truy cập tài khoản trực tuyến PG&E của họ và điều hướng đến trang đích Chia sẻ Dữ liệu của Tôi:
   • Đối với khách hàng đăng nhập vào tài khoản trực tuyến PG&E của họ và điều hướng đến trang đích Chia sẻ Dữ liệu của Tôi và sau đó được chuyển hướng đến "URI Cổng thông tin của Bên thứ ba" đã đăng ký của bên thứ ba khi chọn bên thứ ba từ danh sách các bên thứ ba đã đăng ký. Tại thời điểm đó, khách hàng có thể tiếp tục quy trình OAuth do bên thứ ba khởi tạo. Khi đi qua đường dẫn này, khách hàng sẽ không còn được hiển thị trang ủy quyền khi chọn bên thứ ba từ danh sách thả xuống của bên thứ ba, mà thay vào đó được chuyển hướng đến "URI Cổng thông tin Bên thứ ba" đã đăng ký của bên thứ ba, nơi họ có thể bắt đầu quy trình OAuth do bên thứ ba khởi tạo
   •  Lưu ý: Một số bên thứ ba đã hỏi về cách sắp xếp hợp lý trải nghiệm khách hàng cho trường hợp sử dụng này (tức là ủy quyền được khởi tạo trên trang web của PG&E) sao cho khách hàng có vẻ như họ được đưa trực tiếp đến trang ủy quyền khi chọn bên thứ ba từ danh sách thả xuống. Để tạo điều kiện cho trải nghiệm khách hàng như vậy, các bên thứ ba có thể chọn đặt "URI Cổng thông tin Bên thứ ba" của họ (thông qua trang đăng ký quản lý Chia sẻ Dữ liệu của Tôi) đến một điểm cuối tự động chuyển hướng khách hàng trở lại PG&E như một phần của yêu cầu mã ủy quyền. Khi tự động chuyển hướng trở lại ủy authorizationServerAuthorizationEndpoint, khách hàng sẽ bỏ qua trang đăng nhập của khách hàng (vì họ đã đăng nhập) và sẽ trực tiếp đến trang ủy quyền. Đối với một số bên thứ ba đã đăng ký trước khi phát hành Chia sẻ Dữ liệu của Tôi Nhấp vào Thru 2.0, điều này có thể được thực hiện bằng cách chỉ xác định URI Cổng thông tin của Bên thứ ba để bằng "Màn hình Lựa chọn Phạm vi Bên thứ ba"URI (trường Đăng ký SMD cũ sẽ được nghỉ hưu trong một phát hành trong tương lai).
     Ngược lại, một số bên thứ ba có thể muốn thay vào đó, đầu tiên thu hút và sàng lọc khách hàng về phía họ khi khách hàng được chuyển hướng đến URI 'Cổng thông tin bên thứ ba' của họ trước khi yêu cầu mã ủy quyền, vì vậy cách tiếp cận trên chỉ là một gợi ý.
     
6. SMD hiện sẽ cung cấp chi tiết thông số Phạm vi nâng cao như một phần của phản hồi đối với Yêu cầu Mã Ủy quyền, Yêu cầu Mã Xác thực Truy cập và API Ủy quyền. Thông số phạm vi nâng cao cho phép truyền đạt phạm vi ủy quyền cuối cùng của khách hàng. Cụ thể, tham số phạm vi bao gồm giá trị "Bán Phạm vi" tương ứng với các lựa chọn ủy quyền khách hàng được hỗ trợ của PG&E gồm các nhóm dữ liệu (ví dụ: "Sử dụng", "Thanh toán", "Cơ bản", "Tài khoản", "Đăng ký Chương trình"). Các giá trị tham số phạm vi được ghi lại thêm theo tài liệu sau:Tải xuống Bản đồ Chuỗi Phạm vi Khối Chức năng Được Hỗ trợ Nhấp vào Thru 2.0 (PDF)
   
   Một ví dụ về phản hồi Token dưới đây minh họa một số giá trị tham số phạm vi có thể có.
   • Ví dụ về phản hồi của Token:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_471_3_1_3_3_3_3_3_3_3_4_1_3_3_4_4_4_1_4_3_4_4_AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ;Khoảng Thời Gian=900_3600;BlockDuration=Hàng ngày;Lịch sửChiều dài={3P Chiều dài lịch sử đã đăng ký};Thu Tài Khoản={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} ví dụ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} ví dụ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{ authorizationID}
     khách hàngTài nguyênURI:{CustomerResourceURI} ví dụ:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Các bên thứ ba hiện có thể đăng ký để nhận thông tin Ghi danh Chương trình được ủy quyền thông qua nhóm dữ liệu "Ghi danh Chương trình" mới. Cả hai khách hàng được đo khoảng cách cũng như khách hàng được đo khoảng cách không sẽ đủ điều kiện để cho phép chia sẻ dữ liệu cho SMD Nhấp chuột thông qua Giai đoạn 2. Tóm tắt cấp cao về các yếu tố dữ liệu mới có được cung cấp bởi nhóm dữ liệu Ghi danh Chương trình như sau:
   • Ghi danh Chương trình (tên/trạng thái chương trình Phản hồi Nhu cầu PG&E và thông tin CAISO):
   • Địa chỉ tài khoản (Hóa đơn)
   • Trạng thái Thỏa thuận Dịch vụ
   • (Hiện tại) Biểu phí dịch vụ
   • (Hiện tại) Điện áp phục vụ (chỉ dành cho điện)
   • Số đồng hồ đo dịch vụ (nếu có)
   • Loại đồng hồ đo
   • Chu kỳ Đọc Đồng hồ đo (Hiện tại)
   • (Hiện tại) Tùy chọn Mức giá Dự phòng nếu Chỉ báo Tạo Tại chỗ
   • (sử dụng khoảng thời gian mặc định) Thời lượng (chiều dài tính bằng giây)
   • (Đáp ứng Nhu cầu PG&E đã Đăng ký) Tên Chương trình (nếu có)
   • Ngày chấm dứt sớm nhất từ Chương trình Đáp ứng Nhu cầu (DR) đã đăng ký của PG&E mà không có Nghĩa vụ Tài chính
   • Ngày chấm dứt sớm nhất từ Chương trình Đáp ứng Nhu cầu (DR) đã đăng ký của PG&E bất kể Nghĩa vụ Tài chính
   • Trạng thái Chương trình Đáp ứng Nhu cầu (DR) của PG&E (đăng ký)
   • Ngày Ghi Danh Chương Trình Đáp Ứng Nhu Cầu PG&E (DR)
   • Ngày Hủy Ghi danh Chương trình PG&E Đáp ứng Nhu cầu (DR)
   • Bản đồ Atom XML XSD (Định nghĩa Sơ đồ XML) cho các thành phần dữ liệu mới này được thu thập theo tài liệu sau:
     Tải xuống các thành phần dữ liệu được hỗ trợ (PDF)
   • Mô hình phân cấp dữ liệu quan hệ liên quan được trình bày như sau:
     Tải xuống Mô hình Dữ liệu PGE ESPI (PDF)
   • Điểm sử dụng (còn gọi là SA UUID)
     • ServiceDeliveryPoint\tariffHồ sơ(biểu giá dịch vụ hiện tại AKA bao gồm Tùy chọn Giá Dự phòng nếu có)
     • readCycle (Chu kỳ đọc đồng hồ đo hiện tại)Tóm tắt sử dụng
     • readCycle (chu kỳ dịch vụ lập hóa đơn)
     • Hàng hóa (bao gồm mức điện áp được lập hóa đơn cho điện)
     • tariffProfile (thuế dịch vụ được lập hóa đơn bao gồm tùy chọn Mức giá Dự phòng nếu có
   • Loại đọc
     • Hàng hóa (bao gồm mức điện áp hiện tại cho điện và tiền tố cho Tùy chọn Giá Dự phòng nếu có)
   • Tài khoản Khách hàng
     • (Địa chỉ Thanh toán Chính xác):
     • MainAddress/streetDetail...
     • chínhĐịa chỉ/thị trấnChi tiết...
     • chínhĐịa chỉ/Mã bưu chính...
   • Thỏa thuận Khách hàng
     • status\value (Trạng thái SA
   • Chương trình đáp ứng nhu cầu
     • Chương trìnhTên
     • ghi danhTrạng thái
     • Chương trìnhNgày/chương trìnhNgày
     • Chương trìnhNgày/chương trìnhNgàyMô tả
   • Đồng hồ điện
     • Số sê-ri (ID mét)
     • loại (loại mét)
     • Khoảng thời gian (hiện tại)Chiều dài
   • Các định nghĩa lược đồ ESPI xml mới nhất (XSD) được sử dụng cho các yếu tố dữ liệu mới này được nêu trong các mục sau:
     Tải xuống XSD (ZIP, 49 KB)ZIP. Mở trong Cửa sổ mới.
     Lưu ý: XSD tương thích ngược.
   • Các bên thứ ba sẽ có thể thay đổi đăng ký của họ để cho phép khách hàng chọn nhóm dữ liệu này trong thời gian ủy quyền thông qua cổng thông tin của bên thứ ba trong phần quản lý đăng ký > Chỉnh sửa > phần: Cho biết thông tin khách hàng bạn yêu cầu", chọn hộp kiểm Đăng ký Chương trình.
   • Lưu ý:điều này sẽ chỉ áp dụng cho ủy quyền khách hàng mới.
     
   • Các API mới để truy xuất thông tin Ghi danh DR có sẵn ở cấp độ bên thứ 3 Hàng loạt cũng như ở cấp độ ủy quyền khách hàng cá nhân (Cấp độ ID Khách hàng Bán lẻ), được nêu trong các mục sau:
     Tải xuống các API được hỗ trợ mới của PGE (PDF)
   • API không đồng bộ để yêu cầu thông tin Ghi danh DR cho tất cả các ủy quyền cho bên thứ ba
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • API đồng bộ để yêu cầu thông tin đăng ký DR ở cấp độ ủy quyền của từng khách hàng
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{ID Khách hàng Bán lẻ}

Xin lưu ý: Bên cạnh những thay đổi đối với quy trình ủy quyền của khách hàng, các thay đổi khác cũng tương thích ngược và là những cải tiến tự nguyện mà các bên thứ ba có thể chọn để hỗ trợ.

Nếu bạn có bất kỳ câu hỏi nào hoặc cần hỗ trợ thêm, vui lòng gửi email tới sharemydata@pge.com.

Có gì mới:

1. Giờ đây, khách hàng có thể hưởng lợi từ quy trình ủy quyền Nhấp chuột được sắp xếp hợp lý.
   • Chúng tôi đã cập nhật thông tin chi tiết về cách khách hàng có thể chia sẻ dữ liệu với công ty của bạn.
     Tìm hiểu cách khách hàng chia sẻ dữ liệu với một công ty
     
     Lưu ý: Những thay đổi này, đặc biệt là cải tiến giao diện người dùng ủy quyền của chúng tôi, đã được tối ưu hóa cho các thiết bị di động (ví dụ: điện thoại hoặc máy tính bảng).
   • Các thay đổi đã được thực hiện đối với quy trình quản lý ủy quyền mà khách hàng có thể truy cập thông qua tài khoản trực tuyến PG&E của họ:
     • Khách hàng vẫn có thể xóa SAID khỏi ủy quyền hiện có, gia hạn ngày kết thúc ủy quyền và/hoặc hủy ủy quyền bất cứ lúc nào. Tuy nhiên, để thêm SAID bổ sung và/hoặc thay đổi các yếu tố dữ liệu được ủy quyền, ủy quyền hiện tại cần phải được hủy bỏ và ủy quyền mới cần được tạo.
2. Nếu muốn, bây giờ các bên thứ ba có thể sử dụng API này để thu hồi ủy quyền của khách hàng cá nhân bằng cách sử dụng Mã thông báo Truy cập Khách hàng bên thứ ba của họ (được cung cấp trong quá trình đăng ký bên thứ ba SMD ban đầu) thông qua hoạt động XÓA: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   Lưu ý 1:Để thực hiện PG&E, tham số AuthorizationID có cùng giá trị với SubscriptionID.
   
   Lưu ý 2:API mới cung cấp cho các bên thứ ba khả năng thu hồi (hủy) ủy quyền. Tuy nhiên, chỉ bản thân khách hàng mới có thể xóa ID SA và/hoặc cập nhật ngày kết thúc ủy quyền thông qua các trang ủy quyền quản lý SMD của chúng tôi.
   
   Nhắc nhở:Như với tất cả các yêu cầu dữ liệu API, trước tiên các bên thứ ba phải yêu cầu Cặp Token mới (Truy cập Khách hàng + Token Làm mới) bằng cách sử dụng Token Làm mới mới mới nhất của họ.
   
   Nhắc nhở về Thời gian Hết hạn của Token:
   • Mã thông báo Truy cập:1 giờ
   • Mã Thông Báo Truy Cập Khách Hàng: 5 phút
   • Token Làm mới Tương ứng: 1Yr
3. Giờ đây, các bên thứ ba có thể tạo nhiều đăng ký Chia sẻ Dữ liệu của Tôi (SMD) bằng cách sử dụng cùng tên công ty và ID Thuế nếu cần. Tuy nhiên, tên hiển thị (mà khách hàng nhìn thấy khi ủy quyền) vẫn cần phải là duy nhất.
   
   Lưu ý:Tất cả các thay đổi ở trên đều tương thích ngược và là những cải tiến tự nguyện mà các bên thứ ba có thể chọn để hỗ trợ. Tải xuống các tài liệu hỗ trợ cho bản phát hành này:
   
   ĐƯỢC HỖ TRỢ_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   HỖ TRỢ_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   HỖ TRỢ_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

Ngày 20 tháng 12 năm 2015

Các thay đổi bắt buộc:các bản cập nhật SMD 2.0 sau đây yêu cầu các thay đổi từ phía bên thứ ba.

1. Để xem xét các bên thứ ba có triển khai GBCMD (Green Button Connect My Data) tại nhiều tiện ích bên cạnh PG&E, chúng tôi sẽ chuyển lại dữ liệuCustodianID (tức là dữ liệuCustodianID=PGE) trong chuyển hướng đến ThirdPartyScopeSelectionScreenURI trong trình tự ủy quyền OAuth.
2. Yêu cầu API chấp nhận các thông số ngày (ví dụ: yêu cầu lô), phải sử dụng các thông số dữ liệu Zulu (ví dụ: công bố tối đa/công bố tối thiểu). Các định dạng ngày khác cho các thông số ngày trong các yêu cầu API sẽ không được hỗ trợ.
   • Các API chấp nhận tham số ngày được ghi lại theo đính kèm, API được hỗ trợ.xlsx
3. Các chỉ số TOU khoảng thời gian đi kèm với dữ liệu sử dụng điện đo khoảng thời gian (nếu có, chỉ báo khoảng thời gian TOU mỗi khoảng thời gian tương ứng)
   • Vui lòng tham khảo Bản đồ ID Chương trình tĩnh nêu chi tiết mỗi khoảng thời gian liệt kê TOU tương ứng với khoảng thời gian nào (ví dụ: 1 = Mùa hè Đỉnh điểm, v.v.). (Xem đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx )
4. Client_id như được tìm thấy trong dữ liệuCustodianScopeSelectionScreenURI (được sử dụng cho bên thứ ba khởi tạo OAuth) và được cung cấp trong yêu cầu của bên thứ ba Tài nguyên Thông tin Ứng dụng trong quá trình Kiểm tra Đăng ký đang được cập nhật thành 5 chữ số nếu chưa có (ví dụ: thêm các số không hàng đầu, v.v.). Ngoài ra, URL không còn bao gồm '&verified=true' ở cuối. Các bên thứ ba sẽ cần cập nhật URL của họ cho phù hợp.
   • Để giải thích chi tiết, dữ liệuCustodianScopeSelectionScreenURI trông như sau: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX là clientID)
   • Vì vậy, một ID khách hàng hiện tại là 123 sẽ thay đổi thành 00123 có nghĩa là dữ liệu mới của họCustodianScopeSelectionScreenURI sẽ như sau:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (URL cũ như sau: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. Các bên thứ ba được đăng ký là "ESP" hoặc "Nhà cung cấp Dịch vụ Năng lượng" đang chuyển sang Loại Người dùng Tiêu chuẩn. Không có thay đổi về chức năng, chỉ trong tiêu đề loại người dùng. Phân biệt loại người dùng ESP (từ loại Người dùng Tiêu chuẩn) là sự khác biệt không cần thiết, gây nhầm lẫn trong quá trình đăng ký mà không cung cấp bất kỳ chức năng khác biệt nào, do đó nó đang được ngừng sử dụng.

Cải tiến Tùy chọn: Những thay đổi sau đây tương thích ngược và là những cải tiến tự nguyện mà các bên thứ ba có thể chọn để hỗ trợ.

1. Các bên thứ ba sẽ có khả năng tự động thay đổi/cập nhật chứng chỉ SSL mà họ đã cung cấp ban đầu trong quá trình đăng ký (ví dụ: khi chứng chỉ gần hết hạn) thông qua cổng thông tin của bên thứ ba trong quản lý đăng ký > Chỉnh sửa > phần mới: Thông tin Chứng chỉ SSL (Tùy chọn cập nhật).
2. Các bên thứ ba có thể đăng ký để nhận thông tin thanh toán cơ bản được ủy quyền, thông tin khách hàng và dữ liệu khí đốt.  Cả khách hàng được đo khoảng thời gian cũng như khách hàng được đo khoảng cách không sẽ đủ điều kiện để cho phép chia sẻ dữ liệu cho SMD 2.0. Tóm tắt mức độ cao về các yếu tố dữ liệu mới có như sau:
   • Thông tin Thanh toán: (cho cả SA đo lường theo Khoảng thời gian và không xen kẽ)
     • Biểu giá, tổng số tiền thanh toán, sử dụng theo cấp bậc (nếu có), Nhu cầu (nếu có), tổng số TOU (nếu có)
     • Lưu ý: Đối với các khách hàng được phép sử dụng máy đo không khoảng thời gian giữa kỳ, các bên thứ ba sẽ chỉ nhận được tổng số lần sử dụng hóa đơn (tức là trong Tóm tắt Sử dụng) và không có số lần sử dụng theo khoảng thời gian nào (ví dụ: số lần đọc hàng giờ/hàng ngày vì không có sẵn)
   • Thông tin Khách hàng: (đối với cả SA đo khoảng cách và không đo khoảng cách)
     • Tên Khách hàng, Địa chỉ Dịch vụ, ID Tài khoản, ID Hợp đồng Dịch vụ, Ngày Bắt đầu Dịch vụ Hợp đồng Dịch vụ,
   • Dữ liệu sử dụng khí theo khoảng thời gian: (chỉ dành cho khí SA đo khoảng cách)
     • Chỉ số khí theo khoảng thời gian (tức là hàng ngày)
   • Các thành phần dữ liệu mới được lập sơ đồ theo đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx
   • Phân cấp dữ liệu liên quan được nêu trong đính kèm,PGE ESPI Data Model.xlsx
   • Các định nghĩa lược đồ ESPI xml mới nhất (XSD) được sử dụng cho các yếu tố dữ liệu mới này là theo XSD đính kèm. Lưu ý:XSD tương thích ngược:
     • espiDerived.xsd (Thông tin Sử dụng và Thanh toán Tạm thời)
     • bán lẻcustomer.xsd (thông tin khách hàng)

Nếu bạn có bất kỳ câu hỏi nào hoặc cần hỗ trợ thêm, vui lòng liên hệ với chúng tôi theo địa chỉShareMyData@pge.com.

Ngày 18 tháng 12 năm 2015

Các thay đổi bắt buộc: các bản cập nhật SMD 2.0 sau đâyyêu cầu các thay đổi về phía những người dùng đó truy cập dữ liệu của riêng họ:

1. Yêu cầu API chấp nhận các thông số ngày (ví dụ: yêu cầu lô), phải sử dụng các thông số dữ liệu Zulu (ví dụ: công bố tối đa/công bố tối thiểu). Các định dạng ngày khác cho các thông số ngày trong các yêu cầu API sẽ không được hỗ trợ.
   • Các API chấp nhận tham số ngày được ghi lại theo đính kèm, API được hỗ trợ.xlsx
2. Các chỉ số Khoảng Thời gian Sử dụng (TOU) đi kèm với dữ liệu sử dụng điện đo Khoảng thời gian (nếu có, chỉ báo khoảng thời gian TOU mỗi khoảng thời gian tương ứng)
   • Vui lòng tham khảo Bản đồ ID Chương trình tĩnh nêu chi tiết mỗi khoảng thời gian liệt kê TOU tương ứng với khoảng thời gian nào (ví dụ: 1 = Mùa hè Đỉnh điểm, v.v.). (Xem đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx )

Cải tiến Tùy chọn: Những thay đổi sau đây tương thích ngược và là những cải tiến tự nguyện mà các bên thứ ba có thể chọn để hỗ trợ.

1. Người dùng Tự truy cập sẽ có khả năng tự động thay đổi/cập nhật chứng chỉ SSL mà họ đã cung cấp ban đầu trong quá trình đăng ký (ví dụ: khi chứng chỉ gần hết hạn) thông qua cổng thông tin của bên thứ ba trong quản lý đăng ký > Chỉnh sửa > phần mới: Thông tin Chứng chỉ SSL (Tùy chọn cập nhật)
2. Đăng ký người dùng Tự truy cập sẽ được cập nhật để bao gồm thông tin thanh toán cơ bản được ủy quyền, thông tin khách hàng và dữ liệu gas. Cả hai khoảng thời gian được đo lường như các Thỏa thuận Dịch vụ được đo lường không xen kẽ sẽ đủ điều kiện để được ủy quyền (tự) cho SMD 2.0 Tóm tắt cấp độ cao về các yếu tố dữ liệu mới có như sau:
   • Thông tin Thanh toán: (cho cả SA đo lường theo Khoảng thời gian và không xen kẽ)
     • Biểu giá, tổng số tiền thanh toán, sử dụng theo cấp bậc (nếu có), Nhu cầu (nếu có), tổng số TOU (nếu có)
     • Lưu ý: Đối với các khách hàng được phép sử dụng máy đo không khoảng thời gian giữa kỳ, các bên thứ ba sẽ chỉ nhận được tổng số lần sử dụng hóa đơn (tức là trong Tóm tắt Sử dụng) và không có số lần sử dụng theo khoảng thời gian nào (ví dụ: số lần đọc hàng giờ/hàng ngày vì không có sẵn)
   • Thông tin Khách hàng: (đối với cả SA đo khoảng cách và không đo khoảng cách)
     • Tên Khách hàng, Địa chỉ Dịch vụ, ID Tài khoản, ID Hợp đồng Dịch vụ, Ngày Bắt đầu Dịch vụ Hợp đồng Dịch vụ,
   • Dữ liệu sử dụng khí theo khoảng thời gian: (chỉ dành cho khí SA đo khoảng cách)
     • Chỉ số khí theo khoảng thời gian (tức là hàng ngày)
   • Các thành phần dữ liệu mới được lập sơ đồ theo đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx
   • Phân cấp dữ liệu liên quan được nêu trong đính kèm,PGE ESPI Data Model.xlsx
   • Các định nghĩa lược đồ ESPI xml mới nhất (XSD) được sử dụng cho các yếu tố dữ liệu mới này là theo XSD đính kèm. Lưu ý:XSD tương thích ngược:
     • espiDerived.xsd (Thông tin Sử dụng và Thanh toán Tạm thời)
     • bán lẻcustomer.xsd (thông tin khách hàng)

Nếu bạn có bất kỳ câu hỏi nào hoặc cần hỗ trợ thêm, vui lòng liên hệ với chúng tôi theo địa chỉShareMyData@pge.com.

Ngày 18 tháng 12 năm 2015

Các thay đổi bắt buộc: các bản cập nhật SMD 2.0 sau đâyyêu cầu các thay đổi về phía triển khai CCA.

1. Các yêu cầu đặc biệt (ví dụ: đối với dữ liệu lịch sử), phải được thực hiện bằng cách sử dụng các thông số ngày giờ Zulu. Các định dạng ngày khác cho các thông số ngày trong các yêu cầu API sẽ không được hỗ trợ.
2. Nguồn cấp dữ liệu sử dụng số lượng lớn hàng ngày sẽ bắt đầu bao gồm thông tin thanh toán cơ bản trong khi nguồn cấp dữ liệu khách hàng số lượng lớn hàng ngày sẽ bao gồm thông tin khách hàng bổ sung. Dữ liệu mới này sẽ được cung cấp cho cả khách hàng được đo khoảng thời gian mà họ nhận được dữ liệu hiện tại, cũng như cho khách hàng được đo không khoảng thời gian trong lãnh thổ của họ mà họ hiện không nhận được dữ liệu. Cuối cùng, các giá trị sử dụng khoảng thời gian được cung cấp trong nguồn cấp dữ liệu sử dụng số lượng lớn hàng ngày sẽ bao gồm các chỉ số TOU khoảng thời gian nếu có. Tóm tắt cấp độ cao về các yếu tố dữ liệu mới như sau:
   • Thông tin Thanh toán: (cho cả SA đo lường theo Khoảng thời gian và không xen kẽ)
     • Biểu giá, tổng số tiền thanh toán, sử dụng theo cấp bậc (nếu có), Nhu cầu (nếu có), tổng số TOU (nếu có)
   • (Bổ sung) Thông tin Khách hàng: (cho cả SA định lượng theo khoảng thời gian và không định lượng theo khoảng thời gian)
     • Tên Khách hàng, Địa chỉ Dịch vụ, Ngày Bắt đầu Dịch vụ Thỏa thuận Dịch vụ, ID Tài khoản
   • Các chỉ số TOU khoảng thời gian đi kèm với dữ liệu sử dụng điện đo khoảng thời gian (nếu có, chỉ báo khoảng thời gian TOU mỗi khoảng thời gian tương ứng)
     • Vui lòng tham khảo Bản đồ ID Chương trình tĩnh nêu chi tiết mỗi khoảng thời gian liệt kê TOU tương ứng với khoảng thời gian nào (ví dụ: 1 = Mùa hè Đỉnh điểm, v.v.). (Xem đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx )
   • Các định nghĩa lược đồ ESPI xml mới nhất (XSD) được sử dụng cho các yếu tố dữ liệu mới này là theo XSD đính kèm. Lưu ý, XSD tương thích ngược:
     • espiDerived.xsd (Thông tin Sử dụng và Thanh toán Tạm thời)
     • retailcustomer.xsd (Thông tin khách hàng)
   • Các thành phần dữ liệu mới được lập sơ đồ theo đính kèm,Các thành phần dữ liệu được hỗ trợ.xlsx
   • Phân cấp dữ liệu liên quan được nêu trong đính kèm,PGE ESPI Data Model.xlsx

Cải tiến Tùy chọn: Những thay đổi sau đây tương thích ngược và là những cải tiến tự nguyện mà các bên thứ ba có thể chọn để hỗ trợ.

1. CCA có thể đưa ra các yêu cầu đặc biệt về thông tin khách hàng tại: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (trả về ảnh chụp nhanh thông tin khách hàng mới nhất tại thời điểm yêu cầu), ngoài thông báo hàng ngày nhận được.
2. CCA sẽ có khả năng tự động thay đổi chứng chỉ SSL của họ mà họ đã cung cấp ban đầu trong quá trình đăng ký (ví dụ: khi chứng chỉ sắp hết hạn) thông qua cổng thông tin của bên thứ ba, trong quản lý đăng ký > Chỉnh sửa > phần mới: Thông tin Chứng chỉ SSL (Tùy chọn cập nhật)

Nếu bạn có bất kỳ câu hỏi nào hoặc cần hỗ trợ thêm, vui lòng liên hệ với chúng tôi theo địa chỉShareMyData@pge.com.

Ngày 21 tháng 8 năm 2015

Có gì mới:

1. Các thay đổi về thông số và nguồn lực URI của tiểu bang trong các câu trả lời Oauth
   • Là một phần của yêu cầu mã ủy quyền OAuth, bên thứ ba có tùy chọn gửi thông số trạng thái mà PG&E sẽ gửi lại cho bên thứ ba. PG&E cũng sẽ gửi mã ủy quyền khi hoàn thành ủy quyền thành công. Tham số trạng thái tùy chọn này có thể được sử dụng để giúp bên thứ ba xác định nơi yêu cầu được khởi tạo và ràng buộc yêu cầu trở lại với các ủy quyền mà họ đã khởi tạo.
   • Là một phần của việc hoàn thành thành công yêu cầu mã thông báo, chúng tôi chia sẻ lại resourceURI và authorizationURI riêng biệt với thông tin mã thông báo. Hiện tại, các URI này đã bị lật và là một phần của bản phát hành này, chúng tôi sẽ sửa lại.

Sửa lỗi:

1. Ngày mặc định được công bố-tối đa và công bố-tối thiểu
   Hiện tại PG&E bắt buộc bên thứ ba gửi các thông số tối thiểu và tối đa được công bố trong thời gian cho mỗi yêu cầu dữ liệu để cho PG&E biết thời lượng mà họ đang yêu cầu dữ liệu. Chúng tôi đang thực hiện thay đổi để xử lý các yêu cầu cho các tình huống sau:
   • thiếu các giá trị tối thiểu và tối đa đã công bố
   • các giá trị được công bố-phút và được công bố-tối đa là trong UTC
   • các giá trị được công bố-phút và được công bố-tối đa là trong thời đại giây
   Trong trường hợp các thông số bị thiếu, PG&E sẽ trả về ngày mặc định, trái ngược với thông báo lỗi được trả về trước khi thay đổi này. Mặc định, trong trường hợp của chúng tôi, là dữ liệu của một ngày cho ngày T-2. Nếu các tham số có mặt và được định dạng chính xác, chúng tôi sẽ tiếp tục tôn trọng các tham số.
2. Sửa ngày trong xml ủy quyền
   Hiện tại trong xml ủy quyền mà chúng tôi đã chia sẻ ngày công bố và ngày ủy quyền. Những ngày này tính bằng mili giây trái ngược với giây là tiêu chuẩn. Chúng tôi đang sửa chữa để gửi lại trong vài giây thay vì mili giây.
3. XML không chính xác được trả về cho /tài nguyên/Đăng ký/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Hiện tại chúng tôi đang trả về phản hồi không chính xác cho cấp tài nguyên trên GET khi cấu trúc của XML không chính xác và chúng tôi đang lặp lại các mục nhập cho mỗi khoảng thời gian thay vì tạo một khối khoảng thời gian duy nhất trong khoảng thời gian 24 giờ.
   
   Điều này đang được cố định và chỉ một khối khoảng thời gian đơn sẽ được trả lại cho một khối khoảng 24.

Bạn có thắc mắc hay lo ngại? Vui lòng liên hệShareMyData@pge.com.

• Khách hàng cho phép bạn truy cập dữ liệu của họ thông qua My Energy, tài khoản trực tuyến PG&E của họ. Để biết tổng quan chi tiết về cách khách hàng có thể ủy quyền cho bên thứ ba hoặc các tổ chức khác truy cập dữ liệu của họ, vui lòng xem Tổng quan về Bên thứ ba Chia sẻ Dữ liệu của Tôi.

Đi đến chi tiết ủy quyền

• Hiện tại, không có giới hạn.

• Khách hàng có thể chọn một khoảng thời gian cụ thể mà bạn có thể truy cập dữ liệu của họ hoặc họ có thể để thời gian ủy quyền mở.
• Đơn đăng ký của bạn có thể kiểm tra ngày kết thúc ủy quyền của khách hàng cùng với các chi tiết ủy quyền khác bằng cách gọi cho các API tài nguyên ủy quyền (ví dụ: .../espi/1_1/resource/Authorization và/hoặc.../espi/1_1/resource/Authorization/{AuthorizationID}).
• Ngoài ra, bạn có thể kiểm tra thủ công ngày kết thúc ủy quyền bằng cách đăng nhập vào tài khoản của mình và chọn Quản lý Ủy quyền.

• Nếu khách hàng chọn một khoảng thời gian ủy quyền xác định, thì ủy quyền của họ sẽ hết hạn vào cuối khoảng thời gian đó. Nếu họ hủy ủy quyền, thì ủy quyền của họ sẽ hết hạn vào ngày sau khi họ hủy ủy quyền.
• Nếu khách hàng chọn Không xác định là thời gian ủy quyền của họ, thì ủy quyền của họ không hết hạn. Lưu ý, khi xem xét Nhà cung cấp Đáp ứng Nhu cầu theo Quy tắc 24 và các chương trình khác sử dụng Chia sẻ Dữ liệu của Tôi, các sửa đổi sau sự kiện cho các phạm vi ngày được ủy quyền trước đó có thể được cung cấp cho các bên thứ ba trong tối đa ba năm sau khi hết hạn ủy quyền.
• Xem "Việc chỉnh sửa dữ liệu sẽ được xử lý như thế nào?" để biết thêm chi tiết về việc nhận các sửa đổi.

• Bất kỳ khách hàng nào của PG&E có ID Dịch vụ hiện đang hoạt động cho dịch vụ khí đốt hoặc điện đều có thể cho phép bạn truy cập dữ liệu của họ bằng công cụ Chia sẻ Dữ liệu của Tôi mới.

• Khách hàng quan tâm đến việc tham gia chia sẻ dữ liệu của họ thông qua chương trình Chia sẻ Dữ liệu của Tôi được khuyến khích đăng ký tài khoản My Energy. Điều này sẽ làm cho toàn bộ quy trình hiệu quả hơn và cũng cung cấp cho họ khả năng quản lý ủy quyền trực tuyến.
• Khách hàng có thể đăng ký tài khoản My Energy trong quá trình ủy quyền.
• Có một quy trình thủ công dành cho khách hàng để lấy Mẫu Ủy Quyền Chia Sẻ Dữ Liệu Của Tôi trực tuyến và gửi mẫu đã hoàn thành qua email.
• Để biết thêm thông tin về quy trình thủ công, vui lòng liên hệ với chúng tôi theo địa chỉShareMyData@pge.com.

• Khách hàng được yêu cầu tự thực hiện ủy quyền trực tuyến thông qua tài khoản trực tuyến PG&E của họ. Tuy nhiên, nếu họ hoàn thành và ký vào mẫu Ủy quyền Chia sẻ Dữ liệu của Tôi, thì bạn có thể gửi mẫu đó cho PG&E thay mặt họ.

Tải xuống mẫu Ủy quyền hoặc Thu hồi Ủy quyền Chia sẻ Dữ liệu của Tôi (PDF, 308 KB)

• Bạn có thể cập nhật OAuth URI của mình bằng cách đăng nhập vào tài khoản của mình, điều hướng đến Quản lý Đăng ký > Chỉnh sửa > và cập nhật các trường trong phần Thông tin OAuth 2.0.

• Bạn có thể cập nhật Notification URI bằng cách đăng nhập vào tài khoản của mình, điều hướng đến Quản lý Đăng ký > Chỉnh sửa > và cập nhật các trường trong phần Thông tin Truy cập Dữ liệu.

• Bạn có thể cập nhật chứng chỉ SSL của mình bằng cách đăng nhập vào tài khoản của mình, điều hướng đến Quản lý Đăng ký > Chỉnh sửa > và chọn "Cập nhật" trong phần Thông tin Chứng chỉ SSL. Lưu ý rằng đối với việc tải lên chứng chỉ mới, có thể mất vài ngày để cập nhật hệ thống PG&E với chứng chỉ mới.  
• Một email xác nhận từ nhóm Hỗ trợ Chia sẻ Dữ liệu của Tôi sẽ được gửi khi chứng nhận mới đã được áp dụng.

• Khi bạn nhận được email cho biết đăng ký của bạn đã được chấp nhận, bạn sẽ có thể đăng nhập vào tài khoản Chia sẻ Dữ liệu của Tôi và tải xuống Chứng nhận SSL của chúng tôi thông qua trang Tải xuống Chứng nhận SSL PG&E.

Đăng nhập để Chia sẻ Dữ liệu của Tôi

• Chia sẻ Dữ liệu của tôi tuân theo các thỏa thuận thực hiện Kết nối Nút Xanh Dữ liệu của tôi. Share My Data cũng sử dụng OAuth 2.0 để ủy quyền, Transport Layer Security (TLS) 1.2 và bộ giao thức an ninh mạng tối thiểu được NIST (Viện Tiêu chuẩn và Công nghệ Quốc gia) phê duyệt để không trao đổi thông tin một cách rõ ràng.

• Bảo vệ thông tin khách hàng là ưu tiên hàng đầu của PG&E. PG&E coi thông tin về khách hàng của họ—bao gồm thông tin cá nhân—là thông tin bảo mật, phù hợp với tất cả các yêu cầu pháp lý và quy định, bao gồm cả những yêu cầu do Ủy ban Tiện ích Công cộng California và những yêu cầu khác thiết lập.  
• Trong hơn hai thập kỷ, PG&E và các tiện ích khác do nhà đầu tư sở hữu ở California đã phải tuân theo các quy định CPUC rất nghiêm ngặt cấm họ tiết lộ thông tin cụ thể của khách hàng, chẳng hạn như dữ liệu thanh toán, cho các bên thứ ba mà không có sự đồng ý rõ ràng của khách hàng.  
• Khi khách hàng cho phép tiết lộ dữ liệu, khách hàng và bên thứ ba có trách nhiệm bảo vệ dữ liệu đó.
• Khách hàng có thể chọn ngừng chia sẻ dữ liệu với bên thứ ba bất cứ lúc nào bằng cách đăng nhập vào tài khoản trực tuyến PG&E của họ và hủy ủy quyền của họ. Chính sách quyền riêng tư hoàn chỉnh của PG&E và Thông báo Truy cập, Thu thập, Lưu trữ, Sử dụng và Tiết lộ Thông tin Sử dụng Năng lượng có sẵn tạipge.com/privacy.

• Trong phạm vi của chương trình Chia sẻ Dữ liệu của Tôi, các bên thứ ba phải tuân theo Quy tắc Bảo vệ và Quyền riêng tư Dữ liệu Khách hàng được quy định trong các điều khoản và điều kiện nền tảng Chia sẻ Dữ liệu của Tôi và các yêu cầu được bao gồm trong Biểu thuế Truy cập Dữ liệu Khách hàng.
• Các bên thứ ba cũng phải tuân theo tất cả các luật và quy định hiện hành khác liên quan đến việc bảo vệ quyền riêng tư của khách hàng, bao gồm, nhưng không giới hạn, Quy tắc về Bảo vệ Quyền riêng tư và Bảo mật đối với Dữ liệu Sử dụng Năng lượng được CPUC thông qua làm Tài liệu đính kèm D của Quyết định 11-07-056 (Điện), cũng được tóm tắt trong Quy tắc Điện số 27 của PG&E và Mục 1798.80 – 1798.84 của Bộ luật Dân sự California.
• Để biết thêm thông tin, vui lòng chọn các liên kết dưới đây:
  Chia sẻ Điều khoản và Điều kiện Dữ liệu của Tôi (PDF, 190 KB)
  Quy tắc Điện Số 27 (PDF, 1,6 MB)
  Đính kèm D vào Quyết định 11-07-056 (PDF)
  Tìm thêm thông tin:Bộ luật Dân sự California Phần 1798.80 – 1798.84

• Vui lòng tham khảo liên kết bên dưới để biết danh sách chi tiết các yếu tố dữ liệu được hỗ trợ.

Nhận thêm thông tin về truy cập dữ liệu

• Đôi khi, dữ liệu sử dụng khoảng thời gian bị thiếu vì các quy trình xác thực dữ liệu thượng nguồn của chúng tôi thấy có các dữ liệu đọc bị thiếu hoặc không chính xác có thể cần xử lý thêm (chỉnh sửa và hoặc ước tính).
• Đối với các khách hàng bị tính hóa đơn theo khoảng thời gian (ví dụ: khách hàng có cân nhắc về tính hóa đơn theo Thời gian sử dụng), những trường hợp này được sửa kịp thời để đảm bảo tính toán hóa đơn chính xác trên hóa đơn hàng tháng sắp tới của họ.

• Nếu bạn muốn nhận chỉnh sửa dữ liệu, vui lòng đảm bảo rằng bạn đánh dấu vào hộp kiểm Thông báo cho tôi vì dữ liệu đã sẵn sàng trong quá trình đăng ký hoặc bằng cách đăng nhập vào tài khoản trực tuyến của bạn và chọn hộp kiểm này trong mục Chỉnh sửa Hồ sơ. Sau đó, chúng tôi sẽ bao gồm các chỉnh sửa dữ liệu đã được hệ thống của chúng tôi thu thập trong 24 giờ trước đó, như một phần của nguồn cấp dữ liệu sử dụng hàng ngày, cho bất kỳ dữ liệu nào bạn được phép truy cập.
• Chỉnh sửa dữ liệu sẽ bao gồm bất kỳ thay đổi nào trong thời gian cho phép, tối đa là ba năm.

Lưu ý: Khi xem xét Nhà cung cấp Đáp ứng Nhu cầu theo Quy tắc 24 và các chương trình khác sử dụng Chia sẻ Dữ liệu của Tôi, các sửa đổi sau sự kiện cho các phạm vi ngày được cho phép trước đó có thể được cung cấp cho các bên thứ 3 trong tối đa ba năm sau khi hết hạn ủy quyền.

• Nếu áp dụng, PG&E sẽ gửi thông báo đến URL thông báo của bạn được cung cấp trong quá trình đăng ký. Thông báo bao gồm các URL tương ứng với dữ liệu đã được đóng gói sẵn sẵn để bạn quay lại và yêu cầu tại các URL được cung cấp. Dữ liệu được đóng gói sẵn và thông báo được gửi trong hai tình huống sau: (1) bạn đã chọn "Thông báo cho tôi khi dữ liệu đã sẵn sàng" trong hồ sơ đăng ký của bạn, trong trường hợp đó chúng tôi sẽ đóng gói dữ liệu hàng ngày mới nhất với bất kỳ sửa đổi nào cho các ngày trong quá khứ, hoặc (2) bạn đã thực hiện một yêu cầu không đồng bộ đặc biệt trước đó mà dữ liệu được yêu cầu hiện đã sẵn sàng. Tình huống 1 được minh họa trong "CẬN TRUY CẬPDATA: ĐĂNG KÝ HÀNG NGÀY" trong sơ đồ Phương pháp Truy cập Dữ liệu trên Trang Truy cập Dữ liệu và kịch bản 2 được minh họa trong "CẬN TRUY CẬP DỮ LIỆU: Phần YÊU CẦU HOC AD (ĐƯỢC ĐỒNG BỘ)" của cùng một sơ đồ cũng trên Trang Truy cập Dữ liệu.

Truy cập dữ liệu ở trên

• Dữ liệu sử dụng điện do Share My Data cung cấp không phải là Dữ liệu Đồng hồ đo Chất lượng Thanh toán (SQMD) theo quy định của Nhà điều hành Hệ thống Độc lập California (CAISO). SQMD được tạo ra bằng cách nhân Dữ liệu Đồng hồ đo Chất lượng Doanh thu (RQMD) với Hệ số Tổn thất Phân phối (DLF) áp dụng cho mức điện áp của khách hàng đó cho khoảng thời gian đó, chuyển đổi các khoảng thời gian được đo thành khoảng thời gian theo yêu cầu của CAISO và sau đó tổng hợp kết quả cho mỗi khoảng thời gian thành mức tổng hợp theo yêu cầu của CAISO.
  
• PG&E đang triển khai các cờ của Loại "Chất lượng Đọc" (QOR) được cung cấp theo tiêu chuẩn ESPI để thông báo liệu dữ liệu có phải là Chất lượng Doanh thu hay không. Loại QOR ghi lại các giá trị chất lượng có thể khác nhau cho dữ liệu sử dụng, bao gồm một giá trị rõ ràng cho “Dữ liệu Đồng hồ đo Chất lượng Doanh thu” hoặc “RQMD”. PG&E sẽ sử dụng Loại QOR này trong quá trình truyền dữ liệu của mình như sau:
  • PG&E hỗ trợ lớp "Tóm tắt Sử dụng" do ESPI cung cấp, lớp này sẽ được sử dụng để xác định ngày lập hóa đơn hợp đồng dịch vụ, số tiền sử dụng được lập hóa đơn và chất lượng dữ liệu sử dụng tại thời điểm yêu cầu. Tóm tắt Sử dụng sẽ được điền khi hóa đơn có sẵn cho dữ liệu được yêu cầu và sẽ bao gồm hai cờ (yếu tố) của Loại QOR:
    • Phần tử Usage Summary.QualityOfReading (ở cấp độ Usage Summary) cho biết chất lượng tại thời điểm yêu cầu các giá trị sử dụng khoảng thời gian được cung cấp mới nhất cộng với các hiệu chỉnh tương ứng với Usage Summary.billingPeriod date.
    • Yếu tố chất lượng mặc định cho Tổng tiêu thụLastPeriod (như một phần của Tóm tắt sử dụng.Tổng tiêu thụLastPeriod.ReadingTypeRef) cho biết chất lượng của tổng số lần sử dụng được lập hóa đơn.
  • PG&E cũng sẽ truyền đạt chất lượng dữ liệu sử dụng ở mức khoảng thời gian tại thời điểm yêu cầu bằng cách sử dụng IntervalReading.ReadingQuality.Quality element.

• Trong quá trình đăng ký, bạn có thể chọn số lượng dữ liệu lịch sử bạn cần, 24, 36 hoặc 48 tháng trong danh sách thả xuống "Số lượng dữ liệu lịch sử được yêu cầu".
• Là một phần trong ủy quyền của khách hàng cho phép bạn truy cập dữ liệu của họ, khoảng thời gian ủy quyền trước đây sẽ được mặc định là lựa chọn đăng ký của bạn cho ID Dịch vụ (điểm sử dụng) có trong ủy quyền.
• Bạn có thể cập nhật dữ liệu lịch sử yêu cầu của mình, bằng cách đăng nhập vào tài khoản của bạn, điều hướng đến Quản lý Đăng ký > Chỉnh sửa > và chọn từ danh sách thả xuống có nhãn "Yêu cầu bao nhiêu dữ liệu lịch sử."
• Xin lưu ý rằng dữ liệu được cung cấp trong yêu cầu trước đây sẽ bắt đầu từ ngày khách hàng thực hiện ủy quyền, trái ngược với ngày bạn thực hiện yêu cầu với API.

Lưu ý: Những thay đổi đối với dữ liệu lịch sử được yêu cầu của bạn chỉ ảnh hưởng đến ủy quyền của khách hàng mới, trong khi ủy quyền của khách hàng trước đó sẽ phản ánh lựa chọn của bạn tại thời điểm ủy quyền.

• Theo tiêu chuẩn ESPI, câu trả lời sử dụng Tiêu chuẩn Xuất bản Nguyên tử. Vui lòng chọn liên kết bên dưới để xem danh sách đầy đủ các API được hỗ trợ, cùng với các yếu tố dữ liệu có sẵn.

Nhận thêm thông tin về truy cập dữ liệu

• Các ID Dịch vụ điện và gas đang hoạt động được PG&E cài đặt và đọc đủ điều kiện để ủy quyền thông qua nền tảng Chia sẻ Dữ liệu của Tôi.
• Nếu ID Dịch vụ liên quan đến ủy quyền thay đổi do một trong những lý do sau, ủy quyền sẽ chuyển sang ID Dịch vụ mới và quyền truy cập vào dữ liệu sử dụng khoảng thời gian trước đây sẽ tiếp tục:
  • Tạm thời đóng cửa do không thanh toán
  • Chuyển sang Thanh toán theo Khoảng thời gian
  • Đổi đồng hồ đo
  • Thay đổi tỷ lệ
• Các tình huống khác dẫn đến thay đổi ID Dịch vụ như di chuyển địa điểm hoặc thay đổi công ty sẽ chấm dứt quyền truy cập. Ngoài ra, nếu một tài khoản bị hủy liên kết khỏi tài khoản Năng lượng của tôi, tất cả các ID Dịch vụ cơ bản được ủy quyền qua Chia sẻ Dữ liệu của tôi sẽ bị trái phép.

• Để xác định mức độ chi tiết của dữ liệu khoảng thời gian được cho phép, vui lòng tham khảo phần tử Khoảng thời gian theo tiêu chuẩn ESPI.
• PG&E đang cung cấp dữ liệu sử dụng khoảng thời gian ở cùng mức độ chi tiết như được thu thập cho mục đích lập hóa đơn, thường là theo giờ hoặc 15 phút đối với dữ liệu điện và hàng ngày đối với dữ liệu khí đốt cho những khách hàng có đồng hồ đo khoảng thời gian. Trong khi nó có thể thay đổi theo khách hàng, việc sử dụng máy đo khoảng cách điện thường có sẵn ở mức hàng giờ cho hầu hết các khách hàng dân cư và ở mức khoảng cách 15 phút cho hầu hết các khách hàng thương mại, và việc sử dụng máy đo khoảng cách khí thường có sẵn ở mức hàng ngày cho hầu hết các khách hàng.
• Đối với đồng hồ đo không trung gian, dữ liệu sẽ được cung cấp khi có sẵn.

• Đối với phần lớn khách hàng của PG&E có cài đặt Đồng hồ thông minh, dữ liệu sử dụng khoảng thời gian điện và khí sẽ có sẵn vào cuối ngày hôm sau thông qua nền tảng Chia sẻ Dữ liệu của Tôi.
• Một phần nhỏ khách hàng sử dụng điện của PG&E có lắp đặt đồng hồ MV90 dựa trên dây điện có thể cần thêm thời gian để có dữ liệu.

• Mặc dù chúng tôi không thể hỗ trợ trực tiếp việc thiết lập API của bạn, nhưng chúng tôi có một số tài nguyên sẵn có để hỗ trợ các tài nguyên CNTT và kỹ thuật của bạn trong quá trình phát triển. Vui lòng tham khảo trang Tài liệu API của chúng tôi để tìm hiểu thêm. Vui lòng liên hệ vớiShareMyData@pge.comkhi có thêm bất kỳ câu hỏi nào.

Để biết thêm thông tin, hãy truy cập giao diện lập trình ứng dụng (API)