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

現在の北米エネルギー基準委員会（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 = マイデータの共有登録で指定したリダイレクト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、Yourpassageからスタートし、Share My Dataランディングページに移動すると、登録済みで閲覧可能な第三者のドロップダウンが表示されます。上の2番目の図に示すように、お客様が登録済みの第三者のリストから第三者を選択し、かつ、RuncessNextを選択すると、そのお客様は、第三者の登録済みのRuncessantThird Party Portal URI、Runcessにリダイレクトされ、その時点でお客様は、前セクションで説明した第三者が開始したOAuthプロセスを進めることができます。

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

対照的に、一部の第三者は、顧客が承認コードを要求する前に、まず、その顧客のそばで顧客を関与させ、スクリーニングしたいと考えるかもしれません。そのため、上記のアプローチは単なる提案にすぎません。

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

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

• 必須リクエストパラメータ：
  • grant_type = authorization_code（静的値）
  • code = 認証コード要求に応じて受信した認証コード
  • redirect_uri = マイデータの共有登録で指定したリダイレクト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 値に対応します。
header パラメータは、次の形式になります。
パラメータ名：承認
パラメータ値 : Basicbase64エンコードされたstring℠

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

＜xmlnsの応答 https://api.pge.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 ;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength={3P Registered historical length};AccountCollection={許可されたSAの数};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} 例: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} 例: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerResourceURI:{customerResourceURI} 例:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
ベアラ

注: アクセス トークンは 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}

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

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

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

成功した回答は次のようになります。
{
アクセス権_トークンアクセス権：アクセス権：アクセス権：アクセス権：アクセス権：アクセス権677e6ef8-1e1a-43f0-85b8-5692fcbc72b2
アテリトリートークン_タイプ アテリトリー：さすがベアラー・ささやかさ、
3600、
refresh_token という名前のもの: afrench0eef9a9f-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_
プログラム登録;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength={3P 登録履歴の長さ};AccountCollection={認定SA数};BR={ThirdPartyID};dataCustodianId=PGEの不一致、
nodesresourceURIの挨拶: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
authorauthorizationURI−(*:−(*https://api.pge.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を入力すると、個々の認証の詳細を手動で表示することもできます。

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

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

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

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

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

顧客から、AccountAccount Information（アカウントID、サービス契約ID、サービス開始日）および/またはBasic 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}?相関ID={correlationID}

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

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

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

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

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

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

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

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

お客様が顧客から、RabsontUsage Information℠および/またはRabsontBilling 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 = このデータ取得リクエストに適用される開始日。日付は、yyyy-MM-ddTHH:mm:ssZ（IETC RFC 3339形式）のZulu時間です。

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

注: 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}

サブスクリプションID = アクセストークンを取得するためにOAuthシーケンスの最後に受け取ったサブスクリプションID。サブスクリプション 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を実行し、データを取得します。これには、リクエストされた期間のインターバル使用データ（）と請求情報（）の両方が含まれます。

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

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

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

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

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

2024年6月20日

PG&Eの顧客承認データ共有用マイデータプラットフォーム（SMD）は、当社のメーターID強化の第2段階をリリースし、電気間隔メーターデータに関連する個々のメーターIDを特定できるようになりました。  

この機能強化は、複数のメーターが1つのサービス契約に関連付けられているユーザーシナリオで特に役立ちます。

フェーズ1：  2023年3月リリース - 影響を受けたAPIを変更し、タグの下で返された応答に値とともに値を追加し始めました。serialNumber 値と utcNumber 値の間には 1 対 1 の対応があります。

この情報により、これらの API を使用するベンダーは、フェーズ 2 エンハンスメントがリリースされる前に、顧客ベースの特定のメーターに関連付けられた serialNumber 値とともに、utcNumber とともにレコードのストアを構築できます。

フェーズ2：2024年6月20日リリース - 現在のencode64形式のメーター記述値のmeterReadingID値をutcNumberに置き換えます。これらの変更が完全に実装されると、Share My Dataユーザーは、オンプレミスの単一のサービス契約にリンクされた複数の同じ商品がある場合、特定のメーター間隔の使用にリンクする機能が改善されます。 

以下のAPIはフェーズ2の変更の影響を受ける

影響を受けるAPI：

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock/{IntervalBlockID}

間隔読み取りを持つその他すべての API は変更されず、両方のフロー方向とサービス契約に基づくすべてのメーターでのメーター間隔の SUM を表します。

リリース前は、MeterReadingIDフィールドはBase64エンコードされ、返された値は次のように表示されます。

MeterReadingID= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

Base64形式から以下のようにデコードされます。  NzI6bnVsbDozNjAwOjE =:1:1

これは readingTypeID:rownum:count を示し、 readingTypeID 値は再び Base64 から次のようにデコードされます。

72:null:3600:1。ここで値はuom:phase:intervalLength:flowDirです。

UOM=72、Phase=null、intervalLength=3600、flowDir=1（配信済み）

フェーズ2では、MeterReadingIDフィールドに追加文字が追加され、最初のデコーディングを行った後、以下の結果例が返されます。

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

Base64 から 1 回デコード：  NzI6bnVsbDozNjAwOjE =:1:1:4411310546, 

これはmeter_UUIDが4411310546であり、この値はタグの下のRetailCustomer APIで利用可能な値と一致する必要があります。

\"NzI6bnVsbDozNjAwOjE=:1:1:\" の値 は readingTypeID:rownum:count です。つまり、行番号は 1 で、カウントは PG&E の内部データベースレコードに関連する 1 です。readingTypeID は再び次のようにデコードされます。

72:null:3600:1、ここで値は uom:phase:intervalLength:flowDir

UOM=72、Phase=null、intervalLength=3600、flowDir=1（配信済み）

この変更により、ユーザーは、インターバル読み取りで関心のある物理メーターとフロー方向を指定できます。すべての XML ファイルには、新しい MeterReadingID 値が格納され、新しいフェーズ 2 エンコーディング形式が適用されることに注意してください。マイデータの共有は、MeterReadingIDを使用してAPIコールを使用するすべてのベンダーにアドバイスします。次のAPIコールを実行して新しいMeterReadingIDを取得します。.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

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 - 疑わしい：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. Billing APIとUsage APIは、（published-minおよびpublished-maxの代替として） updated-maxおよび updated-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 データ要素

メモ
アカウント要素
アカウント名
アカウント住所
アカウントID
EDS：停止ブロック
サービス要素
PG&E UUID
サービスID
今後のサービス状況の変更
SAステータス
サービス開始日
サービスアドレス
現在のサービス料金
過去に請求されたサービス料金
タリフオプション（Medical Baseline、CARE、FERA、TBS、CCA_TBS、Solar Choice
電流サービス電圧および商品履歴請求サービス電圧
サービスメーター番号
サービスメーター数
メータータイプ
電流メーターの読み取りサイクル
過去に請求されたメーターの読み取りサイクル
オンサイト生成インジケータの場合の現在のスタンバイ料金オプション
過去に請求されたスタンバイ料金オプション
EDS: 顧客クラスインジケータ
過去の請求要素
請求開始日
請求終了日
請求総額（$）
請求合計kWh
EDS: サービスプロバイダ名
過去の請求階層の内訳（該当する場合）
EDS：明細請求期間
EDS：名称（ベースライン超過1%～30%）
EDS：ボリューム（1234.2）
EDS：料金（$0.032/kWh）
EDS：コスト（$100.23）
過去の請求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ボンド料金）
EDS：ボリューム（1234.2）
EDS：単位（kWh）
EDS：料金（$0.032/kWh）
EDS：コスト（$100.23）
過去の使用間隔
インターバル使用開始
デフォルトの間隔期間（秒）
インターバル使用量（1234.2）
単位（kWh/サーム）
ユーティリティ需要対応プログラム
(DR) プログラム名
財務上の義務のない最も早い終了日
財務上の義務にかかわらず、最も早い終了日
DRプログラムステータス
DRプログラム登録日
DRプログラム登録解除日
データ要素
商品
ローカル時間パラメータ（DST詳細）
デフォルトのデータ品質
エネルギー方向
10乗のパワー（インターバル使用値）
Power of Ten Multiplier（請求済需要用）
Power of Ten Multiplier（請求された合計使用量）
間隔の長さ（使用状況の読み取り値）
請求総額の通貨
電気間隔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. 認証ページまたは認証ページのどちらかにある、お客様が、第三者のredirect_uriにリダイレクトして、redirectageaccess_deniedのredirectionエラーパラメータ（redirect_uriに付加）を使用して、redirectancecancelのそばから終了する機能。
5. で のささやかさびの 設定に登録し、登録されたサードパーティのリストに含まれているサードパーティの場合、顧客は PG&E オンラインアカウントにアクセスし、マイデータの共有ランディングページに移動します。
   • PG&Eオンラインアカウントにログインし、Share My Dataランディングページに移動し、登録された第三者のリストから第三者を選択したときに、第三者の登録されたAddord Party Portal URIのAboutにリダイレクトされるお客様向け。この時点で、お客様はサードパーティが開始したOAuthプロセスを進めることができます。このパスを通過すると、サードパーティのドロップダウンリストからサードパーティを選択すると、承認ページが表示されなくなり、サードパーティが開始したOAuthプロセスを開始できる、サードパーティの登録済みSubscriptionThird Party Portal URIのAbilityにリダイレクトされます。
   • ご注意：一部の第三者は、このユースケース（すなわち、PG&Eのサイトで開始された承認）の顧客体験を合理化する方法について問い合わせており、これにより顧客に対して、ドロップダウンから第三者を選択したときに、承認ページに直接移動するように見えます。このような顧客体験を促進するために、サードパーティは、承認コードリクエストの一部として、自動的に顧客をPG&Eにリダイレクトするエンドポイントに、（マイデータの共有管理登録ページを介して）彼らのAcrendanceThird Party Portal URIのAcrendorを設定することができます。PG&EのauthorizationServerAuthorizationEndpointに自動的にリダイレクトされると、顧客は（すでにログインしているので）顧客のログインページをスキップし、承認ページに直接移動します。Share My Data Click Thru 2.0リリース前に登録した一部の第三者については、これは、第三者ポータルのURIを、もはや使用されていないThird Party Scope Selection Screen℠URI（古いSMD登録フィールドは、将来のリリースで廃止される）と等しくなるように定義するだけで達成できます。
     対照的に、一部の第三者は、顧客が認証コードを要求する前に '第三者ポータル' URI にリダイレクトされるときに、代わりに自分の側で顧客をエンゲージしてスクリーニングしたいと考えるかもしれません。
     
6. SMDは、認証コード要求、アクセストークン要求、および認証APIへの応答の一部として、拡張スコープパラメータの詳細を提供します。拡張スコープパラメータを使用すると、顧客承認の最終スコープを伝達できます。特に、スコープパラメータには、PG&Eがサポートする顧客承認選択のデータグループ（例：AnabasumageUsage、Enabasumbilling、EnabasumageBasic、EnabasumAccount、EnabasmentProgram Enrollment、Enabos）にマッピングする、AddertyScopeのExterendScopeの値が含められます。スコープパラメータ値は、次のドキュメントに従ってさらに取得されます。サポートされているファンクションブロックスコープ文字列マッピングのダウンロードクリックスルー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 ;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength={3P Registered historical length};AccountCollection={許可されたSAの数};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{ResourceURI} 例: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} 例: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} 例:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     ベアラ
     
     
7. 第三者は、新しいProgram Enrollment Nuncデータグループを介して、承認されたプログラム登録情報を受け取るために登録できるようになりました。インターバル測定とインターバル測定以外の顧客の両方が、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/postalCode は...
   • 顧客契約
     • status\\\\'83\\'7dート\\\\'83\\'7d
   • 需要対応プログラム
     • プログラム名
     • 登録ステータス
     • programDate/programDate / プログラム日付
     • programDate/programDate説明
   • メーター
     • serialNumber（メーターID）
     • タイプ（メータータイプ）
     • （現在）間隔長さ
   • これらの新しいデータ要素に使用される最新の ESPI xml スキーマ定義 (XSD) は、次のように概説されています。
     XSD（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を使用して、複数の共有マイデータ（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は、添付の、サポート対象の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://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は、添付の、サポート対象のAPIs.xlsxに従って文書化されます。
2. インターバルメーターによる電気使用データに含まれるインターバル使用時間（TOU）インジケータ（該当する場合、各インターバルがどのTOU期間に対応するかのインジケータ）
   • 各間隔TOU列挙が何に対応するかを詳述した静的プログラムIDマッピングを参照してください（例：1 = Summer Peakなど）。（添付、対応データ要素.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列挙が何に対応するかを詳述した静的プログラムIDマッピングを参照してください（例：1 = Summer Peakなど）。（添付、対応データ要素.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は、サードパーティがデータ要求ごとに、パブリッシュされた最小および最大パラメータをエポック秒で送信し、データを要求している期間を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 に対して不正な応答を返しています。また、24 時間にわたって 1 つのインターバル ブロックを作成する代わりに、各インターバルに対してエントリを繰り返しています。
   
   これは固定されており、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年間、第三者に提供される場合があります。
• 参考：Amerchageデータの訂正はどのように処理されますか？Amerchage 修正の受信に関する詳細については、を参照してください。

• ガスまたは電気サービスの現在アクティブなサービスIDを持つPG&Eのお客様は、新しいマイデータの共有ツールを使用してデータへのアクセスを許可できます。

• 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 を選択し、SSL証明書を更新できます。新しい証明書をアップロードする場合、新しい証明書で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、190KB）
  電気規則第27号（PDF、1.6 MB）
  決定事項11-07-056の添付資料D（PDF）
  詳細を見る：カリフォルニア州民法第1798.80条～第1798.84条

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

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

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

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

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

• 該当する場合、PG&Eは登録時に提供された通知URLに通知を送信します。通知には、すでにパッケージ化されたデータに対応するURLが含まれ、提供されたURLで戻ってリクエストできます。データは事前にパッケージ化され、通知は次の2つのシナリオで送信されます。(1) データが登録プロファイルで準備されているときに通知します。この場合、当社は過去の日付の修正を含む最新の日次データをパッケージ化します。(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\"またはSurgaseRQMDの明示的な値を含む、使用状況データのさまざまな可能な品質値を取得します。PG&Eは、このQORタイプを以下のようにデータ送信に使用します。
  • PG&E は ESPI 提供の、ESPI 提供の、ExasageSummary の、サービス契約が請求される日付、請求される使用量、および要求時の使用データ品質を識別するために使用される、ExasageSummary の、Exasture のクラスをサポートします。UsageSummaryは、請求がリクエストされたデータに対して利用可能になると入力され、QORタイプの2つのフラグ（要素）が含まれます。
    • UsageSummary.QualityOfReading エレメント (UsageSummary レベル) は、最新の指定間隔使用値の要求時の品質と UsageSummary.billingPeriod 日付に対応する修正を示します。
    • OverallConsumptionLastPeriod の DefaultQuality 要素（ UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef の一部として）は、請求された合計使用量の品質を示します。
  • また、PG&Eは、IntervalReading.ReadingQuality.Quality要素を使用して、要求時にインターバルレベルで使用データの品質を伝達します。

• 登録時に、24、36、または48か月のいずれかの期間の、必要な履歴データの量を選択できます。 履歴データの量 ドロップダウンから、リクエストされた履歴データの量。
• お客様のデータへのアクセスを許可するお客様の承認の一環として、承認の履歴期間は、承認に含まれるサービス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分、ガスデータについては毎日です。顧客によって異なる可能性があるが、電気式インターバル・メーターの使用量は、ほとんどの住宅用顧客では一般に時間単位、ほとんどの商用顧客では15分単位、ほとんどの顧客では一般にガス式インターバル・メーターの使用量は日単位レベルで利用可能である。
• 非インターバルメーターについては、利用可能な場合、データが提供されます。

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

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

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