مشاركة بياناتي لأطراف ثالثة

من أجل الامتثال لمعيار ترخيص واجهة مزود خدمة الطاقة (ESPI) الحالي لمجلس معايير الطاقة في أمريكا الشمالية (NAESB)، نفذت PG&E إطار ترخيص OAuth 2.0 للتصريح بالوصول إلى البيانات. يوضح الرسم البياني أدناه كيفية بدء العملاء للتصريح، واختيار معلمات النطاق، ثم إرسال تصريحهم.

مواد مرجعية إضافية تتجاوز المعلومات أدناه:

تنزيل مخطط تسلسل ESPI OAuth 2.0 (PDF, 193 كيلوبايت)
عرض بيانات الزر الأخضر SDK في Github

ملاحظة: بالنسبة إلى Community Choice Aggregators، لا يلزم سوى العميل_access_token لطلب البيانات (عبر OAuth 2-Legged) ولا ينطبق ما يلي.

التراخيص التي تبدأ في موقع الطرف الثالث

لبدء تفويض من موقع طرف ثالث كما هو موضح في الرسم البياني الأول أعلاه، يتم تقديم طلب رمز تفويض عن طريق إعادة توجيه متصفح العميل من موقع الطرف الثالث إلى عنوان URL لتفويض الخادم الخاص بـ PG&E مع معلمات الطلب المناسبة كما هو موضح أدناه. عند إعادة التوجيه، سيُعرض على العميل صفحة تسجيل الدخول إلى PG&E للمصادقة، تليها صفحة تفويض للتصريح بالوصول إلى البيانات إلى الطرف الثالث:

authorizationServerAuthorizationEndpoint URI (مع معلمات الطلب)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={ OptionalState}

• معلمات الطلب الإلزامي:
  • client_id = معرّف العميل من مراحل تسجيل مشاركة بياناتي الرئيسية (أي زوج client_id/client_secret).
  • إعادة التوجيه_uri = إعادة توجيه عنوان URL الذي حددته في تسجيل مشاركة بياناتي (يجب أن تتطابق عناوين URL).
    ملاحظة: نوصي بتطبيق ترميز URL على إعادة التوجيه_uri كما هو موضح أدناه.
  • نوع_الاستجابة = الرمز (قيمة ثابتة)
• معلمة (معلمات) الطلب الاختيارية:
  • الحالة = معلمة الحالة غير الشفافة الاختيارية كما هو مسموح به من خلال معيار OAuth 2.0 الذي يتم إرجاعه مع رمز التصريح من أجل المساعدة في الحفاظ على الحالة. على سبيل المثال، يمكن استخدام معلمة الحالة من قبل طرف ثالث لتحديد إنشاء العميل بشكل فريد ومنع التزوير عبر المواقع.
  • تسجيل الدخول={guest} قدّم خيارًا لطرف ثالث لإعادة توجيه العملاء إما إلى تسجيل الدخول إلى My Energy الخاص بشركة PG&E أو إلى علامة تبويب Guest Access كجزء من تدفق التصريح عبر الإنترنت.

مثال: طلب رمز المصادقة

احصل على: https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri=https%3A%2F%2Fthirdparty.com%2FredirectUrl&response_type=code&state=pge12advertisement

ملاحظة: مثال على معلمة إعادة التوجيه_uri أعلاه تم تطبيق ترميز URL (أي ترميز URL لـ https://thirdparty.com/redirectUrl)

إذا قدمت طلبًا صالحًا كما هو موضح أعلاه، وقام العميل بالمصادقة والتفويض بنجاح، فسيتم بعد ذلك إعادة توجيه العميل إلى إعادة التوجيه_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=يوميًا؛HistoryLength={3P Registered historical length}؛AccountCollection={count of authorizedSAs}؛BR={ThirdPartyID}؛dataCustodianId=PGE &state=pge12advertisement

ملاحظة: رمز التفويض قصير الأجل (ينتهي في غضون 600 ثانية)، ويجب استبداله لاحقًا بزوج رمز الوصول المميز/الرمز المميز المجدد لإكمال التصريح والسماح بالوصول المستمر إلى البيانات. راجع القسم التالي (القسم 2) للحصول على تفاصيل حول طلب رمز الوصول/ رمز التحديث.

يتم إرجاع معلمة النطاق (المصرح بها) الموضحة أعلاه كجزء من الردود على طلب رمز التخويل وطلب رمز الوصول المميز بالإضافة إلى واجهة برمجة التطبيقات الخاصة بالتخويل. تسمح معلمة النطاق هذه بتوصيل النطاق النهائي لتصريح العميل. على وجه الخصوص، تتضمن معلمة النطاق قيمة "النطاق الإضافي" التي يتم تعيينها لتحديدات تصريح العميل المدعومة من PG&E لمجموعات البيانات (على سبيل المثال، "الاستخدام"، "الفوترة"، "الأساسية"، "الحساب"، "تسجيل البرنامج"). يتم تسجيل قيم معلمات النطاق أيضًا وفقًا للوثائق المرجعية التالية:تنزيل تعيين سلسلة نطاق كتلة الوظائف المدعومة انقر فوق من خلال 2.0 (PDF، 222 كيلوبايت)

سيناريوهات الخطأ

أخطاء تنفيذ الطرف الثالث: إذا كانت معلمات الطلب المطلوبة الخاصة بـ client_id أو إعادة التوجيه_uri غير صالحة أو مفقودة عند طلب رمز تفويض، فسيتم عرض رسالة توضيحية للعميل إلى جانب خطأ سلسلة HTTP 400 القياسية. وبالمثل، إذا كانت معلمة الطلب المطلوبة من نوع Response_type مفقودة أو غير صالحة، فستتم إعادة توجيه العميل مرة أخرى إلى إعادة التوجيه_uri باستخدام معلمة خطأ OAuth 2.0 المحددة "invalid_request" بالإضافة إلى معلمة الحالة الاختيارية إذا تم تقديمها لأول مرة كجزء من طلب رمز التفويض الأصلي.

العملاء الذين يرفضون التصريح: عند قيام طرف ثالث بإعادة توجيه عميل للتصريح مع PG&E، يكون لدى العميل خيار الرفض عبر زر "إلغاء" في كل من صفحة تسجيل الدخول وصفحة التصريح. في مثل هذه الحالات، ستتم إعادة توجيه العميل مرة أخرى إلى إعادة التوجيه_uri مع معلمة الخطأ OAuth 2.0 المحددة "access_denied" الملحقة للإشارة إلى رفض العميل التصريح. بالإضافة إلى ذلك، سيتم إرجاع معلمة الحالة الاختيارية إذا تم تقديمها لأول مرة كجزء من طلب رمز التفويض الأصلي.

التراخيص التي تم بدؤها في PG&E

عندما يبدأ العملاء على البوابة الإلكترونية لعملاء PG&E، "حسابك"، ثم ينتقلون إلى الصفحة المنتقل إليها "مشاركة بياناتي"، يتم عرض قائمة منسدلة بالأطراف الثالثة المسجلة والمرئية. كما هو موضح في الرسم البياني الثاني أعلاه، عند اختيار العميل لطرف ثالث من قائمة الأطراف الثالثة المسجلة واختيار "التالي"، ستتم إعادة توجيه العميل إلى "معرّف المستخدم لبوابة الطرف الثالث" المسجل لدى الطرف الثالث، وعندها يمكن للعملاء المضي قدمًا في عملية OAuth التي بدأها الطرف الثالث والموضحة في القسم السابق.

ملاحظة: استفسرت بعض الأطراف الثالثة عن كيفية تبسيط تجربة العميل لحالة الاستخدام هذه (أي، التراخيص التي بدأت على موقع PG&E) بحيث يبدو للعميل أنه يتم نقلها مباشرةً إلى صفحة التفويض عند اختيار طرف ثالث من القائمة المنسدلة. لتسهيل تجربة العميل هذه، يمكن للأطراف الثالثة اختيار تعيين "معرّف URI لبوابة الطرف الثالث" (عبر صفحة مشاركة بياناتي وإدارة التسجيل) إلى نقطة نهاية تعيد توجيه العميل تلقائيًا إلى PG&E كجزء من طلب رمز التفويض. عند إعادة التوجيه تلقائيًا مرة أخرى إلى نقطة نهاية تفويض خادم التخويل لدى PG&E، سيتخطى العميل صفحة تسجيل دخول العميل (حيث تم تسجيل دخوله بالفعل) وسينتقل مباشرةً إلى صفحة التخويل. بالنسبة لبعض الأطراف الثالثة التي سجلت قبل إصدار مشاركة بياناتي انقر فوق 2.0 في أواخر يونيو 2018، يمكن تحقيق ذلك ببساطة من خلال تحديد URI لبوابة الطرف الثالث بحيث يساوي URI الذي لم يعد مستخدمًا "شاشة تحديد نطاق الطرف الثالث" (يتم سحب الحقل في إصدار مستقبلي).

وعلى النقيض من ذلك، قد ترغب بعض الأطراف الثالثة في إشراك العملاء وفحصهم أولاً من جانبهم عند إعادة توجيه العملاء إلى URI "بوابة الأطراف الثالثة" قبل طلب رمز التفويض، لذلك فإن النهج المذكور أعلاه هو مجرد اقتراح.

للحصول على رمز الوصول، استخدم رمز التفويض المستلم واتصل بنقطة النهاية أدناه مع معلمات الطلب كما هو موضح أدناه. كما هو موضح أعلاه، فإن رمز الترخيص قصير الأجل، ينتهي بعد 10 دقائق (600 ثانية)، لذا يُرجى التأكد من طلب رمز الوصول فور استلام رمز الترخيص.

authorizationServerAuthorizationEndpointhttps://api.pge.com/datacustodian/oauth/v2/token

• معلمات الطلب الإلزامي:
  • نوع_المنحة = رمز_التفويض (قيمة ثابتة)
  • الرمز = رمز التفويض المستلم استجابةً لطلب رمز التفويض
  • إعادة التوجيه_uri = إعادة توجيه عنوان URL الذي حددته في تسجيل مشاركة بياناتي (يجب أن تتطابق عناوين URL).
    ملاحظة: كما هو الحال مع طلب رمز التفويض، نوصي بتطبيق ترميز URL على إعادة التوجيه_uri.

مثال: طلب
رمز الوصول POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

إضافة معلمة عنوان التخويل الأساسي مع تطبيق ترميز Base64 "ClientID:clientSecret"

ملاحظة: يتوافق معرّف العميل:قيم ClientSecret مع قيم معرّف العميل المقدمة في مراحل تسجيل مشاركة بياناتي.
ستكون معلمة العنوان بالتنسيق التالي:
اسم المعلمة: قيمة معلمة الترخيص
: "سلسلة مرمزة للقاعدة 64" أساسية

ستبدو الإجابة الناجحة على النحو التالي:

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_47345_345_44_15_14AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment؛الفترة الزمنية=900_3600؛مدة الحظر=يوميًا؛التاريخالطول={3P الطول التاريخي المسجل}؛AccountCollection={عدد SAs المعتمدين}؛BR={ThirdPartyID}؛dataCustodianId=PGE
ResourceURI:{ResourceURI} على سبيل المثال: https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
تفويضURI:{AuthorizationURI} على سبيل المثال: https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
العميلمصدر البحث:{customerResourceURI} على سبيل المثال:https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
حامل

ملاحظة: تنتهي صلاحية رمز الوصول المميز خلال 3600 ثانية (ساعة واحدة)، بينما تنتهي صلاحية رمز التحديث المميز المقابل خلال عام واحد. راجع القسم التالي 3 للحصول على تفاصيل حول الحصول على زوج رمز الوصول/الرمز المميز الجديد.

احفظ الوصول وحدث زوج الرموز.
لطلب بيانات تاريخية أولية وبيانات يومية مستمرة، قم بزيارة الوصول إلى البيانات.

وفقًا لأفضل الممارسات، فإن رمز الوصول هو رمز قصير الأجل (ساعة واحدة) بينما رمز التحديث المقابل هو رمز طويل الأجل (سنة واحدة) يمكنك استخدامه للحصول على زوج رمز وصول/رمز تجديد جديد جديد عند انتهاء صلاحية رمز الوصول. للحصول على زوج رمز وصول ورمز تحديث جديد للتخويلات الحالية غير المنتهية الصلاحية، استخدم "رمز التحديث الحالي" واتصل بنقطة النهاية أدناه مع المعلمات كما هو موضح أدناه.

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

مثال: تحديث طلب
الرمز المميز POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

إضافة معلمة عنوان التخويل الأساسي مع تطبيق ترميز Base64 "ClientID:clientSecret"

ملاحظة: تتوافق قيم ClientId:clientSecret مع قيم clientID المقدمة في مراحل تسجيل مشاركة بياناتي.
ستكون معلمة العنوان بالتنسيق التالي:
اسم المعلمة: قيمة معلمة الترخيص
: "سلسلة مرمزة للقاعدة 64" أساسية

ستظهر الإجابة الناجحة على النحو التالي:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2"،
"token_type": "حامل"،
"ينتهي_في": 3600،
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"النطاق": "scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47؛AdditionalScope=Usage_Billing_Basic_Account_
برنامج_التسجيل؛الفترة الزمنية=900_3600؛مدة الحظر=يوميًا؛التاريخالطول={3P الطول التاريخي المسجل}؛AccountCollection={عدد SAs المعتمدين}؛BR={ThirdPartyID}؛dataCustodianId=PGE"،
"الموارد": "https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test "،
"تفويضURI": "https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Authorization/test "
}

ملاحظة: وبالمثل، فإن رمز وصول العميل هو رمز قصير الأجل (ساعة واحدة) بينما رمز التحديث المقابل له هو رمز طويل الأجل (سنة واحدة) يمكنك استخدامه للحصول على زوج رمز وصول عميل/رمز تجديد عندما تنتهي صلاحية رمز وصول العميل. للحصول على زوج جديد من الرموز المميزة/الرموز المميزة المجددة لوصول العميل، راجع نفس الخطوات الموضحة أعلاه.

سيتمكن العملاء من تحديث تصاريحهم من خلال القيام بما يلي:

• إزالة معرفات الخدمة من تخويلاتها
• تمديد تاريخ انتهاء فترة التفويض
• إلغاء التصريح

ملاحظة: لن يتمكن العملاء من إجراء تغييرات على تصاريحهم إلا عن طريق تسجيل الدخول إلى حساب PG&E عبر الإنترنت واتباع الخطوات المطلوبة. إذا تم اتخاذ أي من هذه الإجراءات، فسنخطرك عبر عنوان URI الخاص بالإخطار الذي قدمته أثناء التسجيل.

هناك خيارات لإدارة وعرض تفاصيل تصاريح العملاء:

• يمكنك الاتصال بواجهة برمجة التطبيقات الخاصة بالتخويل (عملية http GET) باستخدام العميل_access_token إما على مستوى الطرف الثالث (للحصول على تفاصيل حول جميع التخويلات) على https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization أو على مستوى تخويل العميل الفردي على https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• وبشكل منفصل، يمكنك أيضًا عرض تفاصيل التفويض الفردية يدويًا عن طريق تسجيل الدخول إلى حساب مشاركة بياناتي عبر بوابة الطرف الثالث وإدخال معرف الاشتراك للتخويل الذي تبحث عنه.

إذا لم تعد ترغب في الوصول إلى البيانات المرتبطة بالتصريح، فهناك طرق اختيارية لإلغاء التصريح:

• يمكنك الاتصال بـ API لإلغاء التخويل (عملية http DELETE) باستخدام Client_access_token على https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• وبدلاً من ذلك، يمكنك إلغاء التفويض يدويًا عن طريق تسجيل الدخول إلى حساب مشاركة بياناتي عبر بوابة الطرف الثالث وإدخال معرف الاشتراك للتفويض الذي ترغب في إلغاؤه.

ملاحظة: سيتم إخطار العميل بأنك اخترت إلغاء تصريحه. بالإضافة إلى ذلك، بمجرد إلغاء التصريح، لا يمكن عكس الإجراء.

• سترسل PG&E إشعارات إلى عنوان URI الخاص بإشعارك المقدم أثناء التسجيل. تشتمل الإشعارات على عناوين URI مطابقة للبيانات المعبأة مسبقًا الجاهزة لك للعودة وطلبها على عناوين URL المقدمة. البيانات معبأة مسبقًا ويتم إرسال الإشعارات في السيناريوهين التاليين: (1) لقد حددت "إخطاري لأن البيانات جاهزة" في ملف تعريف التسجيل الخاص بك، وفي هذه الحالة سنجمع أحدث البيانات اليومية مع أي تصحيحات للتواريخ السابقة، أو (2) لقد قدمت طلبًا غير متزامن مخصصًا سابقًا أصبحت البيانات المطلوبة جاهزة له الآن.
• يتم توضيح السيناريو 1 تحت عنوان "DATA ACCESS: الاشتراك اليومي" في مخططات طرق الوصول إلى البيانات أدناه، ويتم توضيح السيناريو 2 تحت عنوان "الوصول إلى بيانات البيانات: قسم طلب AD HOC (غير متناغم)" من نفس المخططات أدناه.

يُرجى مراعاة العمر الافتراضي للرمز المميز للرمز المميز للوصول والرمز المميز لوصول العميل والرموز المميزة للتحديث المقابلة لها والمستخدمة في طلبات البيانات. وفقًا لأفضل الممارسات، فإن Access Token عبارة عن رمز قصير الأجل (ساعة واحدة) بينما رمز التحديث هو رمز طويل الأجل (سنة واحدة) يمكنك استخدامه للحصول على زوج رمز الوصول/الرمز التحديثي الجديد عند انتهاء صلاحية رمز الوصول. وبالمثل، فإن رمز وصول العميل هو رمز قصير الأجل (ساعة واحدة) بينما رمز التحديث المقابل له هو رمز طويل الأجل (سنة واحدة) يمكنك استخدامه للحصول على زوج رمز وصول عميل/رمز تجديد عندما تنتهي صلاحية رمز وصول العميل. لمزيد من التفاصيل حول الحصول على زوج رمز جديد، راجع الخطوة 3، طلب رمز وصول جديد، في علامة تبويب تفاصيل التفويض. انتقل إلى تفاصيل التفويض

إذا كان العميل مخولاً باستلام إما "معلومات الحساب" (معرفات الحساب ومعرفات اتفاقية الخدمة وتواريخ بدء الخدمة) و/أو "المعلومات الأساسية" (أي اسم العميل وعنوان الخدمة)، فيمكنك طلب معلومات العميل هذه عبر واجهات برمجة تطبيقات عملاء التجزئة المحددة من قبل ESPI والتي تتوافق البيانات الخاصة بها مع المخطط، RetailCustomer.xsd، المقدمة أعلاه.

متزامن (الأطراف الثالثة القياسية وEEF)

يتمثل أحد الأساليب لطلب بيانات العملاء في استخدام واجهة برمجة التطبيقات المتزامنة لطلب معلومات العملاء للحصول على تصريح عميل واحد لبيانات العملاء (أي عميل التجزئة):

مثال على عنوان URL للطلب المتزامن:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID الذي تلقيته في نهاية تسلسل تفويض OAuth للحصول على رمز وصول مميز. مُعرّف عميل التجزئة هو جزء من معلمة مسار CustomerResourceUri في استجابة الرمز المميز. (معرف العميل للبيع بالتجزئة=معرف الاشتراك)

عنوان HTTP = التخويل:حامل {رمز الوصول المميز لهذا التخويل}

الإجابة = ستستعيد البيانات بشكل متزامن لمعرف عميل التجزئة هذا. تتوافق البيانات مع RetailCustomer.xsd

ملاحظة: تكون واجهة برمجة التطبيقات المتزامنة لعملاء التجزئة على مستوى عملاء التجزئة الفرديين والتي تتوافق مع تصريح عميل واحد.

كمرجع: يوضح الرسم البياني الهرمي أدناه التسلسل الهرمي للعلاقة لعناصر بيانات مؤشر أسعار خدمة العملاء في نمذجة بيانات عملاء PG&E.

يمكنك أيضًا طلب بيانات العملاء عبر واجهة برمجة التطبيقات غير المتزامنة لطلب معلومات العملاء لجميع تصاريح العملاء لبيانات العملاء (أي عملاء التجزئة).

لدعم الطلبات غير المتزامنة، سيحتاج طلبك إلى دعم الإشعارات البريدية التي سنرسلها إليك (وفقًا لعنوان URL الخاص بالإشعارات الذي قدمته أثناء التسجيل).

مثال على عنوان URL للطلب غير المتزامن:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

المعرف المجمع = المعرف المجمع المقدم في التطبيقموارد المعلومات التي تم استردادها أثناء اختبار التسجيل. (المعرف المجمع = معرف العميل)

عنوان HTTP = التخويل:يسترد حامل البطاقة {الرمز المميز لوصول العميل أثناء اختبار التسجيل}

الاستجابة = رمز حالة HTTP 202 (هذا طلب غير متزامن حيث سيتم نشر الاستجابة على عنوان URL للإشعار عندما تكون البيانات جاهزة). بمجرد أن تصبح البيانات جاهزة، سننشر إشعارًا إلى URI الخاص بالإشعار المقدم مع حمولة من عناوين URL التي يمكن أن يعود إليها تطبيقك للحصول على التعبئة المسبقة. يبدو نموذج إشعار المنشور كما هو موضح أدناه

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

قم بإجراء GET على عنوان URL أعلاه باستخدام رمز وصول العميل للحصول على البيانات.

كمرجع: يوضح الرسم البياني الهرمي أدناه التسلسل الهرمي للعلاقة لعناصر بيانات مؤشر أسعار خدمة العملاء في نمذجة بيانات عملاء PG&E.

وأخيرًا، يمكنك الحصول على أحدث معلومات العملاء يوميًا باستخدام نموذج الاشتراك اليومي (أي عن طريق تحديد خانة الاختيار "إخطاري لأن البيانات جاهزة (يوميًا)" أثناء التسجيل).

لدعم نموذج الاشتراك اليومي، سيحتاج طلبك إلى دعم الإشعارات البريدية التي سنرسلها إليك (وفقًا لعنوان URL الخاص بالإشعارات الذي قدمته أثناء التسجيل).

بمجرد أن تصبح البيانات جاهزة، سننشر إشعارًا إلى URI الخاص بالإشعار المقدم مع حمولة من عناوين URL التي يمكن أن يعود إليها تطبيقك للحصول على التعبئة المسبقة. يبدو نموذج إشعار المنشور كما يلي:

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

قم بإجراء GET على عنوان URL أعلاه باستخدام رمز وصول العميل للحصول على البيانات.

كمرجع، يوضح الرسم البياني الهرمي أدناه التسلسل الهرمي للعلاقة لعناصر بيانات مؤشر أسعار خدمة العملاء في نمذجة بيانات عملاء PG&E.

إذا كان العميل مخولاً لتلقي "معلومات الاستخدام" و/أو "معلومات الفوترة"، فيمكنك طلب هذه البيانات عبر واجهات برمجة التطبيقات الخاصة بالاشتراك التي تتوافق البيانات الخاصة بها مع المخطط، espiDerived.xsd، المقدم أعلاه.

الطلبات المتزامنة المخصصة (القياسية والأطراف الثالثة لـ EEF)

لطلب بيانات تاريخية (لكل من بيانات استخدام الفاصل الزمني وبيانات الفاتورة)، يتمثل أحد الأساليب في استخدام واجهات برمجة التطبيقات المتزامنة مع تضمين معلمات طلب تاريخ البدء والانتهاء المناسبة في وقت Zulu.

مثال على عنوان URL للطلب المتزامن:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}? منشور-الحد الأدنى={startDate}ومنشور-الحد الأقصى={endDate}

تاريخ النشر - الحد الأدنى = تاريخ البدء الذي سيتم تطبيقه على هذا الطلب لسحب البيانات. التاريخ بالتوقيت الزولو من yyyyy-MM-ddTHH:mm:ssZ (تنسيق IETC RFC 3339)

المنشورة-الحد الأقصى = تاريخ الانتهاء الذي سيتم تطبيقه على هذا الطلب لجمع البيانات. التاريخ بالتوقيت الزولو من yyyyy-MM-ddTHH:mm:ssZ (تنسيق IETC RFC 3339)

ملاحظة: بالنسبة لطلبات واجهة برمجة التطبيقات التي تقبل معلمات الحد الأقصى للتاريخ المنشور والأدنى للتاريخ المنشور، يكون الإعداد الافتراضي هو T-1 (تاريخ الطلب مطروحًا منه يوم واحد). بالنسبة لطلبات ملخص الاستخدام (على سبيل المثال، .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary)، نقترح توفير نطاق 30 يومًا أو أكثر لضمان وجود فاتورة متاحة تتداخل مع تلك الفترة، وإلا فلن يتم إرجاع أي بيانات.

مُعرّف الاشتراك = مُعرّف الاشتراك الذي تلقيته في نهاية تسلسل تفويض OAuth للحصول على رمز وصول مميز. معرف الاشتراك هو جزء من معلمة ResourceURI في استجابة الرمز المميز. (معرف الاشتراك =معرف عميل التجزئة)

UsagePointID = UsagePoint أسفل معرف الاشتراك أعلاه. يمكنك الحصول على جميع نقاط الاستخدام لاشتراك معين عن طريق الاتصال بعنوان URL لواجهة برمجة التطبيقات أدناه وتوفير رمز الوصول لهذا الاشتراك في عنوان التفويض: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

عنوان HTTP = التخويل:حامل {رمز الوصول المميز لهذا الاشتراك}

الاستجابة = سوف تستعيد البيانات بشكل متزامن لنقطة الاستخدام هذه للفترة المطلوبة. سيحتوي على كل من بيانات استخدام الفاصل الزمني () وبيانات الفاتورة ().

تكون واجهات برمجة التطبيقات الخاصة بالاستخدام المتزامن (كما هو موضح في إنشاء عنوان URL الذي ينتهي بمعرف نقطة الاستخدام) على مستوى نقطة الاستخدام الفردية (أي مستوى اتفاقية الخدمة)، لذلك يقوم التطبيق بتدوير الطلبات من خلال كل معرف من معرفات نقطة الاستخدام التي تنتمي إلى تصريح عميل معين (أي الاشتراك).

ترجع الاستجابة للطلبات المتزامنة كلاً من بيانات الفاصل الزمني (تحت) المرتبطة بنطاق التاريخ المطلوب وكذلك أي إجماليات وفواتير شهرية للاستخدام متداخلة مع نطاق التاريخ المطلوب (تحت ).

• الفاصل الزمنيتحتوي القراءة على بيانات الفاصل الزمني (15 دقيقة/ساعة) لاستخدام الكهرباء والفاصل الزمني (يوميًا) لاستخدام الغاز
• يحتوي ملخص الاستخدام على إجماليات الاستخدام الشهرية وتفاصيل الفاتورة (إذا تم التصريح بذلك)

ستجد في الرد عناصر البيانات المطابقة لجدول تعيين عنصر البيانات ESPI

كمرجع، يوضح الرسم البياني الهرمي أدناه التسلسل الهرمي للعلاقة لعناصر بيانات مؤشر أسعار الخدمة البيئية والاجتماعية في نمذجة بيانات عملاء PG&E.

فيما يلي بعض التوضيحات الرئيسية حول عناصر البيانات هذه:

• حاجز الفاصل الزمني لمدة يوم واحد
• تحتوي قراءة الفاصل الزمني (أسفل كتلة الفاصل الزمني) على قيم الاستخدام الكهربائي الفعلية التي تبلغ 15 دقيقة/ساعة وقيم استخدام الغاز اليومية
• بالنسبة لعملاء الكهرباء الذين لديهم توليد في الموقع (مثل الطاقة الشمسية)، يشير عنصر التدفقالاتجاه إلى بيانات الاستخدام التي تم تسليمها (التوريد) واستلامها (التوليد). بالنسبة للعملاء الذين لديهم أجهزة قياس تم تكوينها لقراءة صافي الاستخدام فقط (أي لا يوجد توليد في الموقع)، يشير عنصر التدفقالاتجاه إلى أن الاستخدام هو صافي كمية (الفرق بين التسليم مطروحًا منه المبلغ المستلم):
  • اتجاه التدفق 1 = يتم توصيله (الطاقة الموردة للعميل)
  • اتجاه التدفق 19 = مستلم (توليد الشبكة يتدفق مرة أخرى إلى شبكة PG&E). (ملاحظة، القيم مطلقة)
  • اتجاه التدفق 4 = صافي (تم التسليم ناقص - تم الاستلام)
• إيلاء اهتمام خاص لقوة المضاعف العشرة ووحدة القياس (uom) لضمان قراءة الاستخدام الصحيحة

الاشتراك على دفعات (الأطراف الثالثة القياسية وEEF)

يمكنك أيضًا طلب بيانات الاستخدام عبر واجهة برمجة التطبيقات غير المتزامنة لجميع نقاط الاستخدام التي تنتمي إلى تصريح عميل واحد لبيانات الاستخدام/الفواتير (أي الاشتراك).

لدعم الطلبات غير المتزامنة المخصصة (أي لأكثر من نقطة استخدام واحدة في كل مرة)، سيحتاج طلبك إلى دعم الإشعارات البريدية التي سنرسلها إليك (وفقًا لعنوان URL الخاص بالإشعارات الذي قدمته أثناء التسجيل)

مثال على عنوان URL
لطلب غير متزامن https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

معرف الاشتراك = معرف الاشتراك الذي تلقيته في نهاية تسلسل OAuth للحصول على رمز وصول مميز. معرف الاشتراك هو جزء من معلمة ResourceURI في استجابة الرمز المميز

تاريخ النشر - الحد الأدنى = تاريخ البدء الذي سيتم تطبيقه على هذا الطلب لسحب البيانات. (تنسيق RFC 3339 zulu الوقت. yyyyy-MM-ddTH:mm:ssZ)

المنشورة-الحد الأقصى = تاريخ الانتهاء الذي سيتم تطبيقه على هذا الطلب لسحب البيانات. (تنسيق RFC 3339 zulu الوقت. yyyyy-MM-ddTH:mm:ssZ)

عنوان HTTP = التخويل:حامل {رمز الوصول المميز لهذا الاشتراك}

الاستجابة = رمز حالة HTTP 202 (هذا طلب غير متزامن حيث سيتم نشر الاستجابة على عنوان URL للإشعار عندما تكون البيانات جاهزة)

بمجرد أن تصبح البيانات جاهزة، سننشر إشعارًا إلى URI الخاص بالإشعار المقدم لك مع حمولة من عناوين URL التي يمكن أن يعود إليها تطبيقك للحصول على التعبئة المسبقة. يبدو نموذج إشعار المنشور كما يلي:

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

قم بإجراء GET على عنوان URL أعلاه مع رمز الوصول للحصول على البيانات. سيحتوي ذلك على كل من بيانات استخدام الفاصل الزمني () بالإضافة إلى معلومات الفاتورة () للفترة المطلوبة.

الاشتراك على دفعات (الأطراف الثالثة القياسية وEEF)
يمكنك أيضًا طلب معلومات الاستخدام والفوترة عبر واجهة برمجة التطبيقات غير المتزامنة المجمعة على دفعات لجميع تصاريح العملاء الخاصة ببيانات الاستخدام/الفوترة (أي الاشتراكات).

مثال على عنوان URL
للطلب المجمع للدفعة https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate}

المعرف المجمع = المعرف المجمع المقدم في التطبيقموارد المعلومات التي تم استردادها أثناء اختبار التسجيل. (المعرف المجمع = معرف العميل)

تاريخ النشر - الحد الأدنى = تاريخ البدء الذي سيتم تطبيقه على هذا الطلب لسحب البيانات. (تنسيق RFC 3339 zulu الوقت. yyyyy-MM-ddTH:mm:ssZ)

المنشورة-الحد الأقصى = تاريخ الانتهاء الذي سيتم تطبيقه على هذا الطلب لسحب البيانات. (تنسيق RFC 3339 zulu الوقت. yyyyy-MM-ddTH:mm:ssZ)

عنوان HTTP = التخويل:حامل {رمز وصول العميل}

الاستجابة = رمز حالة HTTP 202 (هذا طلب غير متزامن حيث سيتم نشر الاستجابة على عنوان URL للإشعار عندما تكون البيانات جاهزة)

بمجرد أن تصبح البيانات جاهزة، سننشر إشعارًا إلى URI الخاص بالإشعار المقدم لك مع حمولة من عناوين URL التي يمكن أن يعود إليها تطبيقك للحصول على التعبئة المسبقة. يبدو نموذج إشعار المنشور كما يلي:

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

قم بإجراء GET على عنوان URL أعلاه مع رمز الوصول للحصول على البيانات. سيحتوي ذلك على كل من بيانات استخدام الفاصل الزمني () بالإضافة إلى معلومات الفاتورة () للفترة المطلوبة.

وأخيرًا، يمكنك الحصول على أحدث معلومات الاستخدام والفوترة بما في ذلك تصحيحات التواريخ السابقة خلال فترات تفويض العملاء على أساس يومي باستخدام نموذج الاشتراك اليومي (أي عن طريق تحديد خانة الاختيار "إخطاري لأن البيانات جاهزة (يوميًا)" أثناء التسجيل).

لدعم نموذج الاشتراك اليومي، سيحتاج طلبك إلى دعم الإشعارات البريدية التي سنرسلها إليك (وفقًا لعنوان URL الخاص بالإشعارات الذي قدمته أثناء التسجيل).

بمجرد أن تصبح البيانات جاهزة، سننشر إشعارًا إلى URI الخاص بالإشعار المقدم لك مع حمولة من عناوين URL التي يمكن أن يعود إليها تطبيقك للحصول على التعبئة المسبقة. يبدو نموذج إشعار المنشور كما يلي:

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 تدعم القدرة على ربط استجابة PG&E باستدعاءات API غير متزامنة معينة عن طريق إعادة هذه القيمة مع معرف الارتباط عندما يكون الملف المطلوب جاهزًا.
3. تم تحسين دقة البيانات الإضافية لواجهة برمجة تطبيقات UsagePoint/MeterReadingID من خلال توفير بيانات الفاصل الزمني الكهربائية لعدة أمتار لسيناريوهات اتفاقية الخدمة الفردية.
4. قدمت وضوحًا إضافيًا لقيم مؤشر جودة القراءة لبيانات الفواصل الزمنية المقدرة لوصف نوع التقدير المستخدم لهذه الفواصل الزمنية. فيما يلي القيم الجديدة التي تشير إلى تطبيق منطق التقدير:
   
   

5. قيمة ووصف RQI

   0 - صالح: البيانات التي مرت بجميع عمليات التحقق المطلوبة وإما أنها اجتازتها جميعًا أو تم التحقق منها

   7 - تم تحريره يدويًا: تم استبداله أو اعتماده من قبل إنسان

   8 - تم التقدير باستخدام اليوم المرجعي: تم استبدال قيمة البيانات بقيمة محسوبة للماكينة بناءً على تحليل البيانات التاريخية باستخدام نفس نوع القياس

   9 - تم التقدير باستخدام الاستيفاء الخطي: تم حساب قيمة البيانات باستخدام الاستيفاء الخطي بناءً على القراءات قبلها وبعدها

   10 - مشكوك فيه: البيانات التي فشلت في فحص واحد أو أكثر

   11 - مستمدة: البيانات التي تم حسابها (باستخدام العمليات المنطقية أو الرياضية)، وليس بالضرورة قياسها مباشرة

   12 - البيانات المتوقعة (المتوقعة): البيانات التي تم حسابها كتوقع أو تنبؤ للقراءات المستقبلية

   13 - مختلط: يشير إلى أن جودة هذه القراءة لها خصائص مختلطة

   14 - خام: البيانات التي لم تخضع لعملية التحقق والتحرير والتقدير. ملاحظة سيبقى مؤشر RQI لعدادات MV90 في 14 كحالة نهائية لـ RQ

   15 - تطبيع الطقس: تم تعديل القيم لحساب الطقس، لمقارنة الاستخدام في المناخات المختلفة

   16 - غير ذلك: يحدد أن إحدى الخصائص تنطبق بخلاف تلك المحددة

   17 - تم التحقق: البيانات التي تم التحقق منها وربما تم تعديلها و/أو تقديرها وفقًا للإجراءات المعتمدة

   18 - تم التحقق: البيانات التي فشلت على الأقل في أحد فحوصات التحقق المطلوبة ولكن تم تحديدها على أنها تمثل الاستخدام الفعلي

   19 - جودة الإيرادات: صالحة ومقبولة لأغراض الفوترة [تمديد محتمل لمعيار ESPI، وليس جزءًا من ESPI الأصلي]

    

6. إصدار مقاييس استخدام واجهة برمجة التطبيقات الخاصة بالموردين في بوابة مشاركة بياناتي الخاصة بالموردين الخارجيين.

15 نوفمبر 2018

ما الجديد:

1. تمت إضافة مؤشر فئة العميل. سيتم تحديد كل من الأشخاص المصرح لهم من قِبل SAID إما على أنهم RES أو AGR أو COM/IND أو غير ذلك.
2. سيتم تحديث واجهات برمجة التطبيقات الخاصة بالفوترة والاستخدام لقبول معلمات الاستعلام المحدثة كحد أقصى والدقيقة المحدثة (كبديل لـ "الحد الأدنى المنشور" والحد الأقصى المنشور). ستكون البيانات المرتجعة هي جميع التغييرات التي حدثت ضمن المعلمات المحدّثة كحد أقصى والدقيقة المحدّثة.
3. استبدال المعرف المجمع المكون من 5 أرقام الخاص بطرف ثالث بمعرف عميل الطرف الثالث لتدفق التصريح عبر الإنترنت.
4. توفير خيار لطرف ثالث لإعادة توجيه العملاء إما إلى تسجيل الدخول إلى حساب PG&E أو علامة تبويب وصول الضيف كجزء من تدفق التصريح عبر الإنترنت.
5. تحسين لوحة معلومات عميل مشاركة بياناتي لدى PG&E لتسهيل عرض العملاء لجميع تصاريح مشاركة البيانات الحالية مع أطراف ثالثة.

27 سبتمبر 2018

ما الجديد:

أضافت PG&E عناصر بيانات جديدة إلى مجموعة بيانات القاعدة 24 كجزء من مشروع مجموعة البيانات الموسعة (EDS) لشركة PG&E، وتم إدخال عناصر بيانات جديدة مقابلة في مجموعة بيانات القاعدة 25. عناصر البيانات المحددة التي تتألف من مجموعة بيانات القاعدة 25 الموسعة لشركة PG&E موضحة أدناه مع تسمية EDS:

القاعدة 25 عناصر البيانات

ملاحظات
عناصر
الحساب اسم
الحساب عنوان
الحساب معرف
الحساب EDS: عناصر
خدمة حظر
الانقطاع معرّف
خدمة PG&E UUID
التغييرات المستقبلية على حالة حالة
خدمة
ضمان البرنامج تاريخ
بدء الخدمة عنوان
تعريفة
الخدمة الحالية خيارات تعريفة
الخدمة التاريخية المفوترة (خط الأساس الطبي، العناية، فيرا، تي بي إس، CCA_TBS، فولطية الخدمة الحالية من Solar Choice

وفولطية الخدمة التاريخية المفوترة بالسلع عدد
عدادات
الخدمة نوع
العداد دورة
القراءة التاريخية المفوترة بالعداد خيار معدل الاستعداد الحالي
لدورة القراءة إذا كان خيار السعر الاحتياطي التاريخي المفوتر لمؤشر
التوليد في الموقع
EDS: مؤشر
فئة العميل عناصر
الفوترة التاريخية تاريخ
بدء الفاتورة تاريخ
انتهاء الفاتورة إجمالي الرسوم (بالدولار)
إجمالي الفاتورة كيلو واط ساعة
EDS: اسم تقسيم فئة الفاتورة التاريخية لمقدم
الخدمة (إن وجدت)
EDS: فترة
فاتورة البند المتسلسل EDS: الاسم (فوق خط الأساس 1%-30%)
EDS: الحجم (1234.2)
EDS: السعر (0 دولار أمريكي.032/كيلو وات في الساعة)
EDS: التكلفة (100 دولار.23)
تعطل الفاتورة التاريخية TOU كيلو وات في الساعة (باستثناء فاتورة ABS-TX)
EDS: فترة فاتورة البند المتسلسل (لتحليل شروط الاستخدام)
EDS: الاسم (لرسوم شروط الاستخدام)
EDS: الحجم (1234.2)
EDS: السعر (0 دولار أمريكي.032/كيلو وات في الساعة)
EDS: التكلفة (100 دولار.23)
تقسيم
طلب الفاتورة التاريخية EDS: فترة فاتورة البند المتسلسل (لتحليل الطلب)
EDS: اسم
EDS: الحجم (1234.2)
EDS: السعر (0 دولار أمريكي.032/كيلو وات في الساعة)
EDS: التكلفة (100 دولار.23)
بنود
سطر الفاتورة التاريخية EDS: فترة
فاتورة البند المتسلسل EDS: اسم الشحنة (DWR Bond Charge)
EDS: الحجم (1234.2)
EDS: الوحدة (كيلو وات في الساعة)
EDS: السعر (0 دولار أمريكي.032/كيلو وات في الساعة)
EDS: التكلفة (100 دولار.23)
تبدأ الفواصل
الزمنية للاستخدام التاريخي مدة الفواصل الزمنية الافتراضية للاستخدام
(بالثواني)
حجم الفواصل الزمنية للاستخدام (1234.2)
الوحدة (كيلو واط ساعة/الثرمس)
برامج
الاستجابة لطلب المرافق (DR) اسم
البرنامج أقرب تاريخ إنهاء دون الالتزام
المالي أقرب تاريخ إنهاء بغض النظر عن حالة
برنامج إيصالات الودائع للالتزام
المالي تاريخ
إلغاء التسجيل تاريخ
إلغاء التسجيل البيانات العناصر
السلع
معلمات الوقت المحلي (تفاصيل DST)
طاقة اتجاه
طاقة جودة
البيانات الافتراضية عشرة أضعاف (لقيم استخدام الفترات الزمنية)
قوة مضاعف العشرة أضعاف (للطلب المفوتر)
قوة مضاعف العشرة أضعاف (للاستخدام الإجمالي المفوتر)
طول الفاصل الزمني (للقراءة)
عملة الفاتورة التكلفة
الإجمالية مؤشرات الفاصل الزمني لوحدات الاستخدام

28 يونيو 2018

كجزء من مشروع Click-Through والتحسينات المستمرة لمنصة Share My Data Platform، أطلقت PG&E المرحلة 2 Click-Through في 28 يونيو 2018.

ما الجديد:

التغييرات الأكثر أهمية التي تؤثر على الأطراف الثالثة هي التغييرات التي تتوافق مع بروتوكول OAuth 2.0 (قامت PG&E بإزالة السلسلة الأولية من عمليات إعادة التوجيه) اعثر على التفاصيل أدناه.

هام: يُطلب من الأطراف الثالثة إجراء تغييرات على تنفيذ OAuth الحالي. لا تتوافق تغييرات المرحلة الثانية من Click-Through لشركة PG&E مع الإصدارات السابقة، لذلك من الضروري أن تقوم الأطراف الثالثة بتنفيذ التغييرات المتزامنة مع تنفيذ PG&E. بدون تنفيذ، ستتوقف عملية ترخيص العملاء الحالية عن العمل في تاريخ الانتهاء في 29 يونيو 2018. ومع ذلك، لا تتأثر التصاريح الحالية.

1. للتوافق مع بروتوكول OAuth 2.0، خفضت PG&E عدد خطوات إعادة التوجيه للتصريح. تم دمج إعادة التوجيه الأولي إلى PG&E للعملاء لتسجيل الدخول وإرسال تصريح مع طلب رمز التصريح على النحو التالي:
   • كما هو موضح في المثال أدناه، تتضمن طلبات رمز تخويل الطرف الثالث الآن إعادة توجيه متصفح العميل إلى authorizationServerAuthorizationEndpoint 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 أو إعادة التوجيه_uri المطلوبة مفقودة أو غير صالحة، فسيظهر للعميل خطأ (http 400) مع رسالة توضيحية
   • إذا كانت معلمة نوع_الاستجابة المطلوبة مفقودة أو غير صالحة، فسيتم إعادة توجيه العميل مرة أخرى إلى إعادة توجيه_uri الخاص بالطرف الثالث باستخدام معلمة خطأ "invalid_request" (المُلحقة بإعادة التوجيه_uri)
     
3. بالنسبة للعملاء الذين لديهم تصريح حالي عبر الإنترنت، قدرة طرف ثالث على طلب زوج Access_token/refresh_token جديد كجزء من تصريح جديد يحل محل التصريح الحالي (أي تصريح عبر الإنترنت لنفس الطرف الثالث ومزيج العميل). تتناول هذه الوظيفة سيناريوهات الأطراف الثالثة التي تخسر زوج Access_token/refresh_token أو تحتاج إلى تغيير نطاق التصريح الأصلي حسب موافقة العميل.
   • بالنسبة لطلبات إعادة التفويض، يرى العميل صفحة التفويض الجديدة بدلاً من صفحة "إدارة التفويض" عند إعادة توجيهها من قِبل طرف ثالث إلى PG&E للحصول على التفويض
   • بناءً على تصريح العميل، تتلقى الأطراف الثالثة إشعارًا إلى عنوان URL الخاص بالإخطار المسجل يفيد بإلغاء معرف الاشتراك القديم (يتضمن الإشعار نقطة نهاية عنوان URL لواجهة برمجة التطبيقات للتخويل لمعرف الاشتراك القديم)
     
4. قدرة العميل على الخروج عبر زر "إلغاء" على صفحة المصادقة أو صفحة التفويض مع إعادة التوجيه مرة أخرى إلى إعادة توجيه_uri للطرف الثالث باستخدام معلمة خطأ "access_denied" (المرفقة بإعادة التوجيه_uri)
5. بالنسبة للأطراف الثالثة التي تسجل بإعداد "الرؤية" على وبالتالي يتم تضمينها في قائمة الأطراف الثالثة المسجلة، سيرى العملاء متى يذهبون إلى حساب PG&E الخاص بهم عبر الإنترنت وينتقلون إلى الصفحة المقصودة مشاركة بياناتي:
   • بالنسبة للعملاء الذين يسجلون الدخول إلى حسابهم على الإنترنت لدى PG&E وينتقلون إلى الصفحة المنتقل إليها "مشاركة بياناتي" ثم يُعاد توجيههم إلى "معرّف URI لبوابة الطرف الثالث" المسجلة لدى طرف ثالث عند اختيار طرف ثالث من قائمة الأطراف الثالثة المسجلة. في هذه المرحلة، يمكن للعملاء المضي قدمًا في عملية OAuth التي بدأها الطرف الثالث. عند اجتياز هذا المسار، لن يتم عرض صفحة التفويض على العملاء بعد اختيار طرف ثالث من القائمة المنسدلة للأطراف الثالثة، ولكن سيتم إعادة توجيههم إلى "مبادرة URI لبوابة الطرف الثالث" المسجلة لدى الطرف الثالث حيث يمكنهم بدء عملية OAuth التي بدأها الطرف الثالث
   • ملاحظة: استفسرت بعض الأطراف الثالثة عن كيفية تبسيط تجربة العميل لحالة الاستخدام هذه (أي، التراخيص التي بدأت على موقع PG&E) بحيث يبدو للعميل أنه يتم نقلها مباشرةً إلى صفحة التفويض عند اختيار طرف ثالث من القائمة المنسدلة. لتسهيل تجربة العميل هذه، يمكن للأطراف الثالثة اختيار تعيين "معرّف URI لبوابة الطرف الثالث" (عبر صفحة مشاركة بياناتي وإدارة التسجيل) إلى نقطة نهاية تعيد توجيه العميل تلقائيًا إلى PG&E كجزء من طلب رمز التفويض. عند إعادة التوجيه تلقائيًا مرة أخرى إلى authorizationServerAuthorizationEndpoint، سيتخطى العميل صفحة تسجيل دخول العميل (حيث تم تسجيل دخوله بالفعل) وسينتقل مباشرةً إلى صفحة التصريح. بالنسبة لبعض الأطراف الثالثة التي سجلت قبل إصدار Share My Data Click Thru 2.0، يمكن تحقيق ذلك ببساطة من خلال تحديد URI لبوابة الطرف الثالث بحيث يساوي "شاشة تحديد نطاق الطرف الثالث" التي لم تعد مستخدمة في URI (حقل تسجيل SMD القديم الذي سيتم سحبه في إصدار مستقبلي).
     وعلى النقيض من ذلك، قد ترغب بعض الأطراف الثالثة بدلاً من ذلك في إشراك العملاء وفحصهم أولاً من جانبهم عند إعادة توجيه العملاء إلى URI "بوابة الأطراف الثالثة" قبل طلب رمز التفويض، لذلك فإن النهج المذكور أعلاه هو مجرد اقتراح.
     
6. ستقدم SMD الآن تفاصيل مُحسّنة لمعلمة النطاق كجزء من الردود على طلب رمز التخويل، وطلب رمز الوصول المميز، وواجهة برمجة تطبيقات التخويل. تسمح معلمة النطاق المحسّن بتوصيل النطاق النهائي لتصريح العميل. وعلى وجه الخصوص، تتضمن معلمة النطاق قيمة "النطاق الإضافي" التي يتم تعيينها لتحديدات تصريح العميل المدعومة من PG&E لمجموعات البيانات (على سبيل المثال، "الاستخدام"، "الفوترة"، "الأساسية"، "الحساب"، "تسجيل البرنامج"). يتم تسجيل قيم معلمات النطاق بشكل أكبر وفقًا للوثائق التالية:تنزيل تعيين سلسلة نطاق كتلة الوظائف المدعومة انقر فوق خلال 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_4745_345_46_44AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment؛الفترة الزمنية=900_3600؛مدة الحظر=يوميًا؛التاريخالطول={3P الطول التاريخي المسجل}؛AccountCollection={عدد SAs المعتمدين}؛BR={ThirdPartyID}؛dataCustodianId=PGE
     ResourceURI:{ResourceURI} على سبيل المثال: https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     تفويضURI:{AuthorizationURI} على سبيل المثال: https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     العميلمصدر البحث:{customerResourceURI} على سبيل المثال:https://آبي.خنزير.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     حامل
     
     
     
7. يمكن للأطراف الثالثة الآن التسجيل لتلقي معلومات تسجيل البرنامج المعتمدة عبر مجموعة بيانات "تسجيل البرنامج" الجديدة. سيكون كل من العملاء الذين تم قياسهم بفاصل زمني وكذلك العملاء الذين لم يتم قياسهم بفاصل زمني مؤهلين للتصريح بمشاركة البيانات من أجل SMD Click-Through Phase 2. فيما يلي ملخص رفيع المستوى لعناصر البيانات المتاحة حديثًا التي توفرها مجموعة بيانات تسجيل البرنامج:
   • التسجيل في البرنامج (اسم/حالة برنامج الاستجابة للطلب لدى PG&E ومعلومات CAISO):
   • (فوترة) عنوان الحساب
   • حالة اتفاقية الخدمة
   • تعريفة الخدمة (الحالية)
   • جهد الخدمة (الحالي) (كهربائي فقط)
   • رقم عداد الخدمة (إن وجد)
   • نوع المقياس
   • دورة قراءة المقياس (الحالي)
   • خيار سعر الاستعداد (الحالي) إذا كان مؤشر التوليد في الموقع
   • (استخدام الفاصل الزمني الافتراضي) المدة (الطول بالثواني)
   • اسم برنامج (الاستجابة لطلب PG&E المسجل) (إن وجد)
   • تاريخ الإنهاء المبكر من برنامج الاستجابة للطلب (DR) المسجل لدى PG&E دون التزام مالي
   • تاريخ الإنهاء المبكر من برنامج الاستجابة للطلب (DR) المسجل لدى PG&E بغض النظر عن الالتزام المالي
   • حالة برنامج الاستجابة للطلب (DR) (التسجيل) لشركة PG&E
   • تاريخ التسجيل في برنامج الاستجابة للطلب (DR) لشركة PG&E
   • تاريخ إلغاء التسجيل في برنامج الاستجابة للطلب (DR) لشركة PG&E
   • يتم تسجيل تخطيط Atom XML XSD (تعريف مخطط XML) لعناصر البيانات الجديدة هذه وفقًا للوثائق التالية:
     تنزيل عناصر البيانات المدعومة (PDF)
   • يتم تحديد نموذج التسلسل الهرمي للبيانات العلائقية المرتبطة وفقًا لما يلي:
     تنزيل نموذج بيانات PGE ESPI (PDF)
   • UsagePoint (المعروف أيضًا باسم SA UUID)
     • ServiceDeliveryPoint\tariffProfile(الجدول الزمني لأسعار AKA لتعريفة الخدمة الحالية بما في ذلك خيار سعر الاستعداد إن وجد)
     • قراءةالدورة (دورة قراءة المقياس الحالية)الاستخدامملخص
     • readCycle (دورة خدمة الفوترة)
     • السلعة (تشمل مستوى الجهد المفوتر للكهرباء)
     • التعريفةملف التعريفة (تعريفة الخدمة المفوترة بما في ذلك خيار سعر الاستعداد إن أمكن
   • نوع القراءة
     • السلعة (تشمل مستوى الجهد الكهربائي للتيار الكهربائي وبادئة خيار سعر الاستعداد حيثما أمكن)
   • حساب العميل
     • (عنوان فوترة العمل):
     • العنوان الرئيسي/تفاصيل الشارع...
     • العنوان الرئيسي/البلدةالتفاصيل...
     • العنوان الرئيسي/الرمز البريدي...
   • اتفاقية العميل
     • الحالة/القيمة (حالة ضمان البرنامج
   • برنامج الاستجابة للطلب
     • اسم البرنامج
     • حالة التسجيل
     • البرنامجالتاريخ/البرنامجالتاريخ
     • البرنامجالتاريخ/البرنامجالتاريخالوصف
   • العَدّاد
     • الرقم التسلسلي (معرف المقياس)
     • النوع (نوع المقياس)
     • الفاصل الزمني (الحالي)الطول
   • يتم توضيح أحدث تعريفات مخطط xml لـ ESPI (XSDs) المستخدمة لعنصر البيانات الجديد هذا وفقًا لما يلي:
     قم بتنزيل XSDs (ZIP، 49 كيلوبايت)ZIP. يفتح في نافذة جديدة.
     ملاحظة: تتوافق XSDs مع الإصدارات السابقة.
   • سيكون لدى الأطراف الثالثة القدرة على تغيير تسجيلها للسماح للعملاء باختيار مجموعة البيانات هذه خلال وقت التصريح عبر بوابة الطرف الثالث ضمن إدارة التسجيل >تحرير > القسم: حدد معلومات العميل التي تحتاجها"، وحدد خانة الاختيار تسجيل البرنامج.
   • ملاحظة:سينطبق ذلك فقط على تصاريح العملاء الجدد.
     
   • تتوفر واجهات برمجة تطبيقات جديدة لاسترداد معلومات تسجيل DR على مستوى الطرف الثالث المجمع وكذلك على مستوى تصريح العميل الفردي (مستوى مُعرّف العميل للبيع بالتجزئة)، الموضح وفقًا لما يلي:
     تنزيل واجهات برمجة تطبيقات PGE المدعومة الجديدة (PDF)
   • واجهة برمجة تطبيقات غير متزامنة لطلب معلومات تسجيل DR لجميع التخويلات إلى طرف ثالث
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • واجهة برمجة تطبيقات متزامنة لطلب معلومات تسجيل DR على مستوى تصريح العميل الفردي
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{معرف العميل للبيع بالتجزئة}

يُرجى الملاحظة: بالإضافة إلى التغييرات التي تطرأ على عملية تفويض العميل، فإن التغييرات الأخرى متوافقة أيضًا مع الإصدارات السابقة وهي تحسينات طوعية يمكن للأطراف الثالثة اختيارها للدعم.

إذا كانت لديك أي أسئلة أو تحتاج إلى دعم إضافي، فلا تتردد في إرسال بريد إلكتروني إلى sharemydata@pge.com.

ما الجديد:

1. يمكن للعملاء الآن الاستفادة من عملية التصريح بنقرة واحدة المبسطة.
   • لقد حدّثنا التفاصيل حول كيفية مشاركة العميل للبيانات مع شركتك.
     تعرّف على كيفية مشاركة العملاء للبيانات مع شركة
     
     ملاحظة: تم تحسين هذه التغييرات، وخاصة التحسينات على واجهة المستخدم الخاصة بالتصريح، للأجهزة المحمولة (على سبيل المثال، الهواتف أو الأجهزة اللوحية).
   • تم إجراء تغييرات على عملية ترخيص الإدارة التي يمكن للعملاء الوصول إليها من خلال حساب PG&E عبر الإنترنت:
     • لا يزال بإمكان العميل إزالة SAIDs من تصريح موجود، و/أو تمديد تاريخ انتهاء التصريح و/أو إلغاء التصريح في أي وقت. ومع ذلك، لإضافة SAIDs إضافية و/أو تغيير عناصر البيانات المصرح بها، يجب إلغاء التصريح الحالي وإنشاء تصريح جديد.
2. إذا رغبت في ذلك، يمكن للأطراف الثالثة الآن استخدام واجهة برمجة التطبيقات هذه لإلغاء تصاريح العملاء الفردية باستخدام أداة الوصول إلى عميل الطرف الثالث (المقدمة أثناء عملية تسجيل الطرف الثالث في SMD) عبر عملية DELETE: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   ملاحظة 1:لتنفيذ PG&E، تكون معلمة AuthorizationID هي نفس قيمة SubscriptionID.
   
   ملاحظة 2:تمنح واجهة برمجة التطبيقات الجديدة الأطراف الثالثة القدرة على إلغاء (إلغاء) التصريح. ومع ذلك، يمكن للعملاء أنفسهم فقط إزالة معرفات ضمان البرنامج و/أو تحديث تاريخ انتهاء التصريح عبر صفحات تصريح إدارة SMD.
   
   تذكير:كما هو الحال مع جميع طلبات بيانات واجهة برمجة التطبيقات، يجب على الأطراف الثالثة أولاً طلب زوج رمز مميز جديد (وصول العميل + تحديث الرمز المميز) باستخدام أحدث رموز التحديث المميزة الخاصة بهم.
   
   تذكير بفترات انتهاء صلاحية الرمز المميز:
   • رمز الوصول:ساعة واحدة
   • رمز وصول العميل: 5 دقائق
   • رموز التحديث المتطابقة: 1Yr
3. يمكن للأطراف الثالثة الآن إنشاء تسجيلات متعددة لمشاركة بياناتي (SMD) باستخدام نفس اسم الشركة والمعرف الضريبي إذا لزم الأمر. ومع ذلك، لا يزال اسم العرض (الذي يراه العملاء عند التصريح) بحاجة إلى أن يكون فريدًا.
   
   ملاحظة:جميع التغييرات المذكورة أعلاه متوافقة مع الإصدارات السابقة وهي تحسينات طوعية يمكن للأطراف الثالثة اختيار دعمها. تنزيل المستندات الداعمة لهذا الإصدار:
   
   SUPPORTED_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORT_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPPORT_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

20 ديسمبر 2015

التغييرات المطلوبة:تتطلب تحديثات SMD 2.0 التالية تغييرات من جانب أطراف ثالثة.

1. بالنظر إلى الأطراف الثالثة التي لديها تطبيقات GBCMD (Green Button Connect My Data) في العديد من المرافق إلى جانب PG&E فقط، سنعيد البياناتCustodianID (أي dataCustodianID=PGE) في إعادة التوجيه إلى ThirdPartyScopeSelectionScreenURI خلال تسلسل تفويض OAuth.
2. يجب أن تستخدم طلبات واجهة برمجة التطبيقات التي تقبل معلمات التاريخ (على سبيل المثال، طلب دفعة)، معلمات بيانات Zulu (على سبيل المثال، الحد الأقصى المنشور/الحد الأدنى المنشور). لن يتم دعم تنسيقات التاريخ الأخرى لمعلمات التاريخ في طلبات واجهة برمجة التطبيقات.
   • يتم توثيق واجهات برمجة التطبيقات التي تقبل معلمات التاريخ وفقًا لواجهات برمجة التطبيقات المرفقة والمدعومة.xlsx
3. مؤشرات وحدة الاستخدام الفاصلة المضمنة مع بيانات الاستخدام الكهربائي المقاسة بالفاصل الزمني (حسب الاقتضاء، مؤشر على فترة وحدة الاستخدام التي يتوافق معها كل فاصل زمني)
   • يُرجى الرجوع إلى تعيينات معرّف البرنامج الثابتة التي توضح بالتفصيل ما يتوافق معه تعداد كل فترة زمنية لـ TOU (على سبيل المثال، 1 = Summer Peak وما إلى ذلك). (انظر المرفق،عناصر البيانات المدعومة.xlsx )
4. يتم تحديث معرّف العميل كما هو موجود في البياناتCustodianScopeSelectionScreenURI (المستخدمة للطرف الثالث الذي بدأ OAuth) والمقدمة في مورد معلومات التطبيق التي تطلبها الأطراف الثالثة أثناء اختبار التسجيل إلى 5 أرقام إذا لم تكن موجودة بالفعل (على سبيل المثال، إضافة أصفار بادئة وما إلى ذلك). بالإضافة إلى ذلك، لم يعد عنوان URL يتضمن "&verified=true" في النهاية. ستحتاج الأطراف الثالثة إلى تحديث عناوين URL الخاصة بها وفقًا لذلك.
   • للتوضيح، تبدو البياناتCustodianScopeSelectionScreenURI كما يلي: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX هو معرّف العميل)
   • لذلك، سيتغير رقم تعريف العميل الحالي البالغ 123 إلى شيء مثل 00123 مما يعني أن بياناته الجديدةCustodianScopeSelectionScreenURI ستكون على النحو التالي:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (عنوان URL القديم سيكون على النحو التالي: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. تتغير الأطراف الثالثة المسجلة باسم "ESP" أو "مزود خدمة الطاقة" إلى نوع المستخدم القياسي. لا توجد تغييرات وظيفية، فقط في عنوان نوع المستخدم. يُعد تمييز نوع مستخدم برنامج الثبات الإلكتروني (من نوع المستخدم القياسي) تمييزًا غير ضروري، مما يسبب الارتباك أثناء عملية التسجيل دون توفير أي وظائف مختلفة، وبالتالي يتم استبعاده.

التحسينات الاختيارية: التغييرات التالية متوافقة مع الإصدارات السابقة، وهي تحسينات طوعية يمكن للأطراف الثالثة اختيار دعمها.

1. سيكون لدى الأطراف الثالثة القدرة على تغيير/تحديث شهادات SSL الخاصة بها تلقائيًا والتي قدموها في الأصل أثناء التسجيل (على سبيل المثال، عندما تقترب الشهادة من انتهاء الصلاحية) عبر بوابة الطرف الثالث تحت إدارة التسجيل >تحرير > قسم جديد: معلومات شهادة SSL (خيار التحديث).
2. يمكن للأطراف الثالثة التسجيل لتلقي معلومات الفوترة الأساسية المصرح بها ومعلومات العميل وبيانات الغاز.  سيكون كل من العملاء الذين تم قياسهم بفاصل زمني وكذلك العملاء الذين لم يتم قياسهم بفاصل زمني مؤهلين للتصريح بمشاركة البيانات لـ SMD 2.0. فيما يلي ملخص رفيع المستوى لعناصر البيانات المتاحة حديثًا:
   • معلومات الفوترة: (لكل من SAs المقاسة بالفاصل الزمني وغير الفاصلة)
     • جدول الأسعار، إجماليات الفواتير بالدولار، الاستخدام المتدرج (حسب الاقتضاء)، الطلب (حسب الاقتضاء)، إجماليات شروط الاستخدام (حسب الاقتضاء)
     • ملاحظة: بالنسبة للعملاء المعتمدين الذين يتم قياسهم بدون فترات زمنية، لن تتلقى الأطراف الثالثة سوى إجماليات استخدام الفواتير (أي في ملخص الاستخدام) ولا توجد قراءات لاستخدام الفواصل الزمنية (على سبيل المثال، القراءات بالساعة/اليوم لأنها غير متاحة)
   • معلومات العميل: (لكل من ضمان البرنامج المقنن للفاصل الزمني وغير الفاصل الزمني)
     • اسم العميل، وعنوان الخدمة، ومعرف الحساب، ومعرف اتفاقية الخدمة، وتاريخ بدء خدمة اتفاقية الخدمة،
   • بيانات استخدام الغاز بالفاصل الزمني: (الشركاء SAs للغاز المقاس بالفاصل الزمني فقط)
     • قراءات غاز الفاصل الزمني (أي يوميًا)
   • يتم رسم عناصر البيانات الجديدة بيانيًا وفقًا لعناصر البيانات المدعومة المرفقة.xlsx
   • تم توضيح التسلسل الهرمي للبيانات العلائقية المرتبطة في نموذج بيانات PGE ESPI المرفق.xlsx
   • آخر تعريفات مخطط ESPI xml (XSDs) المستخدمة لعناصر البيانات الجديدة هذه هي وفقًا لمخططات XSDs المرفقة. ملاحظة:تتوافق XSDs مع الإصدارات السابقة:
     • espiDerived.xsd (معلومات استخدام الفاصل الزمني وإصدار الفواتير)
     • Retailcustomer.xsd (معلومات العميل)

إذا كانت لديك أي أسئلة أو تحتاج إلى دعم إضافي، فلا تتردد في الاتصال بنا على ShareMyData@pge.com.

18 ديسمبر 2015

التغييرات المطلوبة: تتطلب تحديثات SMD 2.0 التالية تغييرات من جانب أولئك المستخدمين الذين يصلون إلى بياناتهم الخاصة:

1. يجب أن تستخدم طلبات واجهة برمجة التطبيقات التي تقبل معلمات التاريخ (على سبيل المثال، طلب دفعة)، معلمات بيانات Zulu (على سبيل المثال، الحد الأقصى المنشور/الحد الأدنى المنشور). لن يتم دعم تنسيقات التاريخ الأخرى لمعلمات التاريخ في طلبات واجهة برمجة التطبيقات.
   • يتم توثيق واجهات برمجة التطبيقات التي تقبل معلمات التاريخ وفقًا لواجهات برمجة التطبيقات المرفقة والمدعومة.xlsx
2. مؤشرات زمن استخدام الفاصل الزمني (TOU) المضمنة مع بيانات استخدام الكهرباء المقاسة بالفاصل الزمني (حسب الاقتضاء، مؤشر على فترة استخدام الفاصل الزمني التي يتوافق معها كل فاصل زمني)
   • يُرجى الرجوع إلى تعيينات معرّف البرنامج الثابتة التي توضح بالتفصيل ما يتوافق معه تعداد كل فترة زمنية لـ TOU (على سبيل المثال، 1 = Summer Peak وما إلى ذلك). (انظر المرفق،عناصر البيانات المدعومة.xlsx )

التحسينات الاختيارية: التغييرات التالية متوافقة مع الإصدارات السابقة، وهي تحسينات طوعية يمكن للأطراف الثالثة اختيار دعمها.

1. سيتمكن مستخدمو الوصول الذاتي من تغيير/تحديث شهادات SSL الخاصة بهم التي قدموها في الأصل أثناء التسجيل (على سبيل المثال، عندما تقترب الشهادة من انتهاء الصلاحية) تلقائيًا عبر بوابة الطرف الثالث ضمن إدارة التسجيل > تحرير > قسم جديد: معلومات شهادة SSL (خيار التحديث)
2. سيتم تحديث تسجيلات مستخدم الوصول الذاتي لتشمل معلومات الفوترة الأساسية المصرح بها ومعلومات العميل وبيانات الغاز. كلاً من اتفاقيات الخدمة المقننة بالفاصل الزمني والتي يتم قياسها بشكل جيد مثل اتفاقيات الخدمة المقننة غير المقننة بالفاصل الزمني ستكون مؤهلة للحصول على تصريح (ذاتي) لـ SMD 2.0 يكون الملخص عالي المستوى لعناصر البيانات المتاحة حديثًا على النحو التالي:
   • معلومات الفوترة: (لكل من SAs المقاسة بالفاصل الزمني وغير الفاصلة)
     • جدول الأسعار، إجماليات الفواتير بالدولار، الاستخدام المتدرج (حسب الاقتضاء)، الطلب (حسب الاقتضاء)، إجماليات شروط الاستخدام (حسب الاقتضاء)
     • ملاحظة: بالنسبة للعملاء المعتمدين الذين يتم قياسهم بدون فترات زمنية، لن تتلقى الأطراف الثالثة سوى إجماليات استخدام الفواتير (أي في ملخص الاستخدام) ولا توجد قراءات لاستخدام الفواصل الزمنية (على سبيل المثال، القراءات بالساعة/اليوم لأنها غير متاحة)
   • معلومات العميل: (لكل من ضمان البرنامج المقنن للفاصل الزمني وغير الفاصل الزمني)
     • اسم العميل، وعنوان الخدمة، ومعرف الحساب، ومعرف اتفاقية الخدمة، وتاريخ بدء خدمة اتفاقية الخدمة،
   • بيانات استخدام الغاز بالفاصل الزمني: (الشركاء SAs للغاز المقاس بالفاصل الزمني فقط)
     • قراءات غاز الفاصل الزمني (أي يوميًا)
   • يتم رسم عناصر البيانات الجديدة بيانيًا وفقًا لعناصر البيانات المدعومة المرفقة.xlsx
   • تم توضيح التسلسل الهرمي للبيانات العلائقية المرتبطة في نموذج بيانات PGE ESPI المرفق.xlsx
   • آخر تعريفات مخطط ESPI xml (XSDs) المستخدمة لعناصر البيانات الجديدة هذه هي وفقًا لمخططات XSDs المرفقة. ملاحظة:تتوافق XSDs مع الإصدارات السابقة:
     • espiDerived.xsd (معلومات استخدام الفاصل الزمني وإصدار الفواتير)
     • Retailcustomer.xsd (معلومات العميل)

إذا كانت لديك أي أسئلة أو تحتاج إلى دعم إضافي، فلا تتردد في الاتصال بنا على ShareMyData@pge.com.

18 ديسمبر 2015

التغييرات المطلوبة: تتطلب تحديثات SMD 2.0 التالية تغييرات من جانب عمليات تنفيذ CCA.

1. يجب تقديم الطلبات المخصصة (على سبيل المثال، للبيانات التاريخية)، باستخدام معلمات تاريخ الوقت Zulu. لن يتم دعم تنسيقات التاريخ الأخرى لمعلمات التاريخ في طلبات واجهة برمجة التطبيقات.
2. سيبدأ موجز الاستخدام المجمع اليومي في تضمين معلومات الفوترة الأساسية بينما يحتوي موجز العميل المجمع اليومي على معلومات عميل إضافية. سيتم توفير هذه البيانات الجديدة لكل من العملاء الذين يتم قياسهم بفاصل زمني والذين يتلقون بيانات بشأنهم حاليًا، وكذلك للعملاء الذين لا يتم قياسهم بفاصل زمني في منطقتهم التي لا يتلقون بيانات بشأنها حاليًا. وأخيرًا، ستتضمن قيم استخدام الفاصل الزمني المتوفرة في موجز الاستخدام اليومي المجمع مؤشرات وحدة استخدام الفاصل الزمني حيثما أمكن. فيما يلي ملخص رفيع المستوى لعناصر البيانات الجديدة:
   • معلومات الفوترة: (لكل من SAs المقاسة بالفاصل الزمني وغير الفاصلة)
     • جدول الأسعار، إجماليات الفواتير بالدولار، الاستخدام المتدرج (حسب الاقتضاء)، الطلب (حسب الاقتضاء)، إجماليات شروط الاستخدام (حسب الاقتضاء)
   • (إضافي) معلومات العميل: (لكل من تراخيص اشتراكات العملاء المقننة بالفاصل الزمني وغير المقننة بالفاصل الزمني)
     • اسم العميل وعنوان الخدمة وتاريخ بدء خدمة اتفاقية الخدمة ومعرف الحساب
   • مؤشرات وحدة الاستخدام الفاصلة المضمنة مع بيانات الاستخدام الكهربائي المقاسة بالفاصل الزمني (حسب الاقتضاء، مؤشر على فترة وحدة الاستخدام التي يتوافق معها كل فاصل زمني)
     • يُرجى الرجوع إلى تعيينات معرّف البرنامج الثابتة التي توضح بالتفصيل ما يتوافق معه تعداد كل وحدة TOU بفاصل زمني (على سبيل المثال، 1 = Summer Peak وما إلى ذلك). (انظر المرفق،عناصر البيانات المدعومة.xlsx )
   • أحدث تعريفات مخطط ESPI xml (XSDs) المستخدمة لعناصر البيانات الجديدة هذه هي وفقًا لمخططات XSDs المرفقة. لاحظ أن أجهزة XSD متوافقة مع الإصدارات السابقة:
     • 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، يكون لدى الطرف الثالث خيار الإرسال في معلمة الولاية التي سترسلها PG&E إلى الطرف الثالث. سترسل PG&E أيضًا رمز التصريح عند إكمال التصريح بنجاح. يمكن استخدام معلمة الحالة الاختيارية هذه لمساعدة الطرف الثالث على تحديد مكان بدء الطلب، ولربط الطلب بالتصاريح التي بدأها.
   • كجزء من الإكمال الناجح لطلب الرمز، نشارك المورد والتفويضURI بشكل منفصل عن معلومات الرمز. في الوقت الحالي، يتم قلب عناوين URI هذه وكجزء من هذا الإصدار، سنقوم بتصحيح ذلك.

العيوب الثابتة:

1. تفرض التواريخ الافتراضية المنشورة - الحد الأقصى والأدنى المنشورة -
   حاليًا PG&E على الطرف الثالث إرسال معلمات الحد الأقصى المنشورة - الحد الأدنى والأقصى المنشورة في ثوانٍ معدودة لكل طلب بيانات لإخبار PG&E بالمدة التي يطلبون البيانات خلالها. نُجري تغييرًا للتعامل مع طلبات السيناريوهات التالية:
   • القيم الحد الأدنى والأقصى المنشورة مفقودة
   • قيم الحد الأدنى والأقصى المنشورة بالتوقيت العالمي المنسق
   • تكون قيم الحد الأدنى والأقصى المنشورة في ثوانٍ معدودة
   في حالة فقدان المعلمات، ستعيد 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 الخاص بهم عبر الإنترنت. للحصول على نظرة عامة مفصلة حول كيفية تفويض العملاء لأطراف ثالثة أو كيانات أخرى للوصول إلى بياناتهم، يُرجى عرض نظرة عامة على مشاركة بياناتي من طرف ثالث.

انتقل إلى تفاصيل التفويض

• حاليًا، لا يوجد حد.

• يمكن للعملاء إما اختيار مقدار زمني محدد يمكنك من خلاله الوصول إلى بياناتهم، أو يمكنهم ترك فترة التصريح مفتوحة.
• يمكن لتطبيقك التحقق من تاريخ انتهاء تصريح العميل إلى جانب تفاصيل التصريح الأخرى عن طريق الاتصال بواجهات برمجة التطبيقات الخاصة بمورد التصريح (على سبيل المثال، .../espi/1_1/resource/Authorization و/أو.../espi/1_1/resource/Authorization/{AuthorizationID}).
• بدلاً من ذلك، يمكنك التحقق يدويًا من تواريخ انتهاء التفويض عن طريق تسجيل الدخول إلى حسابك وتحديد إدارة التفويضات.

• إذا اختار العميل فترة تفويض محددة، فإن صلاحية التفويض تنتهي في نهاية تلك الفترة الزمنية. إذا ألغوا التصريح، تنتهي صلاحية التصريح في اليوم التالي لإلغاء التصريح.
• إذا اختار العميل غير محدد كفترة تفويض، فلن تنتهي صلاحية تفويضه. لاحظ أنه في ضوء القاعدة 24 "موفرو خدمة الاستجابة للطلبات" والبرامج الأخرى التي تستخدم مشاركة "بياناتي"، قد يتم تقديم تصحيحات ما بعد الوقائع لنطاقات التواريخ المصرح بها سابقًا إلى أطراف ثالثة لمدة تصل إلى ثلاث سنوات بعد انتهاء صلاحية التصريح.
• انظر "كيف سيتم التعامل مع تصحيحات البيانات؟" لمزيد من التفاصيل حول تلقي التصحيحات.

• يمكن لأي عميل من عملاء PG&E لديه معرّف خدمة نشط حاليًا لخدمة الغاز أو الكهرباء أن يُخوّلك الوصول إلى بياناته باستخدام أداة مشاركة بياناتي الجديدة.

• يتم تشجيع العملاء المهتمين بالمشاركة في مشاركة بياناتهم عبر برنامج مشاركة بياناتي بشدة على التسجيل للحصول على حساب My Energy. وهذا سيجعل العملية بأكملها أكثر كفاءة وسيمنحهم أيضًا القدرة على إدارة تصاريحهم عبر الإنترنت.
• يمكن للعملاء التسجيل للحصول على حساب My Energy أثناء عملية التصريح.
• هناك عملية يدوية متاحة للعملاء للحصول على نموذج تفويض مشاركة بياناتي عبر الإنترنت وإرسال النموذج المكتمل عبر البريد الإلكتروني.
• لمزيد من المعلومات حول العملية اليدوية، يُرجى الاتصال بنا على ShareMyData@pge.com.

• يُطلب من العملاء تقديم تصاريحهم الخاصة عبر الإنترنت من خلال حسابهم على PG&E. ومع ذلك، إذا أكملوا نموذج تفويض مشاركة بياناتي ووقّعوا عليه، فيمكنك إرساله إلى PG&E نيابةً عنهم.

تنزيل نموذج مشاركة بياناتي تفويض العميل أو إلغاء التفويض (PDF, 308 KB)

• يمكنك تحديث عناوين URI لـ OAuth عن طريق تسجيل الدخول إلى حسابك، والانتقال إلى إدارة التسجيل > تحرير > وتحديث الحقول ضمن قسم معلومات OAuth 2.0.

• يمكنك تحديث URI الخاص بالإشعار عن طريق تسجيل الدخول إلى حسابك، والانتقال إلى إدارة التسجيل > تحرير > وتحديث الحقول ضمن قسم معلومات الوصول إلى البيانات.

• يمكنك تحديث شهادة SSL عن طريق تسجيل الدخول إلى حسابك، والانتقال إلى إدارة التسجيل > تحرير > وتحديد "تحديث" في قسم معلومات شهادة SSL. لاحظ أنه بالنسبة لعمليات تحميل الشهادات الجديدة، قد يستغرق تحديث أنظمة PG&E بالشهادة الجديدة عدة أيام.  
• سيتم إرسال بريد إلكتروني للتأكيد من فريق "مشاركة بياناتي" عند تطبيق الشهادة الجديدة.

• بمجرد أن تتلقى رسالة بريد إلكتروني تشير إلى قبول تسجيلك، ستتمكن من تسجيل الدخول إلى حساب مشاركة بياناتي وتنزيل شهادة SSL عبر صفحة تنزيل شهادة PG&E SSL.

تسجيل الدخول لمشاركة بياناتي

• مشاركة بياناتي تتبع اتفاقيات تنفيذ الزر الأخضر توصيل بياناتي. تستخدم Share My Data أيضًا OAuth 2.0 للتصريح، وTLS (أمان طبقة النقل) 1.2، والحد الأدنى لمجموعة بروتوكولات الأمن السيبراني المعتمدة من المعهد الوطني للمعايير والتكنولوجيا (NIST) بحيث لا يتم تبادل أي معلومات بشكل واضح.

• تأتي حماية معلومات العملاء على رأس أولويات PG&E. تتعامل شركة PG&E مع المعلومات المتعلقة بعملائها - بما في ذلك المعلومات الشخصية - على أنها سرية، بما يتفق مع جميع المتطلبات القانونية والتنظيمية، بما في ذلك تلك التي وضعتها لجنة كاليفورنيا للمرافق العامة وغيرها.  
• لأكثر من عقدين من الزمان، خضعت شركة PG&E وغيرها من المرافق المملوكة للمستثمرين في كاليفورنيا للوائح CPUC الصارمة التي تحظر عليهم الإفصاح عن المعلومات الخاصة بالعملاء، مثل بيانات الفوترة، لأطراف ثالثة دون موافقة صريحة من العميل.  
• بمجرد أن يصرح العميل بالكشف عن البيانات، يتحمل العميل والطرف الثالث مسؤولية حماية تلك البيانات.
• يمكن للعميل اختيار التوقف عن مشاركة البيانات مع طرف ثالث في أي وقت عن طريق تسجيل الدخول إلى حساب PG&E الخاص به عبر الإنترنت وإلغاء تصريحه. تتوفر سياسة الخصوصية الكاملة لشركة PG&E وإشعار الوصول إلى معلومات استخدام الطاقة وجمعها وتخزينها واستخدامها والإفصاح عنها على pge.com/privacy.

• في نطاق برنامج مشاركة بياناتي، تخضع الأطراف الثالثة لقواعد خصوصية وحماية بيانات العميل المحددة في شروط وأحكام منصة مشاركة بياناتي والمتطلبات المدرجة في تعريفة الوصول إلى بيانات العميل.
• تخضع الأطراف الثالثة أيضًا لجميع القوانين واللوائح الأخرى المعمول بها المتعلقة بحماية خصوصية العملاء، بما في ذلك، على سبيل المثال لا الحصر، القواعد المتعلقة بالخصوصية والحماية الأمنية لبيانات استخدام الطاقة التي اعتمدتها CPUC في الملحق د بالقرار 11-07-056 (الكهربائي)، والملخصة أيضًا في قاعدة PG&E الكهربائية رقم 27، وقسم القانون المدني في كاليفورنيا 1798.80 - 1798.84.
• لمزيد من المعلومات، يُرجى تحديد الروابط أدناه:
  مشاركة شروط وأحكام بياناتي (PDF، 190 كيلوبايت)
  القاعدة الكهربائية رقم 27 (PDF، 1.6 ميجابايت)
  المرفق د بالقرار 11-07-056 (PDF)
  العثور على مزيد من المعلومات:القانون المدني لولاية كاليفورنيا القسم 1798.80 – 1798.84

• يُرجى الرجوع إلى الرابط أدناه للحصول على قائمة تفصيلية بعناصر البيانات المدعومة.

احصل على مزيد من المعلومات حول الوصول إلى البيانات

• في بعض الأحيان، تكون بيانات استخدام الفواصل الزمنية مفقودة لأن عمليات التحقق من صحة البيانات الأولية لدينا وجدت أن هناك قراءات بيانات مفقودة أو غير صحيحة قد تتطلب مزيدًا من المعالجة (التحرير و/أو التقدير).
• بالنسبة للعملاء الذين يتم فوترتهم بفواصل زمنية (على سبيل المثال، العملاء الذين لديهم اعتبارات فوترة وقت الاستخدام)، يتم تصحيح هذه الحالات في الوقت المناسب لضمان حساب دقيق للفواتير على فاتورتهم الشهرية القادمة.

• إذا كنت ترغب في تلقي تصحيحات البيانات، فيُرجى التأكد من تحديد خانة الاختيار "إخطاري" لأن البيانات جاهزة أثناء التسجيل أو عن طريق تسجيل الدخول إلى حسابك عبر الإنترنت وتحديد خانة الاختيار هذه أسفل "تحرير ملف التعريف". سنقوم بعد ذلك بتضمين تصحيحات البيانات التي سجلها نظامنا خلال الـ 24 ساعة السابقة، كجزء من موجز الاستخدام اليومي، لأي بيانات مصرح لك بالوصول إليها.
• ستغطي تصحيحات البيانات أي تغييرات للفترة المصرح بها، حتى ثلاث سنوات كحد أقصى.

ملاحظة: في ضوء القاعدة 24: مقدمو خدمة الاستجابة للطلبات والبرامج الأخرى التي تستخدم مشاركة بياناتي، يمكن تقديم تصحيحات ما بعد الوقائع لنطاقات التواريخ المصرح بها سابقًا إلى أطراف ثالثة لمدة تصل إلى ثلاث سنوات بعد انتهاء صلاحية التصريح.

• إذا كان ذلك ممكنًا، سترسل PG&E إشعارات إلى عنوان URL الخاص بالإشعار المقدم أثناء التسجيل. تشتمل الإشعارات على عناوين URL مطابقة للبيانات المعبأة مسبقًا الجاهزة لك للعودة وطلبها على عناوين URL المقدمة. البيانات معبأة مسبقًا ويتم إرسال الإشعارات في السيناريوهين التاليين: (1) لقد حددت "إخطاري لأن البيانات جاهزة" في ملف تعريف التسجيل الخاص بك، وفي هذه الحالة سنجمع أحدث البيانات اليومية مع أي تصحيحات للتواريخ السابقة، أو (2) لقد قدمت طلبًا غير متزامن مخصصًا سابقًا أصبحت البيانات المطلوبة جاهزة له الآن. يتم توضيح السيناريو 1 تحت عنوان "DATA ACCESS: الاشتراك اليومي" في مخططات طرق الوصول إلى البيانات في صفحة الوصول إلى البيانات والسيناريو 2 موضح تحت "الوصول إلى البيانات: طلب AD HOC (غير متزامن)" من نفس المخططات أيضًا في صفحة الوصول إلى البيانات.

زيارة الوصول إلى البيانات أعلاه

• لا تُعد بيانات الاستخدام الكهربائي التي تقدمها مشاركة بياناتي بيانات مقياس جودة التسوية (SQMD) كما هو محدد من قِبل مشغل النظام المستقل في كاليفورنيا (CAISO). يتم إنشاء SQMD عن طريق ضرب بيانات مقياس جودة الإيرادات (RQMD) في عامل فقدان التوزيع (DLF) المطبق على مستوى الجهد الخاص بذلك العميل لتلك الفترة، وتحويل الفواصل المقننة إلى الفترة الفاصلة التي يطلبها CAISO ثم جمع النتائج لكل فاصل إلى المستوى الكلي الذي يطلبه CAISO.
  
• تُنفّذ PG&E علامات من نوع "QualityOfReading" (QOR) المُقدَّم من خلال معيار ESPI لمعرفة ما إذا كانت البيانات هي جودة الإيرادات. يلتقط نوع QOR قيم جودة محتملة مختلفة لبيانات الاستخدام، بما في ذلك قيمة صريحة لـ "بيانات مقياس جودة الإيرادات" أو "RQMD". ستستخدم PG&E نوع QOR هذا في نقل بياناتها على النحو التالي:
  • تدعم PG&E فصل "ملخص الاستخدام" المقدم من ESPI، والذي سيتم استخدامه لتحديد التواريخ التي يتم فيها إصدار فاتورة لاتفاقية الخدمة، ومبلغ الاستخدام المفوتر، وجودة بيانات الاستخدام في وقت الطلب. سيتم ملء ملخص الاستخدام بمجرد توفر الفاتورة للبيانات المطلوبة وستشمل علامتين (عناصر) من نوع QOR:
    • ملخّص الاستخدام.الجودةعنصر القراءة (على مستوى ملخّص الاستخدام) الذي يُشير إلى الجودة في وقت طلب أحدث قيم استخدام الفواصل الزمنية المُقدّمة بالإضافة إلى التصحيحات المقابلة لتواريخ UsageSummary.billingPeriod.
    • عنصر الجودة الافتراضية للاستهلاك الكليالفترة الأخيرة (كجزء من ملخص الاستخدام.الاستهلاك الكليالفترة الأخيرة.نوع القراءةالمرجع) يشير إلى جودة إجمالي الاستخدام المفوتر.
  • ستقوم PG&E أيضًا بتوصيل بيانات جودة الاستخدام على مستوى الفاصل الزمني في وقت الطلب باستخدام عنصر IntervalReading.ReadingQuality.Quality.

• أثناء التسجيل، يمكنك تحديد كمية البيانات التاريخية التي تحتاجها، إما 24 أو 36 أو 48 شهرًا تحت القائمة المنسدلة "كم من البيانات التاريخية مطلوبة".
• كجزء من تصريح العميل الذي يسمح لك بالوصول إلى بياناته، سيتم تعيين الفترة التاريخية للتصريح افتراضيًا على اختيار التسجيل الخاص بك لمعرفات الخدمة (نقاط الاستخدام) المضمنة في التصريح.
• يمكنك تحديث بياناتك التاريخية المطلوبة، عن طريق تسجيل الدخول إلى حسابك، والانتقال إلى إدارة التسجيل > تحرير > والتحديد من القائمة المنسدلة التي تحمل العنوان "كم من البيانات التاريخية مطلوبة".
• يُرجى ملاحظة أن البيانات المقدمة في الطلب التاريخي ستبدأ بتاريخ تقديم العميل للتصريح، على عكس التاريخ الذي قدمت فيه الطلب إلى واجهة برمجة التطبيقات.

ملاحظة: لا تؤثر التغييرات التي تطرأ على بياناتك التاريخية المطلوبة إلا على تصاريح العملاء الجدد، بينما ستعكس تصاريح العملاء السابقة اختيارك في وقت التصريح.

• وفقًا لمعيار ESPI، تستخدم الإجابة معيار نشر الذرة. يُرجى تحديد الرابط أدناه للاطلاع على قائمة كاملة بواجهات برمجة التطبيقات المدعومة، بالإضافة إلى عناصر البيانات المتاحة.

احصل على مزيد من المعلومات حول الوصول إلى البيانات

• مُعرّفات خدمة الكهرباء والغاز النشطة المثبتة والمقروءة من قِبل PG&E مؤهلة للحصول على تصريح عبر منصة مشاركة بياناتي.
• إذا تغير مُعرّف الخدمة المرتبط بتصريح ما بسبب أحد الأسباب التالية، فسينتقل التصريح إلى مُعرّف الخدمة الجديد وسيستمر الوصول إلى بيانات استخدام الفاصل الزمني التاريخي:
  • إيقاف مؤقت بسبب عدم الدفع
  • الانتقال إلى فوترة الفاصل الزمني
  • استبدال العداد
  • تغيير السعر
• ستؤدي السيناريوهات الأخرى التي تؤدي إلى تغيير في معرّف الخدمة مثل المواقع المتحركة أو تغيير الشركة إلى إنهاء الوصول. بالإضافة إلى ذلك، إذا كان الحساب غير مرتبط بحساب My Energy الخاص بك، فإن جميع معرفات الخدمة الأساسية التي تم التصريح بها عبر مشاركة بياناتي ستكون غير مصرح بها نتيجة لذلك.

• لتحديد دقة بيانات الفواصل الزمنية المسموح بها، يُرجى الرجوع إلى عنصر طول الفواصل الزمنية كما هو منصوص عليه في معيار ESPI.
• توفر شركة PG&E بيانات استخدام الفاصل الزمني بنفس التفصيل الذي تم جمعه لأغراض الفوترة، والذي يكون عمومًا على أساس كل ساعة أو 15 دقيقة للبيانات الكهربائية ويوميًا لبيانات الغاز للعملاء الذين لديهم مقاييس فاصلة. في حين أنه يمكن أن يختلف حسب العميل، فإن استخدام مقياس الفاصل الزمني الكهربائي متاح بشكل عام على المستوى بالساعة لمعظم العملاء المقيمين وعلى مستوى الفاصل الزمني لمدة 15 دقيقة لمعظم العملاء التجاريين، كما أن استخدام مقياس الفاصل الزمني للغاز متاح بشكل عام على المستوى اليومي لمعظم العملاء.
• بالنسبة للعدادات غير الفاصلة، سيتم توفير البيانات عند توفرها.

• بالنسبة للغالبية العظمى من عملاء PG&E الذين لديهم مقياس ذكي مثبت، تتوفر بيانات استخدام الفاصل الزمني بين الكهرباء والغاز بحلول نهاية اليوم التالي عبر منصة مشاركة بياناتي.
• قد يتطلب الجزء الصغير من عملاء PG&E الكهربائيين الذين تم تركيب MV90 مترًا على حامل خط الطاقة وقتًا إضافيًا حتى تتوفر البيانات.

• على الرغم من أننا لا نستطيع دعم إعداد واجهات برمجة التطبيقات الخاصة بك بشكل مباشر، إلا أن لدينا عددًا من الموارد المتاحة لمساعدة قسم تكنولوجيا المعلومات والموارد الفنية في عملية التطوير. يُرجى الرجوع إلى صفحة وثائق واجهة برمجة التطبيقات لمعرفة المزيد. يُرجى أيضًا عدم التردد في التواصل مع ShareMyData@pge.com لطرح أي أسئلة إضافية.

لمزيد من المعلومات، تفضل بزيارة واجهة برمجة التطبيقات (API)