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

من أجل الامتثال لمعيار واجهة مزود خدمة الطاقة (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={اختياريالولاية}

• معلمات الطلب الإلزامي:
  • 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) بحيث يبدو للعميل أنه يتم نقلها مباشرةً إلى صفحة التفويض عند اختيار طرف ثالث من القائمة المنسدلة. لتسهيل تجربة العميل هذه، يمكن للأطراف الثالثة اختيار تعيين "معرّف المستخدم على بوابة الطرف الثالث" (عبر صفحة مشاركة بياناتي وإدارة التسجيل) إلى نقطة نهاية تعيد توجيه العميل تلقائيًا إلى 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.

مثال: طلب رمز الوصول المميز
المنشور: 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_47؛ AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ؛IntervalDuration=900_3600؛BlockDuration=يوميًا؛HistoryLength={3P طول تاريخي مسجل}؛AccountCollection={عدد من SAs المصرح بها}؛BR={الطرف الثالثID}؛dataCustodianId=PGE
ResourceURI:{ResourceURI} على سبيل المثال: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AuthorizationURI} على سبيل المثال: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
CustomerResourceURI:{customerResourceURI} على سبيل المثال:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
حامل

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

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

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

authorizationServerAuthorizationEndpointhttps://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"

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

ستبدو الإجابة الناجحة على النحو التالي:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"نوع_الرمز المميز": "حامل"،
"Expires_in": 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 الطول التاريخي المسجل}؛الحسابمجموعة={عدد 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"
}

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

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

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

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

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

• يمكنك الاتصال بواجهة برمجة التطبيقات الخاصة بالتخويل (عملية http GET) باستخدام Client_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)

ملاحظة: بالنسبة لطلبات API التي تقبل معلمات الحد الأقصى للتاريخ المنشور والأدنى للتاريخ المنشور، يكون الإعداد الافتراضي هو 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}? منشور-الحد الأدنى={startDate}و منشور-الحد الأقصى={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}?تم النشر-الحد الأدنى={startDate}تم النشرالحد الأقصى={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 يونيو 2024

منصة مشاركة بياناتي (SMD) الخاصة بشركة PG&E لمشاركة البيانات المصرح بها من قبل العميل مع مقدمي الخدمات الخارجيين الذين أصدروا المرحلة 2 من تحسين معرّف جهاز القياس، مما يسمح بتحديد معرّف جهاز القياس الفردي المرتبط ببيانات جهاز القياس الكهربائي بفاصل زمني.  

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

المرحلة 1:  تم إصداره في مارس 2023 - تم تعديل واجهات برمجة التطبيقات المتأثرة لبدء إضافة قيمة إلى جانب قيمة في الإجابة المرتجعة، تحت علامة . هناك تطابق واحد لواحد بين قيمة الرقم التسلسلي وقيمة utcNumber.

تسمح هذه المعلومات للبائعين الذين يستخدمون واجهة برمجة التطبيقات هذه بإنشاء مخزن للسجلات باستخدام رقم utcNumber بالإضافة إلى قيمة الرقم التسلسلي المرتبطة بمقياس معين لقاعدة عملائهم قبل إصدار تحسين المرحلة 2.

المرحلة 2: تم إصداره في 20 يونيو 2024 - يحل محل قيم معرّف قراءة المقياس من التنسيق الحالي للترميز64 للقيم الوصفية للعداد برقم utcNumber. بمجرد تنفيذ هذه التغييرات بالكامل، سيتمكن مستخدمو مشاركة بياناتي من تحسين القدرة على الربط باستخدام فاصل زمني محدد للعدادات، في الحالات التي يوجد فيها عدة مقاييس لنفس السلعة مرتبطة باتفاقية خدمة واحدة في المقر، بمعرف العداد المحدد الذي أنشأ الاستخدام. 

تتأثر واجهات برمجة التطبيقات التالية بالتغييرات في المرحلة 2

واجهة برمجة التطبيقات المتأثرة:

.../espi/1_1/الموارد/الاشتراك/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

.../espi/1_1/الموارد/الاشتراك/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}

.../espi/1_1/الموارد/الاشتراك/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock

.../espi/1_1/الموارد/الاشتراك/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock/{IntervalBlockID}

لا تتغير جميع واجهات برمجة التطبيقات الأخرى ذات القراءات الفاصلة وتمثل مجموع فترات العداد في كلا اتجاهي التدفق ومع جميع العدادات بموجب اتفاقية الخدمة.

قبل التحرير، كان حقل MeterReadingID مشفرًا Base64 وتظهر القيمة المرتجعة على النحو التالي:

معرّف قراءة المقياس= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

تم فك ترميزها من تنسيق Base64 كـ:  NzI6bnVsbDozNjAwOjE =:1:1

يعرض هذا قراءةمعرف النوع:الصف:العدد، ويتم فك ترميز قيمة معرف نوع القراءة من Base64 مرة أخرى كـ:

72:null:3600:1 حيث تكون القيم uom:phase:intervalLength:flowDir

UOM=72، الطور=خالي، الفاصل الزمنيالطول=3600، التدفقDir=1 (تم التسليم)

في المرحلة 2، يتم إلحاق حقل معرّف قراءة المقياس بأحرف إضافية وبعد المرور بعملية فك تشفير أولية، سيعود بمثال النتائج التالية

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

تم فك ترميزها من Base64 مرة واحدة:  NzI6bnVsbDozNjAwOjE =:1:1:4411310546، 

يوضح هذا أن قيمة Meter_UUID هي 4411310546، ويجب أن تتطابق هذه القيمة مع قيمة المتوفرة في واجهة برمجة تطبيقات RetailCustomer ضمن علامة .

قيمة "NzI6bnVsbDozNjAwOjE=:1:1:" هو ReadingTypeID:rownum:count، أي أن رقم الصف هو 1 والعدد هو 1 المرتبط بسجلات قاعدة البيانات الداخلية لشركة PG&E. يتم فك ترميز معرف نوع القراءة مرة أخرى كـ:

72:null:3600:1، حيث تكون القيم uom:phase:intervalLength:flowDir

UOM=72، الطور=خالي، الفاصل الزمنيالطول=3600، التدفقDir=1 (تم التسليم)

يسمح هذا التغيير للمستخدمين بتحديد المقياس الفيزيائي واتجاه التدفق محل الاهتمام في قراءات الفاصل الزمني. لاحظ أن جميع ملفات XML ستحمل الآن قيم معرّف MeterReading الجديدة وستطبق شكل المرحلة 2 الجديد من الترميز. تنصح مشاركة بياناتي جميع الموردين الذين يستخدمون أي مكالمة API باستخدام MeterReadingID، بإجراء مكالمة API التالية للحصول على معرّف MeterReadingID الجديد: .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

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
معرف الخدمة
التغييرات المستقبلية في حالة الخدمة
حالة ضمان البرنامج
تاريخ بدء الخدمة
عنوان الخدمة
تعريفة الخدمة الحالية
تعريفة الخدمة التاريخية المفوترة
خيارات التعريفة (خط الأساس الطبي، CARE، FERA، TBS، CCA_TBS، اختيار الطاقة الشمسية
فولطية الخدمة الحالية وفولطية الخدمة التاريخية المفوترة للسلع
رقم عداد الخدمة
عدد عدادات الخدمة
نوع المقياس
دورة قراءة المقياس الحالي
دورة قراءة المقياس المفوتر التاريخي
خيار سعر الاستعداد الحالي إذا كان مؤشر التوليد في الموقع
خيار سعر الاستعداد التاريخي المفوتر
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)
تاريخ الإنهاء المبكر دون التزام مالي
تاريخ الإنهاء المبكر بغض النظر عن الالتزام المالي
حالة برنامج DR
تاريخ التسجيل في برنامج DR
تاريخ إلغاء تسجيل برنامج إيصالات الودائع
عناصر البيانات
السلعة
معلمات الوقت المحلي (تفاصيل DST)
جودة البيانات الافتراضية
اتجاه الطاقة
قوة مضاعف العشرة (لقيم استخدام الفواصل الزمنية)
مضاعف قوة العشرة (للطلب المفوتر)
مضاعف قوة العشرة (للاستخدام الإجمالي المفوتر)
طول الفاصل الزمني (قراءة الاستخدام)
عملة التكلفة الإجمالية للفواتير
مؤشرات وحدة التشغيل الفاصلة الكهربائية

28 يونيو 2018

كجزء من مشروع Click-Through والتحسينات المستمرة على منصة Share My Data، أطلقت 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={اختياريالولاية}
   • تم إنهاء نقطة النهاية التالية: 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) بحيث يبدو للعميل أنه يتم نقلها مباشرةً إلى صفحة التفويض عند اختيار طرف ثالث من القائمة المنسدلة. لتسهيل تجربة العميل هذه، يمكن للأطراف الثالثة اختيار تعيين "معرّف المستخدم على بوابة الطرف الثالث" (عبر صفحة مشاركة بياناتي وإدارة التسجيل) إلى نقطة نهاية تعيد توجيه العميل تلقائيًا إلى PG&E كجزء من طلب رمز التفويض. عند إعادة التوجيه تلقائيًا مرة أخرى إلى authorizationServerAuthorizationEndpoint، سيتخطى العميل صفحة تسجيل دخول العميل (لأنه قام بتسجيل الدخول بالفعل) وسينتقل مباشرةً إلى صفحة التصريح. بالنسبة لبعض الأطراف الثالثة التي سجلت قبل إصدار Share My Data Click Thru 2.0، يمكن تحقيق ذلك ببساطة من خلال تحديد 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_47؛ AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ؛IntervalDuration=900_3600؛BlockDuration=يوميًا؛HistoryLength={3P طول تاريخي مسجل}؛AccountCollection={عدد من SAs المصرح بها}؛BR={الطرف الثالثID}؛dataCustodianId=PGE
     ResourceURI:{ResourceURI} على سبيل المثال: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AuthorizationURI} على سبيل المثال: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     CustomerResourceURI:{customerResourceURI} على سبيل المثال:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     حامل
     
     
     
7. يمكن للأطراف الثالثة الآن التسجيل لتلقي معلومات التسجيل في البرنامج المعتمدة عبر مجموعة بيانات "تسجيل البرنامج" الجديدة. سيكون كل من العملاء الذين تم قياسهم بفاصل زمني وكذلك العملاء الذين لم يتم قياسهم بفاصل زمني مؤهلين للتصريح بمشاركة البيانات من أجل 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 (دورة خدمة الفوترة)
     • السلعة (تشمل مستوى الجهد المفوتر للكهرباء)
     • ملف التعريفة (تعريفة الخدمة المفوترة بما في ذلك خيار سعر الاستعداد إن أمكن
   • نوع القراءة
     • السلعة (تشمل مستوى الجهد الكهربائي للتيار الكهربائي والبادئة لخيار معدل الاستعداد حيثما أمكن)
   • حساب العميل
     • (عنوان فوترة العمل):
     • العنوان الرئيسي/تفاصيل الشارع...
     • العنوان الرئيسي/البلدةالتفاصيل...
     • العنوان الرئيسي/الرمز البريدي...
   • اتفاقية العميل
     • الحالة/القيمة (حالة ضمان البرنامج
   • برنامج الاستجابة للطلب
     • اسم البرنامج
     • حالة التسجيل
     • البرنامجالتاريخ/البرنامجالتاريخ
     • البرنامجالتاريخ/البرنامجالتاريخالوصف
   • العَدّاد
     • الرقم التسلسلي (معرف المقياس)
     • النوع (نوع المقياس)
     • الفاصل الزمني (الحالي)الطول
   • يتم توضيح أحدث تعريفات مخطط ESPI xml (XSDs) المستخدمة لعنصر البيانات الجديد هذا وفقًا لما يلي:
     تنزيل XSDs (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 المرفق
   • آخر تعريفات مخطط xml لـ ESPI (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 المرفق
   • آخر تعريفات مخطط xml لـ ESPI (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 )
   • آخر تعريفات مخطط xml لـ ESPI (XSDs) المستخدمة لعناصر البيانات الجديدة هذه هي وفقًا لـ XSDs المرفقة. لاحظ أن 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، يكون لدى الطرف الثالث خيار الإرسال في معلمة الولاية التي سترسلها 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 كيلوبايت)

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

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

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

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

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

• مشاركة بياناتي تتبع اتفاقيات تنفيذ الزر الأخضر توصيل بياناتي. تستخدم مشاركة بياناتي أيضًا 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 ميجابايت)
  المرفق د بالقرار 056-07-11 (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)