제3자를 위해 내 데이터 공유

현재 북미 에너지 표준 위원회(NAESB) 에너지 서비스 제공업체 인터페이스(ESPI) 승인 표준을 준수하기 위해 PG&E는 데이터 액세스를 승인하기 위한 OAuth 2.0 승인 프레임워크를 구현했습니다. 아래 다이어그램은 고객이 승인을 시작하고 범위 매개변수를 선택한 다음 승인을 제출하는 방법을 보여줍니다.

아래 정보 이외의 추가 참고 자료:

ESPI OAuth 2.0 시퀀스 다이어그램 다운로드(PDF, 193KB)
Github에서 Green Button 데이터 SDK 보기

참고: Community Choice Aggregator의 경우 (2-Legged OAuth를 통해) 데이터를 요청하려면 client_access_token만 필요하며 다음 사항은 적용되지 않습니다.

제3자 사이트에서 시작된 승인

위의 첫 번째 다이어그램에 설명된 대로 제3자 사이트의 인증을 시작하려면 고객의 브라우저를 아래 예와 같이 적절한 요청 매개 변수가 있는 PG&E의 AuthorizationServer Authorization Endpoint URL로 리디렉션하여 인증 코드 요청을 합니다. 리디렉션 시, 고객에게 인증을 위한 PG&E 로그인 페이지가 제시되고, 제3자에 대한 데이터 액세스를 승인하기 위한 인증 페이지가 제시됩니다.

authorizationServerAuthorizationEndpoint URI(요청 매개 변수 포함)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• 필수 요청 매개변수:
  • client_id = 내 데이터 공유 등록 마일스톤의 클라이언트 ID(예: client_id/client_secret 쌍).
  • redirect_uri = 내 데이터 공유 등록에서 지정한 URL을 리디렉션합니다(URL이 일치해야 함).
    참고: 아래 예에 따라 URL 인코딩을 redirect_uri에 적용할 것을 권장합니다.
  • response_type = 코드(정적 값)
• 선택적 요청 매개변수(들):
  • state = 상태를 유지하기 위해 인증 코드와 함께 반환되는 OAuth 2.0 표준에서 허용하는 선택적 불투명 상태 매개변수입니다. 예를 들어, 상태 파라미터는 제3자에 의해 고객 기원을 고유하게 식별하고 교차 사이트 위조를 방지하기 위해 사용될 수 있다.
  • login={guest} 제3자가 온라인 승인 흐름의 일환으로 고객을 PG&E의 My Energy 로그인 또는 게스트 액세스 탭으로 리디렉션할 수 있는 옵션을 제공합니다.

예: 인증 코드 요청

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

참고: 위의 redirect_uri 매개변수 예에는 URL 인코딩이 적용되었습니다(예: https://thirdparty.com/redirectUrl URL 인코딩).

위와 같이 유효한 요청을 하고 고객이 성공적으로 인증하고 승인하는 경우, 고객은 이후에 승인 코드, (승인된) 범위 매개 변수 및 옵션 상태 매개 변수(승인 요청의 일부로 제공되는 경우)와 함께 귀하의 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=pge12광고

참고: 인증 코드는 수명이 짧으며(600초 후에 만료됨), 인증을 완료하고 지속적인 데이터 액세스를 허용하려면 이후에 액세스 토큰/새로 고침 토큰 쌍으로 교환해야 합니다. 액세스 토큰/토큰 새로 고침 요청에 대한 자세한 내용은 다음 섹션(섹션 2)을 참조하십시오.

위에 예시된 (승인된) 범위 매개변수는 인증 코드 요청, 액세스 토큰 요청 및 인증 API에 대한 응답의 일부로 반환됩니다. 이 범위 매개변수는 고객 승인의 최종 범위를 전달할 수 있게 합니다. 특히, 범위 파라미터는 PG&E가 지원하는 고객 인증 데이터 그룹 선택(예: '사용', '청구', '기본', '계정', '프로그램 등록')에 매핑되는 '추가 범위' 값을 포함합니다. 범위 파라미터 값은 다음 참조 문서에 따라 추가로 캡처됩니다.지원되는 기능 블록 범위 문자열 매핑 다운로드 2.0(PDF, 222KB)까지 클릭.

오류 시나리오

제3자 구현 오류: 인증 코드 요청 시 client_id 또는 redirect_uri의 필수 요청 매개 변수가 유효하지 않거나 누락된 경우 표준 HTTP 400 시리즈 오류와 함께 설명 메시지가 고객에게 표시됩니다. 이와 유사하게 response_type의 필수 요청 매개 변수가 누락되었거나 유효하지 않은 경우, 원래 인증 코드 요청의 일부로 처음 제공된 경우 OAuth 2.0 정의 'invalid_request' 오류 매개 변수와 선택적 상태 매개 변수가 포함된 redirect_uri로 다시 리디렉션됩니다.

승인 거부 고객: 제3자가 고객에게 PG&E로 승인하도록 리디렉션하면 고객은 로그인 페이지와 승인 페이지 모두에서 '취소' 버튼을 통해 거절할 수 있습니다. 이러한 경우, 고객이 승인을 거부했음을 나타내기 위해 OAuth 2.0에 정의된 'access_denied' 오류 매개 변수가 추가된 상태로 고객이 다시 redirect_uri로 리디렉션됩니다. 또한 원래 승인 코드 요청의 일부로 처음 제공된 경우 선택적 상태 매개변수가 반환됩니다.

PG&E에서 시작된 승인

고객이 PG&E의 고객 웹 포털인 ‘귀하의 계정’에서 시작한 다음 내 데이터 공유 랜딩 페이지로 이동하면 등록되고 눈에 보이는 제3자의 드롭다운이 표시됩니다. 위의 두 번째 다이어그램에 설명된 바와 같이 고객이 등록된 제3자 목록에서 제3자를 선택하고 '다음'을 선택하면 해당 고객은 제3자의 등록된 제3자 포털 URI로 리디렉션되며, 이 때 고객은 이전 섹션에서 설명한 제3자 개시 OAuth 프로세스를 진행할 수 있습니다.

참고: 일부 제3자는 이 사용 사례에 대한 고객 경험을 간소화하는 방법(예: PG&E 사이트에서 시작된 승인)에 대해 질문하여 고객에게 드롭다운에서 제3자를 선택할 때 직접 승인 페이지로 이동하게 했습니다. 이러한 고객 경험을 용이하게 하기 위해, 제3자는 승인 코드 요청의 일부로 고객을 PG&E로 자동 리디렉션하는 엔드포인트로 자신의 \"제3자 포털 URI\"(내 데이터 공유 관리 등록 페이지를 통해)를 설정하도록 선택할 수 있습니다. PG&E의 인증 서버 인증 엔드포인트로 자동 리디렉션되면 고객은 고객 로그인 페이지(이미 로그인되어 있으므로)를 건너뛰고 인증 페이지로 바로 이동합니다. 2018년 6월 말에 Share My Data Click Thru 2.0 릴리스 이전에 등록한 일부 제3자의 경우, 더 이상 사용되지 않는 '제3자 범위 선택 화면' URI(필드는 향후 릴리스에서 폐기됨)와 동일하게 제3자 포털 URI를 정의하기만 하면 됩니다.

이와는 대조적으로, 일부 제3자는 고객이 승인 코드를 요청하기 전에 자신의 \"제3자 포털\" URI로 리디렉션될 때 먼저 고객을 참여시키고 선별하기를 원할 수 있으므로, 상기 접근법은 단지 제안일 뿐입니다.

액세스 토큰을 얻으려면 수신된 인증 코드를 사용하고 아래 설명된 요청 매개 변수를 사용하여 아래 엔드포인트에 전화하십시오. 위에서 설명한 바와 같이, 인증 코드는 10분(600초) 후에 만료되는 짧으므로, 인증 코드를 받으면 액세스 토큰을 즉시 요청해야 합니다.

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

• 필수 요청 매개변수:
  • 승인_유형 = 인증_코드(정적 값)
  • 코드 = 인증 코드 요청에 대한 응답으로 수신된 인증 코드
  • redirect_uri = 내 데이터 공유 등록에서 지정한 URL을 리디렉션합니다(URL이 일치해야 함).
    참고: 인증 코드 요청과 마찬가지로 URL 인코딩을 redirect_uri에 적용할 것을 권장합니다.

예: 액세스 토큰 요청
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Base64 인코딩이 적용된 기본 인증 헤더 매개 변수 추가 'clientID:clientSecret'

참고: clientId:clientSecret 값은 내 데이터 공유 등록 개략 일정에서 제공된 클라이언트 ID 값에 해당합니다.
헤더 매개변수는 다음 형식입니다.
매개변수 이름: 인증
매개 변수 값: 기본 -base64암호화 문자열

성공적인 응답은 다음과 같습니다.

<응답 xmlns= - https://api.페이지.com/datacustodian/oauth/v2/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_47_AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment간격지속 시간=900_3600;BlockDuration=일일;이력 길이={3P 등록 이력 길이};AccountCollection={승인된 SA 수};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} 예: https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} 예: https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
customerResourceURI:{customerResourceURI} 예:https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
베어러

참고: 액세스 토큰은 3600초(1시간) 후에 만료되고 해당 새로 고침 토큰은 1년 후에 만료됩니다. 새 액세스 토큰/새로 고침 토큰 쌍을 획득하는 방법에 대한 자세한 내용은 다음 섹션 3을 참조하십시오.

액세스 및 새로 고침 토큰 쌍을 저장합니다.
초기 이력 데이터 및 진행 중인 일일 데이터를 요청하려면 데이터 액세스를 방문하십시오.

모범 사례에 따라 액세스 토큰은 수명이 짧은 토큰(1시간)이고 해당 새로 고침 토큰은 수명이 긴 토큰(1년)이며, 액세스 토큰이 만료될 때 새 액세스 토큰/새로 고침 토큰 쌍을 획득하는 데 사용할 수 있습니다. 기존 만료되지 않은 권한에 대해 새 액세스 토큰 및 새로 고침 토큰 쌍을 얻으려면 '현재 새로 고침 토큰'을 사용하고 아래 설명된 매개 변수로 아래 엔드포인트에 전화를 겁니다.

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

예: 토큰 새로 고침 요청
게시: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Base64 인코딩이 적용된 기본 인증 헤더 매개 변수 추가 'clientID:clientSecret'

참고: clientId:clientSecret 값은 내 데이터 공유 등록 개략 일정에서 제공된 클라이언트 ID 값에 해당합니다.
헤더 매개변수는 다음 형식입니다.
매개변수 이름: 인증
매개 변수 값: 기본 -base64암호화 문자열

성공적인 응답은 다음과 같습니다.
{
'access_token': '677e6ef8-1e1a-43f0-85b8-5692fcbc72b2',
'token_type': 베어러,
만료: 3600,
새로 고침_토큰: -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=일일;이력 길이={3P 등록 이력 길이};AccountCollection={승인된 SA 수};BR={ThirdPartyID};dataCustodianId=PGE -,
리소스URI: ?https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ,
승인URI: ?https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Authorization/test-
}

참고: 마찬가지로, 클라이언트 액세스 토큰은 짧은 수명의 토큰(1시간)이고, 해당 새로 고침 토큰은 클라이언트 액세스 토큰이 만료될 때 새 클라이언트 액세스 토큰/새로 고침 토큰 쌍을 획득하는 데 사용할 수 있는 긴 수명의 토큰(1년)입니다. 새 클라이언트 액세스 토큰/새로 고침 토큰 쌍을 얻으려면 위에 설명된 것과 동일한 단계를 참조하십시오.

고객은 다음을 수행하여 승인을 업데이트할 수 있습니다.

• 승인에서 서비스 ID 제거
• 허가기간 종료일 연장
• 승인 취소

참고: 고객은 온라인 PG&E 계정에 로그인하고 필요한 단계를 따라야만 권한을 변경할 수 있습니다. 이러한 조치를 취하는 경우, 당사는 귀하가 등록 중에 제공한 알림 URI를 통해 귀하에게 통지할 것입니다.

고객 승인의 세부 정보를 관리하고 볼 수 있는 옵션이 있습니다.

• /espi/1_1/resource/Authorization의 제3자 수준(모든 권한 부여에 대한 자세한 내용) 또는 https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization https://api.pge.com/GreenButtonConnect/{AuthorizationID}의 개별 고객 권한 부여 수준에서 client_access_token을 사용하여 권한 부여 API(http GET 작업)를 호출할 수 있습니다.
• 별도로, 제3자 포털을 통해 내 데이터 공유 계정에 로그인하고 검색 중인 인증에 대한 구독 ID를 입력하여 개별 인증 세부 정보를 수동으로 볼 수도 있습니다.

승인과 관련된 데이터에 더 이상 액세스하지 않으려면 승인을 취소하는 선택적 방법이 있습니다.

• https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}에서 client_access_token을 사용하여 인증 취소 API(http DELETE 작업)를 호출할 수 있습니다.
• 또는 제3자 포털을 통해 Share My Data 계정에 로그인하고 취소하고자 하는 권한에 대한 구독 ID를 입력하여 수동으로 권한을 취소할 수 있습니다.

참고: 귀하가 고객의 승인을 취소하기로 선택했음을 고객에게 통지할 것입니다. 또한 승인이 취소되면 작업을 되돌릴 수 없습니다.

• PG&E는 등록 중에 제공된 알림 URI로 알림을 전송합니다. 알림은 제공된 URL로 다시 돌아와 요청할 수 있도록 미리 패키지된 데이터에 해당하는 URI로 구성됩니다. 데이터는 사전 포장되어 다음 두 가지 시나리오에서 알림이 발송됩니다. (1) 데이터가 준비되면 등록 프로필에서 알림 받기를 선택했습니다. 이 경우 당사는 과거 날짜에 대한 수정 사항을 포함하여 최신 일일 데이터를 포장합니다. 또는 (2) 요청된 데이터가 준비된 이전의 임시 비동기 요청을 했습니다.
• 시나리오 1은 'DATA ACCESS: 아래 데이터 액세스 방법 다이어그램 및 시나리오 2의 일일 구독 섹션은 '데이터 액세스: 아래 동일한 다이어그램의 AD HOC 요청(ASYNCHRONOUS) 섹션을 참조하십시오.

액세스 토큰, 클라이언트 액세스 토큰 및 데이터 요청에 사용되는 해당 새로 고침 토큰의 토큰 수명에 유의하십시오. 모범 사례에 따라 액세스 토큰은 수명이 짧은 토큰(1시간)이고 새로 고침 토큰은 수명이 긴 토큰(1년)이며, 액세스 토큰이 만료될 때 새 액세스 토큰/새로 고침 토큰 쌍을 획득하는 데 사용할 수 있습니다. 마찬가지로, 클라이언트 액세스 토큰은 짧은 수명의 토큰(1시간)이고, 해당 새로 고침 토큰은 클라이언트 액세스 토큰이 만료될 때 새 클라이언트 액세스 토큰/새로 고침 토큰 쌍을 획득하는 데 사용할 수 있는 긴 수명의 토큰(1년)입니다. 새 토큰 쌍을 얻는 방법에 대한 자세한 내용은 승인 세부 정보 탭의 3단계, 새 액세스 토큰 요청을 참조하십시오. 승인 세부 정보로 이동

고객으로부터 \"계정 정보\"(계정 ID, 서비스 계약 ID 및 서비스 시작 날짜) 및/또는 \"기본 정보\"(예: 고객 이름 및 서비스 주소)를 받을 수 있는 권한이 있는 경우, 위에 제공된 schema, retailCustomer.xsd에 부합하는 ESPI 지정 RetailCustomer API를 통해 해당 고객 정보를 요청할 수 있습니다.

동기식(표준 및 EEF 제3자)

고객 데이터를 요청하기 위한 한 가지 접근법은 고객 데이터에 대한 단일 고객 승인(즉, 소매 고객)을 위해 고객 정보를 요청하기 위해 동기식 API를 사용하는 것이다.

동기 요청 URL의 예:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = 액세스 토큰을 얻기 위해 OAuth 인증 시퀀스가 끝날 때 받은 RetailCustomerID입니다. RetailCustomerID는 토큰 응답에서 customerResourceUri 경로 매개 변수의 일부입니다. (소매고객ID=구독ID)

HTTP 헤더 = 인증: 베어러 {이 인증을 위한 액세스 토큰}

응답 = 해당 RetailCustomerID에 대해 동기식으로 데이터를 다시 받게 됩니다. 데이터가 retailCustomer.xsd에 부합합니다.

참고: 동기식 소매 고객 API는 단일 고객 승인에 해당하는 개별 소매 고객 수준에 있습니다.

참고: 아래 계층 다이어그램은 PG&E 고객 데이터 모델링 시 ESPI 데이터 요소에 대한 관계 계층 구조를 보여줍니다.

또한 고객 데이터에 대한 모든 고객 권한(예: 소매 고객)에 대한 고객 정보를 요청하기 위해 비동기 API를 통해 고객 데이터를 요청할 수 있습니다.

비동기 요청을 지원하기 위해, 귀하의 신청서는 당사가 귀하에게 발송할 사후 통지를 지원해야 합니다(등록 시 귀하가 제공한 통지 URL에 따름).

비동기 요청 URL의 예:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = 등록 테스트 중에 검색된 애플리케이션 정보 리소스에 제공된 BulkID입니다. (BulkID=클라이언트 ID)

HTTP 헤더 = 인증:베어러 {등록 테스트 중 클라이언트 액세스 토큰 검색}

응답 = HTTP 상태 코드 202(데이터가 준비되면 응답이 알림 URL에 게시되는 비동기 요청). 데이터가 준비되면, 애플리케이션이 미리 패키지된 URL을 받기 위해 돌아올 수 있는 URL의 페이로드와 함께 제공된 알림 URI에 알림을 게시합니다. 샘플 사후 알림은 아래와 같습니다.

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

클라이언트 액세스 토큰으로 위의 URL에서 GET를 수행하여 데이터를 가져옵니다.

참고: 아래 계층 다이어그램은 PG&E 고객 데이터 모델링 시 ESPI 데이터 요소에 대한 관계 계층 구조를 보여줍니다.

마지막으로, 일일 구독 모델을 사용하여 매일 최신 고객 정보를 얻을 수 있습니다(즉, 등록 시 데이터가 준비되면 알림(일일) 확인란을 선택하여).

일일 구독 모델을 지원하기 위해 귀하의 애플리케이션은 (등록 시 귀하가 제공한 통지 URL에 따라) 당사가 귀하에게 발송할 사후 통지를 지원해야 합니다.

데이터가 준비되면, 애플리케이션이 미리 패키지된 URL을 받기 위해 돌아올 수 있는 URL의 페이로드와 함께 제공된 알림 URI에 알림을 게시합니다. 샘플 게시 알림은 다음과 같습니다.

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

클라이언트 액세스 토큰으로 위의 URL에서 GET를 수행하여 데이터를 가져옵니다.

참고로 아래 계층 다이어그램은 PG&E 고객 데이터 모델링 시 ESPI 데이터 요소에 대한 관계 계층을 보여줍니다.

고객으로부터 '사용 정보' 및/또는 '청구 정보'를 수신할 권한이 있는 경우, 위에 제공된 스키마 espiDerived.xsd를 준수하는 구독 API를 통해 이 데이터를 요청할 수 있습니다.

동기식 특별 요청(표준 및 EEF 제3자)

기록 데이터(간격 사용 데이터 및 청구 데이터 모두)를 요청하려면 Zulu 시간에 적절한 시작 및 종료 날짜 요청 매개변수를 포함하는 동기 API를 사용하는 것이 한 가지 방법입니다.

동기 요청 URL의 예:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max={endDate}

published-min = 데이터 가져오기 요청에 적용될 시작 날짜입니다. 날짜는 yyyy-MM-ddTHH:mm:ssZ(IETC RFC 3339 형식)의 Zulu 시간입니다.

published-max = 데이터 가져오기 요청에 적용될 종료 날짜입니다. 날짜는 yyyy-MM-ddTHH:mm:ssZ(IETC RFC 3339 형식)의 Zulu 시간입니다.

참고: 게시된 최대 및 게시된 최소 날짜 매개 변수를 허용하는 API 요청의 경우 기본값은 T-1(요청 날짜에서 1일을 뺀 값)입니다. 사용 요약 요청(예: .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary)의 경우, 해당 기간과 중복되는 청구서가 있는지 확인하기 위해 30일 이상의 범위를 제공하는 것이 좋습니다. 그렇지 않으면 데이터가 반환되지 않습니다.

구독 ID = 액세스 토큰을 받기 위해 OAuth 인증 시퀀스가 끝날 때 받은 구독 ID입니다. 구독 ID는 토큰 응답에서 resourceURI 파라미터의 일부입니다. (SubscriptionID=소매 고객 ID)

UsagePointID = 위의 구독 ID에 따른 UsagePoint. 아래의 API URL로 전화하여 승인 헤더에서 해당 구독에 대한 액세스 토큰을 제공하여 해당 구독에 대한 모든 사용 포인트를 얻을 수 있습니다. https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

HTTP 헤더 = 인증:베어러 {이 구독에 대한 액세스 토큰}

응답 = 요청된 기간 동안 해당 사용 지점에 대한 데이터를 동기식으로 다시 받게 됩니다. 간격 사용 데이터()와 청구 데이터()가 모두 있습니다.

동기식 사용 API(사용 지점 ID로 끝나는 URL 구성으로 표시)는 개별 사용 지점 수준(예: 서비스 계약 수준)에 있으므로 애플리케이션은 지정된 고객 인증(예: 구독)에 속하는 각 사용 지점 ID를 통해 요청을 순환합니다.

동기 요청에 대한 응답은 요청된 날짜 범위와 관련된 간격 데이터(아래)뿐만 아니라 요청된 날짜 범위(아래)와 중복된 월별 사용 총액 및 청구서를 모두 반환합니다.

• 간격판독에는 간격(15분/시간) 전기 사용량 및 간격(일일) 가스 사용량 데이터가 포함됩니다.
• 사용 요약에는 월별 사용 총액 및 청구서 세부 정보가 포함됩니다(승인된 경우).

응답 내에서 ESPI 데이터 요소 매핑 테이블에 해당하는 데이터 요소를 찾을 수 있습니다.

참고로 아래 계층 다이어그램은 PG&E 고객 데이터 모델링 시 ESPI 데이터 요소에 대한 관계 계층을 보여줍니다.

다음은 이러한 데이터 요소에 대한 몇 가지 주요 설명입니다.

• 간격 블록은 1일입니다.
• IntervalReading(간격 블록 아래)에는 실제 15분/시간당 전기 사용량과 일일 가스 사용량이 포함됩니다.
• 현장 발전(예: 태양열)이 있는 전기 고객의 경우 flowDirection 요소는 전달된(공급) 및 수신된(세대) 사용 데이터를 나타냅니다. 순 사용량만 읽도록 구성된(즉, 현장에서 생성되지 않음) 계량기를 가진 고객의 경우, flowDirection 요소는 사용량이 순량(배송된 - 수신된 차이)임을 나타냅니다.
  • 흐름 방향 1 = 전달됨(고객에게 에너지 공급)
  • 흐름 방향 19 = 수신됨(PG&E 그리드로 순 발전 흐름). (참고: 값은 절대값임)
  • 흐름 방향 4 = 순(전달 빼기 – 수신)
• 올바른 사용 판독값을 보장하기 위해 10배의 파워 및 측정 단위(uom)에 특히 주의를 기울입니다.

일괄 구독(표준 및 EEF 제3자)

또한 비동기 API를 통해 사용/청구 데이터(예: 구독)에 대한 단일 고객 인증에 속하는 모든 사용 포인트에 대한 사용 데이터를 요청할 수 있습니다.

애드혹 비동기 요청을 지원하기 위해(즉, 한 번에 1개 이상의 사용 지점에 대해), 귀하의 애플리케이션은 당사가 귀하에게 보낼 사후 통지를 지원해야 합니다(등록 중에 귀하가 제공한 통지 URL에 따라).

비동기 요청 URL
의 예 https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

구독 ID = 액세스 토큰을 받기 위해 OAuth 시퀀스가 끝날 때 받은 구독 ID입니다. 구독 ID는 토큰 응답에서 resourceURI 매개 변수의 일부입니다.

published-min = 데이터 가져오기 요청에 적용될 시작 날짜입니다. (RFC 3339 형식 zulu 시간. yyyy-MM-ddTHH:mm:ssZ)

published-max = 데이터 가져오기 요청에 적용될 종료 날짜입니다. (RFC 3339 형식 zulu 시간. yyyy-MM-ddTHH:mm:ssZ)

HTTP 헤더 = 인증:베어러 {이 구독에 대한 액세스 토큰}

응답 = HTTP 상태 코드 202(데이터가 준비되면 응답이 알림 URL에 게시되는 비동기 요청)

데이터가 준비되면, 애플리케이션이 미리 패키지된 URL의 페이로드와 함께 제공된 알림 URI에 알림을 게시합니다. 샘플 사후 알림은 다음과 같습니다.

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

액세스 토큰을 사용하여 위의 URL에서 GET를 수행하여 데이터를 가져옵니다. 여기에는 요청된 기간 동안의 청구 정보()뿐만 아니라 간격 사용 데이터()가 모두 포함됩니다.

일괄 구독(표준 및 EEF 제3자)
귀하는 또한 사용/청구 데이터에 대한 모든 고객 승인(예: 구독)에 대해 일괄 일괄 일괄 일괄 비동기 API를 통해 사용 및 청구 정보를 요청할 수 있습니다.

일괄 일괄 요청 URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate} 예시

BulkID = 등록 테스트 중에 검색된 애플리케이션 정보 리소스에 제공된 BulkID입니다. (BulkID=클라이언트 ID)

published-min = 데이터 가져오기 요청에 적용될 시작 날짜입니다. (RFC 3339 형식 zulu 시간. yyyy-MM-ddTHH:mm:ssZ)

published-max = 데이터 가져오기 요청에 적용될 종료 날짜입니다. (RFC 3339 형식 zulu 시간. yyyy-MM-ddTHH:mm:ssZ)

HTTP 헤더 = 인증:베어러 {클라이언트 액세스 토큰}

응답 = HTTP 상태 코드 202(데이터가 준비되면 응답이 알림 URL에 게시되는 비동기 요청)

데이터가 준비되면, 애플리케이션이 미리 패키지된 URL의 페이로드와 함께 제공된 알림 URI에 알림을 게시합니다. 샘플 사후 알림은 다음과 같습니다.

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

액세스 토큰을 사용하여 위의 URL에서 GET를 수행하여 데이터를 가져옵니다. 여기에는 요청된 기간 동안의 청구 정보()뿐만 아니라 간격 사용 데이터()가 모두 포함됩니다.

마지막으로, 일일 구독 모델을 사용하여 고객 승인 기간 내의 과거 날짜 수정을 포함한 최신 사용 및 청구 정보를 매일 얻을 수 있습니다(즉, 등록 중에 데이터 준비(일일)로 알림 확인란을 선택하여).

일일 구독 모델을 지원하기 위해, 귀하의 애플리케이션은 당사가 귀하에게 발송할 사후 통지를 지원해야 합니다(등록 시 귀하가 제공한 통지 URL에 따름).

데이터가 준비되면, 애플리케이션이 미리 패키지된 URL의 페이로드와 함께 제공된 알림 URI에 알림을 게시합니다. 샘플 사후 알림은 다음과 같습니다.

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

액세스 토큰을 사용하여 위의 URL에서 GET를 수행하여 데이터를 가져옵니다. 여기에는 요청된 기간 동안의 청구 정보()뿐만 아니라 간격 사용 데이터()가 모두 포함됩니다.

2023년 3월 20일

새로운 기능:

1. 동기 및 비동기 API 호출에 대한 새 API HTTP 응답 코드(204)를 릴리스하여 요청된 범위에 사용할 수 있는 데이터가 없음을 나타냅니다.
2. 요청된 파일이 준비되면 상관 관계 ID와 함께 이 값을 반환하여 PG&E의 응답을 특정 비동기 API 호출에 연결하는 기능을 지원하는 x-트랜잭션 헤더 레이블을 지원합니다.
3. 여러 미터에서 단일 서비스 계약 시나리오에 대한 전기 간격 데이터를 제공하여 UsagePoint/MeterReadingID API에 대한 추가 데이터 세분화를 개선했습니다.
4. 해당 간격에 사용된 추정 유형을 설명하기 위해 추정 간격 데이터에 대한 판독 품질 지표 값에 대한 추가 명확성을 제공했다. 추정 논리가 적용되었음을 나타내는 새로운 값은 다음과 같습니다.
   
   

5. RQI 값 및 설명

   0 - 유효: 필요한 모든 검증 검사를 거쳤고 모두 통과했거나 검증한 데이터

   7 - 수동으로 편집: 사람이 교체 또는 승인

   8 - 기준일을 사용하여 추정: 데이터 값은 동일한 측정 유형을 사용한 이력 데이터 분석을 기반으로 기계 계산 값으로 대체되었습니다.

   9 - 선형 보간을 사용하여 추정: 데이터 값은 전과 후의 판독값에 기반하여 선형 보간을 사용하여 계산했다.

   10 - 의심됨: 하나 이상의 검사에 실패한 데이터

   11 - 도출: 산출된 데이터(논리 또는 수학적 연산 사용), 직접 측정할 필요는 없음

   12 - 예상(예측): 향후 판독값의 예상 또는 예측으로 계산된 데이터

   13 - 혼합: 이 판독값의 품질이 혼합 특성을 가지고 있음을 나타냅니다.

   14 - 원시: 검증, 편집 및 추정 프로세스를 거치지 않은 데이터. 참고 MV90 미터 RQI 표시기는 최종 RQ 상태로 14로 유지됩니다.

   15 - 날씨에 맞게 정규화: 날씨를 고려하여 값을 조정하여 다양한 기후에서의 사용량을 비교합니다.

   16 - 기타: 정의된 것 이외의 특성을 적용하도록 지정합니다.

   17 - 검증됨: 승인된 절차에 따라 검증되고 편집 및/또는 추정될 가능성이 있는 데이터

   18 - 검증됨: 필요한 검증 점검 중 하나 이상에 실패했지만 실제 사용을 나타내는 것으로 결정된 데이터

   19 - 수익 품질: 청구 목적에 유효하고 허용 가능[ESPI 표준의 연장 가능, 원래 ESPI의 일부가 아님]

    

6. Share My Data Third Party 공급업체 포털에서 공급업체 API 사용 지표 릴리스.

2018년 11월 15일

새로운 기능:

1. 고객 등급 표시기가 추가되었습니다. 승인된 각 SAID는 RES, AGR, COM/IND 또는 기타로 식별됩니다.
2. 청구 및 사용 API는 업데이트된 최대 및 최소 쿼리 매개 변수를 수락하도록 업데이트됩니다(게시된 최소 및 공개된 최대의 대안으로). 반환된 데이터는 업데이트된 최대 및 업데이트된 최소 매개변수 내에서 발생한 모든 변경 사항입니다.
3. 온라인 승인 흐름을 위해 제3자의 5자리 벌크 ID를 제3자의 고객 ID로 대체하는 행위.
4. 제3자가 온라인 승인 흐름의 일환으로 고객을 PG&E의 계정 로그인 또는 게스트 액세스 탭으로 리디렉션할 수 있는 옵션을 제공합니다.
5. PG&E의 내 데이터 공유 고객 대시보드를 개선하여 고객이 제3자와 기존 데이터 공유 권한을 모두 더 쉽게 볼 수 있도록 합니다.

2018년 09월 27일

새로운 기능:

PG&E는 PG&E의 확장 데이터 세트(EDS) 프로젝트의 일환으로 규칙 24 데이터 세트에 새로운 데이터 요소를 추가했으며, 해당 새로운 데이터 요소는 규칙 25 데이터 세트에 도입되었습니다. PG&E의 확장된 규칙 25 데이터 세트를 구성하는 특정 데이터 요소는 EDS로 지정하여 아래에 명시되어 있습니다.

규칙 25 데이터 요소

메모
계정 요소
계정 이름
계정 주소
계정 ID
EDS: 운전 정지 블록
서비스 요소
PG&E UUID
서비스 ID
서비스

SA 상태 서비스 시작일
서비스 주소
현재 서비스 관세
내역 청구 서비스 관세
옵션에 대한 향후 변경 사항(의료 기준, 관심, 페라, TBS, CCA_TBS, Solar Choice
전류 서비스 전압 및 상품 이력 청구 서비스 전압
미터 수
서비스 미터
수 유형
전류 미터 판독 주기
이력 청구 미터 판독 주기
이력 대기율 옵션 현장 생성 표시기
이력 청구 대기율 옵션
EDS인 경우: 고객 등급 표시기
내역 청구 요소
청구 시작 날짜
청구 종료 날짜
청구 총 요금($)
청구 총 kWh
EDS: 서비스 제공자
의 이름 내역 청구서 계층 분류(있는 경우)
EDS: 개별 항목 청구 기간
EDS: 이름(베이스라인 1%-30%)
EDS: 볼륨(1234.2)
EDS: 요금 ($0.032/kWh)
EDS: 비용($100.23)
내역 청구 TOU kWh 내역(청구된 ABS-TX 제외)
EDS: 개별 항목 청구 기간(TOU 내역)
EDS: (TOU 요금의)
EDS: 볼륨(1234.2)
EDS: 요금 ($0.032/kWh)
EDS: 비용($100.23)
과거 청구 수요 분석
EDS: 개별 항목 청구 기간(수요 내역)
EDS: 이름
EDS: 볼륨(1234.2)
EDS: 요금 ($0.032/kWh)
EDS: 비용($100.23)
과거 청구 개별 항목
EDS: 라인 항목 청구 기간
EDS: 충전 이름(DWR Bond Charge)
EDS: 볼륨(1234.2)
EDS: 단위(kWh)
EDS: 요금 ($0.032/kWh)
EDS: 비용($100.23)
과거 사용 간격
사용 시작
기본 간격 지속 시간(초)
간격 사용 볼륨(1234.2)
단위(kWh/Therms)
유틸리티 수요 대응 프로그램
(DR) 프로그램 이름
금융 의무
DR 프로그램 상태
DR 프로그램 등록 날짜
DR 프로그램 등록 날짜
등록 취소 날짜
데이터 요소
상품
현지 시간 매개변수(DST 세부 정보)
기본 데이터 품질
에너지 방향
10배의 힘(간격 사용값) 10배의 힘(청구된 수요의
경우)
10배의 힘(청구된 총 사용의 경우)
간격 길이(사용 판독)
청구 총 비용
의 통화 전기 간격 TOU 표시기

2018년 06월 28일

클릭 스루 프로젝트와 내 데이터 공유 플랫폼에 대한 지속적인 개선의 일환으로, PG&E는 2018년 6월 28일에 클릭 스루 2단계를 시작했습니다.

새로운 기능:

제3자에게 영향을 미치는 가장 중요한 변경 사항은OAuth 2.0 프로토콜을 준수하기 위한 변경 사항입니다(PG&E는 일련의 초기 리디렉션을 제거함). 자세한 내용은 아래에서 확인하십시오.

중요: 제3자는 기존 OAuth 구현을 변경해야 합니다. PG&E의 클릭 스루 2단계 변경 사항은 역호환되지 않으므로 제3자가 PG&E의 구현과 동시에 변경 사항을 구현해야 합니다. 시행하지 않을 경우, 현행 고객 승인 프로세스는 마감일인 2018년 6월 29일에 작업을 중단할 것입니다. 그러나 기존 승인은 영향을 받지 않습니다.

1. OAuth 2.0 프로토콜을 준수하기 위해 PG&E는 승인을 위한 리디렉션 단계 수를 줄였습니다. 고객이 로그인하고 승인을 제출하기 위해 PG&E로 초기 리디렉션이 다음과 같이 승인 코드 요청과 결합되었습니다.
   • 아래 예시에서 볼 수 있듯이, 제3자 인증 코드 요청은 이제 적절한 요청 매개변수와 함께 고객의 브라우저를 PG&E의 새로운 authorizationServerAuthorizationEndpoint URI로 리디렉션합니다.
     GET 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 매개변수가 누락되었거나 유효하지 않은 경우, 고객은 제3자의 redirect_uri로 다시 리디렉션되며, 오류 매개변수가 \"invalid_request\"(리디렉션_uri에 추가됨)
     
3. 기존 온라인 인증이 있는 고객의 경우, 기존 온라인 인증을 대체하는 새로운 인증의 일환으로 제3자가 새로운 access_token/refresh_token 쌍을 요청할 수 있는 기능(즉, 동일한 제3자의 온라인 인증 및 고객 조합). 이 기능은 액세스_토큰/새로 고침_토큰 쌍을 잃거나 고객 승인에 따라 원래 승인의 범위를 변경해야 하는 제3자의 시나리오를 다룹니다.
   • 재인증 요청의 경우, 고객은 제3자가 승인을 위해 PG&E로 리디렉션할 때 '인증 관리' 페이지 대신 새로운 승인 페이지를 보게 됩니다.
   • 고객 승인 시, 제3자는 이전 구독 ID가 취소되었다는 알림을 등록된 알림 URL로 받습니다(알림은 이전 구독 ID에 대한 인증 API URL 끝점으로 구성됨).
     
4. 고객이 인증 페이지 또는 인증 페이지의 '취소' 버튼을 통해 종료하고 '액세스_거부됨' 오류 매개 변수를 사용하여 제3자의 redirect_uri로 다시 리디렉션하는 기능(리디렉션_uri에 추가됨)
5. 에서 '가시성' 설정에 등록하여 등록된 제3자 목록에 포함된 제3자의 경우, 고객은 PG&E 온라인 계정으로 이동하여 내 데이터 공유 랜딩 페이지로 이동할 때 다음 정보를 볼 수 있습니다.
   • PG&E 온라인 계정에 로그인하여 내 데이터 공유 랜딩 페이지로 이동한 후 등록된 제3자 목록에서 제3자를 선택하면 제3자의 등록된 제3자 포털 URI로 리디렉션됩니다. 이때 고객은 제3자가 시작한 OAuth 프로세스를 진행할 수 있습니다. 이 경로를 통해 고객은 제3자의 드롭다운 목록에서 제3자를 선택할 때 더 이상 인증 페이지가 표시되지 않지만, 대신 제3자가 시작한 OAuth 프로세스를 시작할 수 있는 제3자의 등록된 '제3자 포털 URI'로 리디렉션됩니다.
   • 참고: 일부 제3자는 이 사용 사례에 대한 고객 경험을 간소화하는 방법(즉, PG&E 사이트에서 시작된 승인)에 대해 질문하여 고객에게 드롭다운에서 제3자를 선택할 때 직접 승인 페이지로 이동하게 했습니다. 이러한 고객 경험을 용이하게 하기 위해, 제3자는 승인 코드 요청의 일부로 고객을 PG&E로 자동 리디렉션하는 엔드포인트로 자신의 \"제3자 포털 URI\"(내 데이터 공유 관리 등록 페이지를 통해)를 설정할 수 있습니다. PG&E의 authorizationServerAuthorizationEndpoint로 자동 리디렉션되면 고객은 고객 로그인 페이지(이미 로그인되어 있으므로)를 건너뛰고 인증 페이지로 바로 이동합니다. Share My Data Click Thru 2.0 릴리스 이전에 등록한 일부 제3자의 경우, 더 이상 사용되지 않는 '제3자 범위 선택 화면'과 동일하게 제3자 포털 URI를 정의하여 이를 수행할 수 있습니다(이전 SMD 등록 필드는 향후 릴리스에서 폐기됨).
     이와는 대조적으로, 일부 제3자는 고객이 승인 코드를 요청하기 전에 '제3자 포털' URI로 리디렉션될 때 먼저 고객을 참여시키고 선별하기를 원할 수 있습니다. 따라서 위의 접근 방식은 제안일 뿐입니다.
     
6. SMD는 이제 인증 코드 요청, 액세스 토큰 요청 및 인증 API에 대한 응답의 일부로 향상된 범위 매개변수 세부 정보를 제공합니다. 향상된 범위 파라미터는 고객 인가의 최종 범위를 전달할 수 있게 한다. 특히, 범위 파라미터에는 PG&E가 지원하는 고객 인증 데이터 그룹 선택에 매핑되는 'AdditionalScope' 값이 포함됩니다(예: '사용', '청구', '기본', '계정', '프로그램 등록'). 범위 파라미터 값은 다음 문서에 따라 추가로 캡처됩니다.지원되는 기능 블록 범위 문자열 매핑 다운로드 2.0(PDF)까지 클릭
   
   아래의 토큰 응답 예시는 일부 가능한 범위 파라미터 값을 보여줍니다.
   • 토큰 응답 예:
     <응답 xmlns= - https://api.페이지.com/datacustodian/oauth/v2/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_47_16_AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment간격지속 시간=900_3600;BlockDuration=매일;이력 길이={3P 등록 이력 길이};AccountCollection={승인된 SA 수};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} 예: https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} 예: https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
     customerResourceURI:{customerResourceURI} 예:https://api.페이지.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     베어러
     
     
     
7. 이제 제3자는 새로운 '프로그램 등록' 데이터 그룹을 통해 승인된 프로그램 등록 정보를 받기 위해 등록할 수 있습니다. 간격 측정 고객과 비 간격 측정 고객은 모두 SMD 클릭 스루 2단계에 대한 데이터 공유를 승인할 수 있습니다. 프로그램 등록계약 데이터 그룹이 제공하는 새로 사용 가능한 데이터 요소에 대한 상위 수준 요약은 다음과 같습니다.
   • 프로그램 등록(PG&E 수요 대응 프로그램 이름/상태 및 CAISO 정보):
   • (청구) 계좌 주소
   • 서비스 계약 상태
   • (현재) 서비스 요율
   • (전류) 서비스 전압(전기 전용)
   • 서비스 미터 번호(있는 경우)
   • 미터 유형
   • (전류) 미터 판독 주기
   • (현재) 현장 생성 표시기인 경우 대기율 옵션
   • (기본 간격 사용) 지속 시간(초 단위 길이)
   • (등록된 PG&E 수요 응답) 프로그램 이름(해당되는 경우)
   • 재정적 의무 없이 PG&E 등록 수요 대응(DR) 프로그램의 가장 빠른 종료일
   • 재정적 의무와 관계없이 PG&E 등록 수요 대응(DR) 프로그램의 가장 빠른 종료일
   • PG&E 수요 대응(DR) 프로그램(등록) 상태
   • PG&E 수요 대응(DR) 프로그램 등록일
   • PG&E 수요 대응(DR) 프로그램 등록 취소 날짜
   • 이러한 새 데이터 요소에 대한 Atom XML XSD(XML 스키마 정의) 매핑은 다음 문서에 따라 캡처됩니다.
     지원되는 데이터 요소 다운로드(PDF)
   • 관련 관계형 데이터 계층구조 모델은 다음에 따라 약술됩니다.
     PGE ESPI 데이터 모델 다운로드(PDF)
   • UsagePoint(SA UUID라고도 함)
     • ServiceDeliveryPoint\tariffProfile(해당되는 경우 대기 요금 옵션을 포함한 현재 서비스 요금표 AKA 요금 일정)
     • readCycle(현재 미터 판독 주기)UsageSummary
     • readCycle(청구 서비스 주기)
     • 상품(전기용 청구 전압 수준 포함)
     • tariffProfile(해당되는 경우 대기 요금 옵션을 포함한 청구된 서비스 요금
   • 판독 유형
     • 상품(전기용 전류 전압 레벨 및 해당하는 경우 대기율 옵션용 접두사 포함)
   • 고객 계정
     • (계좌 청구 주소):
     • 메인 주소/스트리트세부 정보...
     • 메인 주소/타운세부 정보...
     • 기본 주소/우편 코드...
   • 고객 계약
     • 상태\\값(SA 상태
   • 수요 대응 프로그램
     • 프로그램명
     • 등록상태
     • 프로그램날짜/프로그램날짜
     • 프로그램날짜/프로그램날짜설명
   • 측량기
     • 일련 번호(미터 ID)
     • 유형(미터 유형)
     • (현재) 간격길이
   • 이러한 새로운 데이터 요소에 사용되는 최신 ESPI xml 스키마 정의(XSD)는 다음에 따라 약술됩니다.
     XSD(ZIP, 49KB)ZIP를 다운로드합니다. 새 창에서 열립니다.
     참고: XSD는 이전 버전과 호환됩니다.
   • 제3자는 등록 관리 >편집 > 섹션: 필요한 고객 정보를 표시하고 프로그램 등록 확인란을 선택합니다.
   • 참고:이는 신규 고객 승인에만 적용됩니다.
     
   • DR 등록 정보를 검색하는 새로운 API는 다음에 따라 개별 고객 승인 수준(소매 고객 ID 수준)뿐만 아니라 대량 제3자 수준에서도 사용할 수 있습니다.
     새로운 PGE 지원 API 다운로드(PDF)
   • 제3자에 대한 모든 권한 부여를 위해 DR 등록 정보를 요청하는 비동기 API
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • 개별 고객 인증 수준에서 DR 등록 정보를 요청하기 위한 동기식 API
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{소매 고객 ID}

참고: 고객 승인 프로세스의 변경 외에도 다른 변경 사항도 역호환되며 제3자가 지원할 수 있는 자발적인 개선 사항입니다.

질문이 있거나 추가 지원이 필요한 경우, 언제든지 sharemydata@pge.com으로 이메일을 보내주십시오.

새로운 기능:

1. 이제 고객은 간소화된 클릭 스루 승인 프로세스의 혜택을 누릴 수 있습니다.
   • 이제 고객이 귀사와 데이터를 공유하는 방법에 대한 세부 정보를 업데이트했습니다.
     고객이 회사와 데이터를 공유하는 방법 알아보기
     
     참고: 이러한 변경 사항, 특히 승인 UI의 개선 사항은 모바일 기기(예: 전화 또는 태블릿)에 최적화되었습니다.
   • PG&E 온라인 계정을 통해 고객이 액세스할 수 있는 관리 승인 프로세스가 변경되었습니다.
     • 고객은 여전히 기존 승인에서 SAID를 제거하고, 승인 종료일을 연장하고/하거나 언제든지 승인을 취소할 수 있습니다. 그러나 SAID를 추가하거나 승인된 데이터 요소를 변경하려면 기존 승인을 취소하고 새 승인을 생성해야 합니다.
2. 원하는 경우, 제3자는 이제 DELETE 작업을 통해 제3자 클라이언트 액세스 토큰(최초 SMD 제3자 등록 프로세스 중에 제공됨)을 사용하여 개별 고객 인증을 취소하는 데 이 API를 사용할 수 있습니다. https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   참고 1:PG&E의 구현을 위해 AuthorizationID 매개변수는 SubscriptionID와 동일한 값입니다.
   
   참고 2:새로운 API는 제3자에게 승인을 취소(취소)할 수 있는 기능을 제공합니다. 그러나 SMD 관리 인증 페이지를 통해 SA ID를 제거하거나 인증 종료일을 업데이트할 수는 있습니다.
   
   알림:모든 API 데이터 요청과 마찬가지로 제3자는 먼저 최신 새로 고침 토큰을 사용하여 새 토큰 쌍(클라이언트 액세스 + 토큰 새로 고침)을 요청해야 합니다.
   
   토큰 만료 기간 알림:
   • 액세스 토큰:1시간
   • 클라이언트 액세스 토큰: 5분
   • 해당 새로 고침 토큰: 1Yr
3. 이제 제3자는 필요한 경우 동일한 회사 이름과 납세 ID를 사용하여 여러 SMD(나의 데이터 공유) 등록을 생성할 수 있습니다. 그러나 디스플레이 이름(권한 부여 시 고객이 볼 수 있는 이름)은 여전히 고유해야 합니다.
   
   참고:위의 모든 변경 사항은 이전 버전과 호환되며 제3자가 지원하도록 선택할 수 있는 자발적인 개선 사항입니다. 이 릴리스에 대한 지원 문서 다운로드:
   
   지원되는_APIS.SMD_클릭-스루_1.0(PDF)
   
   지원되는_데이터_요소_소매고객.SMD_클릭_스루_1.0(PDF)
   
   PGE_ESPI_데이터_모델.SMD_클릭-스루_1.0(PDF)
   
   지원되는_데이터_요소_ESPIDERIVED.SMD_클릭_스루_1.0(PDF)
   
   ESPI_XSDS(ZIP)

2015년 12월 20일

필수 변경 사항:다음 SMD 2.0 업데이트는 제3자 측에서 변경해야 합니다.

1. PG&E 외에 여러 유틸리티에서 GBCMD(녹색 버튼 연결 내 데이터)를 구현한 제3자를 고려하여 OAuth 인증 시퀀스 동안 데이터CustodianID(즉, dataCustodianID=PGE)를 thirdPartyScopeSelectionScreenURI로 리디렉션하여 반환합니다.
2. 날짜 매개 변수를 수락하는 API 요청(예: 배치 요청)은 Zulu 데이터 매개 변수(예: 게시된 최대/ 게시된 최소)를 사용해야 합니다. API 요청에서 날짜 매개변수의 다른 날짜 형식은 지원되지 않습니다.
   • 날짜 매개 변수를 허용하는 API는 첨부된 지원 API에 따라 문서화됩니다.xlsx
3. 간격 측정 전기 사용량 데이터에 포함된 간격 TOU 표시기(해당되는 경우 각 간격이 해당하는 TOU 기간의 표시기)
   • 각 간격 TOU 열거가 어떤 것에 해당하는지 자세히 설명하는 정적 프로그램 ID 매핑을 참조하십시오(예: 1 = 여름 피크 등). (첨부,지원되는 데이터 요소.xlsx 참조)
4. 데이터에서 찾을 수 있는 client_idCustodianScopeSelectionScreenURI(제3자가 시작한 OAuth에 사용됨) 및 등록 테스트 중 애플리케이션 정보 리소스 제3자 요청에 제공된 client_id가 아직 5자리로 업데이트되지 않은 경우(예: 앞자리 0 추가 등) 제3자 요청으로 업데이트됩니다. 또한 URL 끝에는 더 이상 '&verified=true'가 포함되지 않습니다. 제3자는 그에 따라 URL을 업데이트해야 합니다.
   • 자세히 설명하자면, dataCustodianScopeSelectionScreenURI는 다음과 같습니다. https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX는 clientID)
   • 따라서 현재 123의 클라이언트 ID는 00123과 같은 것으로 변경되며, 이는 새로운 데이터CustodianScopeSelectionScreenURI가 다음과 같음을 의미합니다.
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (이전 URL은 https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. 'ESP' 또는 '에너지 서비스 제공업체'로 등록된 제3자가 표준 사용자 유형으로 변경됩니다. 사용자 유형 제목에만 기능적으로 변경 사항이 없습니다. (표준 사용자 유형과) ESP 사용자 유형을 구분하는 것은 불필요한 구분으로, 차별화된 기능을 제공하지 않고 등록 프로세스 중에 혼란을 야기하므로 폐기됩니다.

선택적 개선 사항: 다음 변경 사항은 이전 버전과 호환되며 제3자가 지원하도록 선택할 수 있는 자발적인 개선 사항입니다.

1. 제3자는 등록 관리 >편집 > 새 섹션: SSL 인증서 정보(업데이트 옵션).
2. 제3자는 승인된 기본 청구 정보, 고객 정보 및 가스 데이터를 수신하기 위해 등록할 수 있습니다.  간격 측정 고객과 비 간격 측정 고객은 모두 SMD 2.0에 대한 데이터 공유를 승인할 수 있습니다. 새로 이용 가능한 자료 요소에 대한 상위 수준 요약은 다음과 같다.
   • 청구 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 요금 일정, 청구 총액 $, 등급별 사용(해당하는 경우), 수요(해당하는 경우), TOU 총액(해당하는 경우)
     • 참고: 승인된 비간격 측정 고객의 경우, 제3자는 청구 사용 총액(즉, 사용 요약)만 받고 간격 사용 판독(예: 시간당/일일 판독을 사용할 수 없는 경우)은 받지 않습니다.
   • 고객 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 고객 이름, 서비스 주소, 계정 ID, 서비스 계약 ID, 서비스 계약 서비스 시작일,
   • 간격 가스 사용 데이터: (간격 계량 가스 SA만 해당)
     • 간격(즉, 매일) 가스 판독
   • 새 데이터 요소는 첨부된 지원 데이터 요소에 따라 도표화됩니다.xlsx
   • 관련 관계형 데이터 계층구조는 첨부된,PGE ESPI Data Model.xlsx에 약술되어 있습니다.
   • 이러한 새로운 데이터 요소에 사용되는 최신 ESPI xml 스키마 정의(XSD)는 첨부된 XSD에 따릅니다. 참고:XSD는 이전 버전과 호환됩니다.
     • espiDerived.xsd(간격 사용 및 청구 정보)
     • retailcustomer.xsd(고객 정보)

질문이 있거나 추가 지원이 필요한 경우 언제든지 ShareMyData@pge.com으로 문의해 주십시오.

2015년 12월 18일

필수 변경 사항: 다음과 같은 SMD 2.0 업데이트에는 자신의 데이터에 액세스하는 사용자의 변경 사항이 필요합니다.

1. 날짜 매개 변수를 수락하는 API 요청(예: 배치 요청)은 Zulu 데이터 매개 변수(예: 게시된 최대/ 게시된 최소)를 사용해야 합니다. API 요청에서 날짜 매개변수의 다른 날짜 형식은 지원되지 않습니다.
   • 날짜 매개 변수를 허용하는 API는 첨부된 지원 API에 따라 문서화됩니다.xlsx
2. 간격 측정 전기 사용 데이터에 포함된 간격 사용 시간(TOU) 표시기(해당되는 경우 각 간격이 해당하는 TOU 기간의 표시기)
   • 각 간격 TOU 열거가 어떤 것에 해당하는지 자세히 설명하는 정적 프로그램 ID 매핑을 참조하십시오(예: 1 = 여름 피크 등). (첨부,지원되는 데이터 요소.xlsx 참조)

선택적 개선 사항: 다음 변경 사항은 이전 버전과 호환되며 제3자가 지원하도록 선택할 수 있는 자발적인 개선 사항입니다.

1. 셀프 액세스 사용자는 등록 관리 > 편집 > 새 섹션: SSL 인증서 정보(업데이트 옵션)
2. 셀프 액세스 사용자 등록은 승인된 기본 청구 정보, 고객 정보 및 가스 데이터를 포함하도록 업데이트됩니다. 비간격 계량 서비스 계약으로서의 두 간격 계량 서비스 계약 모두 SMD 2.0에 대한 (자체) 승인을 받을 자격이 있습니다. 새로 이용 가능한 데이터 요소에 대한 높은 수준의 요약은 다음과 같습니다.
   • 청구 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 요금 일정, 청구 총액 $, 등급별 사용(해당하는 경우), 수요(해당하는 경우), TOU 총액(해당하는 경우)
     • 참고: 승인된 비간격 측정 고객의 경우, 제3자는 청구 사용 총액(즉, 사용 요약)만 받고 간격 사용 판독(예: 시간당/일일 판독을 사용할 수 없는 경우)은 받지 않습니다.
   • 고객 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 고객 이름, 서비스 주소, 계정 ID, 서비스 계약 ID, 서비스 계약 서비스 시작일,
   • 간격 가스 사용 데이터: (간격 계량 가스 SA만 해당)
     • 간격(즉, 매일) 가스 판독
   • 새 데이터 요소는 첨부된 지원 데이터 요소에 따라 도표화됩니다.xlsx
   • 관련 관계형 데이터 계층구조는 첨부된,PGE ESPI Data Model.xlsx에 약술되어 있습니다.
   • 이러한 새로운 데이터 요소에 사용되는 최신 ESPI xml 스키마 정의(XSD)는 첨부된 XSD에 따릅니다. 참고:XSD는 이전 버전과 호환됩니다.
     • espiDerived.xsd(간격 사용 및 청구 정보)
     • retailcustomer.xsd(고객 정보)

질문이 있거나 추가 지원이 필요한 경우 언제든지 ShareMyData@pge.com으로 문의해 주십시오.

2015년 12월 18일

필수 변경 사항: 다음과 같은 SMD 2.0 업데이트는 CCA 구현 부분에서 변경해야 합니다.

1. 임시 요청(예: 내역 데이터)은 Zulu 시간 날짜 매개변수를 사용하여 이루어져야 합니다. API 요청에서 날짜 매개변수의 다른 날짜 형식은 지원되지 않습니다.
2. 일일 벌크 사용량 피드에는 기본 청구 정보가 포함되기 시작하는 반면 일일 벌크 고객 피드에는 추가 고객 정보가 포함됩니다. 이 새로운 데이터는 현재 데이터를 수신하는 간격 측정 고객과 현재 데이터를 수신하지 않는 해당 지역의 비 간격 측정 고객에게 모두 제공됩니다. 마지막으로, 일일 벌크 사용량 피드에 제공된 간격 사용량 값에는 해당하는 경우 간격 TOU 표시기가 포함됩니다. 새로운 데이터 요소에 대한 높은 수준의 요약은 다음과 같습니다.
   • 청구 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 요금 일정, 청구 총액 $, 등급별 사용(해당하는 경우), 수요(해당하는 경우), TOU 총액(해당하는 경우)
   • (추가) 고객 정보: (간격 측정 SA 및 비간격 측정 SA 모두 해당)
     • 고객 이름, 서비스 주소, 서비스 계약 서비스 시작일, 계정 ID
   • 간격 측정 전기 사용량 데이터에 포함된 간격 TOU 표시기(해당되는 경우 각 간격이 해당하는 TOU 기간의 표시기)
     • 각 간격 TOU 열거가 어떤 것에 해당하는지 자세히 설명하는 정적 프로그램 ID 매핑을 참조하십시오(예: 1 = 여름 피크 등). (첨부,지원되는 데이터 요소.xlsx 참조)
   • 이러한 새로운 데이터 요소에 사용되는 최신 ESPI xml 스키마 정의(XSD)는 첨부된 XSD에 따릅니다. 참고로 XSD는 이전 버전과 호환됩니다.
     • espiDerived.xsd(간격 사용 및 청구 정보)
     • retailcustomer.xsd(고객 정보)
   • 새 데이터 요소는 첨부된 지원 데이터 요소에 따라 도표화됩니다.xlsx
   • 관련 관계형 데이터 계층구조는 첨부된,PGE ESPI Data Model.xlsx에 약술되어 있습니다.

선택적 개선 사항: 다음 변경 사항은 이전 버전과 호환되며 제3자가 지원하도록 선택할 수 있는 자발적인 개선 사항입니다.

1. CCA는 수신된 일일 통지 외에 https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID}(요청 시 고객 정보의 최신 스냅샷을 반환)에서 고객 정보에 대한 특별 요청을 할 수 있습니다.
2. CCA는 등록 관리 > 편집 > 새 섹션: SSL 인증서 정보(업데이트 옵션)

질문이 있거나 추가 지원이 필요한 경우 언제든지 ShareMyData@pge.com으로 문의해 주십시오.

2015년 08월 21일

새로운 기능:

1. Oauth 응답의 상태 매개변수 및 리소스 URI 변경
   • OAuth 인증 코드 요청의 일환으로 제3자는 PG&E가 제3자에게 반송할 상태 매개 변수를 보낼 수 있는 옵션이 있습니다. PG&E는 또한 승인 완료 시 승인 코드를 전송할 것입니다. 이 선택적 상태 매개 변수는 제3자가 요청이 시작된 곳을 식별하고 요청을 시작한 권한과 다시 연결하는 데 사용할 수 있습니다.
   • 토큰 요청의 성공적인 완료의 일환으로, 당사는 토큰 정보와 별도로 resourceURI 및 authorizationURI를 공유합니다. 현재 이러한 URI는 뒤집혀 있으며 이번 릴리스의 일환으로 이를 수정할 예정입니다.

결함 수정:

1. 현재 PG&E는 제3자가 데이터를 요청하는 기간을 PG&E에 알리기 위해 각 데이터 요청에 대해 게시된 최소 및 게시된 최대 매개 변수를 에폭 초 단위로 전송하도록 규정
   하고 있습니다. 다음 시나리오에 대한 요청을 처리하기 위해 변경을 시행하고 있습니다.
   • 게시된 최소값 및 게시된 최대값이 누락되었습니다.
   • 게시된 최소값 및 게시된 최대값은 UTC 단위입니다.
   • 게시된 최소값 및 게시된 최대값은 에폭 초 단위입니다.
   매개변수가 누락된 경우, PG&E는 이 변경 전에 반환된 오류 메시지와는 대조적으로 기본 날짜를 반환합니다. 기본값은 날짜 T-2에 대한 1일 데이터입니다. 매개변수가 올바르게 존재하고 포맷된 경우, 매개변수를 계속하여 존중할 것입니다.
2. 승인 xml의 날짜에 대한 수정
   현재 승인 xml에 게시된 날짜와 승인 날짜를 공유했습니다. 이 날짜는 표준인 초가 아닌 밀리초 단위입니다. 밀리초가 아닌 에폭 초 안에 다시 보내도록 수정하고 있습니다.
3. /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock에 대해 잘못된
   XML이 반환되었습니다. 현재 XML의 구조가 잘못된 경우 위의 리소스 레벨 GET에 대해 잘못된 응답을 반환하고 있으며 24시간 동안 단일 간격 블록을 생성하는 대신 각 간격에 대해 항목을 반복하고 있습니다.
   
   이것은 고정되고 있으며 24 간격 블록에 대해 단일 간격 블록만 반환됩니다.

질문이나 우려 사항이 있습니까? ShareMyData@pge.com으로 문의하십시오.

• 고객은 PG&E 온라인 계정인 My Energy를 통해 데이터에 액세스할 수 있는 권한을 부여합니다. 고객이 제3자 또는 다른 법인에게 자신의 데이터에 대한 액세스를 허가하는 방법에 대한 자세한 개요는 내 데이터 공유 제3자 개요를 참조하십시오.

승인 세부 정보로 이동

• 현재 제한은 없습니다.

• 고객은 데이터에 액세스할 수 있는 지정된 시간을 선택하거나 승인 기간을 열어둘 수 있습니다.
• 귀하의 애플리케이션은 승인 리소스 API(예: .../espi/1_1/resource/Authorization 및/또는.../espi/1_1/resource/Authorization/{AuthorizationID})에 전화하여 다른 승인 세부 정보와 함께 고객 승인의 종료일을 확인할 수 있습니다.
• 또는 계정에 로그인하고 승인 관리를 선택하여 수동으로 승인 종료일을 확인할 수 있습니다.

• 고객이 정의된 승인 기간을 선택하는 경우, 해당 기간은 종료될 때 만료됩니다. 승인을 취소하는 경우, 승인은 승인을 취소한 다음 날 만료됩니다.
• 고객이 승인 기간으로 무기한을 선택한 경우 해당 승인은 만료되지 않습니다. 규칙 24 수요 대응 제공자 및 내 데이터 공유를 사용하는 기타 프로그램을 고려하여, 승인 만료 후 최대 3년 동안 이전에 승인된 날짜 범위에 대한 사후 수정을 제3자에게 제공할 수 있습니다.
• 데이터 수정은 어떻게 처리됩니까?를 참조하십시오. 수정사항 수령에 대한 추가 상세정보.

• 가스 또는 전기 서비스에 대해 현재 유효한 서비스 ID를 가진 PG&E 고객은 새로운 내 데이터 공유 도구를 사용하여 데이터에 액세스할 수 있는 권한을 부여할 수 있습니다.

• Share My Data 프로그램을 통한 데이터 공유에 관심이 있는 고객은 My Energy 계정에 등록하는 것이 좋습니다. 이렇게 하면 전체 프로세스가 더욱 효율적이 되고 온라인으로 승인을 관리할 수 있습니다.
• 고객은 승인 프로세스 중에 My Energy 계정에 등록할 수 있습니다.
• 고객이 온라인으로 내 데이터 공유 승인 양식을 받고 이메일을 통해 작성한 양식을 제출하는 수동 프로세스가 있습니다.
• 수동 프로세스에 대한 자세한 내용은 ShareMyData@pge.com으로 문의하십시오.

• 고객은 PG&E 온라인 계정을 통해 온라인으로 직접 승인을 받아야 합니다. 그러나 이들이 내 데이터 공유 승인 양식을 작성하고 서명하는 경우, 귀하는 이들을 대신하여 이를 PG&E에 제출할 수 있습니다.

내 데이터 공유 고객 승인 또는 승인 취소 양식 다운로드(PDF, 308KB)

• 계정에 로그인하여 등록 관리 > 편집 >으로 이동한 후 OAuth 2.0 정보 섹션 아래의 필드를 업데이트하여 OAuth URI를 업데이트할 수 있습니다.

• 계정에 로그인하여 등록 관리 > 편집 >으로 이동한 후 데이터 액세스 정보 섹션 아래의 필드를 업데이트하여 알림 URI를 업데이트할 수 있습니다.

• 계정에 로그인하고, 등록 관리 > 편집 >으로 이동한 후 SSL 인증서 정보 섹션에서 \"업데이트\"를 선택하여 SSL 인증서를 업데이트할 수 있습니다. 새 인증서 업로드의 경우 PG&E 시스템을 새 인증서로 업데이트하는 데 며칠이 걸릴 수 있습니다. 
• 새 인증서가 적용되면 내 데이터 공유 지원 팀의 확인 이메일이 전송됩니다.

• 등록이 수락되었다는 이메일을 받으면, Share My Data 계정에 로그인하여 PG&E SSL 인증서 다운로드 페이지를 통해 SSL 인증서를 다운로드할 수 있습니다.

내 데이터 공유에 로그인

• 내 데이터 공유는 녹색 버튼 내 데이터 연결 구현 계약을 따릅니다. Share My Data는 또한 승인, TLS(Transport Layer Security) 1.2 및 NIST(National Institute of Standards and Technology)가 승인한 최소 사이버 보안 프로토콜 제품군에 대해 OAuth 2.0을 사용하여 정보를 명확하게 교환하지 않습니다.

• 고객 정보 보호는 PG&E의 최우선 과제입니다. PG&E는 개인 정보를 포함하여 고객에 대한 정보를 캘리포니아 공공시설 위원회 및 기타 기관에서 정한 것을 포함하여 모든 법률 및 규제 요건에 따라 기밀로 취급합니다. 
• 20년 이상 캘리포니아의 PG&E 및 기타 투자자 소유 유틸리티는 고객의 명시적인 동의 없이 청구 데이터와 같은 고객별 정보를 제3자에게 공개하는 것을 금지하는 매우 엄격한 CPUC 규정의 적용을 받았습니다. 
• 고객이 데이터 공개를 승인하면 해당 데이터를 보호하는 것은 고객 및 제3자의 책임입니다.
• 고객은 PG&E 온라인 계정에 로그인하고 승인을 취소하여 언제든지 제3자와의 데이터 공유를 중단할 수 있습니다. PG&E의 전체 개인정보 보호정책 및 에너지 사용 정보의 접근, 수집, 저장, 사용 및 공개에 대한 고지는 pge.com/privacy 확인할 수 있습니다.

• 내 데이터 공유 프로그램의 범위 내에서 제3자는 내 데이터 공유 플랫폼 이용 약관에 명시된 고객 데이터 개인정보 보호 및 보호 규칙과 고객 데이터 액세스 요금표에 포함된 요구 사항을 준수해야 합니다.
• 제3자는 또한 PG&E의 전기 규칙 제27호 및 캘리포니아 민법 제1798.80~1798.84조에 요약된, 결정 11-07-056(전기)의 첨부 D로 CPUC가 채택한 에너지 사용 데이터에 대한 개인정보 보호 및 보안 보호에 관한 규칙을 포함하되 이에 국한되지 않는 고객 개인정보 보호와 관련된 모든 기타 해당 법률 및 규정의 적용을 받습니다.
• 자세한 내용은 아래 링크를 선택하십시오.
  내 데이터 공유 이용 약관(PDF, 190KB)
  전기 규칙 제27호(PDF, 1.6MB)
  결정 11-07-056에 대한 첨부 D(PDF)
  자세한 정보 찾기:캘리포니아 민법 섹션 1798.80 – 1798.84

• 지원되는 데이터 요소의 자세한 목록은 아래 링크를 참조하십시오.

데이터 액세스에 대한 자세한 정보 보기

• 때때로 당사의 업스트림 데이터 검증 프로세스에서 추가 처리(편집 및/또는 추정)가 필요할 수 있는 누락되거나 부정확한 데이터 판독이 있음을 발견하기 때문에 간격 사용 데이터가 누락됩니다.
• 청구 간격 고객(예: 사용 시간 청구 고려 사항이 있는 고객)의 경우, 이러한 인스턴스는 예정된 월별 청구서에 대한 정확한 청구서 계산을 보장하기 위해 적시에 수정됩니다.

• 데이터 수정을 받으려면 등록 중에 또는 온라인 계정에 로그인하여 프로필 편집 아래에서 이 확인란을 선택하여 데이터가 준비되었으므로 착신 알림 확인란을 선택해야 합니다. 그런 다음, 귀하가 액세스 권한을 부여받은 모든 데이터에 대해 일일 사용 피드의 일부로 이전 24시간 동안 당사 시스템에 의해 수집된 데이터 수정 사항을 포함합니다.
• 데이터 수정은 최대 3년까지 승인된 기간 동안의 모든 변경에 적용됩니다.

참고: 규칙 24 수요 대응 제공자 및 내 데이터 공유를 사용하는 기타 프로그램을 고려하여, 승인 만료 후 최대 3년 동안 이전에 승인된 날짜 범위에 대한 사후 수정을 제3자에게 제공할 수 있습니다.

• 해당되는 경우, PG&E는 등록 중에 제공된 알림 URL로 알림을 보냅니다. 알림은 제공된 URL로 다시 돌아와 요청할 수 있도록 미리 패키지된 데이터에 해당하는 URL로 구성됩니다. 데이터는 사전 포장되어 다음 두 가지 시나리오에서 알림이 발송됩니다. (1) 데이터가 준비되면 등록 프로필에서 알림 받기를 선택했습니다. 이 경우 당사는 과거 날짜에 대한 수정 사항을 포함하여 최신 일일 데이터를 포장합니다. 또는 (2) 요청된 데이터가 준비된 이전의 임시 비동기 요청을 했습니다. 시나리오 1은 'DATA ACCESS: 데이터 액세스 페이지 및 시나리오 2의 데이터 액세스 방법 다이어그램의 일일 구독 섹션은 '데이터 액세스: 데이터 액세스 페이지에도 동일한 다이어그램의 AD HOC 요청(ASYNCHRONOUS) 섹션이 있습니다.

위의 방문 데이터 액세스

• Share My Data에서 제공하는 전기 사용 데이터는 캘리포니아 독립 시스템 운영자(CAISO)가 지정한 SQMD(정산 품질 측정기 데이터)가 아닙니다. SQMD는 RQMD(매출액 품질 측정기 데이터)에 해당 간격에 대한 고객의 전압 수준에 적용되는 분배 손실 계수(DLF)를 곱한 다음, 측정 간격을 CAISO가 요구하는 간격 기간으로 변환한 다음 각 간격의 결과를 CAISO가 요구하는 집계 수준으로 합산하여 생성됩니다.
  
• PG&E는 ESPI 표준에서 제공하는 'QualityOfReading'(QOR) 유형의 플래그를 구현하여 데이터가 수익 품질인지 여부를 알립니다. QOR 유형은 “수익 품질 측정기 데이터” 또는 “RQMD”에 대한 명시적인 값을 포함하여 사용 데이터에 대해 다양한 가능한 품질 값을 캡처합니다. PG&E는 데이터 전송 시 다음과 같이 이 QOR 유형을 사용합니다.
  • PG&E는 ESPI가 제공하는 ‘UsageSummary’ 클래스를 지원합니다. 이 클래스는 서비스 계약 청구 날짜, 청구된 사용 금액 및 요청 시 사용 데이터 품질을 식별하는 데 사용됩니다. 요청된 데이터에 대한 청구서를 사용할 수 있게 되면 UsageSummary가 채워지고 QOR 유형의 두 가지 플래그(요소)가 포함됩니다.
    • UsageSummary.QualityOfReading 요소( UsageSummary 수준에서)는 가장 최근에 제공된 간격 사용 값 요청 시의 품질과 UsageSummary.billingPeriod 날짜에 해당하는 수정 사항을 나타냅니다.
    • 전체 소비 마지막 기간( UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef의 일부)에 대한 기본 품질 요소로, 청구된 총 사용량의 품질을 나타냅니다.
  • 또한 PG&E는 IntervalReading.ReadingQuality.Quality 요소를 사용하여 요청 시 간격 수준에서 사용 데이터의 품질을 전달합니다.

• 등록하는 동안 '요청된 내역 데이터의 양' 드롭다운에서 24, 36 또는 48개월 동안 필요한 내역 데이터의 양을 선택할 수 있습니다.
• 고객의 데이터에 액세스할 수 있도록 허용하는 고객의 승인의 일환으로, 승인에 포함된 서비스 ID(사용 포인트)에 대한 등록 선택이 승인 이력 기간으로 기본 설정됩니다.
• 계정에 로그인하여 등록 관리 > 편집 >으로 이동한 후 드롭다운에서 '요청된 내역 데이터 양'을 선택하여 요청된 내역 데이터를 업데이트할 수 있습니다.
• 과거 요청에 제공된 데이터는 API에 요청한 날짜가 아닌 고객이 승인한 날짜부터 시작됩니다.

참고: 요청된 내역 데이터의 변경은 신규 고객 승인에만 영향을 미치며, 이전 고객 승인은 승인 시점에 선택한 내용을 반영합니다.

• ESPI 표준에 따라 응답은 Atom Publishing Standard를 사용합니다. 아래 링크를 선택하여 지원되는 API의 전체 목록과 사용 가능한 데이터 요소를 확인하십시오.

데이터 액세스에 대한 자세한 정보 보기

• PG&E가 설치 및 판독하는 활성 전기 및 가스 서비스 ID는 내 데이터 공유 플랫폼을 통해 승인받을 수 있습니다.
• 승인과 관련된 서비스 ID가 다음 이유 중 하나로 인해 변경되는 경우, 승인은 새 서비스 ID로 전환되고 이전 간격 사용 데이터에 대한 액세스는 계속됩니다.
  • 미지급으로 인한 일시 중단
  • 간격 청구로 이동
  • 미터 교환
  • 요금 변경
• 위치 이동 또는 회사 변경과 같이 서비스 ID가 변경되는 기타 시나리오는 액세스를 종료합니다. 또한 계정이 My Energy 계정과 연결 해제된 경우, Share My Data를 통해 승인된 모든 기본 서비스 ID는 그 결과 승인되지 않습니다.

• 승인된 간격 데이터의 세분성을 확인하려면 ESPI 표준에서 제공하는 간격 길이 요소를 참조하십시오.
• PG&E는 일반적으로 전기 데이터의 경우 시간당 또는 15분 기준으로, 간격계를 사용하는 고객의 경우 가스 데이터의 경우 매일 청구 목적으로 수집된 것과 동일한 단위의 간격 사용 데이터를 제공합니다. 고객마다 다를 수 있지만, 전기 간격 측정기 사용은 일반적으로 대부분의 주거지역 고객의 경우 시간당 수준에서, 대부분의 상업지역 고객의 경우 15분 간격 수준에서 이용 가능하며, 가스 간격 측정기 이용은 일반적으로 대부분의 고객의 경우 일일 수준에서 이용 가능합니다.
• 비간격 측정기의 경우, 이용 가능한 경우 자료를 제공한다.

• 스마트 미터가 설치된 대부분의 PG&E 고객의 경우, 전기 및 가스 간격 사용 데이터를 내 데이터 공유 플랫폼을 통해 다음 날 말까지 사용할 수 있습니다.
• 전력선 캐리어 기반 MV90 미터를 설치한 PG&E 전기 고객의 작은 부분에는 데이터를 사용할 수 있는 추가 시간이 필요할 수 있습니다.

• API 설정을 직접 지원할 수는 없지만 개발 프로세스에서 IT 및 기술 리소스를 지원할 수 있는 많은 리소스가 있습니다. 자세한 내용은 API 문서 페이지를 참조하십시오. 또한 추가 질문이 있으시면 언제든지ShareMyData@pge.com으로 연락주시기 바랍니다.

자세한 내용은 API(Application Programming Interface)를 참조하십시오.