تنبيه عاجل

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

السماح لجهات خارجية بالوصول إلى بيانات استخدام الطاقة الخاصة بك

أيقونة إشعار مهم ملاحظة: ترجم جهاز كمبيوتر هذه الصفحة. إذا كانت لديك أسئلة، فاتصل بخدمات اللغة على الرقم 6789-600-877-1.

      تقدم الشركات الخارجية تحليلات وأدوات لمساعدتك على توفير المال.

      ما المقصود بمشاركة بياناتي؟

       

      مشاركة بياناتي هي الجيل التالي من أداة Green Button Connect My Data®.

       

      هل أنت مسجل بالفعل كمورد معتمد لمشاركة بياناتي؟

      تسجيل الدخول

       

      من يمكنه استخدام مشاركة بياناتي؟

       

      • العملاء التجاريون
      • العملاء المقيمون
      • الجامعات والباحثون
      • بائعو البرامج
      • الشركات الناشئة في مجال الطاقة
      • شركات الطاقة الشمسية
      • مجمعو الخيارات المجتمعية
      • الاستجابة للطلب
      • المركبات الكهربائية
      • وغير ذلك الكثير

      مشاركة عملية البيانات الخاصة بي

      ما فوائد مشاركة بياناتي؟

       

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

       

      الوصول الموثوق إلى البيانات

      وصول ثابت وموثوق للبيانات من خلال واجهات برمجة التطبيقات. لا حاجة إلى "كشط الشاشة" أو تنزيل البيانات بعد الآن.

       

      واجهات برمجة التطبيقات القياسية

      تنسيق API لواجهة مزود خدمة الطاقة القياسي المعترف به وطنيًا لقابلية التشغيل البيني مع مزودي الطاقة الآخرين.

       

      الفوترة والحساب

      يمكن لعملاء PG&E السماح بالوصول إلى معلومات الفواتير والحسابات الخاصة بهم أيضًا.

       

      كمية البيانات وجودتها

      الوصول إلى جميع بيانات الاستخدام والفوترة من مصدر واحد.

       

      الكهرباء والغاز

      تتضمن مشاركة بياناتي بيانات الفاصل الزمني لعميل PG&E لكل من استخدام الكهرباء والغاز.

       

      الابتكار المفتوح

      حالات الاستخدام محدودة فقط بمخيلتك (وبعض الشروط والأحكام).

       

      ابدأ بمشاركة بياناتي

      هناك عدة طرق للوصول إلى البيانات المصرح بها من قبل العميل عبر واجهة برمجة التطبيقات. تتبع أحدث واجهات برمجة التطبيقات الخاصة بنا معيار واجهة مزود خدمة الطاقة (ESPI) لمجلس معايير الطاقة في أمريكا الشمالية (NAESB) وتوفر الوصول إلى معلومات استخدام الطاقة (EUI) من خلال مجموعة من واجهات RESTful.

       

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

      قبل أن تبدأ عملية التسجيل، تأكد من توفر المعلومات التالية لديك.

       

      • رقم التعريف الضريبي: رقم تعريف صاحب العمل الأمريكي (EIN) المكون من 9 أرقام
      • معلومات الاتصال التجارية والفنية
      • مُعرّفات الموارد الموحدة (URIs): تستخدم منصة مشاركة بياناتي بروتوكول OAUth2.0 للتصريح. إذا كان نوع المستخدم الذي حددته يتطلب OAuth ثلاثي الأرجل للوصول إلى البيانات، فستحتاج إلى تقديم URIs صالحة قبل أن نتمكن من قبول تسجيلك.
        تعرف على المزيد حول تفاصيل الاختبار
      • URI: ستحتاج إلى تقديم إشعار URI حتى تتمكن أنظمتنا من إخطارك عندما تكون بياناتك المطلوبة جاهزة.
        تعرف على المزيد حول عنوان URL الخاص بالإشعارات في علامة تبويب الوصول إلى البيانات
      • بروتوكول نقل النص التشعبي الآمن (HTTPS): ستحتاج إلى الحصول على شهادة TLS1.2 X.509 صالحة من موفر SSL معترف به. لا يتم قبول الشهادات الموقعة ذاتيًا وسيؤدي تقديم شهادة SSL الموقعة ذاتيًا إلى تأخير الموافقة على تسجيلك.

      تسمح لك عملية تسجيل مشاركة بياناتي بتحديد هويتك لشركة PG&E كشركة - أو كيان آخر - ترغب في الوصول إلى البيانات المصرح بها من قِبل العميل وإعداد الوصول إلى واجهات برمجة التطبيقات الخاصة بنا. هناك أربعة أنواع مختلفة من المستخدمين لمشاركة بياناتي. حدد نوع المستخدم المناسب للوصول المطلوب.

       

      • المستخدم القياسي: مستخدم قياسي تابع لجهة خارجية. نوع التسجيل: مستقل
      • مستخدم الوصول الذاتي: فرد أو ممثل لكيان يطلب الوصول إلى بياناتك الخاصة.
      • تمويل كفاءة الطاقة: مؤسسة تقدم الخدمات المتعلقة بالسداد على الفاتورة أو التمويل على الفاتورة أو برامج تمويل كفاءة الطاقة السكنية
      • Community Choice Aggregator: مُجمِّع Community Choice (CCA) مسجل في منطقة خدمة PG&E. لمراجعة قائمة اتفاقيات CCAs المسجلة الحالية، قم بزيارة Community Choice Aggregation .

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

      يتم تقديم طلبات البيانات والردود باستخدام بروتوكول HTTPS وتتم المصادقة عليها عبر تبادل شهادات ثنائي الاتجاه مع PG&E. ستحتاج إلى تنفيذ شهادات الأمان لاتصالات API الواردة والصادرة الآمنة.

      ستحتاج أيضًا إلى الاحتفاظ بشهادات RSA غير منتهية الصلاحية وغير منتهية الصلاحية بطول مفتاح عام لا يقل عن 2048 بت. تُعد شهادة SSL شرطًا أساسيًا لإكمال الاختبار، لذا يُرجى التأكد من أن شهادتك جاهزة ومتاحة. تدعم PG&E حاليًا شهادات SHA-2 X.509 فقط الصادرة عن سلطات الشهادات ذات السمعة الطيبة (لا تقبل PG&E الشهادات الموقعة ذاتيًا)، بما في ذلك AddTrust، Comodo، DigiCert. Entrust وGlobalSign وGo Daddy وUSERTrust وVeriSign.

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

      تنزيل شروط وأحكام مشاركة بياناتي (PDF، 175 كيلوبايت)
      تنزيل حماية الخصوصية والأمان لبيانات استخدام الطاقة (PDF)

       

      تأكيد عنوان البريد الإلكتروني

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

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

      • اختبار اتصال واجهة برمجة التطبيقات
      • اختبار OAuth
      • طلب موارد معلومات التطبيق

      المتابعة إلى تعليمات الاختبار

      أيقونة إشعار مهمملاحظة: يجب عليك إكمال الاختبار في غضون 90 يومًا من استلام الإشعار.

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

      لمعرفة المزيد عن عملية التصريح، يُرجى زيارة صفحة نظرة عامة على تصريح العميل.

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

      المتطلبات الأساسية

      يجب استيفاء المتطلبات الأساسية التالية قبل أن تتمكن من الوصول إلى واجهات برمجة التطبيقات الخاصة بنا:

       

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

       

      من المهم إكمال الاختبار في غضون 90 يومًا من قبول تسجيلك. إذا لم تتمكن من إكمال الاختبار في غضون 90 يومًا، فستنتهي صلاحية تسجيلك وستحتاج إلى إعادة التسجيل.

       

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

      أنواع المستخدمين التالية مطلوبة لإكمال اختبار اتصال واجهة برمجة التطبيقات:

      المستخدم القياسي، والوصول الذاتي، وتمويل كفاءة الطاقة، ومجمّع الاختيارات المجتمعية

      الغرض:

      يتمثل الغرض من اختبار اتصال واجهة برمجة التطبيقات في ضمان قدرتك على الاتصال بواجهات برمجة تطبيقات مشاركة بياناتي.

      موصى به: استرداد رمز وصول العميل باستخدام خطوات عينة SOAP UI
      لتنفيذ الخطوة الأولى من اختبار الاتصال (استرداد رمز وصول العميل) باستخدام أداة SOAP UI.
      قم بتنزيل أداة SOAP UI Tool (PDF، 520 كيلوبايت)

      نظرًا لأن عمليات التنفيذ قد تختلف، فإن الغرض من ذلك هو فقط كمرجع للمساعدة في توضيح كيفية إجراء اتصالات واجهة برمجة التطبيقات بـ PG&E عبر SSL المتبادل (ثنائي الاتجاه).

      خطوات اختبار اتصال واجهة برمجة التطبيقات:

      للبدء، قم بتنزيل شهادة Entrust SSL من PG&E عن طريق تسجيل الدخول إلى حسابك. ثم حدد "إدارة التسجيل" لاسترداد

      مراحل التسجيل الرئيسية

      استخدم بيانات اعتماد العميل للحصول على رمز وصول عميل:

      • قدم طلبًا لاحقًا مقابل ترخيص الاختبارServerTokenEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/token
      • إضافة المعلمة grant_type=client_credentials.
      • أضف معلمة عنوان التخويل الأساسي من خلال ترميز Base64 "client_ID:client_Secret". ستكون معلمة العنوان بالتنسيق أدناه:
        اسم المعلمة : قيمة معلمة الترخيص
        : "سلسلة مرمزة للقاعدة 64" أساسية
      • سيمنحك الرد رمز الوصول المميز للعميل ووقت انتهاء صلاحيته (مثال):
             
        c03a9825-16f7-400a-b546-9a206ab995db
        3600
        3
        Bearer

      استخدم رمز وصول العميل للاتصال بواجهة برمجة تطبيقات حالة الخدمة:

      • تقديم طلب GET مقابل عنوان URL هذا:
        https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ReadServiceStatus
      • مرر رمز وصول العميل المميز في رأس التخويل بالتنسيق أدناه:
        اسم معلمة العنوان = قيمة التخويل
        = حامل
      • يجب أن تكون الإجابة على النحو التالي:
             
        1

      استخدم رمز وصول العميل لطلب بيانات العينة:

      • قم بتقديم طلب GET مقابل عنوان URL هذا:
        https://api.pge.com/GreenButtonConnect/espi/1_1/resource/DownloadSampleData
      • مرر رمز وصول العميل المميز في رأس التخويل بالتنسيق أدناه:
        اسم معلمة العنوان = قيمة التخويل
        = حامل
      • يجب أن تكون الإجابة على النحو التالي:مثال على تنزيل قراءة المقياس (XML، 273 كيلوبايت)

        ستكون قد أكملت اختبار اتصال واجهة برمجة التطبيقات بمجرد استلامك بيانات العينة بنجاح وسترى "اختبار اتصال واجهة برمجة التطبيقات: مرحلة "مكتملة" في جدول مرحلة التسجيل كما هو موضح أدناه.

      مراحل التسجيل الرئيسية 2

      يتعين على المستخدمين التاليين إكمال اختبار OAuth:

      المستخدم القياسي وتمويل كفاءة الطاقة

      الغرض:

      الغرض من اختبار OAuth هو ضمان عمل تنفيذ OAuth بشكل صحيح.

      أيقونة إشعار مهمملاحظة:

      لأغراض هذا الاختبار، يجب الإشارة إلى نقاط النهاية التالية في طلبك من أجل طلب "رمز تفويض الاختبار" و"رمز الوصول إلى الاختبار":

      • authorizationServerAuthorizationEndpoint https://api.pge.com/datacustodian/test/oauth/v2/authorize
      • ترخيص الاختبارالخادمTokenEndpoint: https://api.pge.com/datacustodian/test/oauth/v2/token

      اتجاهات اختبار OAuth:

      • تسجيل الدخول إلى بوابة مشاركة بياناتي الخارجية
      • انقر فوق "Go>" في مربع اختبار OAuth
      • سيتم فتح اختبار OAuth في نافذة جديدة. لاحظ أنه إذا لم يتم فتحه، فيُرجى التأكد من إيقاف تشغيل مانع النوافذ المنبثقة أو تعطيله.
      • حدد بدء: باختيار بدء، ستبدأ اختبار OAuth وسيتبع التنفيذ الصحيح التسلسل التالي لعمليات إعادة التوجيه.

        اختبار ShareMyData OAuth:

        إصدار 302 لإعادة التوجيه إلى عنوان URL OAuth (بوابة الطرف الثالث) الذي قدمته أثناء التسجيل، مع معلمات النطاق الوهمية:
        مثال:{ThirdPartyPortalURI}?scope=xxx ومعرف الطرف الثالث={dataCustodianId}

        طلبك:

        اختياري:تطبيقك: يطالب (العميل) بتسجيل الدخول إلى موقع الويب الخاص بتطبيقك

        طلبك:

        إصدار 302 لإعادة التوجيه إلى وتقديم طلب GET لرمز الترخيص:

        مثال، استخدم هذا الرابط للاختبار فقط:

        احصل على https://api.pge.com/datacustodian/test/oauth/v2/authorize?client_id={قيمة معرف العميل في RegistrationMilestones}&redirect_uri={redirect_uri}&scope={scope}&response_type=code

        على سبيل المثال، استخدم هذا الرابط للإنتاج فقط:

        GEThttps://sharemydata.pge.com/myAuthorization?client_id={قيمة معرّف العميل في RegistrationMilestones}&redirect_uri={redirect_uri}&response_type=code&state={ OptionalState}

        اختبار ShareMyData OAuth:

        إصدار رقم 302 لإعادة التوجيه إلى الذي قدمته أثناء التسجيل باستخدام رمز التفويض الوهمي:

        مثال: https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219

        تطبيقك: قم بتقديم طلب POST للرمز المميز للوصول باستخدام رمز التخويل المستلم والاتصال بـ :

        أيقونة إشعار مهمملاحظة: بالنسبة لطلب رمز الوصول المميز، يجب إرفاق شهادة SSL الخاصة بك.
        مثال:

        المنشور: https://api.pge.com/datacustodian/test/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

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

        ستكون معلمة العنوان بالتنسيق التالي:

        • اسم المعلمة : الترخيص
        • قيمة المعلمة : "سلسلة مرمزة للقاعدة 64" أساسية

        اختبار ShareMyData OAuth: يستجيب باستخدام رمز وصول اختباري:

        ستبدو الاستجابة الناجحة على النحو التالي:
        "access_token":" 774ff105-7ad5-40c8-a6ec-f60675dc0e41"
        "expires_in":"3600"
        "refresh_token":998c654-5b3b-4385-af4f-4e5c46c1bb04
        "scope":"{ScopeString}"
        "resourceURI":"{ResourceURI}"
        "authorizationURI":"{AuthorizationURI}"
        "نوع_token":":"

      في هذه المرحلة، ستكون قد أكملت اختبار OAuth بنجاح وسترى "اختبار OAuth: مرحلة "مكتملة" في جدول مرحلة التسجيل كما هو موضح أدناه:

      مراحل التسجيل الرئيسية

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

      أنواع المستخدمين التالية مطلوبة لتقديم طلب موارد معلومات التطبيق:

      المستخدم القياسي وتمويل كفاءة الطاقة

      الغرض:

      يتمثل الغرض من طلب موارد معلومات التطبيق في ضمان استلامك لعناوين URL الخاصة بالإنتاج للحصول على التصريحالخادمنقطة النهاية والتصريحالخادمالرمز المميزنقطة النهاية بالإضافة إلى البياناتالنطاق الحافظالاختيارشاشةURI

      خطوات طلب موارد معلومات التطبيق:

      ستحتاج إلى رمز الوصول إلى التسجيل ومعرف معلومات التطبيق لطلب مورد معلومات التطبيق.

      استرداد رمز الوصول إلى التسجيل

      لاسترداد رمز الوصول إلى التسجيل، سجّل الدخول إلى حساب مشاركة بياناتي وحدد "إدارة التسجيل". سيتم عرض في جدول Registration Milestone عند قبول تسجيلك.

      مراحل التسجيل الرئيسية

      استرداد معرف معلومات التطبيق

      استخدم رمز وصول العميل الذي تم استرداده أثناء اختبار اتصال واجهة برمجة التطبيقات للاتصال بالتصريح xml:
      تقديم طلب GET مقابل عنوان URL هذا:
      https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization

      مرر رمز وصول العميل في رأس التفويض بالتنسيق أدناه:
      اسم معلمة العنوان = قيمة التخويل
      = رمز وصول <العميل المميز>
      في الرد، سترى معرف معلومات التطبيق:

      مراحل التسجيل الرئيسية

      طلب مورد معلومات التطبيق

      اتصل بنقطة نهاية معلومات التطبيق مع الحصول على عنوان url التالي: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/ApplicationInformation/{ApplicationInformationID}.
      استبدل {ApplicationInformationID} بمعرف معلومات التطبيق الذي قمت باسترداده
      إضافة معلمة عنوان التخويل الأساسي. ستكون معلمة العنوان بالتنسيق أدناه:

      اسم المعلمة : قيمة معلمة الترخيص
      : حامل البطاقة
      ستمنحك الإجابة مورد معلومات التطبيق

      أيقونة إشعار مهمهام: للحصول على تعليمات حول كيفية إكمال التوقيع، يُرجى مراجعة اتفاقية تنفيذ الزر الأخضر .

      سيتضمن مورد معلومات التطبيق المعلومات التالية:

      • البياناتمعرف الحفظ
      • البياناتالوصيحالة التطبيق
      • الطرف الثالثالتطبيقالوصف
      • نوع تطبيق الطرف الثالث
      • هاتف طرف ثالث
      • التفويضخادم Uri
      • الطرف الثالثإخطار Uri
      • authorizationServerAuthorizationEndpoint
      • التخويلServerTokenEndpoint
      • البياناتCustodianBulkRequestURI
      • البياناتCustodianResourceEndpoint
      • نطاق الطرف الثالثالاختيارشاشةURI
      • الطرف الثالثUserPortalScreenURI
      • سر_العميل
      • اسم_العميل
      • إعادة توجيه_أوري
      • معرف_العميل
      • معرف_البرنامج
      • إصدار_البرنامج
      • رقم تعريف_العميل_صادر_في
      • انتهت صلاحية_سرية_العميل_في
      • جهات الاتصال
      • طريقة_الرمز المميز_endpoint_auth
      • النطاق
      • أنواع_المنح
      • أنواع_المنح
      • أنواع_المنح
      • أنواع_الاستجابة
      • تسجيل_العميل_أوري
      • رمز_الوصول_التسجيل
      • البياناتنطاق الأمينالاختيارشاشةURI

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

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

      مراحل التسجيل الرئيسية

      لمعرفة المزيد حول كيفية منح العملاء لأطراف ثالثة إمكانية الوصول إلى بياناتهم، يُرجى زيارةتفاصيل التفويض.

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

      المتطلبات الأساسية

      يجب استيفاء المتطلبات الأساسية التالية قبل أن تتمكن من الوصول إلى واجهات برمجة التطبيقات الخاصة بنا:

       

      1. يجب عليك التسجيل لاستخدام منصة مشاركة بياناتي قبل أن يتمكن العملاء من السماح لك بالوصول إلى بياناتهم. إذا لم تكن قد سجلت، فيُرجى التسجيل وإكمال الاختبار.
      2. يجب أن تكون قد أكملت اختبار اتصال API واختبار OAuth. إذا لم تكن قد أكملت الاختبار بعد، فيُرجى الاطلاع على تعليمات الاختبار.
        أيقونة إشعار مهمملاحظة: سيتم تحديث خطوات اختبار OAuth في إصدار مستقبلي لتعكس أحدث وظيفة OAuth 2.0 الموضحة أدناه (أي إزالة ThirdPartyScopeSelectionScreenURI).
        تفاصيل اختبار الزيارة

      عملية الترخيص

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

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

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

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

      Diagram of Authorization process initiated at a third-party site

      Diagram of authorizations initated at PG&E

      خطوات طلب التصريح

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

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

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

      المتطلبات الأساسية

      يجب استيفاء المتطلبات الأساسية التالية قبل أن تتمكن من الوصول إلى واجهات برمجة التطبيقات الخاصة بنا:

      1. يجب عليك التسجيل لاستخدام منصة مشاركة بياناتي قبل أن يتمكن العملاء من تفويضك للوصول إلى بياناتهم.
      2. يجب أن تكون قد أكملت اختبار اتصال واجهة برمجة التطبيقات واختبار OAuth. إذا لم تكن قد أكملت الاختبار بعد، فيُرجى الاطلاع على تعليمات الاختبار.
        تفاصيل اختبار الزيارة
      3. إذا كان نوع المستخدم الخاص بك يتطلب تصريحًا من العميل للوصول إلى البيانات، فيُرجى التأكد من أن العميل قد منحك تصريحًا للوصول إلى بياناته وأنك قد استبدلت رمز التفويض برمز وصول مميز. إذا لم تكن قد حصلت بعد على تصريح من العميل، فيُرجى مراجعة عملية تصريح العميل.
        انتقل إلى تفاصيل التفويض

      نظرة عامة

      هناك عدة طرق للوصول إلى البيانات المصرح بها من قبل العميل عبر واجهة برمجة التطبيقات. تتبع أحدث واجهات برمجة التطبيقات لدينا معيار واجهة مزود خدمة الطاقة (ESPI) (مجلس معايير الطاقة في أمريكا الشمالية (NAESB) وتوفر الوصول إلى معلومات استخدام الطاقة (EUI) من خلال مجموعة من واجهات RESTful

      تنزيل واجهات برمجة التطبيقات المدعومة (PDF، 217 كيلوبايت)

      تعرض وثيقة واجهات برمجة التطبيقات المدعومة واجهات برمجة التطبيقات المدعومة من خلال تنفيذ PG&E لمشاركة بياناتي، بالإضافة إلى عنوان URL الخاص بواجهة برمجة التطبيقات الخاصة بـ PG&E.

      تنزيل تعيين سلسلة نطاق كتلة الوظائف المدعومة (PDF، 222 كيلوبايت)

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

      قم بتنزيل نموذج البيانات العلائقية المدعوم (تنفيذ PG&E لمؤشر أسعار المستهلك) (PDF، 482 كيلوبايت)

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

      تنزيل عناصر البيانات المدعومة (PDF، 283 كيلوبايت)

      يوفر مستند عناصر البيانات المدعومة تخطيطًا بين عناصر البيانات القياسية لـ ESPI وعناصر بيانات PG&E.
      يتوافق تطبيق PG&E مع تعريفات المخطط المقدمة من ESPI والموجودة على GitHub. وعلى وجه التحديد، يستخدم تنفيذنا الحالي إصدارات المخطط التالية:

      تنزيل XSDs (ZIP، 50 كيلوبايت)
      تفضل بزيارة Github

      يُرجى الرجوع إلى المصادر التالية حول كيفية إكمال التوقيع لكل طلب API واختبار مكالمة API في مقابل API Sandbox الخاص بـ GBC:

      قم بزيارة مكتبة مستندات الزر الأخضر
      قم بزيارة واجهة برمجة تطبيقات الزر الأخضر

      إشعار URI

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

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

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

      طرق الوصول إلى البيانات

      Data Access: Daily Subscription Model

      أمثلة على طلب البيانات

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

      موارد المطور

      مجموعات تطوير البرامج (SDKs)

       

      للمساعدة في تطوير برنامج للاتصال بمنصة مشاركة بياناتي، من المفيد رؤية الآلية التفصيلية المتضمنة في كل مكالمة لنقاط نهاية واجهات برمجة التطبيقات المنشورة. وتحقيقًا لهذه الغاية، تمتلك PG&E بعض نماذج حزم تطوير البرمجيات التي طورتها في الماضي لكل من JavaScript وPython لتوضيح الجوانب الرئيسية للاتصال بمنصة مشاركة بياناتي. توفر SDKs عينات رموز للمساعدة في إرشادك خلال عملية التطوير، ولكن ليس الغرض منها تقديم رمز إنتاج. بالنسبة لـ JavaScript، ستحتاج إلى تثبيت NodeJS، والتأكد من "تثبيت npm - حفظ ..." لتحديث وحدات مكتبة NodeJS ذات الصلة. الرمز ليس مستقلاً، ولكنه يوفر مقتطفات توضح كيفية حدوث التفاعل بين رمز عميل بيانات طرف ثالث وخدمات واجهة برمجة تطبيقات مشاركة بياناتي من PG&E.

       

      للمساعدة في تنفيذ منصة مشاركة بياناتي، طوّرت PG&E حزم SDK في كل من JavasScript وPython. توفر حزم تطوير البرامج هذه عينات للمساعدة في إرشادك خلال عملية التطوير، ولكن ليس الغرض منها تقديم رمز وظيفي. 

      تنزيل واجهات برمجة التطبيقات المدعومة (PDF)

      تعرض وثيقة واجهات برمجة التطبيقات المدعومة واجهات برمجة التطبيقات المدعومة من خلال تنفيذ PG&E لمشاركة بياناتي، بالإضافة إلى عنوان URL الخاص بواجهة برمجة التطبيقات الخاصة بـ PG&E.

       

      تنزيل تعيين سلسلة نطاق كتلة الوظائف المدعومة (PDF)

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

       

      تنزيل نموذج البيانات العلائقية المدعوم (تنفيذ PG&E لـ ESPI) (PDF)

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

       

      تنزيل عناصر البيانات المدعومة (PDF)

      يوفر مستند عناصر البيانات المدعومة تخطيطًا بين عناصر البيانات القياسية لـ ESPI وعناصر بيانات PG&E.

      يتوافق تطبيق PG&E مع تعريفات المخطط المقدمة من ESPI والموجودة على GitHub. وعلى وجه التحديد، يستخدم تنفيذنا الحالي إصدارات المخطط التالية:

      تنزيل XSDs (ZIP)
      تفضل بزيارة Github

       

      يُرجى الرجوع إلى المصادر التالية حول كيفية إكمال التوقيع لكل طلب API واختبار مكالمة API في مقابل المربع الرملي API الخاص بشركة GBC:

      قم بزيارة مكتبة مستندات الزر الأخضر
      قم بزيارة واجهة برمجة تطبيقات الزر الأخضر

      يتبع تطبيق مشاركة بياناتي المعيار الوطني لواجهة مزود خدمة الطاقة (ESPI). كما تم وضع علامة تجارية على هذا المعيار باسم مبادرة Green Button Connect My Data (GBCMD) التي روّج لها كبير مسؤولي التكنولوجيا في البيت الأبيض وزملاء الابتكار الرئاسي. يحدد معيار ESPI الإطار الفني لتقديم الوظائف المتعلقة بتصريح العميل وتبادل البيانات وتنسيق البيانات المصرح بها التي يتم تبادلها. هذه التفاصيل مشمولة في معيار ESPI ووثائق GBCMD. ابحث عن الوثائق في بيانات الزر الأخضر .

       

      لاستخدام مشاركة بياناتي، يجب على الأطراف الثالثة أولاً الحصول على شهادة رقمية X.509 وتقديمها من سلطة شهادة موثوق بها على خوادم اتصال واجهة برمجة التطبيقات الخاصة بهم. يمكن للأطراف الثالثة بعد ذلك إكمال التسجيل لدى PG&E في موقع تسجيل الطرف الثالث، وتحميل شهادتها هناك أيضًا، وتلقي بيانات الاعتماد من PG&E التي تمكنهم من اختبار اتصالهم، وبالتالي الحصول على رموز لحاملها من خلال نقاط النهاية الخاصة بتفويض أمين البيانات لدينا. يتم وصف هذه الرموز المميزة لحاملها في معيار OAuth2 وتمكين برامج الجهات الخارجية من توصيل واجهات برمجة التطبيقات للوصول إلى بيانات PG&E بأمان. توفر SDK تفاصيل التفاعل حول كيفية الحصول على الرموز المميزة في رمز البرنامج النصي.

       

      يتم الحصول على الرموز المميزة لحامل الوصول إلى العميل والرموز المميزة لحامل الوصول إلى بيانات العميل بشكل منفصل ويطلق عليها رموز الوصول إلى العميل ورموز الوصول، على التوالي. يتم الحصول على رموز الوصول وفقًا لتصريح فردي من عميل PG&E. سير العمل النموذجي هو سير العمل الذي يتبع OAuth2، وفقًا لآلية التصريح القياسية (IETF 6749)، حيث يبدأ العميل من موقع طرف ثالث، ويعيد هذا الموقع توجيه العميل إلى https://sharemydata.pge.com/#MyAuthorization/ أولاً للمصادقة. هناك، يصادق العميل مع PG&E ويمر عبر تفويض يحدد نطاق وصوله إلى بياناته إلى الطرف الثالث ("عملية النقر"). عند الانتهاء، تقوم PG&E بإعادة التوجيه إلى الطرف الثالث مع استجابة HTTP 302، وعندها يكون الطرف الثالث مستعدًا للحصول على الرموز المميزة لحاملها (رمز الوصول المميز). راجع تدفقًا تفصيليًا للعملية (PDF، 463 كيلوبايت).

       

      يتصل خادم عميل البيانات التابع لجهة خارجية بنقاط نهاية API للوصول إلى بيانات PG&E عن طريق اتصال TLS 1.2 المتبادل. يتم التحكم في الوصول إلى نقطة نهاية API الفردية بواسطة الرموز المميزة لحاملها؛ بمجرد قبول الطلب ومعالجته، يتم إرجاع البيانات في استجابة متزامنة أو استجابة غير متزامنة بناءً على إخطار لعنوان URL محدد من قِبل طرف ثالث.

       

      تتبع البيانات مخطط ESPI المذكور أعلاه. راجع وصفًا للعناصر المدعومة (PDF، 283 كيلوبايت)

       

      تُصدر PG&E البيانات وفقًا للنطاق المسموح به لنوع الطرف الثالث وتصريح العميل.

       

      راجع تعريف النطاق (XLSX )، واتبع أيضًا تعريفات نطاق الزر الأخضر .

       

      قبل التسجيل لاستخدام مشاركة بياناتي، نوصي بشدة بأن تتعرف أنت ومؤسستك على الموارد التالية:

       

      تفضل بزيارة أدوات SDK لبيانات الزر الأخضر
      لإنشاء ملفات بيانات الزر الأخضر واختبارها وعرضها. اعثر على حزم SDK التي طورتها PG&E: JavaScript (ZIP، 1.7 ميجابايت)| Python (ZIP، 5 كيلوبايت)

       

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

      نظرًا لموارد النظام المحدودة وكذلك للسماح لشركة PG&E بتقليل المخاطر التشغيلية، يتم تطبيق حدود واجهة برمجة التطبيقات التالية لضمان الاستقرار المستمر للمنصة لمستخدمينا.

      • طلب واحد في الثانية لكل بائع عبر جميع معرفات عميل البائع
      • 2000 مكالمة API في الساعة لكل معرف عميل
      • 20,000 مكالمة API لكل فترة 24 ساعة لكل معرف عميل. تتم إعادة تعيين حد العتبة اليومي في الساعة 5 مساءً. PT

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

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

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

      الأسئلة الشائعة

      • يمكن لأي طرف ثالث مؤهل مهتم بالوصول إلى البيانات المصرح بها من العميل استخدام مشاركة بياناتي.
      • يمكن للعملاء الذين لديهم معرفة فنية باستخدام واجهات برمجة تطبيقات RESTful (واجهة برنامج التطبيق) للوصول إلى بياناتهم الخاصة استخدام الأداة أيضًا.
      • إذا كنت مقدم خدمة خارجي للاستجابة للطلب (DRP) مشاركًا في برنامج القاعدة 24 لشركة PG&E لتقديم برنامج استجابة للطلب وترغب في استخدام مشاركة بياناتي، فيُرجى زيارة صفحة ويب DRP لمزيد من المعلومات.

      • يمكن لأي طرف ثالث مؤهل مهتم بالوصول إلى البيانات المصرح بها من العميل استخدام مشاركة بياناتي.
      • يمكن للعملاء الذين لديهم معرفة فنية باستخدام واجهات برمجة تطبيقات RESTful (واجهة برنامج التطبيق) للوصول إلى بياناتهم الخاصة استخدام الأداة أيضًا.
      • إذا كنت مقدم خدمة خارجي للاستجابة للطلب (DRP) مشاركًا في برنامج القاعدة 24 لشركة PG&E لتقديم برنامج استجابة للطلب وترغب في استخدام مشاركة بياناتي، فيُرجى زيارة صفحة ويب DRP لمزيد من المعلومات.

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

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

      تعرف على المزيد حول معدلات الكهرباء في PG&E

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

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

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

      • نعم. قم بزيارة صفحة الويب أدناه لعرض قائمة بالمرافق الأخرى التي تنفذ برامج مماثلة.

      تفضل بزيارة greenbuttondata.org

      • بالنسبة لهذه الأداة، يُعد CPUC هو السلطة الحاكمة النهائية بشأن الأشخاص غير المؤهلين لتلقي بيانات العملاء المصرح لهم. 
      • يراجع CPUC تقارير إساءة استخدام بيانات العملاء ويتخذ القرارات النهائية بشأن ما إذا كان قد تم انتهاك شروط التعريفة و/أو قواعد خصوصية وحماية بيانات العملاء.
      • تتمتع اللجنة بسلطة إصدار أمر للمرافق بإلغاء الوصول على الفور وإنهاء تسجيل الشركات أو الأفراد الذين ينتهكون ذلك ومنعهم من المشاركة في المستقبل. لمزيد من المعلومات، حدد الروابط أدناه:
        القاعدة الكهربائية رقم 27 (PDF، 1.6 ميجابايت)

      • لمزيد من المعلومات حول معيار ESPI، تفضل بزيارة greenbuttondata.org.

      يُرجى مراجعة المعلومات التالية وجمعها قبل التسجيل في مشاركة بياناتي.

      زيارة البدء بمشاركة بياناتي
      للتسجيل، تفضل بزيارة مشاركة بياناتي

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

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

      • يُطلب منك تقديم المعرّف الضريبي الفيدرالي الخاص بك إلى المرافق المملوكة لمستثمري كاليفورنيا (غاز المحيط الهادئ والكهرباء، وجنوب كاليفورنيا إديسون، وسان دييجو للغاز والكهرباء) ولجنة المرافق العامة في كاليفورنيا (CPUC) بمعرّف مشترك وفريد لك.

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

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

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

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

      • لا يمكننا إعادة تعيين كلمات المرور إذا كنت لا تعرف الإجابة على سؤال الأمان الخاص بك.

      • لا يمكننا إعادة تعيين كلمات المرور إذا كنت لا تعرف الإجابة على سؤال الأمان الخاص بك.

      • يمكنك تسجيل الدخول إلى حسابك في أي وقت لتحديث معلومات ملفك التعريفي عن طريق تحديد إدارة التسجيل.

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

      • بمجرد استلام رسالة بريد إلكتروني تشير إلى قبول تسجيلك، ستتمكن من تسجيل الدخول إلى حسابك لاسترداد . حدد "Manage Registration" وسيتم عرض في جدول مراحل التسجيل تحت الحالة Accepted.

      • إذا لم تعد ترغب في الوصول إلى البيانات المصرح بها من العميل على منصة مشاركة بياناتي، فيُرجى مراسلتنا عبر البريد الإلكتروني على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.

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

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

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

      • إذا كنت ترغب في تلقي تصحيحات البيانات، فيُرجى التأكد من تحديد خانة الاختيار "إخطاري" لأن البيانات جاهزة أثناء التسجيل أو عن طريق تسجيل الدخول إلى حسابك عبر الإنترنت وتحديد خانة الاختيار هذه أسفل "تحرير ملف التعريف". سنقوم بعد ذلك بتضمين تصحيحات البيانات التي سجلها نظامنا خلال الـ 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)

      المزيد عن SmartMeter

      الاتصال بنا

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

      موردو الأجهزة

      معلومات لموردي أجهزة شبكة المنطقة المنزلية (HAN).

      قراءة SmartMeter

      تعرض شاشة SmartMeter سهمًا يشير إلى ما إذا كنت تستخدم الطاقة أو تقوم بتصديرها.