اشتراک گذاری اطلاعات من برای اشخاص ثالث

به منظور مطابقت با استاندارد فعلی هیئت استانداردهای انرژی امریکای شمالی (NAESB) رابط ارائه دهنده خدمات انرژی (ESPI) برای مجوز، PG & E چارچوب مجوز OAuth 2.0 را برای اجازه دسترسی به داده ها اجرا کرده است. نمودار زیر نشان می دهد که چگونه مشتریان مجوز را اغاز می کنند، پارامترهای دامنه را انتخاب می کنند و سپس مجوز خود را ارائه می دهند.

مواد مرجع اضافی فراتر از اطلاعات زیر:

دانلود نمودار توالی ESPI OAuth 2.0 (PDF، 193 KB)
مشاهده داده های دکمه سبز SDK در Github

توجه: برای جمع اوری کنندگان انتخاب جامعه، تنها client_access_token برای درخواست داده ها (از طریق 2-Legged OAuth) مورد نیاز است و زیر اعمال نمی شود.

مجوزهای اغاز شده در سایت شخص ثالث

برای شروع مجوز از یک سایت شخص ثالث همانطور که در نمودار اول بالا نشان داده شده است، درخواست کد مجوز با هدایت مرورگر مشتری از سایت شخص ثالث خود به URL Endpoint AuthorizationServer PG & E با پارامترهای درخواست مناسب به عنوان مثال زیر انجام می شود. پس از تغییر مسیر، مشتری یک صفحه ورود به سیستم PG & E برای احراز هویت ارائه می شود و به دنبال ان یک صفحه مجوز برای اجازه دسترسی به داده ها به شخص ثالث شما ارائه می شود:

مجوزServerAuthorizationEndpoint URI (با پارامترهای درخواست)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• پارامترهای درخواست اجباری:
  • client_id = شناسه مشتری از نقاط عطف ثبت نام به اشتراک گذاری داده های من (به عنوان مثال، client_id / client_secret جفت).
  • redirect_uri = تغییر مسیر URL که شما در ثبت نام Share My Data خود مشخص کرده اید (URL ها باید مطابقت داشته باشند).
    توجه: ما توصیه می کنیم رمزگذاری URL به redirect_uri به عنوان مثال زیر اعمال شود.
  • response_type = کد (مقدار استاتیک)
• پارامتر درخواست اختیاری (ها):
  • state = پارامتر اختیاری حالت مات که توسط استاندارد OAuth 2.0 مجاز است که با کد مجوز بازگردانده می شود تا به حفظ وضعیت کمک کند. به عنوان مثال، پارامتر حالت ممکن است توسط یک شخص ثالث برای شناسایی منحصر به فرد منشا مشتری و جلوگیری از جعل بین سایت استفاده شود.
  • login={guest} ارائه گزینه ای برای شخص ثالث برای هدایت مشتریان به ورود به سیستم انرژی من PG & E و یا به تب دسترسی مهمان به عنوان بخشی از جریان مجوز انلاین.

مثال: درخواست کد Auth

دریافت: https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri=https%3A%2F%2Fthirdparty.com%2FredirectUrl&response_type=code&state=pge12advertisement

توجه: به عنوان مثال redirect_uri پارامتر بالا دارای رمزگذاری URL اعمال شده است (به عنوان مثال رمزگذاری URL https://thirdparty.com/redirectUrl)

اگر شما یک درخواست معتبر مانند بالا انجام دهید و مشتری با موفقیت تایید و مجوز دهد، مشتری پس از ان با کد مجوز، پارامتر دامنه (مجاز) و پارامتر وضعیت اختیاری (اگر به عنوان بخشی از درخواست مجوز ارائه شود) به redirect_uri شما هدایت می شود:

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_37_ 38_39_40_4_5_10_15_16_46_47؛ AdditionalScope = Usage_Billing_Basic_Account_ProgramEnrollment؛ فاصلهDuration = 900_3600؛ BlockDuration = روزانه؛ HistoryLength={3P طول تاریخی ثبت شده}؛ AccountCollection={count of authorizedSAs}؛BR={ThirdPartyID}؛ dataCustodianId=PGE &state=pge12تبلیغات

توجه: کد مجوز کوتاه مدت است (در 600 ثانیه منقضی می شود) و باید پس از ان برای یک جفت توکن دسترسی / تازه کردن مبادله شود تا مجوز را تکمیل کند و اجازه دسترسی به داده ها را فراهم کند. بخش بعدی (بخش 2) را برای جزئیات بیشتر در مورد درخواست Token Access / Refresh Token مشاهده کنید.

پارامتر دامنه (مجاز) که در بالا ذکر شد به عنوان بخشی از پاسخ به درخواست کد مجوز، درخواست رمز دسترسی و همچنین API مجوز بازگردانده می شود. این پارامتر دامنه اجازه می دهد تا برای برقراری ارتباط دامنه نهایی مجوز مشتری. به طور خاص، پارامتر دامنه شامل یک مقدار "AdditionalScope" است که به انتخاب مجوز مشتری پشتیبانی شده توسط PG & E از گروه های داده (به عنوان مثال، "استفاده"، "صورتحساب"، "پایه"، "حساب"، "ثبت نام برنامه"). مقادیر پارامتر دامنه بیشتر در هر مستندات مرجع زیر گرفته شده است: دانلود تابع پشتیبانی شده بلوک محدوده رشته نقشه برداری کلیک کنید از طریق 2.0 (PDF، 222 KB).

سناریوهای خطا

خطاهای پیاده سازی شخص ثالث: اگر پارامترهای درخواست مورد نیاز client_id یا redirect_uri پس از درخواست کد مجوز نامعتبر یا گم شده باشد، مشتری یک پیام توضیحی همراه با خطای استاندارد سری HTTP 400 نشان داده می شود. به طور مشابه، اگر پارامتر درخواست مورد نیاز response_type از دست رفته یا نامعتبر باشد، مشتری به redirect_uri شما با پارامتر خطای "invalid_request" تعریف شده OAuth 2.0 و همچنین پارامتر حالت اختیاری هدایت می شود اگر ابتدا به عنوان بخشی از درخواست کد مجوز اصلی ارائه شود.

مشتریان کاهش مجوز: پس از یک شخص ثالث هدایت مشتری به مجوز با PG & E، مشتری این گزینه را دارد که از طریق دکمه "لغو" در هر دو صفحه ورود به سیستم و صفحه مجوز، رد شود. در چنین مواردی، مشتری به redirect_uri شما هدایت می شود و پارامتر خطای "access_denied" تعریف شده OAuth 2.0 اضافه می شود تا نشان دهد مشتری از مجوز خودداری کرده است. علاوه بر این، پارامتر حالت اختیاری در صورتی که ابتدا به عنوان بخشی از درخواست کد مجوز اصلی ارائه شود، بازگردانده خواهد شد.

مجوز های اغاز شده در PG & E

هنگامی که مشتریان در پورتال وب مشتری PG & E، "حساب شما" شروع به کار می کنند و سپس به صفحه فرود Share My Data حرکت می کنند، به انها یک کشویی از اشخاص ثالث ثبت شده و قابل مشاهده ارائه می شود. همانطور که در نمودار دوم بالا نشان داده شده است، بر اساس یک مشتری انتخاب شخص ثالث از لیست اشخاص ثالث ثبت شده و انتخاب "بعدی"، مشتری به شخص ثالث ثبت شده "پورتال شخص ثالث URI" هدایت می شود، که در ان نقطه مشتریان می توانند با فرایند OAuth اغاز شده توسط شخص ثالث که در بخش قبلی شرح داده شده است، ادامه دهند.

توجه: برخی از اشخاص ثالث در مورد چگونگی ساده سازی تجربه مشتری برای این مورد استفاده (به عنوان مثال مجوزهای اغاز شده در سایت PG & E) به طوری که به مشتری به نظر می رسد انها به طور مستقیم به یک صفحه مجوز پس از انتخاب شخص ثالث از کشویی گرفته شده است. برای تسهیل چنین تجربه مشتری، اشخاص ثالث می توانند "پورتال شخص ثالث URI" خود را (از طریق صفحه ثبت نام مدیریت Share My Data) به یک نقطه پایانی تنظیم کنند که به طور خودکار مشتری را به عنوان بخشی از درخواست کد مجوز به PG & E هدایت می کند. پس از تغییر مسیر خودکار به مجوز PG & E مجوز سرور Endpoint، مشتری صفحه ورود مشتری را رد می کند (زیرا انها قبلا وارد سیستم شده اند) و به طور مستقیم به صفحه مجوز می رود. برای برخی از اشخاص ثالث که قبل از انتشار Share My Data Click Thru 2.0 در اواخر ژوئن 2018 ثبت نام کرده اند، این را می توان به سادگی با تعریف URI پورتال شخص ثالث برای برابری با URI "صفحه انتخاب دامنه شخص ثالث" (زمینه ای که در نسخه اینده بازنشسته می شود) انجام داد.

در مقابل، برخی از اشخاص ثالث ممکن است بخواهند ابتدا مشتریان را درگیر کنند و مشتریان را در کنار خود قرار دهند، زمانی که مشتریان قبل از درخواست کد مجوز به ادرس "پورتال شخص ثالث" هدایت می شوند، بنابراین رویکرد فوق فقط یک پیشنهاد است.

برای به دست اوردن یک توکن دسترسی، از کد مجوز دریافت شده استفاده کنید و با نقطه پایانی زیر با پارامترهای درخواست همانطور که در زیر توضیح داده شده است، تماس بگیرید. همانطور که در بالا توضیح داده شد، کد مجوز کوتاه مدت است و پس از 10 دقیقه (600 ثانیه) منقضی می شود، بنابراین لطفا اطمینان حاصل کنید که رمز دسترسی به سرعت پس از دریافت کد مجوز درخواست می شود.

مجوزServerAuthorizationپایین نقطه: https://api.pge.com/datacustodian/oauth/v2/token

• پارامترهای درخواست اجباری:
  • grant_type = authorization_code (مقدار استاتیک)
  • کد = کد مجوز دریافت شده در پاسخ به درخواست کد مجوز
  • redirect_uri = تغییر مسیر URL که شما در ثبت نام Share My Data خود مشخص کرده اید (URL ها باید مطابقت داشته باشند).
    توجه: همانطور که با درخواست کد مجوز، توصیه می کنیم رمزگذاری URL به redirect_uri اعمال شود.

مثال: درخواست
رمز دسترسی : https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code ={authorizationcode}&redirect_uri={redirect_uri}

اضافه کردن پارامتر اصلی مجوز هدر با Base64 رمزگذاری اعمال "clientID: clientSecret"

توجه: clientId: مقادیر clientSecret با مقادیر clientID ارائه شده در نقاط عطف ثبت نام Share My Data شما مطابقت دارد.
پارامتر سرایند در قالب زیر خواهد بود:
نام پارام : مجوز
ارزش پارام : پایه "base64encoded 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؛ فاصلهDuration = 900_3600؛ BlockDuration = روزانه؛ HistoryLength={3P طول تاریخی ثبت شده}؛ AccountCollection ={count of authorized SAs}؛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/RetailCustomerID}
بر
< / پاسخ>

توجه: یک توکن دسترسی در 3600 ثانیه (1 ساعت) منقضی می شود، در حالی که توکن Refresh مربوطه در 1 سال منقضی می شود. بخش بعدی 3 را برای جزئیات بیشتر در مورد دستیابی به یک جفت جدید Access Token / Refresh Token مشاهده کنید.

ذخیره دسترسی و تازه کردن جفت نشانه.
برای درخواست داده های تاریخی اولیه و داده های روزانه در حال انجام، از دسترسی به داده ها بازدید کنید.

همانطور که در بهترین روش، Access Token یک توکن کوتاه مدت (1 ساعت) است، در حالی که Refresh Token مربوطه یک توکن طولانی مدت (1 ساله) است که می توانید از ان برای به دست اوردن یک جفت جدید Access Token / Refresh Token پس از انقضای Access Token استفاده کنید. برای به دست اوردن یک جفت جدید Access Token و Refresh Token برای مجوزهای منقضی شده موجود، از "Current Refresh Token" استفاده کنید و نقطه پایانی زیر را با پارامترهای زیر که در زیر توضیح داده شده است، تماس بگیرید.

مجوزServerAuthorizationپایینپوینت: 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 ارائه شده در نقاط عطف ثبت نام Share My Data شما مطابقت دارد.
پارامتر سرایند در قالب زیر خواهد بود:
نام پارام : مجوز
ارزش پارام : پایه "base64encoded string"

یک پاسخ موفق به این شکل خواهد بود:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2"،
"token_type": "حامل"،
"expires_in": 3600،
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298"،
"محدوده": "محدوده = 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؛ فاصلهDuration = 900_3600؛ BlockDuration = روزانه؛ HistoryLength={3P طول تاریخی ثبت شده}؛ AccountCollection ={count of authorized SAs}؛BR={ThirdPartyID}؛ dataCustodianId=PGE"،
"resourceURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test"،
"authorizationuri": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

توجه: به طور مشابه، رمز دسترسی مشتری یک توکن کوتاه مدت (1 ساعت) است در حالی که Refresh Token مربوطه یک توکن با عمر طولانی (1 ساله) است که می توانید از ان برای به دست اوردن یک جفت جدید Client Access Token / Refresh Token پس از انقضای رمز دسترسی مشتری استفاده کنید. برای به دست اوردن یک جفت رمز دسترسی مشتری جدید / تازه کردن توکن، به همان مراحلی که در بالا توضیح داده شد اشاره کنید.

مشتریان می توانند مجوز خود را با انجام کارهای زیر به روز کنند:

• حذف شناسنامه های سرویس از مجوزهای انها
• تمدید تاریخ پایان دوره مجوز
• لغو مجوز

توجه: مشتریان تنها می توانند با ورود به حساب انلاین PG & E خود و پیروی از مراحل مورد نیاز ، مجوزهای خود را تغییر دهند. اگر هر یک از این اقدامات انجام شود، ما از طریق Notification URI که در هنگام ثبت نام ارائه کرده اید، به شما اطلاع خواهیم داد.

گزینه هایی برای مدیریت و مشاهده جزئیات مجوز مشتری شما وجود دارد:

• شما می توانید API مجوز (http GET operation) را با استفاده از client_access_token خود در سطح شخص ثالث (برای جزئیات بیشتر در مورد تمام مجوزها) در https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization یا در سطح مجوز مشتری فردی در https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID} تماس بگیرید.
• به طور جداگانه، شما همچنین می توانید جزئیات مجوز فردی را به صورت دستی با ورود به حساب Share My Data خود از طریق پورتال شخص ثالث و وارد کردن شناسه اشتراک برای مجوزی که جستجو می کنید مشاهده کنید.

اگر دیگر نمی خواهید به داده های مرتبط با مجوز دسترسی پیدا کنید، روش های اختیاری برای لغو مجوز وجود دارد:

• شما می توانید API لغو مجوز (http عملیات DELETE) با استفاده از client_access_token خود را در https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID} تماس بگیرید.
• متناوبا، شما می توانید به صورت دستی لغو مجوز با ورود به حساب به اشتراک گذاری داده های من خود را از طریق پورتال شخص ثالث و وارد کردن شناسه اشتراک برای مجوز شما مایل به لغو.

توجه: به مشتری اطلاع داده می شود که شما تصمیم به لغو مجوز خود گرفته اید. علاوه بر این، هنگامی که مجوز لغو می شود، عمل نمی تواند معکوس شود.

• PG & E اعلان هایی را به URI اطلاع رسانی شما که در هنگام ثبت نام ارائه شده است ارسال می کند. اعلان ها شامل URIs مربوط به داده های از پیش بسته بندی شده اماده برای شما برای بازگشت و درخواست در URL های ارائه شده است. داده ها از پیش بسته بندی شده اند و اطلاعیه ها در دو سناریوی زیر ارسال می شوند: (1) شما در پروفایل ثبت نام خود "Notify me as data is ready" را انتخاب کرده اید، در این صورت ما اخرین داده های روزانه را با هر گونه اصلاح برای تاریخ های گذشته بسته بندی می کنیم یا (2) شما یک درخواست ناهمزمان موقت قبلی را انجام داده اید که داده های درخواست شده اکنون اماده است.
• سناریوی 1 در زیر "دسترسی به داده ها" نشان داده شده است: اشتراک روزانه» بخش نمودارهای روش دسترسی به داده ها در زیر و سناریو 2 در زیر "دسترسی به داده ها" نشان داده شده است: درخواست AD HOC (ASYNCHRONOUS)" بخش از همان نمودار زیر است.

لطفا طول عمر توکن های Access، Access Token Client و توکن های Refresh مربوطه مورد استفاده در درخواست های داده را در نظر داشته باشید. همانطور که در بهترین روش، Access Token یک توکن کوتاه مدت (1 ساعت) است، در حالی که نشانه تجدید یک توکن طولانی مدت (1 ساله) است که می توانید از ان برای به دست اوردن یک جفت جدید Access Token / Refresh Token پس از انقضای Access Token استفاده کنید. به طور مشابه، رمز دسترسی مشتری یک توکن کوتاه مدت (1 ساعت) است، در حالی که Refresh Token مربوطه یک توکن با عمر طولانی (1 ساله) است که می توانید از ان برای به دست اوردن یک جفت جدید Client Access Token / Refresh Token پس از انقضای رمز دسترسی مشتری استفاده کنید. برای جزئیات بیشتر در مورد به دست اوردن یک جفت توکن جدید، به مرحله 3، درخواست یک توکن دسترسی جدید، در زبانه جزئیات مجوز ما مراجعه کنید. به جزئیات مجوز بروید

اگر مشتری مجاز به دریافت "اطلاعات حساب" (کارت شناسایی حساب، کارت شناسایی توافقنامه خدمات و تاریخ شروع خدمات) و / یا "اطلاعات اولیه" (به عنوان مثال نام مشتری و ادرس خدمات) است، می توانید چنین اطلاعات مشتری را از طریق API های تعریف شده ESPI RetailCustomer درخواست کنید که داده ها مطابق با طرحواره، retailCustomer.xsd، ارائه شده در بالا است.

سنکرون (اشخاص ثالث استاندارد و EEF)

یک رویکرد برای درخواست داده های مشتری استفاده از API همزمان برای درخواست اطلاعات مشتری برای یک مجوز مشتری برای داده های مشتری (به عنوان مثال، مشتری خرده فروشی):

مثال URL درخواست همزمان: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID شما در پایان توالی مجوز OAuth برای دریافت یک نشانه دسترسی دریافت کردید. RetailCustomerID بخشی از پارامتر مسیر CustomerResourceUri در پاسخ نشانه است. (RetailCustomerID =SubscriptionID)

HTTP Header = مجوز:Bearer {access token for this authorization}

Response = شما داده ها را به صورت همزمان برای RetailCustomerID دریافت خواهید کرد. داده ها مطابق با retailCustomer.xsd

توجه: API مشتری خرده فروشی همزمان در سطح مشتری خرده فروشی فردی است که مربوط به مجوز مشتری واحد است.

برای مرجع: نمودار سلسله مراتبی زیر سلسله مراتب رابطه برای عناصر داده ESPI در مدل سازی داده های مشتری PG & E را نشان می دهد.

شما همچنین می توانید داده های مشتری را از طریق API ناهمزمان برای درخواست اطلاعات مشتری برای تمام مجوزهای مشتری خود برای داده های مشتری (یعنی مشتریان خرده فروشی) درخواست کنید.

برای پشتیبانی از درخواست های ناهمزمان، درخواست شما باید از اطلاعیه های که ما به شما ارسال می کنیم پشتیبانی کند (همانطور که در URL اطلاع رسانی شما در هنگام ثبت نام ارائه شده است).

مثال ادرس درخواست ناهمگام:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{حجید}

BulkID = BulkID ارائه شده در ApplicationInformation Resource بازیابی شده در طول تست ثبت نام. (BulkID=ClientID)

HTTP Header = Authorization:Bearer {بازیابی رمز دسترسی مشتری در حین تست ثبت نام}

پاسخ = کد وضعیت HTTP 202 (این یک درخواست ناهمزمان است که در ان پاسخ به URL اطلاع رسانی ارسال می شود زمانی که داده ها اماده است). هنگامی که داده ها اماده شدند، ما یک اعلان به URI اطلاع رسانی ارائه شده خود را با یک محموله از URL های برنامه شما می توانید برای دریافت از پیش بسته بندی شده ارسال کنید. اطلاعیه نمونه به نظر می رسد به شرح زیر است

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

Get را در URL بالا با نشانه دسترسی مشتری برای دریافت داده ها انجام دهید.

برای مرجع: نمودار سلسله مراتبی زیر سلسله مراتب رابطه برای عناصر داده ESPI در مدل سازی داده های مشتری PG & E را نشان می دهد.

در نهایت شما می توانید اخرین اطلاعات مشتری را به صورت روزانه با استفاده از مدل اشتراک روزانه (به عنوان مثال، با انتخاب کادر انتخاب "Notify me as data is ready (daily)" در هنگام ثبت نام) دریافت کنید.

برای حمایت از مدل اشتراک روزانه، درخواست شما باید از اطلاعیه های ارسال شده پشتیبانی کند که ما به شما ارسال می کنیم (همانطور که در URL اطلاع رسانی شما در هنگام ثبت نام ارائه شده است).

هنگامی که داده ها اماده شدند، ما یک اعلان به URI اطلاع رسانی ارائه شده خود را با یک محموله از URL های برنامه شما می توانید برای دریافت از پیش بسته بندی شده ارسال کنید. اطلاعیه نمونه به شرح زیر است:

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

Get را در URL بالا با نشانه دسترسی مشتری برای دریافت داده ها انجام دهید.

برای مرجع، نمودار سلسله مراتبی زیر سلسله مراتب رابطه برای عناصر داده ESPI را در مدل سازی داده های مشتری PG & E نشان می دهد.

اگر مشتری شما مجاز به دریافت "اطلاعات استفاده" و / یا "اطلاعات صورتحساب" است، می توانید این داده ها را از طریق API های اشتراکی که داده ها مطابق با طرح، espiDerived.xsd، ارائه شده در بالا درخواست کنید.

درخواست های موقت همزمان (اشخاص ثالث استاندارد و EEF)

برای درخواست داده های تاریخی (برای هر دو داده استفاده فاصله و داده های صورتحساب)، یک رویکرد استفاده از API های همزمان با گنجاندن پارامترهای درخواست تاریخ شروع و پایان مناسب در زمان زولو است.

مثال ادرس درخواست همزمان:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePoint}؟published-min={startDate}&published-max={endDate}

published-min = تاریخ شروع که برای این درخواست برای کشیدن داده ها اعمال می شود. تاریخ در زمان زولو از yyyy-MM-ddTHH است:mm:ssZ (IETC RFC 3339 فرمت)

published-max = تاریخ پایان که برای این درخواست برای کشیدن داده ها اعمال می شود. تاریخ در زمان زولو از yyyy-MM-ddTHH است:mm:ssZ (IETC RFC 3339 فرمت)

توجه: برای درخواست های API که پارامترهای published-max و published-min-date را قبول می کنند، پیش فرض T-1 (تاریخ درخواست منهای 1 روز) است. برای درخواست های خلاصه استفاده (به عنوان مثال، .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary)، ما پیشنهاد می کنیم طیف وسیعی از 30 روز یا بیشتر را برای اطمینان از وجود یک لایحه در دسترس است که با ان دوره همپوشانی دارد، در غیر این صورت هیچ داده ای بازگردانده نخواهد شد.

شناسه اشتراک = SubscriptionID شما در پایان توالی مجوز OAuth برای دریافت یک نشانه دسترسی دریافت کرده اید. شناسه اشتراک بخشی از پارامتر resourceURI در پاسخ نشانه است. (SubscriptionID = RetailCustomerID)

UsagePointID = UsagePoint در زیر شناسه اشتراک بالا. شما می توانید تمام نقاط استفاده برای یک اشتراک داده شده را با فراخوانی URL API زیر و تهیه نشانه دسترسی برای ان اشتراک در هدر مجوز دریافت کنید: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

HTTP Header = مجوز:Bearer {access token for this Subscription}

Response = شما داده ها را به صورت همزمان برای ان نقطه استفاده برای دوره درخواست شده دریافت خواهید کرد. این هر دو داده استفاده فاصله () و داده های صورتحساب () را خواهد داشت.

API های استفاده همزمان (همانطور که توسط ساخت URL نشان داده شده است که با شناسه نقطه استفاده به پایان می رسد) در سطح نقطه استفاده فردی (به عنوان مثال، سطح توافقنامه خدمات) هستند، بنابراین یک برنامه درخواست ها را از طریق هر یک از شناسه های نقطه استفاده متعلق به مجوز مشتری داده شده (به عنوان مثال اشتراک) چرخه می کند.

پاسخ به درخواست های همزمان هر دو داده فاصله (زیر) مربوط به محدوده تاریخ درخواست شده و همچنین هر مجموع استفاده ماهانه و صورتحساب هایی که با محدوده تاریخ درخواست شده (زیر) همپوشانی دارند، باز می گردد.

• IntervalReading شامل فاصله (15 دقیقه / ساعتی) مصرف برق و فاصله (روزانه) داده های مصرف گاز
• خلاصه استفاده شامل مجموع استفاده ماهانه و جزئیات صورتحساب (در صورت مجاز)

در پاسخ شما عناصر داده مربوط به جدول نقشه برداری عنصر داده ESPI ما را پیدا خواهید کرد

برای مرجع، نمودار سلسله مراتبی زیر سلسله مراتب رابطه برای عناصر داده ESPI را در مدل سازی داده های مشتری PG & E نشان می دهد.

در زیر چند توضیح کلیدی در مورد این عناصر داده وجود دارد:

• بلوک فاصله برای 1 روز است
• IntervalReading (زیر بلوک فاصله) شامل مقادیر واقعی 15 دقیقه / ساعت مصرف برق و مقادیر مصرف روزانه گاز است.
• برای مشتریان الکتریکی با تولید در محل (به عنوان مثال خورشیدی)، عنصر flowDirection نشان دهنده داده های استفاده تحویل داده شده (عرضه) و دریافت شده (تولید) است. برای مشتریان با متر پیکربندی شده برای خواندن فقط استفاده خالص (به عنوان مثال هیچ نسل در محل)، عنصر flowDirection نشان می دهد که استفاده از یک مقدار خالص است (تفاوت تحویل منهای دریافت شده):
  • جهت جریان 1 = تحویل (انرژی عرضه شده به مشتری)
  • جهت جریان 19 = دریافت شده (تولید خالص جریان به شبکه PG & E). (توجه داشته باشید، ارزش ها مطلق هستند)
  • جهت جریان 4 = خالص (تحویل منفی - دریافت شده)
• توجه ویژه به قدرت ده ضرب و واحد اندازه گیری (uom) به طوری که برای اطمینان از خواندن استفاده صحیح

اشتراک دسته ای (اشخاص ثالث استاندارد و EEF)

شما همچنین می توانید داده های استفاده را از طریق API ناهمزمان برای تمام نقاط استفاده متعلق به یک مجوز مشتری برای داده های استفاده / صورتحساب (به عنوان مثال اشتراک) درخواست کنید.

برای پشتیبانی از درخواست های ناهمزمان Ad Hoc (به عنوان مثال، برای بیش از یک نقطه استفاده در یک زمان)، درخواست شما باید از اعلان های پستی که ما برای شما ارسال می کنیم پشتیبانی کند (همانطور که در URL اطلاع رسانی شما در هنگام ثبت نام ارائه شده است)

مثال نشانی وب
درخواست ناهمگام https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}؟published-min={startDate}&published-max={endDate}

شناسه اشتراک = شناسه اشتراکی که در انتهای دنباله OAuth دریافت کرده اید تا یک نشانه دسترسی دریافت کنید. شناسه اشتراک بخشی از پارامتر resourceURI در پاسخ توکن است

published-min = تاریخ شروع که برای این درخواست برای کشیدن داده ها اعمال می شود. (RFC 3339 زمان زولو فرمت. yyyy-MM-ddTHH:mm:ssZ)

published-max = تاریخ پایان که برای این درخواست برای کشیدن داده ها اعمال می شود. (RFC 3339 زمان زولو فرمت. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = مجوز:Bearer {access token for this Subscription}

پاسخ = کد وضعیت HTTP 202 (این یک درخواست ناهمزمان است که در ان پاسخ به URL اطلاع رسانی ارسال می شود زمانی که داده ها اماده است)

هنگامی که داده ها اماده شدند، ما یک اعلان به URI اطلاع رسانی ارائه شده خود را با یک محموله از URL های برنامه شما می توانید برای دریافت از پیش بسته بندی شده ارسال کنید. اطلاعیه نمونه به شرح زیر است:

<؟xml version="1.0" encoding="UTF-8"؟>

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

انجام GET در URL بالا با نشانه دسترسی به داده ها. این شامل هر دو داده استفاده فاصله () و همچنین اطلاعات صورتحساب () برای دوره درخواست شده است.

اشتراک دسته ای (اشخاص ثالث استاندارد و EEF)
شما همچنین می توانید اطلاعات استفاده و صورتحساب را از طریق API ناهمزمان فله ای برای تمام مجوزهای مشتری خود برای استفاده / داده های صورتحساب (به عنوان مثال اشتراک) درخواست کنید.

به عنوان مثال دسته ای انبوه درخواست URL
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}؟published-min={startDate}&publishedmax={endDate}

BulkID = BulkID ارائه شده در ApplicationInformation Resource بازیابی شده در طول تست ثبت نام. (BulkID=ClientID)

published-min = تاریخ شروع که برای این درخواست برای کشیدن داده ها اعمال می شود. (RFC 3339 زمان زولو فرمت. yyyy-MM-ddTHH:mm:ssZ)

published-max = تاریخ پایان که برای این درخواست برای کشیدن داده ها اعمال می شود. (RFC 3339 زمان زولو فرمت. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = مجوز:Bearer {نشانه دسترسی مشتری}

پاسخ = کد وضعیت HTTP 202 (این یک درخواست ناهمزمان است که در ان پاسخ به URL اطلاع رسانی ارسال می شود زمانی که داده ها اماده است)

هنگامی که داده ها اماده شدند، ما یک اعلان به URI اطلاع رسانی ارائه شده خود را با یک محموله از URL های برنامه شما می توانید برای دریافت از پیش بسته بندی شده ارسال کنید. اطلاعیه نمونه به شرح زیر است:

<؟xml version="1.0" encoding="UTF-8"؟>

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

انجام GET در URL بالا با نشانه دسترسی به داده ها. این شامل هر دو داده استفاده فاصله () و همچنین اطلاعات صورتحساب () برای دوره درخواست شده است.

در نهایت شما می توانید اخرین اطلاعات استفاده و صورتحساب از جمله اصلاحات برای تاریخ های گذشته در دوره های مجوز مشتری را به صورت روزانه با استفاده از مدل اشتراک روزانه (به عنوان مثال، با انتخاب کادر انتخاب "Notify me as data is ready (daily)" در هنگام ثبت نام) دریافت کنید.

برای حمایت از مدل اشتراک روزانه، درخواست شما باید از اطلاعیه های ارسال شده پشتیبانی کند که ما به شما ارسال می کنیم (همانطور که در URL اطلاع رسانی شما در هنگام ثبت نام ارائه شده است).

هنگامی که داده ها اماده شدند، ما یک اعلان به URI اطلاع رسانی ارائه شده خود را با یک محموله از URL های برنامه شما می توانید برای دریافت از پیش بسته بندی شده ارسال کنید. اطلاعیه نمونه به شرح زیر است:

<؟xml version="1.0" encoding="UTF-8"؟>

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

انجام GET در URL بالا با نشانه دسترسی به داده ها. این شامل هر دو داده استفاده فاصله () و همچنین اطلاعات صورتحساب () برای دوره درخواست شده است.

مارس 20، 2023

چه خبر:

1. انتشار یک API جدید کد پاسخ HTTP (204) برای هر دو API همزمان و ناهمزمان برای نشان دادن زمانی که هیچ داده ای برای محدوده درخواست شده در دسترس نیست.
2. پشتیبانی از برچسب هدر x-transaction که از توانایی پیوند دادن پاسخ PG & E به API های خاص Asynchronous پشتیبانی می کند، با بازگرداندن این مقدار همراه با یک شناسه همبستگی زمانی که فایل درخواست شده اماده است.
3. بهبود دانه دانه داده های اضافی به API UsagePoint / MeterReadingID با ارائه داده های فاصله الکتریکی برای متر چندگانه به سناریوهای توافقنامه خدمات تک.
4. وضوح بیشتر به مقادیر شاخص کیفیت خواندن برای داده های فاصله تخمین زده شده برای توصیف نوع براورد مورد استفاده برای ان فاصله ارائه شده است. مقادیر جدید نشان می دهد منطق براورد شده است اعمال شده است زیر:
   
   

5. RQI ارزش و توضیحات

   0 - معتبر: داده هایی که از طریق تمام چک های اعتبار سنجی مورد نیاز رفته اند و یا همه انها را منتقل کرده اند یا تایید شده اند

   7 - به صورت دستی ویرایش شده: جایگزین یا تایید شده توسط یک انسان

   8 - براورد با استفاده از روز مرجع: مقدار داده ها با یک ماشین محاسبه شده بر اساس تجزیه و تحلیل داده های تاریخی با استفاده از همان نوع اندازه گیری جایگزین شد

   9 - براورد با استفاده از درون یابی خطی: مقدار داده ها با استفاده از درون یابی خطی بر اساس خوانش های قبل و بعد از ان محاسبه شد.

   10 - مشکوک: داده هایی که یک یا چند چک را شکست داده اند

   11 - مشتق شده: داده هایی که محاسبه شده اند (با استفاده از منطق یا عملیات ریاضی)، لزوما به طور مستقیم اندازه گیری نمی شوند

   12 - پیش بینی شده (پیش بینی): داده هایی که به عنوان پیش بینی یا پیش بینی خواندن اینده محاسبه شده است

   13 - مخلوط: نشان می دهد که کیفیت این خواندن دارای ویژگی های مخلوط است

   14 - Raw: داده هایی که از طریق فرایند اعتبار سنجی، ویرایش و براورد انجام نشده است. توجه داشته باشید شاخص MV90 Meters RQI به عنوان وضعیت نهایی RQ در 14 باقی خواهد ماند

   15 - عادی برای اب و هوا: مقادیر تنظیم شده اند به حساب اب و هوا، برای مقایسه استفاده در اب و هوای مختلف

   16 - دیگر: مشخص می کند که یک ویژگی غیر از انچه تعریف شده است اعمال می شود

   17 - معتبر: داده هایی که تایید شده و احتمالا ویرایش شده و / یا براورد شده مطابق با روش های تایید شده

   18 - تایید شده: داده هایی که حداقل یکی از بررسی های اعتبار سنجی مورد نیاز را انجام نداده اند، اما مشخص شده است که استفاده واقعی را نشان می دهد

   19 - کیفیت درامد: معتبر و قابل قبول برای اهداف صدور صورت صورتحساب [گسترش احتمالی استاندارد ESPI و نه بخشی از ESPI اصلی]

    

6. معیارهای استفاده از API فروشنده را در پورتال فروشنده شخص ثالث Share My Data منتشر کنید.

نوامبر 15، 15، 15، 15، 15، 25، 2018، 201

چه خبر:

1. شاخص کلاس مشتری اضافه شده است. هر SAID که مجاز است به عنوان RES، AGR، COM / IND یا Other شناسایی خواهد شد.
2. API های صورتحساب و استفاده برای پذیرش پارامترهای پرس و جو به روز شده حداکثر و به روز شده (به عنوان جایگزینی برای published-min و published-max) به روز می شوند. داده های بازگردانده شده تمام تغییراتی است که در پارامترهای به روز شده حداکثر و به روز شده حداقل رخ داده است.
3. جایگزینی استفاده از Bulk ID 5 رقمی شخص ثالث با شناسه مشتری شخص ثالث برای جریان مجوز انلاین.
4. ارائه گزینه ای برای شخص ثالث برای هدایت مشتریان به ورود به حساب PG & E یا برگه دسترسی مهمان به عنوان بخشی از جریان مجوز انلاین.
5. بهبود داشبورد مشتری PG & E برای به اشتراک گذاشتن داده های من برای مشتریان اسان تر می شود تا تمام مجوزهای به اشتراک گذاری داده های موجود خود را با اشخاص ثالث مشاهده کنند.

در ماه سپتامبر 25، 27، 27، 27، 27، 27، 27، 27،

چه خبر:

PG & E عناصر داده های جدید را به مجموعه داده های قانون 24 به عنوان بخشی از پروژه مجموعه داده های گسترده PG & E (EDS) اضافه کرد و عناصر داده های جدید مربوطه در مجموعه داده های قانون 25 معرفی شده است. عناصر داده خاص شامل مجموعه داده های قانون 25 گسترش یافته PG & E در زیر با تعیین EDS بیان شده است:

قانون 25 عناصر داده

یادداشت
عناصر
حساب نام
کاربری ادرس
حساب شناسه
حساب گردآورندگان: بلوک
قطع عناصر
خدمات PG & E UUID
شناسه
خدمات تغییرات اینده در وضعیت خدمات
وضعیت
SA تاریخ
شروع خدمات ادرس
خدمات تعرفه
خدمات فعلی تعرفه
خدمات صورتحساب تاریخی گزینه های تعرفه (پایه پزشکی، CARE، FERA، TBS، CCA_TBS، انتخاب
خورشیدی ولتاژ خدمات فعلی و کالا تاریخی ولتاژ
خدمات صورتحساب شماره
سرویس متر تعداد خدمات متر
نوع
متر متر فعلی چرخه
خواندن تاریخی متر صورتحساب چرخه
خواندن گزینه فعلی نرخ اماده به کار اگر شاخص
تولید در محل گزینه
نرخ اماده به کار صورتحساب تاریخی EDS: شاخص
کلاس مشتری عناصر
حسابداری تاریخی تاریخ
شروع لایحه تاریخ
پایان بیل کل هزینه های صورتحساب ($)
بیل کل کیلووات ساعت
EDS: نام ارائه دهنده
خدمات شکست تاریخی بیل ردیف (در صورت وجود)
EDS: خط مورد بیل دوره
EDS: نام (بیش از پایه 1٪ -30٪)
EDS: جلد (1234.2)
EDS: نرخ ($ 0.032 / کیلووات ساعت)
EDS: هزینه (100.23 دلار)
لایحه تاریخی شکست کیلووات ساعت TOU (به جز ABS-TX صورتحساب)
EDS: خط مورد بیل دوره (برای شکست TOU)
EDS: نام (از شارژ TOU)
EDS: جلد (1234.2)
EDS: نرخ ($ 0.032 / کیلووات ساعت)
EDS: هزینه (100.23 دلار)
شکست
تقاضای لایحه تاریخی EDS: دوره لایحه مورد خط (برای تفکیک تقاضا)
EDS: نام
EDS: جلد (1234.2)
EDS: نرخ ($ 0.032 / کیلووات ساعت)
EDS: هزینه (100.23 دلار)
اقلام تاریخی بیل خط
EDS: خط مورد بیل دوره
EDS: نام شارژ (DWR باند شارژ)
EDS: جلد (1234.2)
EDS: واحد (کیلووات ساعت)
EDS: نرخ ($ 0.032 / کیلووات ساعت)
EDS: هزینه (100.23 دلار)
فواصل
استفاده تاریخی اغاز
استفاده فاصله مدت زمان فاصلۀ پیشفرض) به ثانیه (
دوره استفاده فاصله (1234.2)
واحد (کیلووات ساعت / ترم)
برنامه های
پاسخگویی به تقاضا (دکتر) نام
برنامه اولین تاریخ فسخ بدون تعهد
مالی اولین تاریخ فسخ بدون در نظر گرفتن تعهد
مالی وضعیت
برنامه DR تاریخ
ثبت نام برنامه DR تاریخ ثبت نام
برنامه DR عناصر
داده کالا
پارامترهای زمان محلی (جزئیات DST)
کیفیت
داده پیشفرض جهت
انرژی قدرت ده چند برابر (برای مقادیر استفاده فاصله)
قدرت ده چند برابر (برای تقاضای صورتحساب)
قدرت ده چند برابر (برای استفاده کل صورتحساب)
طول فاصله (خواندن استفاده)
واحد پول قبض کل هزینه
شاخص های TOU فاصله الکتریکی

ژوئن 28، 2018

به عنوان بخشی از پروژه Click-Through و پیشرفت های مداوم در پلت فرم به اشتراک گذاری داده های من، PG & E فاز 2 Click-Through را در تاریخ 28 ژوئن 2018 راه اندازی کرد.

چه خبر:

مهمترین تغییراتی که بر اشخاص ثالث تاثیر می گذارند، تغییراتی است که مطابق با پروتکل OAuth 2.0 است (PG & E سری اولیه ریدایرکت ها را حذف کرد). جزئیات زیر را پیدا کنید.

مهم: اشخاص ثالث ملزم به ایجاد تغییرات در اجرای OAuth موجود خود هستند. تغییرات فاز 2 کلیک PG & E با عقب سازگار نیستند، بنابراین لازم است اشخاص ثالث تغییرات را همزمان با اجرای PG & E انجام دهند. بدون پیاده سازی، فرایند مجوز مشتری فعلی کار بر روی تاریخ قطع 29 ژوئن 2018 متوقف خواهد شد. با این حال، مجوزهای موجود تحت تاثیر قرار نمی گیرند.

1. برای مطابقت با پروتکل OAuth 2.0، PG & E تعداد مراحل تغییر مسیر را برای مجوز کاهش داده است. تغییر مسیر اولیه به PG & E برای مشتریان برای ورود به سیستم و ارائه مجوز با درخواست کد مجوز به شرح زیر ترکیب شده است:
   • همانطور که در مثال زیر نشان داده شده است، درخواست های کد مجوز شخص ثالث در حال حاضر شامل تغییر مسیر مرورگر مشتری به مجوز جدید PG & EServerAuthorizationEndpoint URI همراه با پارامترهای درخواست مناسب است:
     دریافت https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={optionalState}
   • نقطه پایانی زیر بازنشسته شده است: https://api.pge.com/datacustodian/oauth/v2/authorize ...
     
2. پیام های خطای جدید برای درخواست های کد مجوز با پارامترهای محدوده از دست رفته یا نامعتبر به شرح زیر است:
   • اگر پارامترهای client_id یا redirect_uri مورد نیاز وجود نداشته باشد یا نامعتبر باشد، یک خطای (http 400) با پیام توضیحی به مشتری نشان داده می شود.
   • اگر پارامتر response_type مورد نیاز وجود نداشته باشد یا نامعتبر باشد، مشتری با پارامتر خطای "invalid_request" (اضافه شده به redirect_uri) به redirect_uri شخص ثالث هدایت می شود.
     
3. برای مشتریان با مجوز انلاین موجود، توانایی شخص ثالث برای درخواست یک جفت access_token / refresh_token جدید به عنوان بخشی از مجوز جدید که جایگزین مجوز موجود (به عنوان مثال، مجوز انلاین همان شخص ثالث و ترکیب مشتری). این قابلیت به سناریوهای اشخاص ثالث از دست دادن یک جفت access_token / refresh_token یا در غیر این صورت نیاز به تغییر دامنه مجوز اصلی در تایید مشتری می پردازد.
   • برای درخواست مجوز مجدد، مشتری صفحه مجوز جدید را به جای صفحه "مدیریت مجوز" می بیند، زمانی که توسط شخص ثالث برای مجوز به PG & E هدایت می شود.
   • پس از مجوز مشتری، اشخاص ثالث یک اعلان به URL اطلاع رسانی ثبت شده خود دریافت می کنند که شناسه اشتراک قدیمی لغو می شود (اطلاع رسانی شامل مجوز API URL endpoint برای شناسه اشتراک قدیمی است)
     
4. توانایی مشتری برای خروج از طریق دکمه "لغو" در صفحه احراز هویت یا صفحه مجوز با تغییر مسیر به redirect_uri شخص ثالث با پارامتر خطای "access_denied" (اضافه شده به redirect_uri)
5. برای اشخاص ثالث که با تنظیمات "دید" ثبت نام می کنند و بنابراین در لیست اشخاص ثالث ثبت نام می کنند، مشتریان می بینند که چه زمانی به حساب انلاین PG & E خود می روند و به صفحه فرود Share My Data می روند:
   • برای مشتریانی که به حساب انلاین PG & E خود وارد می شوند و به صفحه فرود Share My Data می روند و پس از انتخاب شخص ثالث از لیست اشخاص ثالث ثبت شده ، به "پورتال شخص ثالث URI" ثبت شده شخص ثالث هدایت می شوند. در این مرحله، مشتریان می توانند فرایند OAuth را اغاز کنند. هنگام رفتن از طریق این مسیر، مشتریان دیگر صفحه مجوز را پس از انتخاب شخص ثالث از لیست کشویی اشخاص ثالث نشان نمی دهند، بلکه به شخص ثالث ثبت شده "پورتال شخص ثالث URI" هدایت می شوند که در ان می توانند فرایند OAuth را اغاز کنند.
   • نکته: برخی از اشخاص ثالث در مورد چگونگی ساده سازی تجربه مشتری برای این مورد استفاده (به عنوان مثال، مجوزهای اغاز شده در سایت PG & E) به طوری که به مشتری به نظر می رسد انها به طور مستقیم به یک صفحه مجوز پس از انتخاب شخص ثالث از کشویی گرفته شده است. برای تسهیل چنین تجربه مشتری، اشخاص ثالث می توانند "پورتال شخص ثالث URI" خود را (از طریق صفحه ثبت نام مدیریت Share My Data) به یک نقطه پایانی تنظیم کنند که به طور خودکار مشتری را به عنوان بخشی از درخواست کد مجوز به PG & E هدایت می کند. پس از هدایت خودکار به مجوز PG & EServerAuthorizationEndpoint، مشتری صفحه ورود مشتری را رد می کند (زیرا انها قبلا وارد سیستم شده اند) و به طور مستقیم به صفحه مجوز می رود. برای برخی از اشخاص ثالث که قبل از انتشار Share My Data Click Thru 2.0 ثبت نام کرده اند، این را می توان به سادگی با تعریف پورتال شخص ثالث URI انجام داد تا با URI "صفحه انتخاب دامنه شخص ثالث" (فیلد ثبت نام SMD قدیمی که در نسخه اینده بازنشسته می شود) برابر باشد.
     در مقابل، برخی از اشخاص ثالث ممکن است بخواهند به جای ان ابتدا مشتریان را درگیر کنند و مشتریان را در کنار خود قرار دهند، زمانی که مشتریان قبل از درخواست کد مجوز به URI "پورتال شخص ثالث" هدایت می شوند، بنابراین رویکرد فوق فقط یک پیشنهاد است.
     
6. SMD در حال حاضر جزئیات پارامتر Scope را به عنوان بخشی از پاسخ به درخواست کد مجوز، درخواست رمز دسترسی و API مجوز ارائه می دهد. پارامتر دامنه پیشرفته اجازه می دهد تا برای برقراری ارتباط دامنه نهایی مجوز مشتری. به طور خاص، پارامتر دامنه شامل یک مقدار "AdditionalScope" است که به انتخاب مجوز مشتری پشتیبانی شده توسط PG & E از گروه های داده (به عنوان مثال "استفاده"، "صورتحساب"، "پایه"، "حساب"، "ثبت نام برنامه"). مقادیر پارامتر دامنه بیشتر در اسناد زیر گرفته شده است: دانلود تابع پشتیبانی بلوک محدوده رشته نقشه برداری کلیک کنید از طریق 2.0 (PDF)
   
   یک مثال پاسخ Token در زیر برخی از مقادیر پارامتر دامنه ممکن را نشان می دهد.
   • پاسخ توکن مثال:
     < پاسخ 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؛ فاصلهDuration = 900_3600؛ BlockDuration = روزانه؛ HistoryLength={3P طول تاریخی ثبت شده}؛ AccountCollection ={count of authorized SAs}؛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/RetailCustomerID}
     بر
     < / پاسخ>
     
     
7. اشخاص ثالث اکنون می توانند برای دریافت اطلاعات ثبت نام برنامه مجاز از طریق گروه داده جدید "ثبت نام برنامه" ثبت نام کنند. هر دو فاصله اندازه گیری و همچنین مشتریان اندازه گیری غیر فاصله واجد شرایط برای اجازه به اشتراک گذاری داده ها برای 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 (تعرفه خدمات صورتحساب از جمله گزینه نرخ اماده به کار در صورت وجود)
   • نوع خواندن
     • کالا (شامل سطح ولتاژ فعلی برای برق و پیشوند برای گزینه نرخ اماده به کار که در ان قابل اجرا است)
   • حساب مشتری
     • (ادرس صورتحساب ACCT):
     • اصلیAddress / streetDetail...
     • mainAddress/townDetail...
     • ادرس اصلی/ کد پستی...
   • توافقنامه مشتری
     • status\value (وضعیت SA)
   • برنامه پاسخگویی به تقاضا
     • برنامهName
     • ثبت نام
     • برنامهDate/programDate
     • برنامهDate/programDateDescription
   • کنتور
     • شماره سریال (شناسه متر)
     • نوع (نوع متر)
     • (فعلی) فاصله طول
   • اخرین تعاریف طرحواره ای ESPI xml (XSDs) که برای این عنصر داده جدید استفاده می شود در موارد زیر مشخص شده است:
     دانلود XSDs (ZIP، 49 KB)ZIP. در پنجره جدید باز می شود.
     توجه: XSD ها سازگار با عقب هستند.
   • اشخاص ثالث می توانند ثبت نام خود را تغییر دهند تا مشتریان بتوانند این گروه داده را در طول زمان مجوز از طریق پورتال شخص ثالث تحت مدیریت بخش ثبت نام >Edit > انتخاب کنند: اطلاعات مشتری مورد نیاز خود را نشان دهید"، جعبه بررسی ثبت نام برنامه را انتخاب کنید.
   • توجه: این فقط برای مجوزهای جدید مشتری اعمال می شود.
     
   • API های جدید برای بازیابی اطلاعات ثبت نام DR در سطح فله 3rd party و همچنین در سطح مجوز مشتری فردی (سطح RetailCustomerID) در دسترس است که به شرح زیر است:
     دانلود API های پشتیبانی شده جدید PGE (PDF)
   • API ناهمزمان برای درخواست DR اطلاعات ثبت نام برای تمام مجوزها به شخص ثالث
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • API همزمان برای درخواست اطلاعات ثبت نام DR در سطح مجوز مشتری فردی
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

لطفاً توجه کنید: علاوه بر تغییرات در فرایند مجوز مشتری، تغییرات دیگر نیز سازگار با عقب هستند و پیشرفت های داوطلبانه ای هستند که اشخاص ثالث می توانند برای حمایت از انها انتخاب کنند.

اگر شما هر گونه سوال و یا نیاز به پشتیبانی اضافی، احساس رایگان به ایمیل sharemydata@pge.com.

چه خبر:

1. مشتریان اکنون می توانند از فرایند ساده مجوز کلیک از طریق بهره مند شوند.
   • ما جزئیات مربوط به اینکه چگونه یک مشتری اکنون می تواند داده ها را با شرکت شما به اشتراک بگذارد، به روز کرده ایم.
     یاد بگیرید چگونه مشتریان داده ها را با یک شرکت
     
     به اشتراک می گذارند توجه داشته باشید: این تغییرات، به ویژه بهبود UI مجوز ما، برای دستگاه های تلفن همراه (به عنوان مثال تلفن یا تبلت) بهینه شده است.
   • تغییراتی در فرایند مدیریت مجوز در دسترس مشتریان از طریق حساب انلاین PG & E انجام شده است:
     • مشتری هنوز هم می تواند SAIDs را از یک مجوز موجود حذف کند، تاریخ پایان مجوز را تمدید کند و / یا مجوز را در هر زمان لغو کند. با این حال، برای اضافه کردن SAIDs اضافی و / یا تغییر عناصر داده مجاز، مجوز موجود باید لغو شود و مجوز جدید باید ایجاد شود.
2. در صورت تمایل، اشخاص ثالث اکنون می توانند از این API برای لغو مجوزهای فردی مشتری با استفاده از توکن دسترسی مشتری شخص ثالث خود (ارائه شده در طول فرایند ثبت نام شخص ثالث SMD اولیه) از طریق عملیات DELETE استفاده کنند: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   نکته 1: برای پیاده سازی PG & E، پارامتر AuthorizationID همان مقدار SubscriptionID است.
   
   یاداوری 2: API جدید به اشخاص ثالث امکان لغو (لغو) مجوز را می دهد. با این حال، تنها مشتریان خود می توانند SA IDs را حذف کنند و / یا تاریخ پایان مجوز را از طریق صفحات مجوز مدیریت SMD ما به روز کنند.
   
   یاداوری: مانند تمام درخواست های داده API، اشخاص ثالث ابتدا باید یک جفت توکن جدید (دسترسی مشتری + تازه کردن توکن) را با استفاده از اخرین توکن های تازه خود درخواست کنند.
   
   یاداوری دوره های انقضای توکن:
   • رمز دسترسی: 1 ساعت
   • رمز دسترسی مشتری: 5 دقیقه
   • نشانه های بازخوانی مربوطه: 1 سال
3. اشخاص ثالث اکنون می توانند چندین ثبت نام به اشتراک گذاری داده های من (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 (زیپ)

دسامبر 20، 2015

تغییرات مورد نیاز: به روز رسانی SMD 2.0 زیر نیاز به تغییرات در بخشی از اشخاص ثالث دارد.

1. با توجه به اشخاص ثالث با پیاده سازی GBCMD (دکمه سبز اتصال داده های من) در چندین ابزار علاوه بر PG & E، ما داده هایCustodianID (به عنوان مثال، dataCustodianID = PGE) را در هدایت به thirdPartyScopeSelectionScreenURI در طول توالی مجوز OAuth منتقل خواهیم کرد.
2. درخواست های API که پارامترهای تاریخ را قبول می کنند (به عنوان مثال، درخواست دسته ای)، باید از پارامترهای داده زولو (به عنوان مثال، منتشر شده حداکثر / منتشر شده دقیقه) استفاده کنند. سایر فرمت های تاریخ برای پارامترهای تاریخ در درخواست های API پشتیبانی نخواهند شد.
   • API هایی که پارامترهای تاریخ را می پذیرند، در API های متصل و پشتیبانی شده مستند شده اند.xlsx
3. شاخص های TOU فاصله ای همراه با داده های استفاده الکتریکی اندازه گیری شده فاصله (همانطور که قابل اجرا است، شاخص انچه که دوره TOU هر فاصله مربوط به)
   • لطفا به نقشه برداری های استاتیک Program ID مراجعه کنید که جزئیات هر شمارش TOU فاصله ای را نشان می دهد (به عنوان مثال، 1 = Summer Peak و غیره). (نگاه کنید به ضمیمه، عناصر داده پشتیبانی شده.xlsx)
4. client_id همانطور که در داده ها یافت می شودCustodianScopeSelectionScreenURI (مورد استفاده برای شخص ثالث OAuth اغاز شده) و ارائه شده در درخواست شخص ثالث منابع اطلاعات برنامه در طول تست ثبت نام به 5 رقم به روز می شود اگر قبلا نباشد (به عنوان مثال، اضافه کردن صفرهای پیشرو و غیره). علاوه بر این، URL دیگر شامل "&verified=true" در پایان نیست. اشخاص ثالث باید URL های خود را مطابق با ان به روز کنند.
   • برای توضیح دقیق، داده هاCustodianScopeSelectionScreenURI به نظر می رسد به شرح زیر است: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX clientID است)
   • بنابراین یک clientID فعلی 123 به چیزی شبیه به 00123 تغییر خواهد کرد به این معنی که داده های جدید خود راCustodianScopeSelectionScreenURI به شرح زیر خواهد بود:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (URL قدیمی به شرح زیر است: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. اشخاص ثالث ثبت شده به عنوان "ESP" یا "ارائه دهنده خدمات انرژی" در حال تغییر به نوع کاربر استاندارد هستند. هیچ تغییری از نظر عملکردی وجود ندارد، فقط در عنوان نوع کاربر. تمایز نوع کاربر ESP (از نوع کاربر استاندارد) یک تمایز غیر ضروری است که باعث سردرگمی در طول فرایند ثبت نام بدون ارائه هیچ گونه عملکرد متمایز می شود، از این رو بازنشسته می شود.

پیشرفت های اختیاری: تغییرات زیر با عقب سازگار هستند و پیشرفت های داوطلبانه ای هستند که اشخاص ثالث می توانند برای حمایت از انها انتخاب کنند.

1. اشخاص ثالث توانایی تغییر / به روز رسانی گواهینامه های SSL خود را که در ابتدا در هنگام ثبت نام ارائه شده اند (به عنوان مثال، زمانی که گواهی نزدیک به انقضا) از طریق پورتال شخص ثالث تحت مدیریت ثبت نام >Edit > بخش جدید: SSL اطلاعات گواهی (گزینه به روز رسانی).
2. اشخاص ثالث می توانند برای دریافت اطلاعات صورتحساب پایه مجاز، اطلاعات مشتری و داده های گاز ثبت نام کنند.  هر دو فاصله اندازه گیری و همچنین مشتریان اندازه گیری غیر فاصله واجد شرایط برای اجازه به اشتراک گذاری داده ها برای SMD 2.0 خواهد بود. خلاصه سطح بالایی از عناصر داده تازه در دسترس به شرح زیر است:
   • اطلاعات صورتحساب: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • برنامه نرخ، کل صورتحساب $، استفاده ردیف (به عنوان قابل اجرا)، تقاضا (به عنوان قابل اجرا)، مجموع TOU (به عنوان قابل اجرا)
     • نکته: برای مشتریان مجاز بدون فاصله اندازه گیری، اشخاص ثالث فقط کل استفاده صورتحساب (به عنوان مثال، در خلاصه استفاده) را دریافت می کنند و هیچ فاصله ای از استفاده خوانده نمی شود (به عنوان مثال، خواندن ساعتی / روزانه به عنوان انها در دسترس نیست)
   • اطلاعات مشتری: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • در حال حاضر در حال حاضر.
   • داده های استفاده از گاز فاصله: (فقط SAs گاز اندازه گیری شده)
     • فاصله (به عنوان مثال، روزانه) گاز خوانده می شود
   • عناصر داده های جدید به عنوان عناصر داده متصل و پشتیبانی شده نمودار می شوند.xlsx
   • سلسله مراتب داده های رابطه ای مرتبط در مدل داده PGE ESPI متصل شده است.xlsx
   • اخرین تعاریف طرح واره XML ESPI (XSDs) که برای این عناصر داده جدید استفاده می شود در XSD های پیوست شده است. توجه: XSDs سازگار با عقب هستند:
     • espiDerived.xsd (فاصله استفاده و اطلاعات صورتحساب)
     • retailcustomer.xsd (اطلاعات مشتری)

اگر شما هر گونه سوال و یا نیاز به پشتیبانی اضافی، لطفا احساس رایگان برای تماس با ما در ShareMyData@pge.com.

دسامبر 18، 2015
 

تغییرات مورد نیاز: به روز رسانی های SMD 2.0 زیر نیاز به تغییرات در بخشی از کاربران دسترسی به داده های خود دارند:

1. درخواست های API که پارامترهای تاریخ را قبول می کنند (به عنوان مثال، درخواست دسته ای)، باید از پارامترهای داده زولو (به عنوان مثال، منتشر شده حداکثر / منتشر شده دقیقه) استفاده کنند. سایر فرمت های تاریخ برای پارامترهای تاریخ در درخواست های API پشتیبانی نخواهند شد.
   • API هایی که پارامترهای تاریخ را می پذیرند، در API های متصل و پشتیبانی شده مستند شده اند.xlsx
2. شاخص های زمان استفاده فاصله (TOU) همراه با داده های مصرف الکتریکی اندازه گیری شده فاصله (در صورت لزوم، شاخص انچه که دوره TOU هر فاصله مربوط به)
   • لطفا به نقشه برداری های استاتیک Program ID مراجعه کنید که جزئیات هر شمارش TOU فاصله ای را نشان می دهد (به عنوان مثال، 1 = Summer Peak و غیره). (نگاه کنید به ضمیمه، عناصر داده پشتیبانی شده.xlsx)

پیشرفت های اختیاری: تغییرات زیر با عقب سازگار هستند و پیشرفت های داوطلبانه ای هستند که اشخاص ثالث می توانند برای حمایت از انها انتخاب کنند.

1. کاربران خود دسترسی به توانایی به طور خودکار تغییر / به روز رسانی گواهینامه SSL خود را که در اصل در طول ثبت نام ارائه شده (به عنوان مثال، زمانی که گواهی نزدیک به انقضا) از طریق پورتال شخص ثالث تحت مدیریت ثبت نام > ویرایش > بخش جدید: اطلاعات گواهی SSL (گزینه بروزرسانی)
2. ثبت نام کاربران خود دسترسی به روز خواهد شد تا شامل اطلاعات صدور صورت حساب اساسی مجاز، اطلاعات مشتری و داده های گاز باشد. هر دو توافقنامه خدمات اندازه گیری شده و غیر فاصله ای واجد شرایط مجوز (خود) برای SMD 2.0 خواهند بود خلاصه ای از عناصر داده جدید موجود به شرح زیر است:
   • اطلاعات صورتحساب: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • برنامه نرخ، کل صورتحساب $، استفاده ردیف (به عنوان قابل اجرا)، تقاضا (به عنوان قابل اجرا)، مجموع TOU (به عنوان قابل اجرا)
     • نکته: برای مشتریان مجاز بدون فاصله اندازه گیری، اشخاص ثالث فقط کل استفاده صورتحساب (به عنوان مثال، در خلاصه استفاده) را دریافت می کنند و هیچ فاصله ای از استفاده خوانده نمی شود (به عنوان مثال، خواندن ساعتی / روزانه به عنوان انها در دسترس نیست)
   • اطلاعات مشتری: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • در حال حاضر در حال حاضر.
   • داده های استفاده از گاز فاصله: (فقط SAs گاز اندازه گیری شده)
     • فاصله (به عنوان مثال، روزانه) گاز خوانده می شود
   • عناصر داده های جدید به عنوان عناصر داده متصل و پشتیبانی شده نمودار می شوند.xlsx
   • سلسله مراتب داده های رابطه ای مرتبط در مدل داده PGE ESPI متصل شده است.xlsx
   • اخرین تعاریف طرح واره XML ESPI (XSDs) که برای این عناصر داده جدید استفاده می شود در XSD های پیوست شده است. توجه: XSDs سازگار با عقب هستند:
     • espiDerived.xsd (فاصله استفاده و اطلاعات صورتحساب)
     • retailcustomer.xsd (اطلاعات مشتری)

اگر شما هر گونه سوال و یا نیاز به پشتیبانی اضافی، لطفا احساس رایگان برای تماس با ما در ShareMyData@pge.com.

دسامبر 18، 2015
 

تغییرات مورد نیاز: به روز رسانی SMD 2.0 زیر نیاز به تغییرات در بخشی از پیاده سازی CCA دارد.

1. درخواست های موقت (به عنوان مثال، برای داده های تاریخی)، باید با استفاده از پارامترهای تاریخ زمان زولو انجام شود. سایر فرمت های تاریخ برای پارامترهای تاریخ در درخواست های API پشتیبانی نخواهند شد.
2. خوراک استفاده روزانه شامل اطلاعات صورتحساب اساسی خواهد بود در حالی که خوراک مشتری روزانه شامل اطلاعات مشتری اضافی خواهد بود. این داده های جدید هم برای مشتریان اندازه گیری شده با فاصله ای که در حال حاضر داده ها را دریافت می کنند و هم برای مشتریان اندازه گیری شده بدون فاصله در قلمرو خود که در حال حاضر داده ها را دریافت نمی کنند، ارائه می شود. در نهایت، مقادیر استفاده فاصله ای ارائه شده در خوراک استفاده فله روزانه شامل شاخص های TOU فاصله ای است که در ان قابل اجرا است. خلاصه سطح بالایی از عناصر داده جدید به شرح زیر است:
   • اطلاعات صورتحساب: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • برنامه نرخ، کل صورتحساب $، استفاده ردیف (به عنوان قابل اجرا)، تقاضا (به عنوان قابل اجرا)، مجموع TOU (به عنوان قابل اجرا)
   • (اضافی) اطلاعات مشتری: (برای هر دو فاصله و غیر فاصله اندازه گیری SAs)
     • نام خود را به عنوان نام نام خود را به عنوان نام خود را که نام خود را
   • شاخص های TOU فاصله ای همراه با داده های استفاده الکتریکی اندازه گیری شده فاصله (همانطور که قابل اجرا است، شاخص انچه که دوره TOU هر فاصله مربوط به)
     • لطفا به نقشه برداری های استاتیک Program ID مراجعه کنید که جزئیات هر شمارش TOU فاصله ای را نشان می دهد (به عنوان مثال، 1 = Summer Peak و غیره). (نگاه کنید به ضمیمه، عناصر داده پشتیبانی شده.xlsx)
   • اخرین تعاریف طرح واره XML ESPI (XSDs) که برای این عناصر داده جدید استفاده می شود در XSD های پیوست شده است. توجه داشته باشید، XSDs به عقب سازگار هستند:
     • espiDerived.xsd (فاصله استفاده و اطلاعات صورتحساب)
     • retailcustomer.xsd (اطلاعات مشتری)
   • عناصر داده های جدید به عنوان عناصر داده متصل و پشتیبانی شده نمودار می شوند.xlsx
   • سلسله مراتب داده های رابطه ای مرتبط در مدل داده PGE ESPI متصل شده است.xlsx

پیشرفت های اختیاری: تغییرات زیر با عقب سازگار هستند و پیشرفت های داوطلبانه ای هستند که اشخاص ثالث می توانند برای حمایت از انها انتخاب کنند.

1. CCA می تواند درخواست های موقت برای اطلاعات مشتری را در: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (اخرین عکس فوری از اطلاعات مشتری را در زمان درخواست باز می گرداند)، علاوه بر اطلاع رسانی روزانه دریافت شده است.
2. CCA توانایی تغییر خودکار گواهینامه SSL خود را که در ابتدا در طول ثبت نام ارائه شده است (به عنوان مثال، زمانی که گواهی نزدیک به انقضا) از طریق پورتال شخص ثالث، تحت مدیریت ثبت نام > ویرایش > بخش جدید: اطلاعات گواهی SSL (گزینه بروزرسانی)

اگر شما هر گونه سوال و یا نیاز به پشتیبانی اضافی، لطفا احساس رایگان برای تماس با ما در ShareMyData@pge.com.

اوت 21، 2015
 

چه خبر:

1. تغییرات URI پارام وضعیت و منبع در پاسخهای Oauth
   • به عنوان بخشی از درخواست کد مجوز OAuth، شخص ثالث این گزینه را دارد که یک پارامتر state را ارسال کند که PG & E به شخص ثالث ارسال می کند. PG & E همچنین کد مجوز را پس از اتمام موفقیت امیز مجوز ارسال خواهد کرد. این پارام حالت اختیاری می تواند برای کمک به شخص ثالث برای شناسایی جایی که درخواست اغاز شده است و درخواست را به مجوزهایی که اغاز کرده است، متصل کند.
   • به عنوان بخشی از تکمیل موفقیت امیز درخواست توکن، ما resourceURI و authorizationURI را به طور جداگانه از اطلاعات توکن به اشتراک می گذاریم. در حال حاضر این URL ها تلنگر می شوند و به عنوان بخشی از این نسخه ما ان را اصلاح خواهیم کرد.

نقص های ثابت:

1. تاریخ های پیش فرض published-max و published-min
   در حال حاضر PG & E دستور می دهد که شخص ثالث پارامترهای منتشر شده حداقل و حداکثر منتشر شده را در ثانیه های دوره برای هر درخواست داده ارسال کند تا PG & E را مدت زمان درخواست داده ها را بگوید. ما در حال اجرای یک تغییر برای رسیدگی به درخواست برای سناریوهای زیر هستیم:
   • مقادیر published-min و published-max از دست رفته اند
   • مقادیر published-min و published-max در UTC هستند
   • مقادیر published-min و published-max در ثانیه های دوره هستند
   در صورتی که پارامترها از دست رفته باشند، PG & E تاریخ های پیش فرض را باز می گرداند، در مقابل پیام های خطا که قبل از این تغییر بازگردانده می شوند. پیش فرض، در مورد ما، داده های یک روز برای تاریخ T-2 است. اگر پارامترها وجود داشته باشند و به درستی فرمت شوند، ما همچنان به پارامترها احترام می دانیم.
2. رفع تاریخ در xml
   مجوز در حال حاضر در xml مجوز ما تاریخ منتشر شده و تاریخ مجوز را به اشتراک گذاشته ایم. این تاریخ ها در میلی ثانیه در مقابل ثانیه است که استاندارد است. ما در حال تعمیر ان هستیم که به جای میلی ثانیه در ثانیه های دوره ارسال شود.
3. XML نادرست برای /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   بازگشت در حال حاضر ما در حال بازگشت پاسخ نادرست برای سطح منابع بالا GET که در ان ساختار XML نادرست است و ما در حال تکرار ورودی برای هر بازه به جای ایجاد یک بلوک فاصله واحد برای مدت زمان 24 ساعت است.
   
   این ثابت است و تنها یک بلوک فاصله تنها خواهد شد برای یک بلوک فاصله 24 بازگشت.

سوال یا نگرانی؟ لطفا با ShareMyData@pge.com تماس بگیرید.

• مشتریان به شما اجازه دسترسی به داده های خود را از طریق My Energy، حساب انلاین PG & E خود می دهند. برای یک مرور کلی دقیق در مورد اینکه چگونه مشتریان می توانند به اشخاص ثالث یا اشخاص دیگر اجازه دسترسی به داده های خود را دهند، لطفا بررسی اجمالی شخص ثالث Share My Data را مشاهده کنید.

به جزئیات مجوز بروید

• در حال حاضر هیچ محدودیتی وجود ندارد.

• مشتریان می توانند مدت زمان مشخصی را انتخاب کنند که بتوانید به داده های انها دسترسی داشته باشید یا می توانند دوره مجوز را باز بگذارند.
• درخواست شما می تواند تاریخ پایان مجوز مشتری را همراه با سایر جزئیات مجوز با تماس با API های منبع مجوز (به عنوان مثال، .../espi/1_1/resource/Authorization and/or.../espi/1_1/resource/Authorization/{AuthorizationID}) بررسی کند.
• متناوبا، شما می توانید به صورت دستی تاریخ پایان مجوز را با ورود به حساب خود و انتخاب مدیریت مجوزها بررسی کنید.

• اگر یک مشتری یک دوره تعریف شده از مجوز را انتخاب کند، مجوز انها در پایان ان دوره زمانی منقضی می شود. اگر انها مجوز را لغو کنند، مجوز انها روز بعد از لغو مجوز منقضی می شود.
• اگر مشتری نامحدود را به عنوان دوره مجوز خود انتخاب کند، مجوز انها منقضی نمی شود. توجه داشته باشید، با توجه به قانون 24 ارائه دهندگان پاسخ به تقاضا و سایر برنامه هایی که از داده های به اشتراک گذاری من استفاده می کنند، اصلاحات پس از واقعیت برای محدوده های تاریخ قبلا مجاز ممکن است تا سه سال پس از انقضای مجوز به اشخاص ثالث ارائه شود.
• ببینید "چگونه اصلاحات داده ها انجام می شود؟" برای جزئیات بیشتر در مورد دریافت اصلاحات.

• هر مشتری PG & E با یک شناسه خدمات فعال در حال حاضر برای خدمات گاز یا برق می تواند به شما اجازه دسترسی به داده های خود را با استفاده از ابزار جدید به اشتراک گذاری داده های من.

• مشتریان علاقه مند به شرکت در به اشتراک گذاری داده های خود را از طریق برنامه به اشتراک گذاری داده های من به شدت تشویق به ثبت نام برای یک حساب انرژی من. این باعث می شود کل فرایند کارامدتر شود و همچنین به انها توانایی مدیریت مجوزهای خود را به صورت انلاین می دهد.
• مشتریان می توانند در طول فرایند مجوز برای یک حساب My Energy ثبت نام کنند.
• یک فرایند دستی برای مشتریان برای به دست اوردن فرم مجوز اشتراک گذاری داده های من به صورت انلاین و ارسال فرم تکمیل شده از طریق ایمیل وجود دارد.
• برای کسب اطلاعات بیشتر در مورد فرایند دستی، لطفا با ما تماس بگیرید در ShareMyData@pge.com.

• مشتریان ملزم به ایجاد مجوزهای خود به صورت انلاین از طریق حساب انلاین PG & E خود هستند. با این حال، اگر انها فرم مجوز به اشتراک گذاری داده های من را تکمیل و امضا کنند، می توانید ان را از طرف انها به PG & E ارسال کنید.

دانلود مجوز مشتری به اشتراک گذاری اطلاعات من یا لغو فرم مجوز (PDF، 308 KB)

• شما می توانید URIs OAuth خود را با ورود به حساب خود، حرکت به مدیریت ثبت نام > ویرایش > و به روز رسانی زمینه ها تحت بخش اطلاعات OAuth 2.0 به روز کنید.

• شما می توانید URI اطلاع رسانی خود را با ورود به حساب خود، حرکت به مدیریت ثبت نام > ویرایش > و به روز رسانی زمینه ها تحت بخش اطلاعات دسترسی به داده ها به روز کنید.

• شما می توانید گواهینامه SSL خود را با ورود به حساب خود، حرکت به مدیریت ثبت نام > ویرایش > و انتخاب "به روز رسانی" در بخش اطلاعات گواهینامه SSL به روز کنید. توجه داشته باشید که برای اپلود گواهینامه جدید، ممکن است چند روز طول بکشد تا سیستم های PG & E را با گواهینامه جدید به روز کنید.  
• یک ایمیل تایید از تیم پشتیبانی به اشتراک گذاشتن داده های من ارسال خواهد شد زمانی که گواهی جدید اعمال شده است.

• هنگامی که یک ایمیل دریافت می کنید که نشان می دهد ثبت نام شما پذیرفته شده است، می توانید به حساب Share My Data خود وارد شوید و گواهینامه SSL ما را از طریق صفحه Download PG & E SSL Certificate دانلود کنید.

ورود برای به اشتراک گذاشتن داده های من

• Share My Data از توافقنامه های اجرای Green Button Connect My Data پیروی می کند. Share My Data همچنین OAuth 2.0 را برای مجوز، Transport Layer Security (TLS) 1.2 و حداقل مجموعه پروتکل های امنیت سایبری تایید شده توسط NIST (موسسه ملی استاندارد و فناوری) به گونه ای که هیچ اطلاعاتی به صورت واضح مبادله نمی شود، استخدام می کند.

• حفاظت از اطلاعات مشتری اولویت اصلی PG & E است. PG & E اطلاعات مربوط به مشتریان خود - از جمله اطلاعات شخصی - را به عنوان محرمانه، مطابق با تمام الزامات قانونی و نظارتی، از جمله انهایی که توسط کمیسیون خدمات عمومی کالیفرنیا و دیگران ایجاد شده است، رفتار می کند.  
• برای بیش از دو دهه، PG & E و دیگر شرکت های متعلق به سرمایه گذار در کالیفرنیا تحت مقررات بسیار سختگیرانه CPUC قرار گرفته اند که انها را از افشای اطلاعات خاص مشتری مانند داده های صورتحساب به اشخاص ثالث بدون رضایت صریح مشتری منع می کند.  
• هنگامی که یک مشتری اجازه انتشار داده ها را می دهد، مسئولیت مشتری و شخص ثالث برای محافظت از ان داده ها است.
• یک مشتری می تواند تصمیم بگیرد که در هر زمان با ورود به حساب انلاین PG & E خود و لغو مجوز خود، به اشتراک گذاری داده ها را با شخص ثالث متوقف کند. سیاست حفظ حریم خصوصی کامل PG & E و اطلاعیه دسترسی، جمع اوری، ذخیره سازی، استفاده و افشای اطلاعات استفاده از انرژی در pge.com/privacy در دسترس است.

• در محدوده برنامه به اشتراک گذاری داده های من، اشخاص ثالث تحت قوانین حریم خصوصی و حفاظت از داده های مشتری مشخص شده در شرایط و ضوابط پلت فرم Share My Data و الزامات موجود در تعرفه دسترسی به داده های مشتری قرار دارند.
• اشخاص ثالث همچنین مشمول تمام قوانین و مقررات قابل اجرا مربوط به حفاظت از حریم خصوصی مشتری هستند، از جمله، اما نه محدود به، قوانین مربوط به حفاظت از حریم خصوصی و امنیت برای داده های استفاده از انرژی تصویب شده توسط CPUC به عنوان پیوست D به تصمیم 11-07-056 (الکتریکی)، همچنین در قانون برق PG & E شماره 27 خلاصه شده است. و بخش قانون مدنی کالیفرنیا 1798.80 - 1798.84.
• برای اطلاعات بیشتر، لطفا لینک زیر را انتخاب کنید:
  شرایط و ضوابط داده های من را به اشتراک بگذارید (PDF، 190 KB)
  قانون الکتریکی شماره 27 (PDF، 1.6 MB)
  پیوست D به تصمیم 11-07-056 (PDF)
  اطلاعات بیشتر را پیدا کنید: بخش قانون مدنی کالیفرنیا 1798.80 - 1798.84

• لطفا به لینک زیر مراجعه کنید، برای یک لیست دقیق از عناصر داده ای که پشتیبانی می شوند.

دریافت اطلاعات بیشتر در مورد دسترسی به داده ها

• گاهی اوقات، داده های استفاده فاصله ای از دست رفته است، زیرا فرایندهای اعتبار سنجی داده های بالادست ما نشان می دهد که داده های گم شده یا نادرست وجود دارد که ممکن است نیاز به پردازش بیشتر (ویرایش و یا براورد) داشته باشد.
• برای مشتریان صورتحساب فاصله ای (به عنوان مثال، مشتریان با ملاحظات صورتحساب زمان استفاده)، این موارد به موقع اصلاح می شوند تا از محاسبه دقیق صورتحساب در صورتحساب ماهانه اینده خود اطمینان حاصل شود.

• اگر می خواهید اصلاحات داده ها را دریافت کنید، لطفا اطمینان حاصل کنید که کادر انتخاب Notify Me as Data is Ready را در هنگام ثبت نام یا با ورود به حساب انلاین خود و انتخاب این کادر انتخاب در زیر Edit Profile بررسی کنید. سپس ما اصلاحات داده هایی را که توسط سیستم ما در طول 24 ساعت گذشته گرفته شده است، به عنوان بخشی از خوراک استفاده روزانه، برای هر گونه داده ای که مجاز به دسترسی به ان هستید، شامل می شود.
• اصلاحات داده ها هر گونه تغییر برای دوره مجاز، حداکثر سه سال را پوشش می دهد.

توجه: با توجه به قانون 24 ارائه دهندگان پاسخ به تقاضا و سایر برنامه هایی که از Share My Data استفاده می کنند، اصلاحات پس از واقعیت برای محدوده های تاریخ قبلا مجاز ممکن است تا سه سال پس از انقضای مجوز به اشخاص ثالث ارائه شود.

• در صورت لزوم، PG & E اطلاعیه ها را به URL اطلاع رسانی شما ارائه شده در هنگام ثبت نام ارسال می کند. اعلان ها شامل URL های مربوط به داده های از پیش بسته بندی شده اماده برای شما برای بازگشت و درخواست در URL های ارائه شده است. داده ها از پیش بسته بندی شده اند و اطلاعیه ها در دو سناریوی زیر ارسال می شوند: (1) شما در پروفایل ثبت نام خود "Notify me as data is ready" را انتخاب کرده اید، در این صورت ما اخرین داده های روزانه را با هر گونه اصلاح برای تاریخ های گذشته بسته بندی می کنیم یا (2) شما یک درخواست ناهمزمان موقت قبلی را انجام داده اید که داده های درخواست شده اکنون اماده است. سناریوی 1 در زیر "دسترسی به داده ها" نشان داده شده است: اشتراک روزانه» بخش نمودارهای روش دسترسی به داده ها در صفحه دسترسی به داده ها و سناریو 2 در زیر "دسترسی به داده ها" نشان داده شده است: AD HOC REQUEST (ASYNCHRONOUS)" بخش همان نمودارها نیز در صفحه دسترسی به داده ها قرار دارد.

دسترسی به داده ها را در بالا ببینید

• داده های مصرف برق ارائه شده توسط Share My Data، داده های اندازه گیری کیفیت حل و فصل (SQMD) نیست که توسط اپراتور سیستم مستقل کالیفرنیا (CAISO) مشخص شده است. SQMD با ضرب داده های متر کیفیت درامد (RQMD) در ضریب از دست دادن توزیع (DLF) قابل اجرا برای سطح ولتاژ ان مشتری برای ان فاصله، تبدیل فواصل اندازه گیری شده به دوره فاصله مورد نیاز CAISO و سپس خلاصه نتایج برای هر فاصله به سطح کل مورد نیاز CAISO تولید می شود.
  
• PG & E در حال پیاده سازی پرچم های "QualityOfReading" (QOR) نوع ارائه شده توسط استاندارد ESPI برای برقراری ارتباط با اینکه ایا داده ها کیفیت درامد است. نوع QOR مقادیر مختلف کیفیت ممکن برای داده های استفاده را شامل می شود، از جمله یک مقدار صریح برای "داده های متر کیفیت درامد" یا "RQMD". PG & E از این نوع QOR در انتقال داده های خود به شرح زیر استفاده می کند:
  • PG & E از ESPI کلاس "UsageSummary" پشتیبانی می کند که برای شناسایی تاریخ هایی که توافقنامه خدمات صورتحساب می شود، مقدار استفاده صورتحساب و کیفیت داده های استفاده در زمان درخواست استفاده می شود. UsageSummary هنگامی که لایحه برای داده های درخواست شده در دسترس است، پر می شود و شامل دو پرچم (عناصر) نوع QOR خواهد بود:
    • عنصر UsageSummary.QualityOfReading (در سطح UsageSummary) نشان دهنده کیفیت در زمان درخواست اخرین مقادیر استفاده از فاصله ارائه شده به علاوه اصلاحات مربوط به UsageSummary.billing تاریخPeriod است.
    • عنصر DefaultQuality برای OverallConsumptionLastPeriod (به عنوان بخشی از UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) نشان دهنده کیفیت کل استفاده صورتحساب است.
  • PG & E همچنین کیفیت داده های استفاده را در سطح فاصله در زمان درخواست با استفاده از عنصر IntervalReading.ReadingQuality.Quality ارتباط برقرار می کند.

• در طول ثبت نام شما می توانید انتخاب کنید که چه مقدار داده تاریخی شما نیاز دارید، یا 24، 36 یا 48 ماه تحت "چقدر داده های تاریخی درخواست شده است" کشویی.
• به عنوان بخشی از مجوز مشتری که به شما اجازه دسترسی به داده های خود را می دهد، دوره تاریخی مجوز به انتخاب ثبت نام شما برای کارت های خدمات (نقاط استفاده) موجود در مجوز پیش فرض خواهد شد.
• شما می توانید داده های تاریخی درخواست شده خود را با ورود به حساب خود، حرکت به مدیریت ثبت نام > ویرایش > و انتخاب از کشویی با برچسب "چقدر داده های تاریخی درخواست شده است" به روز کنید.
• لطفا توجه داشته باشید که داده های ارائه شده در درخواست تاریخی با تاریخی که مشتری مجوز می دهد شروع می شود، در مقایسه با تاریخی که درخواست شما را به API انجام می دهید.

توجه: تغییرات در داده های تاریخی درخواست شده شما فقط بر مجوزهای جدید مشتری تاثیر می گذارد، در حالی که مجوزهای قبلی مشتری منعکس کننده انتخاب شما در زمان مجوز است.

• همانطور که در استاندارد ESPI، پاسخ از استاندارد انتشارات Atom استفاده می کند. لطفا لینک زیر را انتخاب کنید تا لیست کاملی از API هایی که پشتیبانی می شوند، همراه با عناصر داده موجود را ببینید.

دریافت اطلاعات بیشتر در مورد دسترسی به داده ها

• گواهینامه های فعال خدمات برق و گاز نصب شده و خوانده شده توسط PG & E واجد شرایط مجوز از طریق پلت فرم Share My Data هستند.
• اگر شناسه سرویس مرتبط با مجوز به یکی از دلایل زیر تغییر کند، مجوز به شناسه سرویس جدید منتقل می شود و دسترسی به داده های استفاده فاصله تاریخی ادامه خواهد یافت:
  • تعطیلی موقت به دلیل عدم پرداخت
  • جابهجایی به صورتحساب فاصله
  • تبادل متر
  • تغییر نرخ
• سناریوهای دیگری که منجر به تغییر در شناسه سرویس می شوند مانند جابجایی مکان ها یا تغییر یک شرکت ، دسترسی را متوقف می کنند. علاوه بر این، اگر یک حساب از حساب My Energy شما جدا شود، تمام شناسایی های خدمات اساسی که از طریق Share My Data مجاز هستند، در نتیجه غیر مجاز خواهند بود.

• برای تعیین دانه دانه بودن داده های فاصله مجاز، لطفا عنصر طول فاصله را که توسط استاندارد ESPI ارائه شده است، ارجاع دهید.
• PG & E داده های استفاده فاصله ای را در همان دانه بندی جمع اوری شده برای اهداف صورتحساب ارائه می دهد که به طور کلی به صورت ساعتی یا 15 دقیقه ای برای داده های الکتریکی و روزانه برای داده های گاز برای ان دسته از مشتریان با متر فاصله است. در حالی که می تواند بر اساس مشتری متفاوت باشد، استفاده از متر فاصله الکتریکی به طور کلی در سطح ساعتی برای اکثر مشتریان مسکونی و در سطح فاصله 15 دقیقه ای برای اکثر مشتریان تجاری در دسترس است و استفاده از فاصله متر گاز به طور کلی در سطح روزانه برای اکثر مشتریان در دسترس است.
• برای مترهای بدون وقفه، داده ها در صورت موجود بودن ارائه می شوند.

• برای اکثریت مشتریان PG & E با یک متر هوشمند نصب شده، داده های استفاده از فاصله برق و گاز تا پایان روز بعد از طریق پلت فرم Share My Data در دسترس است.
• بخش کوچکی از مشتریان الکتریکی PG & E با MV90 متر مبتنی بر حامل برق نصب شده ممکن است نیاز به زمان اضافی برای داده ها در دسترس باشد.

• در حالی که ما نمی توانیم به طور مستقیم از راه اندازی API های شما پشتیبانی کنیم، ما تعدادی از منابع موجود برای کمک به فناوری اطلاعات و منابع فنی شما در فرایند توسعه داریم. لطفا به صفحه مستندات API ما مراجعه کنید تا اطلاعات بیشتری کسب کنید. لطفا همچنین احساس رایگان برای تماس با ShareMyData@pge.com با هر گونه سوال اضافی.

برای اطلاعات بیشتر، به رابط برنامه نویسی برنامه (API) مراجعه کنید