第三者とマイデータを共有する

現在の北米エネルギー基準委員会（NAESB）エネルギーサービスプロバイダーインターフェース（ESPI）の認証基準に準拠するために、PG&Eはデータへのアクセスを承認するためのOAuth 2.0認証フレームワークを実装しました。以下の図は、顧客が承認を開始し、範囲パラメータを選択してから承認を送信する方法を示しています。

以下の情報以外の追加の参考資料：

ESPI OAuth 2.0 シーケンスダイアグラム (PDF、193 KB) をダウンロード
Github のグリーンボタンデータ SDK を表示

注: Community Choice Aggregators では、(2-Legged OAuth を介して) データの要求には client_access_token のみが必要であり、以下は適用されません。

第三者サイトで開始された承認

上記の最初の図に示すように、サードパーティサイトから承認を開始するには、お客様のサードパーティサイトからPG&EのAuthorizationServer Authorization Endpoint URLにお客様のブラウザをリダイレクトし、以下の適切なリクエストパラメーターを使用して承認コードのリクエストを行います。リダイレクトされると、認証用のPG&Eログインページが表示され、その後、サードパーティへのデータアクセスを承認するための承認ページが表示されます。

authorizationServerAuthorizationEndpoint URI (リクエストパラメータあり）
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={OptionalState}

• 必須リクエストパラメータ：
  • client_id = マイデータ共有登録マイルストーンのクライアントID（クライアント_id/クライアント_シークレットペア）。
  • redirect_uri = Share My Data登録で指定したリダイレクトURL（URLは一致する必要があります）。
    注: 以下の例のように、redirect_uri に URL エンコーディングを適用することをお勧めします。
  • response_type = コード (静的値）
• オプションのリクエストパラメータ（複数可）：
  • state = OAuth 2.0 標準で許可されているオプションの不透明状態パラメータ。状態を維持するために、認証コードとともに返されます。例えば、状態パラメータは、顧客の出所を一意に識別し、クロスサイト偽造を防止するために、第三者によって使用され得る。
  • login={guest} 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）

上記のように有効なリクエストを行い、顧客が認証と承認に成功した場合、顧客はその後、承認コード、（認証済み）スコープパラメータ、およびオプションの状態パラメータ（承認リクエストの一部として提供される場合）とともに、以下の例のようにredirect_uriにリダイレクトされます。

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_37_ 38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength={3P Registered historical length};AccountCollection={count of authorizedSAs};BR={ThirdPartyID};dataCustodianId=PGE &state=pge12advertisement

注: 認証コードは短期間 (600 秒で期限切れ) で、認証を完了し、継続的なデータアクセスを許可するには、アクセストークン/リフレッシュトークンペアと交換する必要があります。アクセストークン/リフレッシュトークンリクエストの詳細については、次のセクション（セクション2）を参照してください。

上記の (authorized) scope パラメータは、 Authorization Code Request、Access Token Request、および Authorization API への応答の一部として返されます。このスコープパラメータにより、顧客承認の最終スコープを伝達できます。特に、スコープパラメータには、PG&Eがサポートする顧客承認選択のデータグループ（例：EmforseUsage 、EmforseBilling 、EmforceBasic 、EmforseAccount 、EmforceProgram Enrollment など）にマッピングされる、AddsurbleScopeAdditionalScope という値が含まれます。スコープパラメータ値は、次のリファレンスドキュメントに従ってさらにキャプチャされます。サポートされているファンクションブロックスコープ文字列マッピングのダウンロードクリックスルー2.0（PDF、222KB）。

エラーシナリオ

サードパーティ実装エラー: 認証コードをリクエストする際に client_id または redirect_uri の必須リクエストパラメータが無効または欠落している場合、標準 HTTP 400 シリーズエラーとともに説明メッセージが表示されます。同様に、 response_type の必須リクエストパラメータが欠落または無効な場合、カスタマーは OAuth 2.0 で定義された アキスタンスインバリッド_request−(* のエラーパラメータとともに、元の承認コードリクエストの一部として最初に提供された場合は、オプションの状態パラメータとともに redirect_uri にリダイレクトされます。

承認を拒否する顧客：第三者がPG&Eの承認を顧客にリダイレクトすると、顧客はログインページと承認ページの両方で、Creamatorcancelのアクセス権ボタンを使用して拒否することができます。このような場合、カスタマーはredirect_uriにリダイレクトされ、OAuth 2.0で定義されたaccess_denied℠のエラーパラメータが追加され、カスタマーが承認を拒否したことを示します。さらに、元の承認コード要求の一部として最初に提供された場合は、オプションの state パラメータが返されます。

PG&Eで開始された承認

お客様がPG&Eの顧客ウェブポータルであるYour Account、Your Account、Ecrendaseから開始し、Share My Dataランディングページに移動すると、登録済みで閲覧可能な第三者のドロップダウンが表示されます。上の2番目の図に示すように、お客様が登録済みの第三者のリストから第三者を選択し、かつ、RuncessNextを選択すると、お客様は、第三者の登録済みのRuncessantThird Party Portal URI,Runcessにリダイレクトされ、その時点でお客様は、前セクションで説明した第三者が開始したOAuthプロセスを進めることができます。

注：一部の第三者は、このユースケース（すなわち、PG&Eのサイトで開始された承認）の顧客体験を合理化する方法について問い合わせており、これにより顧客に対して、ドロップダウンから第三者を選択すると、承認ページに直接移動するように見えます。このような顧客体験を促進するために、サードパーティは、承認コードリクエストの一部として、自動的に顧客をPG&Eにリダイレクトするエンドポイントに、（マイデータの共有管理登録ページを介して）彼らのAcrendanceThird Party Portal URIのAcrendiumを設定することを選択できます。PG&Eの承認サーバー承認エンドポイントに自動的にリダイレクトされると、顧客は（すでにログインしているため）顧客のログインページをスキップし、承認ページに直接移動します。2018年6月下旬にShare My Data Click Thru 2.0リリース前に登録した一部の第三者については、第三者ポータルのURIを、もはや使用されていないMarketingThird Party Scope Selection Screen−(* URI（将来のリリースで廃止されるフィールド）と等しくなるように定義するだけで、これを実現できます。

対照的に、一部の第三者は、顧客が承認コードを要求する前に、まず、その顧客が自身のAcrendanceThird Party PortalのURIにリダイレクトされたときに、自分の側で顧客を関与させ、スクリーニングしたいと考える場合があるため、上記のアプローチは単なる提案にすぎません。

アクセストークンを取得するには、受信した承認コードを使用し、以下のエンドポイントに以下のパラメータを要求して呼び出します。前述のように、認証コードは10分（600秒）後に期限切れになるため、認証コードを受け取ったら、アクセストークンが速やかに要求されていることを確認してください。

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

• 必須リクエストパラメータ：
  • grant_type = authorization_code (静的値）
  • code = 認証コードの要求に応じて受信した認証コード
  • redirect_uri = Share My Data登録で指定したリダイレクトURL（URLは一致する必要があります）。
    注: 認証コード要求と同様に、redirect_uri に URL エンコーディングを適用することをお勧めします。

例: アクセストークンリクエスト
の投稿: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Base64エンコーディング適用済みclientID:clientSecret−(*で基本認証ヘッダーパラメータを追加

注: clientId:clientSecret 値は、共有マイデータ登録マイルストーンで指定された clientID 値に対応します。
ヘッダーパラメータは、次の形式になります。
パラメータ名：承認
パラメータ値：Basicbase64エンコードされたstring℠

成功した回答は次のようになります。

774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
998c6654-5b3b-4385-af4f-4e5c46c1bb04
scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47>AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;間隔期間=900_3600;BlockDuration=毎日HistoryLength={3P 登録履歴の長さ};AccountCollection={承認されたSAの数};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} 例： https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} 例： https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerResourceURI:{customerResourceURI} 例：https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

注: アクセス トークンは 3600 秒 (1 時間) で期限切れになり、対応するリフレッシュ トークンは 1 年で期限切れになります。新しいアクセス トークン/リフレッシュ トークン ペアの取得の詳細については、次のセクション 3 を参照してください。

アクセスを保存し、トークンペアを更新します。
初期履歴データと継続中の日次データをリクエストするには、データアクセスにアクセスしてください。

ベストプラクティスによると、アクセストークンは短寿命トークン（1時間）であり、対応するリフレッシュトークンは長寿命トークン（1年）であり、アクセストークンの期限が切れたときに新しいアクセストークン/リフレッシュトークンのペアを取得するために使用できます。既存の有効期限が切れていない認証に対して新しいアクセストークンとリフレッシュトークンのペアを取得するには、current Refresh Token℠を使用し、以下のパラメータを使用して以下のエンドポイントを呼び出します。

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

例: トークン更新リクエスト
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Base64エンコーディング適用済みclientID:clientSecret−(*で基本認証ヘッダーパラメータを追加

注: clientId:clientSecret 値は、マイデータの共有登録マイルストーンで指定された clientID 値に対応します。
ヘッダーパラメータは、次の形式になります。
パラメータ名：承認
パラメータ値：Basicbase64エンコードされたstring℠

正常に応答すると、次のようになります：
{
access_token℠: HCl677e6ef8-1e1a-43f0-85b8-5692fcbc72b2 の挨拶、
挨拶token_type 挨拶：emporioBearerの
の が の の が の の を の の が の の 3600、
refresh_token のもつもつもつもつもつもの： emporio0eef9a9f-60c6-40bb-b33f-910e322c0298 こんにちは、
内視鏡内視鏡内視鏡： scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_
プログラム登録；間隔期間=900_3600;BlockDuration=毎日HistoryLength={3P 登録履歴の長さ};AccountCollection={承認されたSAの数};BR={ThirdPartyID};dataCustodianId=PGE℠、
`resourceURI `resourceURI `re` は、 https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test−(*、
authorizationURI の抄録： https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Authorization/test−(*
}

注：同様に、クライアントアクセストークンは短寿命トークン（1時間）ですが、対応するリフレッシュトークンは長寿命トークン（1年）で、クライアントアクセストークンの期限が切れると新しいクライアントアクセストークン/リフレッシュトークンのペアを取得するために使用できます。新しいクライアント アクセス トークン/リフレッシュ トークンのペアを取得するには、上記の手順と同じ手順を参照してください。

顧客は、以下を行うことで承認を更新できます。

• 承認からサービスIDを削除する
• 承認期間の終了日の延長
• 承認のキャンセル

注：顧客は、オンラインPG&Eアカウントにログインし、必要なステップに従ってのみ、承認を変更することができます。これらの措置のいずれかが講じられた場合、登録時にお客様が提供した通知URIを介してお客様に通知します。

顧客承認の詳細を管理および表示するためのオプションがあります。

• client_access_token を使用して、 /espi/1_1/resource/Authorization または https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID} のサードパーティ レベル (すべての承認の詳細) で認証 API (http GET 操作) https://api.pge.com/GreenButtonConnect を呼び出すことができます。
• これとは別に、第三者ポータルから自分のShare My Dataアカウントにログインし、探している認証のサブスクリプションIDを入力することで、個々の認証の詳細を手動で表示することもできます。

承認に関連付けられたデータにアクセスしたくない場合は、承認をキャンセルするオプションの方法があります。

• https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID} で client_access_token を使用して、認証取り消し API (http DELETE 操作) を呼び出すことができます。
• または、第三者ポータルから自分のShare My Dataアカウントにログインし、キャンセルしたい承認のサブスクリプションIDを入力することで、承認を手動でキャンセルすることもできます。

注: 承認のキャンセルを選択したことが通知されます。また、承認がキャンセルされると、アクションを元に戻すことはできません。

• PG&Eは、登録時に提供された通知URIに通知を送信します。通知には、すでにパッケージ化されたデータに対応する URI が含まれ、この URI は、指定された URL で要求を返す準備が整いました。データは事前にパッケージ化され、通知は次の2つのシナリオで送信されます。(1) お客様が選択されたNotify me as data is readyであるお客様の登録プロファイルで、データが準備されているときに通知します。この場合、当社は過去の日付の修正を含む最新の日次データをパッケージ化します。(2) お客様がリクエストされたデータの準備ができた以前のアドホック非同期リクエストをしました。
• シナリオ 1 は、DataflowtomData Access の下に表示されます。以下のデータアクセス方法図およびシナリオ2のDaily SUBSCRIPTIONのご意見セクションは、ご意見・ご感想データアクセスの下に記載されています。AD HOC REQUEST (ASYNCHRONOUS) 以下の同じダイアグラムのASYNCHRONOUS セクション。

アクセストークン、クライアントアクセストークン、およびデータ要求で使用される対応するリフレッシュトークンのトークン寿命に注意してください。ベストプラクティスによると、アクセストークンは短寿命トークン（1時間）で、リフレッシュトークンは長寿命トークン（1年）で、アクセストークンの期限が切れたときに新しいアクセストークン/リフレッシュトークンのペアを取得するために使用できます。同様に、クライアント アクセス トークンは短期間 (1 時間) のトークンで、対応するリフレッシュ トークンは長期間 (1 年) のトークンで、クライアント アクセス トークンの期限が切れたときに新しいクライアント アクセス トークン/リフレッシュ トークンのペアを取得するために使用できます。新しいトークンペアの取得の詳細については、承認詳細タブのステップ3、新しいアクセストークンのリクエストを参照してください。 承認の詳細に移動

お客様が顧客から、AccountAccount Information℠（アカウントID、サービス契約ID、サービス開始日）および/またはSimplecketBasic Information℠（すなわち、顧客名とサービスアドレス）のいずれかを受け取る権限を与えられた場合、お客様は、上記のスキーマ、retailCustomer.xsdに準拠するESP定義のRetailCustomer APIを介して、かかる顧客情報をリクエストすることができます。

同期（スタンダードおよびEEFサードパーティ）

顧客データを要求する1つのアプローチは、顧客データ（すなわち、小売顧客）に対する単一の顧客承認のために顧客情報を要求するために同期APIを使用することである。

同期リクエスト URL の例:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = アクセストークンを取得するためにOAuth認証シーケンスの最後に受け取ったRetailCustomerID。RetailCustomerIDは、トークン応答のcustomerResourceUriパスパラメータの一部です。（RetailCustomerID=SubscriptionID）

HTTP ヘッダー = 承認：ベアラ {この承認のアクセストークン}

応答 = その RetailCustomerID のデータを同期して取得します。データは retailCustomer.xsd に準拠しています。

注: 同期小売顧客APIは、個々の小売顧客レベルで、単一の顧客承認に対応します。

参考：以下の階層図は、PG&E顧客データのモデリングにおけるESPデータ要素の関係階層を示しています。

また、非同期APIを介して顧客データをリクエストして、顧客データ（小売顧客）に対するすべての顧客承認の顧客情報をリクエストすることもできます。

非同期リクエストをサポートするには、当社が送信する通知の投稿（登録時に提供された通知URLによる）をサポートするアプリケーションが必要です。

非同期リクエスト URL の例：
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = 登録テスト中に取得されたアプリケーション情報リソースで提供される BulkID。（BulkID=クライアントID）

HTTP ヘッダー = 承認：ベアラ {登録テスト中にクライアント アクセス トークンを取得}

Response = HTTP ステータスコード 202 (これは非同期リクエストで、データの準備ができたら応答が通知 URL に投稿されます）。データの準備ができたら、アプリケーションがプリパッケージを取得するために戻ってくることができるURLのペイロードとともに、提供された通知URIに通知をポストします。ポスト通知のサンプルは次のようになります

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

クライアントアクセストークンを使用して上記のURLでGETを実行し、データを取得します。

参考：以下の階層図は、PG&E顧客データのモデリングにおけるESPデータ要素の関係階層を示しています。

最後に、日次サブスクリプションモデルを使用して、毎日最新の顧客情報を取得できます（登録時にデータの準備ができている（日次）場合、Notify meを選択します）。

日次サブスクリプションモデルをサポートするには、アプリケーションが（登録時に提供された通知URLに従って）送信する通知の投稿をサポートする必要があります。

データの準備ができたら、アプリケーションがプリパッケージを取得するために戻ってくることができるURLのペイロードとともに、提供された通知URIに通知をポストします。ポスト通知のサンプルは、次のように表示されます。

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

クライアントアクセストークンを使用して上記のURLでGETを実行し、データを取得します。

参考までに、以下の階層図は、PG&E顧客データのモデリングにおけるESPデータ要素の関係階層を示しています。

お客様が顧客から、RapidanceUsage Information−(*および/またはRapidanceBilling Information−(*のどちらかを受け取る権限を与えられている場合、お客様は、上記のスキーマ、espiDerived.xsdに準拠するサブスクリプションAPIを介して、このデータをリクエストすることができます。

同期特別リクエスト（標準およびEEFサードパーティ）

ヒストリカルデータをリクエストするには（インターバル使用率データと請求データの両方）、1つのアプローチとして、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 = このデータ取得リクエストに適用される開始日。日付はZulu時刻yyyy-MM-ddTHH:mm:ssZ（IETC RFC 3339形式）です。

published-max = データ取得のこのリクエストに適用される終了日。日付はZulu時刻yyyy-MM-ddTHH:mm:ssZ（IETC RFC 3339形式）です。

注: published-max および published-min-date パラメータを受け入れる API リクエストの場合、デフォルトは T-1 (リクエストの日付から 1 日を引いた値) です。利用状況概要リクエスト（例：.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary）については、30日以上の範囲を指定して、その期間と重複する請求があることを確認することをお勧めします。そうしないと、データは返されません。

サブスクリプションID = アクセストークンを取得するためにOAuth認証シーケンスの最後に受け取ったサブスクリプションID。サブスクリプション ID は、トークン応答の resourceURI パラメータの一部です。（SubscriptionID=RetailCustomerID）

UsagePointID = 上記のサブスクリプションIDの下の UsagePoint。次の API URL を呼び出し、承認ヘッダーでそのサブスクリプションのアクセス トークンを指定することで、特定のサブスクリプションのすべての使用ポイントを取得できます: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

HTTP ヘッダー = 承認：ベアラ {このサブスクリプションのアクセストークン}

応答 = リクエストされた期間のその使用ポイントのデータを同期して取得します。インターバル使用データ（）と請求データ（）の両方が含まれます。

同期使用API（使用ポイントIDで終わるURL構造で示される）は、個々の使用ポイントレベル（サービス契約レベル）にあるため、アプリケーションは、特定の顧客承認（サブスクリプション）に属する各使用ポイントIDを通じてリクエストをサイクルします。

同期リクエストへの応答は、リクエストされた日付範囲に関連付けられた間隔データ（下）と、リクエストされた日付範囲（の下）と重複する月ごとの使用量合計と請求書の両方を返します。

• 間隔読み取りには、間隔（15分/時）の電気使用量と間隔（毎日）のガス使用量データが含まれます。
• 使用量サマリーには、月間使用量の合計と請求書の詳細（承認されている場合）が含まれます。

応答内には、ESPデータ要素マッピングテーブルに対応するデータ要素があります。

参考までに、以下の階層図は、PG&E顧客データのモデリングにおけるESPデータ要素の関係階層を示しています。

以下は、これらのデータ要素に関するいくつかの重要な説明です。

• インターバルブロックは1日です
• IntervalReading（インターバルブロックの下）には、実際の15分/時間電気使用量値と毎日のガス使用量値が含まれます。
• オンサイト発電（ソーラーなど）の電気顧客の場合、flowDirection要素は、配信（供給）および受信（発電）の使用データを示します。メーターが正味使用量のみを読み取るように設定されているお客様（つまり、オンサイトで生成されない）の場合、flowDirection要素は使用量が正味金額であることを示します（配信された金額から受信された金額を差し引いた金額）。
  • フロー方向1 = 供給（顧客に供給されるエネルギー）
  • フロー方向19 = 受信（PG&Eグリッドに逆流するネット生成）。（注：値は絶対値です）
  • フロー方向4 = 正味（供給マイナス-受領）
• 10乗のパワーと測定単位（uom）に特に注意を払い、正しい使用の読み取り値を確保します。

バッチサブスクリプション（標準およびEEFサードパーティ）

また、単一の顧客による使用/請求データ（サブスクリプション）の承認に属するすべての使用ポイントについて、非同期APIを介して使用データをリクエストすることもできます。

臨時の非同期リクエスト（一度に複数の使用ポイント）をサポートするには、当社が送信する通知の投稿（登録時に提供した通知URLに従う）をサポートする必要があります。

非同期リクエスト URL
の例 https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

Subscription ID = アクセストークンを取得するためにOAuthシーケンスの最後に受け取ったSubscriptionID。サブスクリプション ID はトークン応答の resourceURI パラメータの一部です。

published-min = このデータ取得リクエストに適用される開始日。（RFC 3339形式zulu time. yyyy-MM-ddTHH:mm:ssZ）

published-max = データ取得のこのリクエストに適用される終了日。（RFC 3339形式zulu time. yyyy-MM-ddTHH:mm:ssZ）

HTTP ヘッダー = 承認：ベアラ {このサブスクリプションのアクセストークン}

応答 = HTTP ステータスコード 202 (これは非同期要求で、データの準備ができたら応答が通知 URL に投稿されます）

データの準備ができたら、アプリケーションがプリパッケージを取得するために戻ってくることができるURLのペイロードとともに、提供された通知URIに通知をポストします。ポスト通知のサンプルは、次のように表示されます。

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

アクセストークンを使用して上記のURLでGETを実行し、データを取得します。これには、リクエストされた期間のインターバル使用データ（）と請求情報（）の両方が含まれます。

バッチサブスクリプション（標準およびEEFのサードパーティ）
お客様は、利用/請求データ（サブスクリプションなど）に関するすべての顧客承認について、バッチバルク非同期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 time. yyyy-MM-ddTHH:mm:ssZ）

published-max = データ取得のこのリクエストに適用される終了日。（RFC 3339形式zulu time. 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を実行し、データを取得します。これには、リクエストされた期間のインターバル使用データ（）と請求情報（）の両方が含まれます。

最後に、毎日のサブスクリプションモデルを使用して、毎日、顧客承認期間内の過去の日付の訂正を含む最新の使用状況と請求情報を取得できます（登録時にデータの準備ができている（毎日）のに、EcrandanceNotify meチェックボックスを選択することで）。

日次サブスクリプションモデルをサポートするには、アプリケーションが（登録時に提供された通知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呼び出しの両方の新しいAPI HTTP応答コード（204）のリリース。
2. リクエストされたファイルの準備ができているときに、この値を相関IDとともに返すことで、PG&Eの応答を特定の非同期API呼び出しにリンクする機能をサポートするxトランザクションヘッダーラベルをサポートします。
3. 複数のメーターの電気間隔データを単一のサービス契約シナリオに提供することで、UsagePoint/MeterReadingID API への追加データ粒度が向上しました。
4. 予測間隔データの品質指標値の読み取りに、その間隔に使用される予測のタイプを説明するためのさらなる明確化を提供。推定ロジックが適用されたことを示す新しい値を以下に示します。
   
   

5. RQI値と説明

   0 - 有効：必要なすべての検証チェックを通過し、すべて合格したか、検証されたデータ

   7 - 手動編集：人間が交換または承認

   8 - 基準日を使用して推定：同じタイプの測定を使用した履歴データの分析に基づいて、データ値を機械計算値に置き換えた

   9 - 線形補間を使用して推定：前後の読み取り値に基づいて線形補間を使用してデータ値を計算

   10 - 疑わしい：1つ以上のチェックに失敗したデータ

   11 - 派生：（論理または数学的演算を使用して）計算されたデータで、必ずしも直接測定されるものではない

   12 - 予測（予測）：将来の読み取り値の予測または予測として計算されたデータ

   13 - 混合：この読み取り値の品質に混合特性があることを示します。

   14 - 未加工：検証、編集、推定プロセスを経ていないデータ。注記 MV90 メーター RQI インジケーターは、最終 RQ ステータスとして 14 のままになります。

   15 - 天候のために正規化: 値は、天候を考慮して調整され、異なる気候での使用を比較しています。

   16 - その他：定義された特性以外に特性が適用されることを指定します。

   17 - 検証済み：承認済みの手順に従って検証され、編集および/または推定されたデータ

   18 - 検証済み：必要な検証チェックの少なくとも1つに失敗したが、実際の使用を示すと判断されたデータ

   19 - 収益の質：請求目的に有効かつ許容可能［元の ESPI の一部ではなく、ESPI 規格の延長の可能性］

    

6. Share My Data Third PartyベンダーポータルでのベンダーAPI使用メトリクスのリリース。

2018年11月15日

最新情報：

1. 顧客クラス指標が追加されました。承認された各SAIDは、RES、AGR、COM/IND、その他のいずれかとして識別されます。
2. 請求および使用APIは、（published-minおよびpublished-maxの代替として）update-maxおよびupdate-minクエリパラメータを受け入れるように更新されます。返されるデータは、更新された最大パラメータおよび更新された最小パラメータ内で発生したすべての変更になります。
3. オンライン承認フローのために、第三者の5桁のバルクIDの使用を第三者のクライアントIDに置き換える。
4. オンライン承認フローの一環として、第三者がPG&Eのアカウントログインまたはゲストアクセスタブのいずれかに顧客をリダイレクトするオプションを提供する。
5. PG&EのShare My Data顧客ダッシュボードを改善し、顧客が既存のデータ共有認証をすべて第三者と簡単に表示できるようにします。

2018年9月27日

最新情報：

PG&Eは、PG&Eの拡張データセット（EDS）プロジェクトの一環としてルール24データセットに新しいデータ要素を追加し、対応する新しいデータ要素をルール25データセットに導入しました。PG&Eの拡張された規則25データセットを構成する特定のデータ要素は、EDSという名称で以下に記載されている。

ルール 25 データ要素

Notes
アカウント要素
アカウント名
アカウント住所
アカウントID
EDS: 停止ブロック
サービス要素
PG&E UUID
サービスID
サービス
ステータスの今後の変更 SAステータス
サービス開始日
サービスアドレス
現在のサービス料金
履歴請求サービス料金
オプション（医療ベースライン、 お手入れ、 フェラ、 TBS、 CCA_TBS、 Solar Choice
電流サービス電圧および商品履歴請求サービス電圧
サービスメーター数
サービスメーター
数 メータータイプ
電流メーター読み取りサイクル
履歴請求メーター読み取りサイクル
オンサイト生成インジケーター
履歴請求スタンバイレートオプションEDSの場合の現在のスタンバイレートオプション
： 顧客クラス指標
ヒストリカル請求要素
請求開始日
請求終了日
請求合計料金($)
請求合計kWh
EDS: サービス・プロバイダー
の過去の請求階層の内訳の名前（該当する場合）
EDS： 明細請求期間
EDS: EDS名（ベースライン超過1%～30%）
： ボリューム (1234.2）
EDS： 料金 ($0.032/kWh）
EDS： コスト（100ドル。23)
過去の請求TOU kWh内訳（ABS-TX請求を除く）
EDS： 明細請求期間（TOU明細）
EDS： EDS（TOU料金の名前）
： ボリューム (1234.2）
EDS： 料金 ($0.032/kWh）
EDS： コスト（100ドル。23)
過去の請求需要内訳
EDS： 明細請求期間（需要内訳用）
EDS： EDSの名称
： ボリューム (1234.2）
EDS： 料金 ($0.032/kWh）
EDS： コスト（100ドル。23)
過去の請求明細
EDS： 明細請求期間
EDS: 料金名（DWRボンド料金）
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年6月28日

クリックスループロジェクトおよびShare My Data Platformの継続的な改善の一環として、PG&Eは2018年6月28日にクリックスルーフェーズ2を開始しました。

最新情報：

第三者に影響を与える最も重要な変更は、OAuth 2.0プロトコルに準拠するための変更です（PG&Eは最初の一連のリダイレクトを削除しました）。 詳細は以下をご覧ください。

重要： 第三者は、既存のOAuth実装に変更を加える必要があります。PG&Eのクリックスルーフェーズ2の変更は下位互換性がないため、第三者はPG&Eの実装と同時に変更を実装する必要があります。実施しない場合、現在の顧客承認プロセスは2018年6月29日のカットオフ日に作業が停止します。 ただし、既存の承認は影響を受けません。

1. OAuth 2.0プロトコルに準拠するために、PG&Eは承認のためのリダイレクトステップの数を減らしました。顧客がログインして承認を送信するためのPG&Eへの最初のリダイレクトは、以下のように承認コードリクエストと組み合わされました。
   • 以下の例に示すように、サードパーティの認証コードリクエストは、適切なリクエストパラメータとともに、お客様のブラウザをPG&Eの新しいauthorizationServerAuthorizationEndpointURIにリダイレクトするようになりました。
     https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={OptionalState} を取得
   • 次のエンドポイントは廃止されました: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. 以下のように、スコープパラメータが欠落または無効な承認コードリクエストの新しいエラー処理メッセージ：
   • 必要な client_id または redirect_uri パラメータが見つからないか無効である場合、説明メッセージを含む (http 400) エラーがカスタマーに表示されます。
   • 必要な response_type パラメータが見つからないか無効である場合、顧客は、redirect_uri に、redirect_uri に \"Andisoninvalid_request の \"redirect_uri\" というエラー パラメータ (redirect_uri に付加) とともに、第三者の redirect_uri にリダイレクトされます。
     
3. 既存のオンライン認証をお持ちのお客様の場合、既存の認証に代わる新しい認証の一部として、第三者が新しい access_token/refresh_token ペアをリクエストする機能（つまり、同じ第三者とお客様の組み合わせのオンライン認証）。この機能は、第三者が access_token/refresh_token ペアを失った場合、または顧客承認ごとに元の承認の範囲を変更する必要がある場合のシナリオに対応します。
   • 再承認リクエストの場合、サードパーティが承認のためにPG&Eにリダイレクトすると、顧客は、承認の管理のページではなく新しい承認ページを表示します。
   • 顧客の承認後、サードパーティは、古いサブスクリプションIDがキャンセルされたという通知URLに登録された通知を受け取ります（通知は、古いサブスクリプションIDの承認API URLエンドポイントを含みます）
     
4. 顧客が認証ページまたは認証ページのいずれかにある、redirecting back to the third party's redirect_uri with anaccess_denied−(*のエラーパラメータ（redirect_uriに付加される）で、redirectagecancel−(*ボタンを介して終了する機能
5. で の のささやかさ の 設定に登録し、登録された の 第三者のリスト に 含まれている第三者の場合、 の PG&E オンライン アカウントに移動し、 マイデータの共有 ランディング ページに移動します。
   • PG&Eオンラインアカウントにログインし、Share My Dataランディングページに移動し、登録された第三者のリストから第三者を選択したときに、第三者の登録されたMarketingThird Party Portal URIの可能性にリダイレクトされるお客様向け。この時点で、お客様はサードパーティが開始したOAuthプロセスを進めることができます。このパスを進むと、サードパーティのドロップダウンリストからサードパーティを選択すると、承認ページが表示されなくなり、サードパーティの登録済みのEcrificateThird Party Portal URIのEcrificateにリダイレクトされ、サードパーティが開始したOAuthプロセスを開始できます。
   • ご注意：一部の第三者は、このユースケース（すなわち、PG&Eのサイトで開始された承認）の顧客体験を合理化して、顧客に対して、ドロップダウンから第三者を選択すると、承認ページに直接移動するようにする方法を問い合わせています。このような顧客体験を促進するために、サードパーティは、承認コードリクエストの一部として、自動的に顧客をPG&Eにリダイレクトするエンドポイントに、（マイデータの共有管理登録ページを介して）彼らのAcrendanceThird Party Portal URIのAcrendiumを設定することを選択できます。PG&EのauthorizationServerAuthorizationEndpointに自動的にリダイレクトされると、顧客は（すでにログインしているため）顧客のログインページをスキップし、承認ページに直接移動します。Share My Data Click Thru 2.0リリース前に登録した一部の第三者については、これは、第三者ポータルのURIを、もはや使用されていないThird Party Scope Selection Screen℠URI（古いSMD登録フィールドは、将来のリリースで廃止される）と等しくなるように定義するだけで達成できます。
     対照的に、一部の第三者は、顧客が承認コードを要求する前に自分の '第三者ポータル' URI にリダイレクトされたときに、代わりに自分の側で顧客を関与させ、スクリーニングしたいと考えるかもしれません。
     
6. SMDは、認証コード要求、アクセストークン要求、および認証APIへの応答の一部として、拡張スコープパラメータの詳細を提供します。拡張スコープパラメータを使用すると、顧客承認の最終スコープを伝達できます。特に、スコープパラメータには、PG&Eがサポートする顧客承認選択のデータグループ（例：AnabasumUsage、Anabasumbilling、AnabasumeBasic、AnabasumAccount、AnabosumeProgram Enrollment）にマッピングされる、AddextalScopeのExtendedScopeの値が含められます。スコープパラメータ値は、次のドキュメントに従ってさらにキャプチャされます。サポートされているファンクションブロックスコープ文字列マッピングのダウンロードクリックスルー2.0（PDF）
   
   以下のトークン応答の例は、考えられるスコープパラメータ値を示しています。
   • トークン応答の例：
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47>AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;間隔期間=900_3600;BlockDuration=毎日HistoryLength={3P 登録履歴の長さ};AccountCollection={承認されたSAの数};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} 例： https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} 例： https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} 例：https://piです。ページcom/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. サードパーティは、新しいプログラム登録プログラム登録登録登録登録データグループを介して、承認されたプログラム登録情報を受け取るために登録できるようになりました。インターバル測定とインターバル測定以外の顧客の両方が、SMDクリックスルーフェーズ2のデータ共有を承認する資格があります。プログラム加入契約データ グループが提供する新しく利用可能なデータ エレメントの概要は次のとおりです。
   • プログラム登録（PG&E Demand Responseプログラム名/ステータスおよび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 (現在のメーター読み取りサイクル）使用状況サマリー
     • readCycle（請求サービスサイクル）
     • 商品（電気料金請求電圧レベルを含む）
     • tariffProfile（該当する場合はスタンバイ料金オプションを含む請求済みサービス料金
   • 読み取りタイプ
     • コモディティ（該当する場合、電気の電流電圧レベルとスタンバイ料金オプションのプレフィックスを含む）
   • 顧客アカウント
     • （アカウント請求先住所）：
     • メインアドレス/ストリート詳細...
     • mainAddress/town詳細...
     • mainAddress/郵便番号...
   • 顧客契約
     • status\\\\'83\\'7dート値 (SA ステータス
   • 需要対応プログラム
     • プログラム名
     • 登録ステータス
     • プログラム日付/プログラム日付
     • programDate/programDate説明
   • メーター
     • serialNumber（メーターID）
     • タイプ（メータータイプ）
     • （現在）間隔長さ
   • これらの新しいデータ要素に使用される最新の ESPI xml スキーマ定義 (XSD) の概要は、以下のとおりです。
     XSDs (ZIP、49 KB)ZIP をダウンロードします。新しいウィンドウで開きます。
     注: XSD は後方互換性があります。
   • 第三者は、登録管理 >編集 > セクション：必要な顧客情報を示し、プログラム登録チェックボックスをオンにします。
   • 注：これは新規顧客の承認にのみ適用されます。
     
   • DR登録情報を取得するための新しいAPIは、バルクサードパーティレベルおよび個々の顧客承認レベル（RetailCustomerIDレベル）で利用可能であり、以下に概説します。
     新しいPGE対応APIをダウンロード（PDF）
   • 第三者へのすべての承認について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/{RetailCustomerID}

注意：顧客承認プロセスの変更に加えて、その他の変更は下位互換性があり、第三者がサポートを選択できる自発的な機能強化です。

ご質問がある場合、または追加のサポートが必要な場合は、sharemydata@pge.comまでEメールでお問い合わせください。

最新情報：

1. 顧客は、合理化されたクリックスルー承認プロセスから恩恵を受けることができます。
   • 顧客が貴社とデータを共有する方法の詳細を更新しました。
     顧客が企業とデータを共有する方法を学ぶ
     
     注： これらの変更、特に当社の承認UIの改善は、モバイルデバイス（電話やタブレットなど）向けに最適化されています。
   • PG&Eオンラインアカウントを通じて顧客がアクセス可能な承認プロセスの管理が変更されました。
     • 顧客は、既存の承認からSAIDを削除したり、承認終了日を延長したり、承認をいつでもキャンセルしたりできます。ただし、SAIDを追加したり、承認されたデータ要素を変更したりするには、既存の承認をキャンセルし、新しい承認を作成する必要があります。
2. 必要に応じて、サードパーティはこのAPIを使用して、DELETE操作を介してサードパーティのクライアントアクセストークン（最初のSMDサードパーティ登録プロセスで提供）を使用して個々の顧客の承認を取り消すことができます：https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   注1：PG&Eの実装では、AuthorizationIDパラメータはSubscriptionIDと同じ値です。
   
   注2：新しいAPIは、第三者が承認を取り消す（キャンセルする）機能を提供します。ただし、SA IDを削除したり、当社のSMD管理承認ページから承認終了日を更新したりできるのは、お客様自身のみです。
   
   注意：すべてのAPIデータリクエストと同様に、サードパーティは最新のリフレッシュトークンを使用して新しいトークンペア（クライアントアクセス＋リフレッシュトークン）を最初にリクエストする必要があります。
   
   トークンの有効期限のリマインダー：
   • アクセストークン：1時間
   • クライアントアクセストークン：5分
   • 対応するリフレッシュトークン：1Yr
3. サードパーティは、必要に応じて同じ会社名と納税者IDを使用して、複数のShare My Data（SMD）登録を作成できるようになりました。ただし、表示名（顧客が承認する際に表示）は一意である必要があります。
   
   注：上記の変更はすべて下位互換性があり、第三者がサポートを選択できる自発的な機能強化です。本リリースの関連文書をダウンロード：
   
   SUPPORTED_APIS.SMD_CLICK-THRU_1.0（PDF）
   
   SUPPORTED_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0（PDF）
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0（PDF）
   
   SUPPORTED_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0（PDF）
   
   ESPI_XSDS (ZIP)

2015年12月20日

必要な変更：以下のSMD 2.0の更新には、サードパーティ側の変更が必要です。

1. PG&E以外の複数のユーティリティでGBCMD（Green Button Connect My Data）を実装しているサードパーティを考慮して、OAuth認証シーケンス中に、dataCustodianID（dataCustodianID=PGE）をthirPartyScopeSelectionScreenURIにリダイレクトします。
2. 日付パラメーター（バッチリクエストなど）を受け入れるAPIリクエストは、Zuluデータパラメーター（published-max/ published-minなど）を使用する必要があります。APIリクエストの日付パラメーターのその他の日付形式はサポートされていません。
   • 日付パラメータを受け入れるAPIは、添付のSupported APIs.xlsxに従って文書化されます。
3. インターバルTOUインジケータは、インターバルメーターによる電気使用量データに含まれています（該当する場合、各インターバルがどのTOU期間に対応するかのインジケータ）
   • 各間隔TOU列挙が何に対応するか（例：1 = Summer Peakなど）を詳述した静的プログラムIDマッピングを参照してください。（添付、対応データ要素.xlsx参照）
4. dataCustodianScopeSelectionScreenURI（サードパーティが開始したOAuthで使用）で見つけられ、登録テスト中にアプリケーション情報リソースサードパーティリクエストで提供されたclient_idは、まだ更新されていない場合（例：先頭のゼロの追加など）、5桁に更新されます。さらに、URL の末尾に '&verified=true' が含まれなくなりました。第三者は、それに応じてURLを更新する必要があります。
   • 詳しく説明すると、dataCustodianScopeSelectionScreenURIは次のようになります：https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX（XXXXはクライアントID）
   • したがって、現在の123のクライアントIDは00123のようなものに変更され、新しいdataCustodianScopeSelectionScreenURIは次のようになります：
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123（古いURLはhttps://https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true）
5. 登録された第三者が、Energy Service ProviderのEcrendorまたはEcrendorEnergy Service ProviderのEcrendorを標準ユーザータイプに変更します。機能的に変更はなく、ユーザータイプのタイトルのみに変更があります。ESPユーザータイプ（標準ユーザータイプと）を区別することは、不要な区別であり、区別された機能を提供しずに登録プロセス中に混乱を引き起こし、したがって、それは廃止される。

オプションの強化： 以下の変更は後方互換性があり、第三者がサポートを選択できる自発的な機能強化です。

1. サードパーティは、登録管理下にあるサードパーティポータルから、登録時に最初に提供したSSL証明書を自動的に変更/更新することができます >編集 > 新しいセクション：SSL 証明書情報 (更新オプション）。
2. 第三者は、承認された基本請求情報、顧客情報、およびガスデータを受け取るために登録することができます。  インターバル測定とインターバル測定以外の顧客の両方が、SMD 2.0のデータの共有を承認する資格があります。新しく利用可能なデータ要素の概要は次のとおりです。
   • 請求情報: (インターバルと非インターバルのメーター付き SA の両方）
     • 料金表、請求額合計、段階的利用（該当する場合）、需要（該当する場合）、TOU合計（該当する場合）
     • ご注意：認定された非インターバル検針顧客については、第三者は請求利用合計（利用状況概要）のみを受け取り、インターバル利用の読み取り（例：利用不可のため、時間/日単位の読み取り）は受けません。
   • 顧客情報: (インターバルと非インターバルのメータ付き SA の両方）
     • 顧客名、サービスアドレス、アカウントID、サービス契約ID、サービス契約サービス開始日、
   • インターバル・ガス使用データ：（インターバル・メーター付きガスSAのみ）
     • 間隔（毎日）のガス読み取り
   • 新しいデータ要素は、添付のSupported Data Elements.xlsxに従ってダイアグラム化されます。
   • 関連するリレーショナルデータ階層は、添付のPGE ESPIデータモデル.xlsxに概説されています。
   • これらの新しいデータ要素に使用される最新の ESPI xml スキーマ定義 (XSD) は、添付の XSD に従います。注：XSDは後方互換性があります。
     • espiDerived.xsd (インターバル使用量と請求情報）
     • retailcustomer.xsd（顧客情報）

ご質問がある場合、または追加のサポートが必要な場合は、ShareMyData@pge.comまでお気軽にお問い合わせください。

2015年12月18日

必要な変更: 次の SMD 2.0 の更新には、自分のデータにアクセスするユーザー側の変更が必要です。

1. 日付パラメーター（バッチリクエストなど）を受け入れるAPIリクエストは、Zuluデータパラメーター（published-max/ published-minなど）を使用する必要があります。APIリクエストの日付パラメーターのその他の日付形式はサポートされていません。
   • 日付パラメータを受け入れるAPIは、添付のSupported APIs.xlsxに従って文書化されます。
2. インターバルメータ付き電気使用データに含まれるインターバル使用時間（TOU）インジケータ（該当する場合、各インターバルがどのTOU期間に対応するかのインジケータ）
   • 各間隔TOU列挙が何に対応するか（例：1 = Summer Peakなど）を詳述した静的プログラムIDマッピングを参照してください。（添付、対応データ要素.xlsx参照）

オプションの強化： 以下の変更は後方互換性があり、第三者がサポートを選択できる自発的な機能強化です。

1. セルフアクセスユーザーは、登録の管理下にあるサードパーティポータルから、登録時に提供したSSL証明書を自動的に変更/更新することができます > 編集 > 新しいセクション：SSL 証明書情報 (更新オプション）
2. Self Accessユーザー登録が更新され、承認された基本請求情報、顧客情報、ガスデータが含まれます。非間隔検針サービス契約として検針された両方のインターバルは、SMD 2.0の（自己）承認の資格があります。新しく利用可能なデータ要素の大まかな概要は次のとおりです。
   • 請求情報: (インターバルと非インターバルのメーター付き SA の両方）
     • 料金表、請求額合計、段階的利用（該当する場合）、需要（該当する場合）、TOU合計（該当する場合）
     • ご注意：認定された非インターバル検針顧客については、第三者は請求利用合計（利用状況概要）のみを受け取り、インターバル利用の読み取り（例：利用不可のため、時間/日単位の読み取り）は受けません。
   • 顧客情報: (インターバルと非インターバルのメータ付き SA の両方）
     • 顧客名、サービスアドレス、アカウントID、サービス契約ID、サービス契約サービス開始日、
   • インターバル・ガス使用データ：（インターバル・メーター付きガスSAのみ）
     • 間隔（毎日）のガス読み取り
   • 新しいデータ要素は、添付のSupported Data Elements.xlsxに従ってダイアグラム化されます。
   • 関連するリレーショナルデータ階層は、添付のPGE ESPIデータモデル.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 の両方）
     • 料金表、請求額合計、段階的利用（該当する場合）、需要（該当する場合）、TOU合計（該当する場合）
   • （追加）顧客情報：（インターバルと非インターバルのメータリングSAの両方）
     • 顧客名、サービス住所、サービス契約サービス開始日、アカウントID
   • インターバルTOUインジケータは、インターバルメーターによる電気使用量データに含まれています（該当する場合、各インターバルがどのTOU期間に対応するかのインジケータ）
     • 各間隔TOU列挙が何に対応するか（例：1 = Summer Peakなど）を詳述した静的プログラムIDマッピングを参照してください。（添付、対応データ要素.xlsx参照）
   • これらの新しいデータ要素に使用される最新の ESPI xml スキーマ定義 (XSD) は、添付の XSD に従います。XSDは後方互換性があります。
     • espiDerived.xsd (インターバル使用量と請求情報）
     • retailcustomer.xsd（顧客情報）
   • 新しいデータ要素は、添付のSupported Data Elements.xlsxに従ってダイアグラム化されます。
   • 関連するリレーショナルデータ階層は、添付のPGE ESPIデータモデル.xlsxに概説されています。

オプションの強化： 以下の変更は後方互換性があり、第三者がサポートを選択できる自発的な機能強化です。

1. CCAは、受信した毎日の通知に加えて、https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID}（リクエスト時に最新の顧客情報のスナップショットを返す）で顧客情報のアドホックリクエストを行うことができます。
2. CCAは、登録管理 > 編集 > 新しいセクションで、サードパーティポータルを介して登録中に（証明書の有効期限が近づくなど）最初に提供したSSL証明書を自動的に変更することができます。SSL 証明書情報 (更新オプション）

ご質問がある場合、または追加のサポートが必要な場合は、ShareMyData@pge.comまでお気軽にお問い合わせください。

2015年8月21日

最新情報：

1. Oauth応答における状態パラメータとリソースURIの変更
   • OAuth承認コード要求の一部として、第三者は、PG&Eが第三者に送信する状態パラメータを送信するオプションがあります。PG&Eは、承認が正常に完了すると、承認コードも送信します。このオプションの状態パラメータは、サードパーティがリクエストが開始された場所を特定し、リクエストを開始済みの承認に結び付けるのに役立ちます。
   • トークン要求の正常な完了の一部として、我々はトークン情報とは別に resourceURI と authorizationURI を共有します。現在、これらの URI は反転されており、このリリースの一部として、これを修正します。

修正された欠陥：

1. デフォルトの公開日-maxおよび公開日-min
   現在、PG&Eは、第三者がデータ要求ごとに公開日-minおよび公開日-maxパラメータをエポック秒で送信し、PG&Eにデータ要求の期間を伝えることを義務付けています。以下のシナリオのリクエストを処理するための変更を実装しています。
   • published-min および published-max の値がありません
   • published-min および published-max の値は UTC です。
   • published-min および published-max の値はエポック秒単位です
   パラメータが欠落している場合、PG&Eは、この変更の前に返されたエラーメッセージとは対照的に、デフォルトの日付を返します。この場合、デフォルトは日付T-2の1日データです。パラメータが存在し、正しくフォーマットされている場合、パラメータは引き続き尊重されます。
2. 承認 xml の日付を修正
   現在の承認 xml では、公開日と承認日を共有しました。これらの日付は、標準である秒ではなくミリ秒単位です。ミリ秒ではなくエポック秒で返送するように修正しています。
3. /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock に返された XML
   が正しくありません。現在、XML の構造が間違っている上記のリソース レベルの GET に対して不正な応答を返しています。1 つのインターバル ブロックを 24 時間作成せずに、各インターバルに対してエントリを繰り返しています。
   
   これは固定されており、24間隔ブロックに対して1つの間隔ブロックのみが返されます。

質問や懸念は？ ShareMyData@pge.comまでご連絡ください。

• 顧客は、PG&EオンラインアカウントであるMy Energyを介してデータにアクセスすることを承認します。顧客が第三者またはその他の事業体にデータへのアクセスを許可する方法の詳細な概要については、共有マイデータ第三者概要をご覧ください。

承認の詳細に移動

• 現在、制限はありません。

• 顧客は、データにアクセスできる指定された時間を選択するか、承認期間を開いたままにすることができます。
• アプリケーションは、承認リソースAPIを呼び出すことで、他の承認の詳細とともに、顧客承認の終了日を確認できます（例：.../espi/1_1/resource/Authorizationおよび/または.../espi/1_1/resource/Authorization/{AuthorizationID}）。
• または、アカウントにログインし、承認の管理を選択することで、承認終了日を手動で確認することもできます。

• 顧客が定義された承認期間を選択した場合、その承認はその期間の終了時に失効します。承認をキャンセルした場合、その承認は、承認をキャンセルした翌日に失効します。
• 顧客が承認期間として無期限を選択した場合、承認は期限切れになりません。規則24のデマンドレスポンスプロバイダーおよびその他のShare My Dataを使用するプログラムを考慮して、以前に承認された日付範囲の事後修正は、承認の有効期限が切れてから最長3年間、第三者に提供される場合があります。
• 参考：Rakasenデータ修正はどのように処理されますか？Rakasen 修正の受信に関する詳細については、を参照してください。

• 現在アクティブなガスまたは電気サービスのサービスIDを持つPG&Eのお客様は、新しいShare My Dataツールを使用してデータにアクセスする権限を付与できます。

• Share My Dataプログラムを介してデータを共有することに関心のあるお客様は、My Energyアカウントに登録することを強くお勧めします。これにより、プロセス全体が効率化され、オンラインで承認を管理する機能も提供されます。
• お客様は、承認プロセス中にMy Energyアカウントに登録できます。
• オンラインで自分のデータの共有承認フォームを入手し、記入済みのフォームを電子メールで送信するための手動プロセスがあります。
• 手動プロセスの詳細については、ShareMyData@pge.comまでお問い合わせください。

• 顧客は、PG&Eオンラインアカウントを通じて、自身のオンライン認証を行う必要があります。ただし、共有マイデータ承認フォームに記入して署名した場合は、代わりにPG&Eに提出することができます。

Share My Data Customer AuthorizationまたはRevocation of Authorizationフォームをダウンロード（PDF、308 KB）

• アカウントにログインし、登録の管理 > 編集 > に移動し、OAuth 2.0 Informationセクションのフィールドを更新することで、OAuth URIを更新できます。

• 通知URIは、アカウントにログインし、登録の管理 > 編集 > に移動し、データアクセス情報セクションのフィールドを更新することで更新できます。

• アカウントにログインし、登録の管理 > 編集 > に移動し、SSL証明書情報セクションで、AbsotainUpdate を選択します。新しい証明書をアップロードする場合、PG&Eシステムを新しい証明書で更新するのに数日かかる場合があります。 
• 新しい証明書が適用されると、Share My Data Supportチームから確認メールが送信されます。

• 登録が承認されたことを示す電子メールを受信したら、自分のShare My Dataアカウントにログインし、PG&E SSL証明書のダウンロードページからSSL証明書をダウンロードすることができます。

ログインしてマイデータを共有

• Share My Dataは、Green Button Connect My Dataの実装契約に従います。Share My Dataはまた、承認にはOAuth 2.0、Transport Layer Security（TLS）1.2、NIST（National Institute of Standards and Technology）が承認したサイバーセキュリティプロトコルの最小スイートを採用しており、明確な情報交換は行われません。

• 顧客情報の保護はPG&Eの最優先事項です。 PG&Eは、個人情報を含む顧客に関する情報を、カリフォルニア州公益事業委員会などによって確立されたものを含む、すべての法的および規制上の要件に従って、機密情報として取り扱います。 
• 20年以上にわたり、PG&Eおよびその他のカリフォルニア州の投資家が所有する公益事業は、請求データなどの顧客固有の情報を、顧客の明示的な同意なしに第三者に開示することを禁止する非常に厳格なCPUC規制の対象となっています。 
• 顧客がデータのリリースを承認すると、そのデータを保護するのは顧客および第三者の責任です。
• 顧客は、PG&Eオンラインアカウントにログインし、承認を取り消すことで、いつでも第三者とのデータ共有を停止することができます。PG&Eの完全なプライバシーポリシーおよびエネルギー利用情報へのアクセス、収集、保管、使用、開示に関する通知は、pge.com/privacy。

• Share My Dataプログラムの範囲内で、第三者はShare My Dataプラットフォームの利用規約に明記されている顧客データプライバシーおよび保護規則、ならびに顧客データアクセス料金に含まれる要件の対象となります。
• 第三者はまた、決定11-07-056（電気）の添付書類DとしてCPUCが採用したエネルギー使用データのプライバシーおよびセキュリティ保護に関する規則、およびPG&Eの電気規則第27条、およびカリフォルニア州民法第1798.80～1798.84項に要約されているものを含むがこれらに限定されない、顧客のプライバシーの保護に関連するその他のすべての適用法および規制の対象となります。
• 詳細については、以下のリンクを選択してください。
  マイデータの共有に関する利用規約（PDF、190 KB）
  電気規則No. 27（PDF、1.6 MB）
  決定書の添付書類D 11-07-056（PDF）
  詳細：カリフォルニア州民法第1798.80項～1798.84項

• サポートされるデータ要素の詳細なリストについては、以下のリンクを参照してください。

データアクセスに関する詳細情報を入手する

• アップストリームのデータ検証プロセスで、さらなる処理（編集および/または推定）を必要とする可能性のあるデータの読み取りが欠落または不正確であることが判明したため、インターバル使用データが欠落することがあります。
• インターバル請求の顧客（使用時間の請求に関する考慮事項がある顧客など）の場合、これらのインスタンスは、次回の月次請求で正確な請求計算を確実にするために時間内に修正されます。

• データ修正をご希望の場合は、登録中またはオンラインアカウントにログインしてプロファイルの編集でこのチェックボックスを選択して、Notify Me as Data is Readyチェックボックスに必ずチェックを入れてください。その後、アクセスが許可されたデータについて、過去24時間の間に当社のシステムでキャプチャされたデータ修正を、毎日の使用フィードの一部として含めます。
• データ修正は、最長3年間、承認された期間の変更を対象とします。

注：規則24のデマンドレスポンスプロバイダーおよびShare My Dataを使用するその他のプログラムを考慮して、以前に承認された日付範囲の事後修正は、承認の有効期限が切れてから最長3年間、第三者に提供することができます。

• 該当する場合、PG&Eは登録時に提供された通知URLに通知を送信します。通知には、すでにパッケージ化されたデータに対応するURLが含まれており、提供されたURLで戻ってリクエストできます。データは事前にパッケージ化され、通知は次の2つのシナリオで送信されます。(1) お客様が選択されたNotify me as data is readyであるお客様の登録プロファイルで、データが準備されているときに通知します。この場合、当社は過去の日付の修正を含む最新の日次データをパッケージ化します。(2) お客様がリクエストされたデータの準備ができた以前のアドホック非同期リクエストをしました。シナリオ 1 は、DataflowtomData Access の下に表示されます。データアクセスページとシナリオ2のデータアクセス方法図のDaily SUBSCRIPTIONの懐中電化セクションは、懐中電化データアクセス：データアクセスページでも同じ図のAD HOC REQUEST（ASYNCHRONOUS）の叙述セクション。

上記の来院データアクセス

• Share My Dataが提供する電気利用データは、カリフォルニア州独立系システムオペレーター（CAISO）が指定する決済品質メーターデータ（SQMD）ではありません。SQMDは、収益品質メーターデータ（RQMD）に、その間隔の顧客の電圧レベルに適用される分配損失係数（DLF）を掛け、計測された間隔をCAISOが要求する間隔期間に変換し、各間隔の結果をCAISOが要求する集計レベルに合計することによって生成されます。
  
• PG&Eは、データが収益品質であるかどうかを伝達するために、ESPI規格によって提供されるQualityOfReading−(*（QOR）タイプのフラグを実装しています。QORタイプは、\"Revenue Quality Meter Data\"または\"RakaseRQMD\"の明示的な値を含む、使用状況データのさまざまな可能な品質値を取得します。PG&Eは、このQORタイプをデータ送信に以下のように使用します。
  • PG&E は ESPI 提供の、ESPI 提供の、ExasageSummary の、サービス契約が請求される日付、請求される使用量、および要求時の使用データ品質を識別するために使用される、ExasageSummary の、Exaskor のクラスをサポートします。UsageSummaryは、請求が要求されたデータに対して利用可能になると入力され、QORタイプの2つのフラグ（要素）が含まれます。
    • UsageSummary.QualityOfReading 要素（ UsageSummary レベル）は、最新の指定間隔使用値の要求時の品質と UsageSummary.billingPeriod 日付に対応する修正を示します。
    • OverallConsumptionLastPeriod の DefaultQuality 要素（ UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef の一部として）は、請求された合計使用量の品質を示します。
  • また、PG&Eは、IntervalReading.ReadingQuality.Quality要素を使用して、要求時にインターバルレベルで使用データの品質を伝達します。

• 登録中に、24、36、または48か月のいずれかの期間の、How much historical data is requesteddupilumabドロップダウンの下で必要な履歴データの量を選択できます。
• お客様のデータへのアクセスを許可するお客様の承認の一環として、承認の履歴期間は、承認に含まれるサービスID（使用ポイント）の登録選択にデフォルト設定されます。
• アカウントにログインし、登録の管理 > 編集 > に移動し、How much historical data is requested.
• 過去のリクエストで提供されたデータは、APIにリクエストを行った日付ではなく、顧客が承認を行った日付から始まります。

注：リクエストされた履歴データの変更は、新規顧客の承認にのみ影響しますが、以前の顧客の承認は、承認時の選択を反映します。

• ESPI 標準に従い、応答は Atom 公開標準を使用します。以下のリンクを選択して、サポートされているAPIの完全なリストと利用可能なデータ要素を確認してください。

データアクセスに関する詳細情報を入手する

• PG&Eがインストールおよび読み取った有効な電気およびガスサービスIDは、Share My Dataプラットフォームを介して承認を受ける資格があります。
• 次のいずれかの理由により、承認に関連付けられたサービス ID が変更された場合、承認は新しいサービス ID に移行し、履歴インターバル使用データへのアクセスは続行されます。
  • 未払いのため一時休業
  • インターバル請求に移動
  • メーターの交換
  • 料金変更
• 場所の移動や会社の変更など、サービスIDの変更につながるその他のシナリオでは、アクセスが終了します。さらに、アカウントがMy Energyアカウントからリンク解除された場合、Share My Dataを介して承認されたすべての基礎となるサービスIDは、結果として許可されません。

• 承認された間隔データの粒度を決定するには、ESPI 規格で提供されている間隔長要素を参照してください。
• PG&Eは、請求目的で収集されたものと同じ粒度でインターバル利用データを提供しています。これは通常、インターバルメーターを使用している顧客については、電気データについては1時間ごとまたは15分ごと、ガスデータについては1日ごとです。顧客によって異なる可能性があるが、電気インターバルメーターの使用は、ほとんどの住宅顧客では一般に時間単位、ほとんどの商業顧客では15分の間隔で利用可能であり、ほとんどの顧客では、ガスインターバルメーターの使用は一般に、毎日利用可能である。
• 非インターバルメーターについては、利用可能な場合、データが提供されます。

• スマートメーターが設置されているPG&Eの大多数の顧客にとって、電気およびガスの間隔使用データは、翌日の終わりまでにShare My Dataプラットフォームから入手することができます。
• 電力線キャリアベースのMV90メーターが設置されているPG&Eの電気顧客のごく一部では、データが利用可能になるまでにさらに時間がかかる場合があります。

• APIのセットアップを直接サポートすることはできませんが、開発プロセスにおいてITおよび技術リソースを支援するために利用可能なリソースが多数あります。詳細については、APIドキュメントページを参照してください。その他ご質問がありましたら、ShareMyData@pge.comまでお気軽にお問い合わせください。

詳細については、アプリケーションプログラミングインターフェイス（API）をご覧ください。