Передача моих данных третьим лицам

Для соответствия действующему стандарту авторизации Североамериканского совета по энергетическим стандартам (NAESB) по интерфейсу поставщика энергетических услуг (ESPI), PG&E внедрила систему авторизации OAuth 2.0 для авторизации доступа к данным. На приведенной ниже схеме показано, как клиенты инициируют авторизацию, выбирают параметры области действия, а затем отправляют авторизацию.

Дополнительные справочные материалы помимо информации ниже:

Загрузить диаграмму последовательности ESPI OAuth 2.0 (PDF, 193 КБ)
Просмотреть SDK данных зеленой кнопки в Github

Примечание. Для агрегаторов Community Choice для запроса данных требуется только токен Client_access_token (через 2-Legged OAuth), и следующее не применяется.

Разрешения, инициированные на стороннем объекте

Чтобы начать авторизацию с стороннего сайта, как показано на первой схеме выше, запрос кода авторизации выполняется путем перенаправления браузера клиента с вашего стороннего сайта на 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 = идентификатор клиента из контрольных точек регистрации «Поделиться моими данными» (т. е. пара клиент_id/клиент_секрет).
  • redirect_uri = URL-адрес перенаправления, указанный при регистрации «Поделиться моими данными» (URL-адреса должны совпадать).
    Примечание. Мы рекомендуем применить кодировку URL к redirect_uri, как показано в примере ниже.
  • response_type = код (статическое значение)
• Дополнительный параметр(-ы) запроса:
  • состояние = необязательный непрозрачный параметр состояния, разрешенный стандартом OAuth 2.0, который возвращается с кодом авторизации, чтобы помочь поддерживать состояние. Например, параметр состояния может использоваться третьей стороной для уникальной идентификации происхождения клиента и предотвращения подделки на другом объекте.
  • login={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

Примечание: приведенный выше пример параметра redirect_uri содержит кодировку URL-адреса (т. е. кодировку URL-адреса https://thirdparty.com/redirectUrl)

Если вы сделаете действительный запрос, как указано выше, и клиент успешно пройдет проверку подлинности и авторизует, клиент будет впоследствии перенаправлен на ваш redirect_uri с кодом авторизации, параметром (авторизованным) области и дополнительным параметром состояния (если он предоставлен как часть запроса авторизации), как показано ниже:

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_37_ 38_39_40_4_5_10_15_16_46_47; AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment ;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength={3P Registered Historical length};AccountCollectionCollection={count of authorizedSAs};BR={ThirdPartyID};dataCustodianId=PGE &state=pge12advertisement

Примечание. Код авторизации является кратковременным (истекает через 600 секунд), и его необходимо впоследствии обменять на пару токенов доступа/обновления токенов, чтобы завершить авторизацию и разрешить доступ к текущим данным. См. следующий раздел (раздел 2) для получения подробной информации о запросе токена доступа/обновления токена.

Параметр (авторизованный) области, приведенный выше, возвращается как часть ответов на запрос кода авторизации, запрос токена доступа, а также API авторизации. Этот параметр области действия позволяет передавать окончательную область действия авторизации клиента. В частности, параметр области включает значение «Дополнительный объем», которое сопоставляется с поддерживаемыми PG&E вариантами авторизации клиентов групп данных (например, «Использование», «Выставление счетов», «Базовый», «Учетная запись», «Регистрация программы»). Значения параметров осциллографа дополнительно фиксируются в соответствии со следующей справочной документацией:Скачать сопоставление строк осциллографа поддерживаемого функционального блока Click Thru 2.0 (PDF, 222 КБ).

Сценарии ошибок

Ошибки внедрения третьей стороны: если требуемые параметры запроса Client_id или redirect_uri недействительны или отсутствуют при запросе кода авторизации, клиенту будет показано пояснительное сообщение вместе со стандартной ошибкой серии HTTP 400. Аналогичным образом, если требуемый параметр запроса response_type отсутствует или недействителен, клиент будет перенаправлен обратно на ваш redirect_uri с определенным параметром ошибки OAuth 2.0 «invalid_request», а также с дополнительным параметром состояния, если он был впервые предоставлен как часть исходного запроса авторизационного кода.

Клиенты, отказывающиеся авторизовать: после того, как третья сторона перенаправляет клиента на авторизацию в PG&E, клиент может отклонить запрос с помощью кнопки «отмена» на странице входа и странице авторизации. В таких случаях клиент будет перенаправлен обратно на ваш redirect_uri с параметром ошибки OAuth 2.0 «access_denied», добавленным, чтобы указать, что клиент отказался авторизовать его. Кроме того, необязательный параметр состояния будет возвращен, если он сначала предоставлен как часть исходного запроса на авторизационный код.

Авторизации, инициированные в PG&E

Когда клиенты начинают работу на веб-портале PG&E «Ваша учетная запись», а затем переходят на целевую страницу «Поделиться моими данными», они получают выпадающий список зарегистрированных и видимых третьих сторон. Как показано на второй диаграмме выше, после выбора клиентом третьей стороны из списка зарегистрированных третьих сторон и выбора «Далее» клиент будет перенаправлен на зарегистрированный URI портала третьей стороны, после чего клиенты смогут перейти к процессу OAuth, инициированному третьей стороной, описанному в предыдущем разделе.

Примечание. Некоторые третьи стороны спросили о том, как оптимизировать взаимодействие с клиентами для этого сценария использования (т. е. авторизации, инициированные на сайте PG&E), чтобы клиент понимал, что они переходят непосредственно на страницу авторизации при выборе третьей стороны из выпадающего списка. Чтобы облегчить такой клиентский опыт, третьи стороны могут выбрать параметр «URI стороннего портала» (на странице регистрации «Поделиться моими данными с моими данными») для конечной точки, которая автоматически перенаправляет клиента обратно в PG&E в рамках запроса на авторизационный код. После автоматического перенаправления обратно на конечную точку авторизации сервера авторизации PG&E клиент пропустит страницу входа клиента (поскольку он уже вошел в систему) и перейдет непосредственно на страницу авторизации. Для некоторых третьих лиц, которые зарегистрировались до выпуска «Передать мои данные» в конце июня 2018 г., это можно сделать, просто задав URI портала для третьих лиц, чтобы он был равен больше не используемому URI «Экрану выбора области действия третьих лиц» (поле будет выведено из обращения в будущем).

В отличие от этого, некоторые третьи стороны могут сначала привлечь и проверить клиентов со своей стороны, когда клиенты перенаправляются на свой URI «Портала третьих сторон» перед запросом авторизационного кода, поэтому вышеуказанный подход является лишь предложением.

Чтобы получить токен доступа, используйте полученный код авторизации и вызовите указанную ниже конечную точку с параметрами запроса, как описано ниже. Как описано выше, Авторизационный код краткосрочный и истекает через 10 минут (600 секунд), поэтому убедитесь, что Токен доступа незамедлительно запрашивается после получения Авторизационного кода.

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

• Обязательные параметры запроса:
  • grant_type = код авторизации (статическое значение)
  • код = авторизационный код, полученный в ответ на запрос авторизационного кода
  • redirect_uri = URL-адрес перенаправления, указанный при регистрации «Поделиться моими данными» (URL-адреса должны совпадать).
    Примечание. Как и в случае с запросом на авторизационный код, мы рекомендуем применить кодировку URL к redirect_uri.

ПРИМЕР: ПОЧТА запроса
токена доступа: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Добавить базовый параметр заголовка авторизации с примененным кодированием Base64 «clientID:clientSecret»

Примечание. Значения clientId:clientSecret соответствуют значениям clientID, указанным в контрольных точках регистрации «Поделиться моими данными».
Параметр заголовка будет иметь следующий формат:
Имя параметра: Значение параметра авторизации
: Базовая "закодированная строкаbase64"

Успешный ответ будет выглядеть следующим образом:

<Ответ xmlns="https://апи.стр.com/datacustodian/oauth/v2/token">
774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
998c6654-5b3b-4385-af4f-4e5c46c1bb04

resourceURI:{ResourceURI}, например: https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
авторизацияURI:{URI авторизации}, например: https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerРесурсыURI:{CustomerResourceURI}, например:https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Примечание. Срок действия маркера доступа истекает через 3600 секунд (1 час), а срок действия соответствующего маркера обновления истекает через 1 год. Подробные сведения о получении новой пары токен доступа/обновление токена см. в следующем разделе 3.

Сохраните пару токенов доступа и обновите ее.
Чтобы запросить первоначальные исторические данные и текущие ежедневные данные, посетите раздел «Доступ к данным».

Согласно передовой практике, токен доступа представляет собой кратковременный токен (1 час), в то время как соответствующий «Обновить токен» представляет собой долгосрочный токен (1 год), который вы можете использовать для получения новой пары токен доступа/Обновить токен по истечении срока действия токена доступа. Чтобы получить новую пару токенов доступа и Обновить токен для существующих авторизаций с неистекшим сроком действия, используйте «текущий Обновить токен» и вызовите указанную ниже конечную точку с параметрами, описанными ниже.

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, указанным в контрольных точках регистрации «Поделиться моими данными».
Параметр заголовка будет иметь следующий формат:
Имя параметра: Значение параметра авторизации
: Базовая "закодированная строкаbase64"

Успешный ответ будет выглядеть следующим образом:
{
"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;BlockDuration=Ежедневно;Длина истории={3P Зарегистрированная длина истории};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
«ресурсный URI»: "https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ",
«URI авторизации»: "https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Authorization/test "
}

Примечание. Аналогичным образом, токен клиентского доступа представляет собой кратковременный токен (1 час), в то время как соответствующий ему «Обновить токен» представляет собой продолжительный токен (1 год), который можно использовать для получения новой пары «Токен клиентского доступа/Обновить токен» по истечении срока действия токена клиентского доступа. Для получения новой пары токен доступа клиента/Обновить токен выполните описанные выше действия.

Клиенты смогут обновить свои разрешения, выполнив следующие действия:

• Удаление идентификаторов службы из их авторизаций
• Продление даты окончания периода авторизации
• Отмена авторизации

Примечание. Клиенты смогут вносить изменения в свои авторизации только путем входа в свою учетную запись PG&E в Интернете и выполнения необходимых шагов. В случае выполнения любого из этих действий мы уведомим вас через URI уведомления, который вы предоставили во время регистрации.

Существуют варианты управления и просмотра сведений о ваших авторизациях клиентов:

• Вы можете позвонить в API авторизации (функция http GET), используя свой токен Client_access_token, либо на уровне третьей стороны (для получения подробной информации обо всех авторизациях) по адресу https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization, либо на уровне авторизации отдельного клиента по адресу https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Кроме того, вы можете просматривать индивидуальные данные авторизации вручную, войдя в свою учетную запись «Поделиться моими данными» на стороннем портале и введя идентификатор подписки для авторизации, которую вы ищете.

Если вы больше не хотите получать доступ к данным, связанным с авторизацией, существуют необязательные методы отмены авторизации:

• Вы можете позвонить в API отзыва авторизации (операция http DELETE), используя свой токен Client_access_token на сайте https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Вы также можете вручную отменить авторизацию, войдя в свою учетную запись «Поделиться моими данными» на стороннем портале и введя идентификатор подписки для авторизации, которую вы хотите отменить.

Примечание. Клиент получит уведомление о том, что вы решили отменить его авторизацию. Кроме того, после отмены авторизации действие нельзя отменить.

• PG&E будет отправлять уведомления на ваш URI уведомления, предоставленные во время регистрации. Уведомления содержат URI, соответствующие уже предварительно упакованным данным, готовым для вашего возвращения и запроса по предоставленным URL-адресам. Данные предварительно упакованы, а уведомления отправляются в следующих двух сценариях: (1) вы выбрали «Уведомить меня о готовности данных» в вашем профиле регистрации, и в этом случае мы упакуем последние ежедневные данные с любыми исправлениями за прошлые даты; или (2) вы ранее сделали специальный асинхронный запрос, для которого запрошенные данные теперь готовы.
• Сценарий 1 показан в разделе «DATA ACCESS: ЕЖЕДНЕВНАЯ ПОДПИСКА» нижеприведенных диаграмм «Методы доступа к данным» и сценарий 2 проиллюстрированы в разделе «ДАННЫЙ ДОСТУП: AD HOC REQUEST (ASYNCHRONOUS)», раздел тех же диаграмм ниже.

Пожалуйста, помните о сроке действия токенов доступа, токенов клиентского доступа и их соответствующих Обновить токены, используемых в запросах данных. Согласно передовой практике, токен доступа представляет собой кратковременный токен (1 час), а токен обновления представляет собой долгосрочный токен (1 год), который можно использовать для получения новой пары токен доступа/обновления токена по истечении срока действия токена доступа. Аналогичным образом, токен клиентского доступа представляет собой кратковременный токен (1 час), в то время как его соответствующий «Обновить токен» представляет собой долгосрочный токен (1 год), который вы можете использовать для приобретения новой пары «Токен клиентского доступа/Обновить токен» по истечении срока действия токена клиентского доступа. Для получения более подробной информации о получении новой пары маркеров см. Шаг 3, Запрос нового маркера доступа, на нашей вкладке сведений об авторизации. Перейти к данным авторизации

Если клиент уполномочил вас на получение «Информации об учетной записи» (Идентификаторы учетной записи, Идентификаторы соглашений об обслуживании и даты начала обслуживания) и/или «Основной информации» (т. е. имя клиента и адрес обслуживания), вы можете запросить такую информацию через API-интерфейсы, определенные ESPI RetailCustomer, для которых данные соответствуют схеме RetailCustomer.xsd, представленной выше.

Синхронный (стандарт и EEF сторонние организации)

Одним из подходов к запросу данных клиентов является использование синхронного API для запроса информации о клиенте для авторизации одного клиента для данных клиентов (т. е. розничного клиента):

Пример URL-адреса синхронного запроса:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID, полученный в конце последовательности авторизации OAuth для получения токена доступа. RetailCustomerID является частью параметра пути customerResourceUri в ответе на токен. (RetailCustomerID=SubscriptionID)

Заголовок HTTP = авторизация:Предъявитель {токен доступа для этой авторизации}

Ответ = вы синхронно получите данные для этого RetailCustomerID. Данные соответствуют файлу retailCustomer.xsd

Примечание. Синхронный API розничного клиента находится на уровне отдельного розничного клиента, что соответствует авторизации одного клиента.

Для справки: иерархическая диаграмма ниже показывает иерархию отношений для элементов данных ESPI при моделировании данных клиентов PG&E.

Вы также можете запросить данные клиентов через асинхронный API для запроса информации о клиентах для всех ваших авторизаций клиентов для данных клиентов (т. е. розничных клиентов).

Для поддержки асинхронных запросов ваше приложение должно будет поддерживать пост-уведомления, которые мы отправим вам (в соответствии с URL-адресом уведомления, который вы указали во время регистрации).

Пример URL-адреса асинхронного запроса:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID, предоставленный в ресурсе ApplicationInformation Resource, полученном во время регистрационных испытаний. (BulkID=ClientID)

HTTP Header = Авторизация:Несущий {токен доступа клиента, полученный во время регистрационных испытаний}

Ответ = код состояния HTTP 202 (это асинхронный запрос, где ответ будет размещен на URL-адресе уведомления, когда данные будут готовы). Как только данные будут готовы, мы РАЗМЕСТИМ уведомление на предоставленный вами URI уведомления с полезными данными URL-адресов, которые ваше приложение может вернуть, чтобы получить предварительно упакованный файл. Пример уведомления после публикации выглядит следующим образом

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

Выполните GET по вышеуказанному URL-адресу с токеном Client Access, чтобы получить данные.

Для справки: иерархическая диаграмма ниже показывает иерархию отношений для элементов данных ESPI при моделировании данных клиентов PG&E.

Наконец, вы можете ежедневно получать самую последнюю информацию о клиенте, используя модель ежедневной подписки (т. е. установив флажок «Уведомить меня о готовности данных (ежедневно)» во время регистрации).

Чтобы поддерживать модель ежедневной подписки, ваше приложение должно будет поддерживать Почтовые уведомления, которые мы отправим вам (в соответствии с URL-адресом уведомления, который вы указали во время регистрации).

Как только данные будут готовы, мы РАЗМЕСТИМ уведомление на предоставленный вами URI уведомления с полезными данными URL-адресов, которые ваше приложение может вернуть, чтобы получить предварительно упакованный файл. Пример уведомления после отправки выглядит следующим образом:

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

Выполните GET по вышеуказанному URL-адресу с токеном Client Access, чтобы получить данные.

Для справки, иерархическая диаграмма ниже показывает иерархию отношений для элементов данных ESPI при моделировании данных клиентов PG&E.

Если вы уполномочены клиентом получать либо «Информация об использовании», либо «Информация о выставлении счета», вы можете запросить эти данные через API подписки, для которых данные соответствуют схеме espiDerived.xsd, представленной выше.

Синхронные специальные запросы (стандартные и EEF сторонние организации)

Для запроса хронологических данных (как для данных об использовании за интервал, так и данных о счетах) один подход заключается в использовании синхронных API с включением надлежащих параметров запроса даты начала и окончания в время Zulu.

Пример URL-адреса синхронного запроса:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?публиковано-min={startDate}&публиковано-max={endDate}

опубликовано-min = дата начала, которая будет применена к этому запросу для извлечения данных. Дата указана в формате Zulu гггг-ММ-ддТГ:мм:ссЗ (формат IEEETC RFC 3339)

Опубликовано-макс. = дата окончания, которая будет применена к этому запросу на извлечение данных. Дата указана в формате Zulu гггг-ММ-ддТГ:мм:ссЗ (формат IEEETC RFC 3339)

Примечание. Для запросов API, которые принимают параметры опубликованного максимума и опубликованного минимума, по умолчанию используется T-1 (дата запроса минус 1 день). Для запросов сводных данных об использовании (например, .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary) мы рекомендуем предоставить диапазон 30 дней или более, чтобы обеспечить наличие счета, который перекрывается с этим периодом, в противном случае данные не будут возвращены.

Идентификатор подписки = Идентификатор подписки, полученный в конце последовательности авторизации OAuth для получения токена доступа. Идентификатор подписки является частью параметра resourceURI в ответе маркера. (SubscriptionID=RetailCustomerID)

UsagePointID = UsagePoint под указанным выше идентификатором подписки. Вы можете получить все точки использования для данной Подписки, позвонив по указанному ниже URL-адресу API и предоставив токен доступа для этой подписки в заголовке авторизации: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

HTTP Header = Авторизация:Предъявитель {токен доступа для этой подписки}

Ответ = вы синхронно получите данные для этой точки использования в течение запрошенного периода. Он будет иметь как данные об использовании за интервал (), так и данные о счете ().

API синхронного использования (как указано структурой URL-адреса, которая заканчивается идентификатором точки использования) находятся на уровне отдельной точки использования (т. е. на уровне соглашения об обслуживании), поэтому приложение будет циклически обрабатывать запросы через каждый из идентификаторов точки использования, принадлежащих данному авторизационному запросу клиента (т. е. подписке).

Ответ на синхронные запросы возвращает как интервальные данные (ниже), связанные с запрашиваемым диапазоном дат, так и любые ежемесячные суммарные значения использования и счета, которые перекрываются с запрашиваемым диапазоном дат (ниже ).

• ИнтервалЧтение содержит данные об использовании электрической энергии за интервал (15 мин/час) и об использовании газа за интервал (ежедневно)
• Сводка по использованию содержит ежемесячные итоговые значения использования и сведения о счете (если разрешено)

В ответе вы найдете элементы данных, соответствующие нашей таблице сопоставления элементов данных ESPI

Для справки, иерархическая диаграмма ниже показывает иерархию отношений для элементов данных ESPI при моделировании данных клиентов PG&E.

Ниже приведено несколько ключевых разъяснений по этим элементам данных:

• Интервальный блок рассчитан на 1 день
• ИнтервалЧтение (под блоком интервалов) содержит фактические 15-минутные/часовые значения использования электроэнергии и ежедневные значения использования газа
• Для потребителей электрооборудования с генерацией на объекте (например, Solar) элемент FlowDirection указывает доставленные (подача) и полученные (генерация) данные об использовании. Для клиентов с счетчиками, настроенными только на считывание чистого использования (т. е. без генерации на месте), элемент FlowDirection указывает, что использование является чистой суммой (разница между доставленным и полученным):
  • Направление потока 1 = доставлено (энергия подается заказчику)
  • Направление потока 19 = полученное (чистое генерирование, возвращающееся в PG&E-сеть). (Примечание: значения являются абсолютными)
  • Направление потока 4 = нетто (доставлено минус – получено)
• Обратите особое внимание на мощность десяти множителей и единицу измерения (мкм), чтобы обеспечить правильное показание использования

Пакетная подписка (стандартные и EEF сторонние организации)

Вы также можете запросить данные об использовании через асинхронный API для всех Точек использования, относящихся к одному разрешению клиента на использование/выставление счетов (т. е. Подписка).

Для поддержки специальных асинхронных запросов (т. е. для более чем одной Точки использования за раз) вашему приложению потребуется поддержка пост-уведомлений, которые мы будем отправлять вам (в соответствии с URL-адресом уведомления, который вы указали при регистрации)

Пример URL-
адреса асинхронного запроса https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?публиковано-min={startDate}&публиковано-max={endDate}

Идентификатор подписки = Идентификатор подписки, полученный в конце последовательности OAuth для получения токена доступа. Идентификатор подписки является частью параметра resourceURI в ответе маркера

опубликовано-min = дата начала, которая будет применена к этому запросу для извлечения данных. (RFC 3339 формат zulu time. yyyy-MM-ddTHH:mm:ssZ)

опубликовано-макс. = дата окончания, которая будет применена к этому запросу для извлечения данных. (RFC 3339 формат zulu time. yyyy-MM-ddTHH:mm:ssZ)

HTTP Header = Авторизация:Предъявитель {токен доступа для этой подписки}

Ответ = код состояния HTTP 202 (это асинхронный запрос, при котором ответ будет размещен на URL-адресе уведомления, когда данные будут готовы)

Как только данные будут готовы, мы опубликуем уведомление на предоставленный вами URI уведомления с полезными данными URL-адресов, которые ваше приложение может вернуть, чтобы получить предварительно упакованный файл. Пример после уведомления выглядит следующим образом:

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

Выполните GET по указанному выше URL-адресу с токеном доступа, чтобы получить данные. Он будет содержать как данные об использовании интервала (), так и информацию о счете () за запрошенный период.

Пакетная подписка (стандартная и EEF)
Вы также можете запросить информацию об использовании и выставлении счетов через пакетный асинхронный API для всех ваших авторизаций клиентов для данных об использовании/выставлении счетов (т. е. Подписки).

Пример URL-
адреса группового запроса https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?опубликовано-мин={startDate}&опубликованомакс={endDate}

BulkID = BulkID, предоставленный в ресурсе ApplicationInformation Resource, полученном во время регистрационных испытаний. (BulkID=ClientID)

опубликовано-min = дата начала, которая будет применена к этому запросу для извлечения данных. (RFC 3339 формат zulu time. yyyy-MM-ddTHH:mm:ssZ)

опубликовано-макс. = дата окончания, которая будет применена к этому запросу для извлечения данных. (RFC 3339 формат zulu time. yyyy-MM-ddTHH:mm:ssZ)

Заголовок HTTP = авторизация:Предъявитель {токен доступа клиента}

Ответ = код состояния HTTP 202 (это асинхронный запрос, при котором ответ будет размещен на URL-адресе уведомления, когда данные будут готовы)

Как только данные будут готовы, мы опубликуем уведомление на предоставленный вами URI уведомления с полезными данными URL-адресов, которые ваше приложение может вернуть, чтобы получить предварительно упакованный файл. Пример после уведомления выглядит следующим образом:

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

Выполните GET по указанному выше URL-адресу с токеном доступа, чтобы получить данные. Он будет содержать как данные об использовании интервала (), так и информацию о счете () за запрошенный период.

Наконец, вы можете ежедневно получать последнюю информацию об использовании и выставлении счетов, включая исправления прошлых дат в рамках периодов авторизации клиентов, используя модель ежедневной подписки (т. е. поставив флажок «Уведомить меня о готовности данных (ежедневно)» во время регистрации).

Для поддержки модели ежедневной подписки ваше приложение должно будет поддерживать отправку вам уведомлений (в соответствии с URL-адресом уведомления, который вы указали при регистрации).

Как только данные будут готовы, мы опубликуем уведомление на предоставленный вами URI уведомления с полезными данными URL-адресов, которые ваше приложение может вернуть, чтобы получить предварительно упакованный файл. Пример после уведомления выглядит следующим образом:

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

Выполните GET по указанному выше URL-адресу с токеном доступа, чтобы получить данные. Он будет содержать как данные об использовании интервала (), так и информацию о счете () за запрошенный период.

20 марта 2023 г.

Что нового:

1. Выпуск нового кода ответа API HTTP (204) как для синхронных, так и для асинхронных вызовов API, чтобы указать, когда данные недоступны для запрашиваемого диапазона.
2. Поддержка метки заголовка x-транзакции, которая поддерживает возможность привязывать ответ PG&E к конкретным асинхронным вызовам API путем возврата этого значения вместе с идентификатором корреляции, когда запрошенный файл будет готов.
3. Улучшенная детализация дополнительных данных для UsagePoint/MeterReadingID API за счет предоставления данных электрических интервалов для нескольких счетчиков в один сценарий соглашения об обслуживании.
4. Внесено дополнительное уточнение в значения индикатора качества чтения для данных ОЖИДАЕМОГО интервала, чтобы описать тип оценки, используемой для этого интервала. Новые значения, указывающие на применение логики оценки, приведены ниже:
   
   

5. Значение и описание RQI

   0 - Действительны: данные, прошедшие все необходимые проверки и либо прошедшие все, либо проверенные

   7 - Отредактировано вручную: заменено или одобрено человеком

   8 - Рассчитано с использованием эталонного дня: значение данных было заменено рассчитанным машиной значением на основе анализа исторических данных с использованием того же типа измерения

   9 - Рассчитано с использованием линейной интерполяции: значение данных было рассчитано с использованием линейной интерполяции на основе показаний до и после нее

   10 - Сомнительный: данные, которые не прошли одну или несколько проверок

   11 - Производные: данные, которые были рассчитаны (с использованием логических или математических операций), не обязательно измерены напрямую

   12 - Прогнозируемые (прогнозные): данные, которые были рассчитаны как прогноз будущих показаний

   13 - Смешанный: указывает на то, что качество этого показания имеет смешанные характеристики

   14 - Необработанные данные: данные, которые не прошли процесс проверки, редактирования и оценки. ПРИМЕЧАНИЕ Индикатор RQI расходомеров MV90 останется в 14 состоянии окончательного RQ

   15 - Нормализовано погоде: значения скорректированы с учетом погоды, для сравнения использования в различных климатических условиях

   16 - Другое: указывает на то, что характеристика применима к характеристикам, отличным от определенных

   17 - Валидированные: данные, которые были валидированы и, возможно, отредактированы и/или оценены в соответствии с утвержденными процедурами

   18 - Проверено: данные, которые не прошли хотя бы одну из необходимых проверок валидации, но были определены как фактические

   19 - Качество дохода: допустимо и приемлемо для выставления счетов [возможное продление для стандарта ESPI, а не для оригинального стандарта ESPI]

    

6. Выпуск метрик использования API поставщика на портале для поставщиков «Поделиться моими данными с третьими сторонами».

15 ноября 2018 г.

Что нового:

1. Добавлен индикатор класса клиента. Каждое утвержденное SAID будет идентифицироваться как RES, AGR, COM/IND или другое.
2. API биллинга и использования будут обновлены для принятия параметров запроса с обновленным максимумом и обновленным минимумом (в качестве альтернативы опубликованному минимуму и опубликованному максимуму). Возвращенные данные будут представлять собой все изменения, которые произошли в пределах обновленных максимальных и обновленных минимальных параметров.
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
Идентификатор
обслуживания Будущие изменения статуса обслуживания
SA Статус
обслуживания Дата
начала обслуживания Адрес
обслуживания Текущая услуга
Тариф Исторический расчет стоимости обслуживания Варианты тарифа
(Базовый медицинский уровень, ЗАБОТУ, FERA, TBS, CCA_TBS, Solar Choice
Текущее рабочее напряжение и товар Исторический биллинг Рабочее напряжение
Номер
служебного счетчика Количество служебных счетчиков
Тип
измерителя Ток Измеритель Прочитанный цикл
Исторический биллинг Измеритель Прочитанный цикл
Ток в режиме ожидания Опция Вариант ожидания Вариант
ЭЦП Исторический биллинг индикатора
генерации на объекте: Индикатор
класса клиента Исторические элементы
выставления счетов Дата
начала выставления счета Дата
окончания выставления счета Общая стоимость счета ($)
Общая стоимость счета кВт·ч
ЭЦП: Название EDS для разбивки исторического уровня счета поставщика
услуг (при наличии
): EDS периода
выставления счета за позицию: Название (по сравнению с исходным уровнем 1–30 %)
ЭДС: Объем (1234.2)
ЭЦП: Тариф (0 долл. США032/кВт·ч)
ЭЦП: Стоимость (100 долл. США.23)
Разбивка исторического билля TOU кВт·ч (за исключением EDS с выставлением счета ABS-TX):
Период выставления счета за позицию (для разбивки TOU)
EDS: Название (затраты на ТОУ)
ЭЦП: Объем (1234.2)
ЭЦП: Тариф (0 долл. США032/кВт·ч)
EDS: Стоимость (100 долл. США.23)
ЭЦП для разбивки
исторического биллового спроса: Период выставления счета за позицию (для разбивки спроса)
EDS: Название
EDS: Объем (1234.2)
ЭЦП: Тариф (0 долл. США032/кВт·ч)
ЭЦП: Стоимость (100 долл. США.23)
ЭЦП исторических позиций
счета: EDS периода выставления
счета за позицию: Название платежа (DWR Bond Charge)
EDS: Объем (1234.2)
ЭЦП: Единица (кВт-ч)
EDS: Тариф (0 долл. США032/кВт·ч)
ЭЦП: Стоимость (100 долл. США.23)
Интервалы
использования истории Интервал использования
Начало Интервал использования по умолчанию Длительность (в секундах)
Объем использования интервала (1234.2)
Название
программы
реагирования на спрос на
коммунальные услуги (DR) Самая ранняя дата прекращения без финансового обязательства
Самая ранняя дата прекращения независимо от финансового обязательства

Статус программы DR Дата
регистрации в программе DR Дата
прекращения участия в программе DR Дата прекращения участия в программе Элементы

данных Местные параметры времени (подробности DST)
Качество данных
Направление
энергии Мощность десяти (для значений интервалов использования)
Мощность десяти множителей (для биллингового спроса)
Мощность десяти множителей (для биллингового общего использования)
Длительность интервала (измерения использования)
Валюта общей стоимости
счета Индикаторы TOU электрического интервала

28 июня 2018 г.

В рамках проекта Click-Chrough и постоянного улучшения платформы Share My Data Platform компания PG&E запустила этап Click-Chrough 2 28 июня 2018 года.

Что нового:

Наиболее важными изменениями, влияющими на третьи стороны, являются изменения, соответствующие протоколу OAuth 2.0 (PG&E устранила первоначальную серию перенаправлений). Ниже приведена подробная информация.

ВАЖНО: Третьи стороны ОБЯЗАТЕЛЬНО вносят изменения в существующую реализацию OAuth. Изменения фазы 2 по щелчку от 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 или redirect_uri отсутствуют или недействительны, клиенту отображается ошибка (http 400) с пояснительным сообщением
   • Если требуемый параметр response_type отсутствует или недействителен, клиент будет перенаправлен обратно к redirect_uri третьей стороны с параметром ошибки "invalid_request" (прилагается к redirect_uri)
     
3. Для клиентов с существующей онлайн-авторизацией возможность для третьей стороны запросить новую пару access_token/refresh_token в рамках новой авторизации, которая заменяет существующую (т. е. онлайн-авторизация той же третьей стороны и комбинации клиентов). Эта функция касается сценариев потери пар токен доступа/обновления токена третьими лицами или иной необходимости изменения объема первоначального разрешения на утверждение клиентом.
   • Для запросов на повторную авторизацию клиент видит новую страницу авторизации вместо страницы «управлять авторизацией» при перенаправлении третьей стороной в PG&E для авторизации
   • После авторизации клиента третьи стороны получают уведомление на свой зарегистрированный URL-адрес уведомления об отмене старого ID подписки (уведомление содержит конечную точку URL API авторизации для старого ID подписки)
     
4. Возможность для клиента выйти с помощью кнопки «отмена» на странице аутентификации или на странице авторизации с перенаправлением обратно к redirect_uri третьей стороны с параметром ошибки «access_denied» (прилагается к redirect_uri)
5. Для третьих сторон, которые регистрируются с настройкой «видимость» и поэтому включены в список зарегистрированных третьих сторон, клиенты увидят, когда они перейдут в свою учетную запись PG&E в Интернете и перейдут на целевую страницу «Поделиться моими данными»:
   • Для клиентов, которые вошли в свою учетную запись PG&E в Интернете и переходят на целевую страницу «Поделиться моими данными», а затем перенаправляются на зарегистрированный URI портала третьей стороны после выбора третьей стороны из списка зарегистрированных третьих сторон. На этом этапе клиенты могут приступить к процессу OAuth, инициированному третьей стороной. При прохождении по этому пути клиентам больше не будет отображаться страница авторизации при выборе третьей стороны из выпадающего списка третьих сторон, а вместо этого они будут перенаправлены на зарегистрированный URI портала третьей стороны, где они могут начать процесс OAuth, инициированный третьей стороной
   • Примечание. Некоторые третьи стороны спросили, как оптимизировать клиентский опыт для этого сценария использования (т. е. авторизации, инициированные на сайте PG&E), чтобы клиент мог видеть, что они переходят непосредственно на страницу авторизации при выборе третьей стороны из выпадающего списка. Для обеспечения такого клиентского опыта третьи стороны могут установить свой URI «Портала третьих сторон» (на странице регистрации «Поделиться моими данными с моими данными») на оконечное устройство, которое автоматически перенаправляет клиента обратно в PG&E в рамках запроса на авторизационный код. После автоматического перенаправления обратно на authorizationServerAuthorizationEndpoint клиент пропустит страницу входа клиента (так как он уже вошел в систему) и перейдет непосредственно на страницу авторизации. Для некоторых третьих сторон, которые зарегистрировались до выпуска «Передача моих данных через приложение 2.0», это можно сделать, просто задав URI портала для третьих сторон, чтобы он был равен больше не используемому URI «Экран выбора области действия третьих сторон» (старое поле регистрации SMD будет выведено из обращения в будущем).
     В отличие от этого, некоторые третьи стороны могут захотеть сначала привлечь и проверить клиентов со своей стороны, когда клиенты перенаправляются на свой URI «Портала третьих сторон» перед запросом авторизационного кода, поэтому вышеуказанный подход является лишь предложением.
     
6. Теперь SMD предоставит расширенные данные параметров области действия в рамках ответов на запрос кода авторизации, запрос токена доступа и API авторизации. Расширенный параметр объема позволяет передавать окончательный объем авторизации клиента. В частности, параметр области включает значение «Дополнительный объем», которое соответствует поддерживаемым PG&E выборкам авторизаций клиентов для групп данных (например, «Использование», «Выставление счетов», «Базовый», «Учетная запись», «Регистрация программы»). Значения параметров осциллографа дополнительно фиксируются в соответствии со следующей документацией:Скачать сопоставление строк осциллографа поддерживаемого функционального блока Click Thru 2.0 (PDF)
   
   Пример ответа маркера ниже иллюстрирует некоторые возможные значения параметров области действия.
   • Пример отклика токена:
     <Ответ xmlns="https://апи.стр.com/datacustodian/oauth/v2/token">
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     
     resourceURI:{ResourceURI}, например: https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     авторизацияURI:{URI авторизации}, например: https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{CustomerResourceURI}, например:https://апи.стр.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Теперь третьи стороны могут зарегистрироваться для получения информации о регистрации в программе через новую группу данных «Соглашение о регистрации в программе». Как интервальные, так и неинтерваловые клиенты будут иметь право разрешать обмен данными для фазы 2 SMD Click-Through. Ниже представлен общий обзор новых доступных элементов данных, предоставленных группой данных о регистрации в программе:
   • Регистрация в программе (название/статус программы PG&E Demand Response и информация CAISO):
   • (Выставление счетов) Адрес счета
   • Статус соглашения об обслуживании
   • Тариф на обслуживание (текущий)
   • (Ток) Рабочее напряжение (только электрическое)
   • Номер сервисного счетчика (при наличии)
   • Тип расходомера
   • (Текущий) цикл считывания показаний измерителя
   • (Текущий) вариант скорости ожидания, если индикатор генерации на объекте
   • (использование интервала по умолчанию) Длительность (длительность в секундах)
   • (Ответ на зарегистрированный спрос PG&E) Название программы (если применимо)
   • Самая ранняя дата увольнения из зарегистрированной в PG&E программы реагирования на спрос (DR) без финансовых обязательств
   • Самая ранняя дата прекращения участия в программе по реагированию на спрос (DR) PG&E, независимо от финансовых обязательств
   • Статус программы PG&E Demand Response (DR) (регистрация)
   • Дата включения в программу PG&E Demand Response (DR)
   • Дата прекращения участия в программе PG&E Demand Response (DR)
   • Сопоставление Atom XML XSD (определение схемы XML) для этих новых элементов данных фиксируется в соответствии со следующей документацией:
     Загрузить поддерживаемые элементы данных (PDF)
   • Связанная модель иерархии реляционных данных описана следующим образом:
     Загрузить модель данных PGE ESPI (PDF)
   • UsagePoint (также известный как SA UUID)
     • ServiceDeliveryPoint\tariffProfile(текущий тарифный план AKA, включая опцию тарифа ожидания, если применимо)
     • readCycle (текущий цикл чтения измерителя)Обзор использования
     • readCycle (цикл обслуживания выставления счетов)
     • Товар (включает расчетный уровень напряжения для электрического оборудования)
     • тарифный профиль (тариф на услуги по выставлению счетов, включая опцию «Тариф ожидания», если применимо
   • Тип считывания
     • Товар (включает уровень напряжения тока для электрической системы и префикс для опции нормы резервирования, если применимо)
   • Учетная запись клиента
     • (Адрес выставления счета):
     • основнойАдрес/улицаПодробная информация...
     • mainАдрес/городПодробная информация...
     • основнойАдрес/почтовыйкод...
   • Соглашение с клиентом
     • состояние\значение (статус SA
   • Программа реагирования на спрос
     • Название программы
     • статус включения в исследование
     • программаДата/программаДата
     • ПрограммаДата/программаДатаОписание
   • Счетчик
     • серийный номер (идентификатор счетчика)
     • тип (тип расходомера)
     • (текущий) интервалДлина
   • Последние определения схемы ESPI xml (XSD), используемые для этих новых элементов данных, изложены следующим образом:
     Загрузить XSD (ZIP, 49 КБ)ZIP. Открывается в новом окне.
     Примечание: XSD обратно совместимы.
   • Третьи лица будут иметь возможность изменить свою регистрацию, чтобы позволить клиентам выбирать эту группу данных в течение времени авторизации через портал третьей стороны в разделе «Управление регистрацией» > «Редактировать» > «Раздел»: Укажите необходимую информацию о клиенте», установите флажок Регистрация в программе.
   • Примечание:это относится только к новым авторизации клиентов.
     
   • Новые API для получения информации о регистрации DR доступны на уровне Пакета 3-й стороны, а также на уровне авторизации отдельного клиента (уровень RetailCustomerID), как указано ниже:
     Загрузить новые API, поддерживаемые PGE (PDF)
   • Асинхронный API для запроса информации о регистрации DR для всех авторизаций третьей стороне
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • Синхронный API для запроса информации о регистрации DR на уровне авторизации отдельного клиента
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

Обратите внимание: Помимо изменений в процессе авторизации клиентов, другие изменения также являются обратно совместимыми и являются добровольными улучшениями, которые третьи стороны могут решить поддержать.

Если у вас есть какие-либо вопросы или вам нужна дополнительная поддержка, обращайтесь по адресу электронной почтыsharemydata@pge.com.

Что нового:

1. Теперь клиенты могут воспользоваться преимуществами оптимизированного процесса авторизации Click-To-Chrough.
   • Мы обновили информацию о том, как клиент может теперь обмениваться данными с вашей компанией.
     Узнайте, как клиенты обмениваются данными с компанией
     
     Примечание: Эти изменения, особенно улучшения нашего пользовательского интерфейса авторизации, были оптимизированы для мобильных устройств (например, телефонов или планшетов).
   • Внесены изменения в процесс управления авторизацией, доступный клиентам через их онлайн-аккаунт PG&E:
     • Клиент может удалить SAID из существующей авторизации, продлить дату окончания авторизации и/или отменить авторизацию в любое время. Однако для добавления дополнительных SAID и/или изменения элементов авторизованных данных необходимо отменить существующее разрешение и создать новое разрешение.
2. При желании третьи лица могут использовать этот API для отзыва индивидуальных авторизаций клиентов с использованием своего токена доступа клиента третьей стороны (предоставленного во время первоначального процесса регистрации третьей стороны в SMD) посредством операции УДАЛИТЬ: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   Примечание 1.Для реализации PG&E параметр AuthorizationID является тем же значением, что и SubscriptionID.
   
   Примечание 2:Новый API предоставляет третьим лицам возможность отозвать (отменить) авторизацию. Тем не менее, только сами клиенты могут удалять идентификаторы SA и/или обновлять дату окончания авторизации на наших страницах авторизации управления SMD.
   
   Напоминание:Как и во всех запросах данных API, третьи лица должны сначала запросить новую пару токенов (клиентский доступ + обновление токена), используя последние обновления токенов.
   
   Напоминание о сроках действия токена:
   • Токен доступа:1 час
   • Токен доступа клиента: 5 мин
   • Соответствующие маркеры обновления: 1Yr
3. Третьи лица могут создать несколько регистраций Share My Data (SMD), используя одно и то же название компании и налоговый идентификатор, если это необходимо. Однако отображаемое имя (которое клиенты видят при авторизации) должно быть уникальным.
   
   Примечание:Все указанные выше изменения являются обратно совместимыми и являются добровольными улучшениями, которые третьи стороны могут принять для поддержки. Скачать сопроводительные документы для этого выпуска:
   
   SUPPORTED_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   ПОДДЕРЖИВАЕМЫЕ_ДАННЫЕ_ЭЛЕМЕНТЫ_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   ПОДДЕРЖИВАЕМЫЕ_ДАННЫЕ_ЭЛЕМЕНТЫ_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

20 декабря 2015 г.

Требуемые изменения:следующие обновления SMD 2.0 требуют изменений со стороны третьих сторон.

1. Принимая во внимание третьи стороны, использующие GBCMD (Green Button Connect My Data) на нескольких сервисных программах, кроме PG&E, мы передадим обратно DataCustodianID (т. е. dataCustodianID=PGE) в перенаправлении к третьей сторонеPartyScopeSelectionScreenURI во время последовательности авторизации OAuth.
2. Запросы API, которые принимают параметры даты (например, пакетный запрос), должны использовать параметры данных Zulu (например, опубликованные-макс/опубликованные-мин). Другие форматы дат для параметров дат в запросах API не поддерживаются.
   • API, принимающие параметры даты, документируются в соответствии с прилагаемым файлом,Supported APIs.xlsx
3. Индикаторы TOU за интервал, включенные в данные об использовании электроэнергии за интервал (если применимо, индикатор того, какой период TOU соответствует каждому интервалу)
   • См. статические схемы идентификаторов программ, в которых указано, что соответствует каждому интервалу подсчета TOU (например, 1 = летний пик и т. д.). (См. приложение,Supported Data Elements.xlsx )
4. Идентификатор клиента, найденный в данныхCustodianScopeSelectionScreenURI (используется для инициированного третьей стороной OAuth) и предоставленный в запросе ресурса информации приложения третьих сторон во время регистрационных испытаний, обновляется до 5 цифр, если он еще не был обновлен (например, добавление начальных нулей и т. д.). Кроме того, URL-адрес больше не содержит '&verified=true' в конце. Третьим сторонам потребуется соответствующим образом обновить свои URL-адреса.
   • Для более подробной информации, dataCustodianScopeSelectionScreenURI выглядит следующим образом: 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» или «Поставщик энергетических услуг», меняются на «Стандартный тип пользователя». Функциональные изменения отсутствуют, только в заголовке типа пользователя. Отличие типа пользователя ESP (от стандартного типа пользователя) является ненужной дифференциацией, вызывающей путаницу в процессе регистрации без предоставления каких-либо дифференцированных функций, поэтому он выводится из обращения.

Дополнительные улучшения: Следующие изменения являются обратно совместимыми и являются добровольными улучшениями, которые третьи стороны могут принять для поддержки.

1. Третьи стороны будут иметь возможность автоматически изменять/обновлять свои сертификаты SSL, которые они изначально предоставили во время регистрации (например, когда срок действия сертификата истекает) через портал третьей стороны под управлением регистрации >Редактировать > новый раздел: Информация о сертификате SSL (вариант обновления).
2. Третьи лица могут зарегистрироваться для получения утвержденной базовой платежной информации, информации о клиенте и данных о газе.  Как измерительные, так и неинтервал-измерительные клиенты будут иметь право разрешать обмен данными для SMD 2.0. Ниже представлен краткий обзор новых доступных элементов данных:
   • Информация для выставления счета: (для АБ, измеренных как за интервал, так и за период)
     • Тарифный график, итоговые суммы по выставлению счетов в долларах США, многоуровневое использование (если применимо), спрос (если применимо), итоговые суммы TOU (если применимо)
     • Примечание.Для авторизованных клиентов с неинтервалным измерением третьи стороны будут получать только итоговые суммы использования счетов (т. е. в Сводке использования) и не будут читать показания об использовании интервалов (например, почасовые/ежедневные показания, поскольку они недоступны)
   • Информация о клиенте: (для АБ с измерением интервалов и без них)
     • Имя клиента, адрес службы, идентификатор учетной записи, идентификатор соглашения об обслуживании, дата начала обслуживания по соглашению об обслуживании,
   • Данные об использовании газа за период: (только SA с счетчиком за период)
     • Интервальные (т. е. ежедневные) показания газа
   • Новые элементы данных представлены на диаграмме в соответствии с прилагаемым файлом,Supported Data Elements.xlsx
   • Связанная иерархия реляционных данных описана в приложении,PGE ESPI Data Model.xlsx
   • Последние определения схемы ESPI xml (XSD), используемые для этих новых элементов данных, соответствуют прилагаемым XSD. Примечание: XSD обратно совместимы:
     • espiDerived.xsd (информация об использовании интервалов и выставлении счетов)
     • retailcustomer.xsd (информация о клиенте)

Если у вас есть какие-либо вопросы или вам нужна дополнительная поддержка, свяжитесь с нами по адресу ShareMyData@pge.com.

18 декабря 2015 г.

Требуемые изменения: следующие обновления SMD 2.0требуют изменений со стороны пользователей, имеющих доступ к собственным данным:

1. Запросы API, которые принимают параметры даты (например, пакетный запрос), должны использовать параметры данных Zulu (например, опубликованные-макс/опубликованные-мин). Другие форматы дат для параметров дат в запросах API не поддерживаются.
   • API, принимающие параметры даты, документируются в соответствии с прилагаемым файлом,Supported APIs.xlsx
2. Индикаторы времени использования интервала (TOU), включенные в данные об использовании электроэнергии за период (если применимо, индикатор того, какой период TOU соответствует каждому интервалу)
   • См. статические схемы идентификаторов программ, в которых указано, что соответствует каждому интервалу подсчета TOU (например, 1 = летний пик и т. д.). (См. приложение,Supported Data Elements.xlsx )

Дополнительные улучшения: Следующие изменения являются обратно совместимыми и являются добровольными улучшениями, которые третьи стороны могут принять для поддержки.

1. Пользователи с самостоятельным доступом смогут автоматически изменять/обновлять свои сертификаты SSL, которые они изначально предоставили во время регистрации (например, когда срок действия сертификата истекает) через сторонний портал под управлением регистрации > Редактировать > новый раздел: Информация о сертификате SSL (вариант обновления)
2. Регистрация пользователей с самостоятельным доступом будет обновлена с целью включения утвержденной базовой платежной информации, информации о клиенте и данных о газе. Оба соглашения об обслуживании с измерением интервала, как и соглашения об обслуживании без измерения интервала, будут иметь право на (самостоятельное) авторизацию для SMD 2.0. Краткий обзор новых доступных элементов данных на высоком уровне выглядит следующим образом:
   • Информация для выставления счета: (для АБ, измеренных как за интервал, так и за период)
     • Тарифный график, итоговые суммы по выставлению счетов в долларах США, многоуровневое использование (если применимо), спрос (если применимо), итоговые суммы TOU (если применимо)
     • Примечание.Для авторизованных клиентов с неинтервалным измерением третьи стороны будут получать только итоговые суммы использования счетов (т. е. в Сводке использования) и не будут читать показания об использовании интервалов (например, почасовые/ежедневные показания, поскольку они недоступны)
   • Информация о клиенте: (для АБ с измерением интервалов и без них)
     • Имя клиента, адрес службы, идентификатор учетной записи, идентификатор соглашения об обслуживании, дата начала обслуживания по соглашению об обслуживании,
   • Данные об использовании газа за период: (только SA с счетчиком за период)
     • Интервальные (т. е. ежедневные) показания газа
   • Новые элементы данных представлены на диаграмме в соответствии с прилагаемым файлом,Supported Data Elements.xlsx
   • Связанная иерархия реляционных данных описана в приложении,PGE ESPI Data Model.xlsx
   • Последние определения схемы ESPI xml (XSD), используемые для этих новых элементов данных, соответствуют прилагаемым XSD. Примечание: XSD обратно совместимы:
     • espiDerived.xsd (информация об использовании интервалов и выставлении счетов)
     • retailcustomer.xsd (информация о клиенте)

Если у вас есть какие-либо вопросы или вам нужна дополнительная поддержка, свяжитесь с нами по адресу ShareMyData@pge.com.

18 декабря 2015 г.

Требуемые изменения: следующие обновления SMD 2.0требуют изменений со стороны внедрения CCA.

1. Специальные запросы (например, для исторических данных) должны выполняться с использованием параметров даты времени Zulu. Другие форматы дат для параметров дат в запросах API не поддерживаются.
2. Ежедневная лента массового использования начнет включать базовую платежную информацию, а ежедневная лента массового использования будет включать дополнительную информацию о клиенте. Эти новые данные будут предоставлены как для клиентов с интервальным замером, для которых они получают данные в настоящее время, так и для клиентов без интервального замера на их территории, для которых они в настоящее время не получают данные. Наконец, значения использования интервала, указанные в ежедневной ленте массового использования, будут включать индикаторы TOU интервала, если это применимо. Краткий обзор новых элементов данных на высоком уровне:
   • Информация для выставления счета: (для АБ, измеренных как за интервал, так и за период)
     • Тарифный график, итоговые суммы по выставлению счетов в долларах США, многоуровневое использование (если применимо), спрос (если применимо), итоговые суммы TOU (если применимо)
   • (Дополнительно) Информация о клиенте: (для АБ с измерением интервала и без него)
     • Имя клиента, адрес службы, дата начала обслуживания по соглашению об обслуживании, идентификатор учетной записи
   • Индикаторы TOU за интервал, включенные в данные об использовании электроэнергии за интервал (если применимо, индикатор того, какой период TOU соответствует каждому интервалу)
     • См. статические схемы идентификаторов программ, в которых указано, что соответствует каждому интервалу подсчета TOU (например, 1 = летний пик и т. д.). (См. приложение,Supported Data Elements.xlsx )
   • Последние определения схемы ESPI xml (XSD), используемые для этих новых элементов данных, соответствуют прилагаемым XSD. Обратите внимание, что XSD обратно совместимы:
     • espiDerived.xsd (информация об использовании интервалов и выставлении счетов)
     • retailcustomer.xsd (Информация о клиенте)
   • Новые элементы данных представлены на диаграмме в соответствии с прилагаемым файлом,Supported Data Elements.xlsx
   • Связанная иерархия реляционных данных описана в приложении,PGE ESPI Data Model.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 авторизации отдельно от информации о маркере. В настоящее время эти URI переворачиваются, и в рамках этого выпуска мы будем их исправлять.

Устраненные дефекты:

1. Даты по умолчанию, опубликованные максимумом и минимумом
   В настоящее время PG&E требует от третьей стороны отправки в опубликованных минимумах и опубликованных максимумах параметров в секундах периода для каждого запроса данных, чтобы сообщить PG&E продолжительность, в течение которой они запрашивают данные. Мы вносим изменения в обработку запросов для следующих сценариев:
   • Отсутствуют опубликованные-мин. и опубликованные-макс. значения
   • опубликованные-мин. и опубликованные-макс. значения приведены в UTC
   • опубликованные-мин. и опубликованные-макс. значения указаны в секундах периода
   В случае отсутствия параметров PG&E вернет даты по умолчанию, а не сообщения об ошибках, возвращенные до этого изменения. По умолчанию в нашем случае это данные за один день на дату T-2. Если параметры присутствуют и отформатированы правильно, мы продолжим соблюдать эти параметры.
2. Исправление дат авторизации xml
   В настоящее время в разрешении xml мы предоставили опубликованную дату и дату авторизации. Эти даты выражены в миллисекундах, а не в секундах, что является стандартом. Мы исправляем его, чтобы отправить обратно в секундах периода, а не в миллисекундах.
3. Возвращен неверный XML для /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   В настоящее время мы возвращаем неверный ответ для вышеуказанного уровня ресурсов GET, где структура XML неверна, и мы повторяем записи для каждого интервала вместо создания одного блока интервала в течение 24 часов.
   
   Это фиксированное значение, и только один интервальный блок будет возвращен для 24 интервального блока.

Есть вопросы или сомнения? Пожалуйста, свяжитесь сShareMyData@pge.com.

• Клиенты разрешают вам доступ к своим данным через My Energy, свою учетную запись PG&E в Интернете. Для получения подробного обзора того, как клиенты могут разрешить третьим лицам или другим организациям доступ к их данным, просмотрите Обзор обмена моими данными с третьими лицами.

Перейти к данным авторизации

• В настоящее время нет ограничений.

• Клиенты могут выбрать определенное количество времени, в течение которого вы можете получить доступ к их данным, или оставить период авторизации открытым.
• Ваша заявка может проверить дату окончания авторизации клиента вместе с другими данными авторизации, позвонив в API ресурса авторизации (например, .../espi/1_1/resource/Authorization и/или.../espi/1_1/resource/Authorization/{AuthorizationID}).
• Вы также можете вручную проверить даты окончания авторизации, войдя в свою учетную запись и выбрав Управление авторизациями.

• Если клиент выбирает определенный период авторизации, срок действия его авторизации истекает в конце этого периода времени. Если они отменят разрешение, срок его действия истекает на следующий день после его отмены.
• Если клиент выбирает «Неопределенно» в качестве срока авторизации, срок действия авторизации не истекает. Обратите внимание, что с учетом Поставщиков услуг по реагированию на запросы согласно Правилу 24 и других программ, использующих функцию «Передать мои данные», сторонние организации могут получить послепродажные исправления для ранее утвержденных диапазонов дат в течение трех лет после истечения срока действия разрешения.
• См. раздел «Как будут обрабатываться исправления данных?» для получения дополнительной информации о внесении исправлений.

• Любой клиент PG&E с действующим сервисным идентификатором для газовой или электрической службы может разрешить вам доступ к их данным с помощью нового инструмента «Поделиться моими данными».

• Клиентам, заинтересованным в передаче своих данных через программу «Поделиться моими данными», настоятельно рекомендуется зарегистрироваться в учетной записи My Energy. Это сделает весь процесс более эффективным, а также позволит им управлять своими авторизациями онлайн.
• Клиенты могут зарегистрироваться в учетной записи My Energy в процессе авторизации.
• Клиенты могут получить онлайн-форму авторизации на передачу моих данных и отправить заполненную форму по электронной почте.
• Для получения дополнительной информации о ручном процессе свяжитесь с нами по адресу ShareMyData@pge.com.

• Клиенты должны самостоятельно авторизовать свои учетные записи PG&E в Интернете. Однако, если они заполнят и подпишут форму разрешения на передачу моих данных, вы можете отправить ее в PG&E от их имени.

Загрузить форму авторизации клиента на передачу моих данных или отзыва авторизации (PDF, 308 КБ)

• Вы можете обновить свои URI OAuth, войдя в свою учетную запись, перейдя в раздел Управление регистрацией > Редактировать > и обновив поля в разделе Информация OAuth 2.0.

• Вы можете обновить свой URI уведомления, войдя в свою учетную запись, перейдя в раздел Управление регистрацией > Редактировать > и обновив поля в разделе Информация о доступе к данным.

• Вы можете обновить сертификат SSL, войдя в свою учетную запись, перейдя в раздел Управление регистрацией > Редактировать > и выбрав «Обновить» в разделе Информация о сертификате SSL. Обратите внимание, что для загрузки нового сертификата может потребоваться несколько дней, чтобы обновить системы PG&E новым сертификатом.  
• После применения нового сертификата будет отправлено электронное письмо с подтверждением от группы поддержки «Поделиться моими данными».

• После получения электронного письма с подтверждением того, что ваша регистрация была принята, вы сможете войти в свою учетную запись «Поделиться моими данными» и загрузить наш сертификат SSL на странице загрузки сертификата PG&E SSL.

Войдите в систему, чтобы поделиться моими данными

• Передача моих данных осуществляется в соответствии с соглашениями о внедрении «Подключить мои данные» с зеленой кнопкой. «Передача моих данных» также использует OAuth 2.0 для авторизации, Transport Layer Security (TLS) 1.2 и минимальный набор протоколов кибербезопасности, утвержденных NIST (Национальным институтом стандартов и технологий), чтобы не обмениваться четкой информацией.

• Защита информации о клиентах является главным приоритетом для PG&E. PG&E рассматривает информацию о своих клиентах, включая личную информацию, как конфиденциальную, соответствующую всем законодательным и нормативным требованиям, включая требования, установленные Калифорнийской комиссией по коммунальным услугам и другими организациями.  
• На протяжении более двух десятилетий компания PG&E и другие коммунальные предприятия, принадлежащие инвесторам в Калифорнии, подпадают под очень строгие правила CPUC, которые запрещают им раскрывать информацию о клиентах, такую как платежные данные, третьим сторонам без явного согласия клиента.  
• После того как клиент санкционирует передачу данных, ответственность за защиту этих данных лежит на клиенте и третьей стороне.
• Клиент может прекратить передачу данных третьей стороне в любое время, войдя в свою учетную запись PG&E и отменив свое разрешение. Полная политика конфиденциальности PG&E и Уведомление о доступе, сборе, хранении, использовании и раскрытии информации об использовании энергии доступны на сайте pge.com/privacy.

• В рамках программы «Передача моих данных» на третьих лиц распространяются Правила конфиденциальности и защиты данных клиента, указанные в условиях и положениях платформы «Передача моих данных», а также требования, включенные в Тариф на доступ к данным клиента.
• Третьи стороны также подпадают под действие всех других применимых законов и нормативных актов, касающихся защиты конфиденциальности клиентов, включая, помимо прочего, Правила в отношении конфиденциальности и безопасности данных об использовании энергии, принятые ЦПК в качестве Приложения D к Решению 11-07-056 (Электрика), также обобщенные в Правиле PG&E об электрооборудовании No 27 и Гражданском кодексе Калифорнии, раздел 1798.80 – 1798.84.
• Для получения дополнительной информации перейдите по ссылкам ниже:
  Положения и условия передачи моих данных (PDF, 190 КБ)
  Электрическое правило No 27 (PDF, 1,6 МБ),
  Приложение D к решению 11-07-056 (PDF)
  Дополнительная информация:Гражданский кодекс Калифорнии, раздел 1798.80 – 1798.84

• Подробный список поддерживаемых элементов данных см. по ссылке ниже.

Получить дополнительную информацию о доступе к данным

• В некоторых случаях данные об использовании интервала отсутствуют, потому что наши процессы проверки данных, поступающих раньше, обнаруживают отсутствие или неправильные считывания данных, которые могут потребовать дальнейшей обработки (редактирования и/или оценки).
• Для клиентов, выставивших счет за период (например, клиентов с учетом времени использования), эти случаи корректируются вовремя, чтобы обеспечить точный расчет счета в предстоящем ежемесячном счете.

• Если вы хотите получать исправления данных, убедитесь, что вы поставили флажок «Уведомить меня, поскольку данные готовы» во время регистрации или войдя в свою учетную запись в Интернете и установив этот флажок в разделе «Редактировать профиль». Затем мы включим исправления данных, которые были зафиксированы нашей системой в течение предыдущих 24 часов, в рамках ежедневной ленты использования, для любых данных, к которым вы имеете право доступа.
• Исправление данных будет охватывать любые изменения в течение разрешенного периода, максимум до трех лет.

Примечание. С учетом Поставщиков услуг по реагированию на запросы согласно Правилу 24 и других программ, использующих функцию «Передавать мои данные», сторонние организации могут быть предоставлены поправки после фактов для ранее утвержденных диапазонов дат в течение трех лет после истечения срока действия разрешения.

• Если применимо, PG&E будет отправлять уведомления на ваш URL-адрес уведомления, предоставленный во время регистрации. Уведомления содержат URL-адреса, соответствующие уже предварительно упакованным данным, готовым к возвращению и запросу по указанным URL-адресам. Данные предварительно упакованы, а уведомления отправляются в следующих двух сценариях: (1) вы выбрали «Уведомить меня о готовности данных» в вашем профиле регистрации, и в этом случае мы упакуем последние ежедневные данные с любыми исправлениями за прошлые даты; или (2) вы ранее сделали специальный асинхронный запрос, для которого запрошенные данные теперь готовы. Сценарий 1 показан в разделе «DATA ACCESS: ЕЖЕДНЕВНАЯ ПОДПИСКА» на диаграммах Методы доступа к данным на странице доступа к данным и сценарий 2 проиллюстрирован в разделе «ДАННЫЙ ДОСТУП: AD HOC REQUEST (ASYNCHRONOUS)» на тех же диаграммах также на странице доступа к данным.

Доступ к данным визита выше

• Данные об использовании электроэнергии, предоставленные компанией Share My Data, не являются данными измерителя качества расчетов (SQMD), как указано независимым системным оператором штата Калифорния (CAISO). SQMD генерируется путем умножения данных измерителя качества доходов (RQMD) на коэффициент потерь распределения (DLF), применимый к уровню напряжения этого клиента для этого интервала, преобразования измеренных интервалов в интервальный период, требуемый CAISO, а затем суммирования результатов для каждого интервала до совокупного уровня, требуемого CAISO.
  
• PG&E внедряет флаги типа «Качество чтения» (QualityOfReading, QOR), предоставленные стандартом ESPI, чтобы сообщить, являются ли данные качеством дохода. Тип QOR регистрирует различные возможные значения качества для данных об использовании, включая явное значение для «Данные счетчика качества прибыли» или «RQMD». PG&E будет использовать этот тип QOR при передаче данных следующим образом:
  • PG&E поддерживает предоставленный ESPI класс «Обзор использования», который будет использоваться для определения дат, за которые выставляется счет за соглашение об обслуживании, суммы счета за использование и качества данных об использовании на момент запроса. Сводка по использованию будет заполнена после того, как счет будет доступен для запрашиваемых данных, и будет содержать два флага (элемента) типа QOR:
    • Элемент UsageSummary.QualityOfReading (на уровне UsageSummary), указывающий качество на момент запроса последних заданных значений использования интервала плюс исправления, соответствующие датам UsageSummary.billingPeriod.
    • Элемент качества по умолчанию для общегопотребленияПоследний период (как часть UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef), указывающий качество общего количества использований, по которым выставлен счет.
  • PG&E также сообщит данные о качестве использования на уровне интервала во время запроса с помощью элемента IntervalReading.ReadingQuality.Quality.

• Во время регистрации вы можете выбрать, сколько хронологических данных вам нужно, за 24, 36 или 48 месяцев в раскрывающемся списке «Какое количество хронологических данных требуется».
• В рамках авторизации клиента, позволяющей вам получить доступ к его данным, исторический период авторизации будет установлен по умолчанию в соответствии с выбором регистрации для идентификаторов услуг (точек использования), включенных в авторизацию.
• Вы можете обновить запрошенные исторические данные, войдя в свою учетную запись, перейдя в раздел Управление регистрацией > Редактировать > и выбрав из выпадающего списка «Сколько исторических данных запрашивается».
• Обратите внимание, что данные, предоставленные в историческом запросе, начинаются с даты, когда клиент делает авторизацию, а не с даты, когда вы делаете запрос в API.

Примечание. Изменения в запрошенных исторических данных влияют только на авторизацию новых клиентов, в то время как предыдущие авторизации клиентов будут отражать ваш выбор на момент авторизации.

• В соответствии со стандартом ESPI в ответе используется стандарт публикации Atom. Выберите ссылку ниже, чтобы просмотреть полный список поддерживаемых API, а также доступные элементы данных.

Получить дополнительную информацию о доступе к данным

• Активные электрические и газовые сервисные идентификаторы, установленные и считанные PG&E, могут быть авторизованы через платформу обмена моими данными.
• Если идентификатор службы, связанный с авторизацией, изменяется по одной из следующих причин, авторизация перейдет к новому идентификатору службы, и доступ к историческим данным об использовании интервала будет продолжен:
  • Временное отключение из-за неуплаты
  • Перейти к выставлению счетов за интервал
  • Замена расходомера
  • Изменение тарифа
• Другие сценарии, которые приводят к изменению Сервисного идентификатора, например, перемещение местоположения или изменение компании, прекратят доступ. Кроме того, если учетная запись отсоединена от вашей учетной записи My Energy, все базовые сервисные идентификаторы, которые были авторизованы через раздел «Передача моих данных», будут несанкционированы.

• Для определения детализации авторизованных интервальных данных обратитесь к элементу «Длина интервала» в соответствии со стандартом ESPI.
• PG&E предоставляет данные об использовании за период с той же детализацией, что и для целей выставления счетов, что обычно происходит на почасовой или 15-минутной основе для электрических данных и ежедневно для данных о газе для клиентов с интервальными счетчиками. В то время как это может варьироваться в зависимости от клиента, использование счетчика электрических интервалов обычно доступно на почасовом уровне для большинства клиентов в жилых помещениях и на уровне 15-минутного интервала для большинства коммерческих клиентов, а использование счетчиков газов обычно доступно на ежедневном уровне для большинства клиентов.
• Для неинтервалных счетчиков данные будут предоставлены, когда они будут доступны.

• Для подавляющего большинства клиентов PG&E с установленным интеллектуальным счетчиком данные об использовании электрических и газовых интервалов доступны к концу следующего дня на платформе Share My Data.
• Небольшая часть потребителей электроэнергии PG&E с установленными счетчиками MV90 на основе операторской линии может потребовать дополнительного времени для получения данных.

• Хотя мы не можем напрямую поддерживать настройку ваших API, у нас есть ряд ресурсов, которые помогут вашим ИТ- и техническим ресурсам в процессе разработки. Для получения дополнительной информации посетите страницу Документация API. С любыми дополнительными вопросами обращайтесь по адресуShareMyData@pge.com.

Для получения дополнительной информации посетите программный интерфейс приложения (API)