Rest API в Power BI – информационная панель, встроенный токен, шлюзы, группа
1. Rest API в Power BI
В нашем прошлом посте мы обсуждали API-интерфейсы администратора Power BI. В этой части REST API в Power BI мы рассмотрим следующие 3 API: API информационной панели Power BI, API встроенного токена в Power BI, API шлюза в Power BI и API группы Power BI с их подкатегориями.
Итак, приступим к изучению Power BI REST API Tutorial.
Rest API в Power BI – информационная панель, встроенный токен, шлюзы, группа
2. Rest API в Power BI
Это группы API/операций Power BI REST:
- Операционная группа, описание
- Операции администрирования
- Операции доступных функций
- Операции с ресурсами
- Операции с информационными панелями
- Операции внедрения токенов
- Операции со шлюзами
- Групповые операции
- Операции импортирования
- Операции с push наборами данных
- Операции отчетности
- Операции с наборами данных
3. API информационных панелей Power BI
Это самый важный REST API в Power BI.
a. Включить информационную панель
Добавляет еще одну свободную информационную панель в «Мое рабочее пространство».
Требуемое расширение: Content.Create
b. Включить информационную панель в группу
Создает еще одну свободную информационную панель в заранее определенной рабочей области.
Требуемая степень: Content.Create
А вы знаете, как создать информационную панель Power BI?
c. Клонировать плитку
Клонирует заранее заданную плитку из «Моего рабочего пространства».
Если идентификатор объективного отчета и целевой набор данных не определены, может произойти следующее:
- В момент, когда клонирование плитки выполняется в аналогичной рабочей области, соединения отчета и набора данных будут клонированы из исходного фрагмента.
- При клонировании плитки в альтернативной рабочей области соединения отчетов и наборов данных будут обновлены.
Требуемое расширение: Dashboard.ReadWrite.All
d. Клонировать плитку в группе
Клонирует предопределенную плитку из предопределенной рабочей области.
В случае потери идентификатора отчета и целевого набора данных может произойти следующее:
- В момент, когда клонирование плитки выполняется внутри аналогичной рабочей области, соединения отчета и набора данных будут клонированы из исходной плитки.
- Если вы клонируете плитку в альтернативной рабочей области, соединения отчетов и наборов данных будут обновлены. Плитка будет сломана.
Требуемое расширение: Dashboard.ReadWrite.All
e. Получить информационную панель
Возвращает предопределенную информационную панель из «Моей рабочей области».
Требуемое расширение: Dashboard.ReadWrite.All или Dashboard.Read.All
f. Получить информационную панель в группе
Возвращает предопределенную информационную панель из предопределенной рабочей области.
Требуемая степень: Dashboard.ReadWrite.All или Dashboard.Read.All
g. Получить информационные панели
Возвращает краткое изложение информационных панелей из «Моей рабочей области».
Требуемое расширение: Dashboard.ReadWrite.All или Dashboard.Read.All
h. Получить информационные панели в группе
Возвращает краткое изложение информационных панелей из предопределенной рабочей области.
Требуемая степень: Dashboard.ReadWrite.All или Dashboard.Read.All
i. Получить плитку
Возвращает предопределенную плитку внутри предопределенной информационной панели из «Моей рабочей области».
Примечание. Поддерживаются все композиции плиток, за исключением тех, которые включают наборы данных, и живые плитки, содержащие всю страницу отчета.
Требуемое расширение: Dashboard.ReadWrite.All или Dashboard.Read.All
j. Получить плитку в группе
Возвращает предопределенную плитку внутри предопределенной информационной панели из предопределенной рабочей области.
Примечание. Все композиции плиток поддерживаются, за исключением плиток, которые включают наборы данных, и живые плитки, содержащие всю страницу отчета.
Требуемое расширение: Dashboard.ReadWrite.All или Dashboard.Read.All
k. Получить плитки
Возвращает краткое изложение плиток внутри предопределенной информационной панели из «Моей рабочей области».
Примечание. Все композиции плиток поддерживаются, за исключением плиток, которые включают наборы данных, и живых плиток, содержащих всю страницу отчета.
Требуемое расширение: Dashboard.ReadWrite.All или Dashboard.Read.All
l. Получить плитки в группе
Возвращает краткое изложение плиток внутри предопределенной информационной панели из предопределенной рабочей области.
Примечание. Поддерживаются все композиции плиток, за исключением плиток, которые включают наборы данных, и живые плитки, содержащие всю страницу отчета.
Требуемая степень: Dashboard.ReadWrite.All или Dashboard.Read.All
4. API встроенного токена в Power BI
REST API в Power BI – встроенный токен
a. Информационная панель GenerateToken
Эта команда доступна только в настройках рабочего пространства. Используйте панели мониторинга GenerateTokenInGroup.
b. Информационная панель GenerateTokenInGroup
Создает маркер имплантата для просмотра заранее определенной информационной панель из заранее определенной рабочей области.
Этот API-интерфейс Power BI Rest подходит только для ситуации установки «Информация о заявках приложений».
Требуемая степень: большинство нижестоящих
- Dashboard.ReadWrite.All или Dashboard.Read.All
- Report.ReadWrite.All или Report.Read.All
- Dataset.ReadWrite.All или Dataset.Read.All
c. Наборы данных GenerateTokenInGroup
Создает токен установки для вставки вопросов и ответов с учетом предварительно определенного набора данных из предварительно определенной рабочей области.
Этот REST API в Power BI подходит только для установки «Информации о заявках на приложения».
Требуемая степень: Dataset.ReadWrite.All или Dataset.Read.All
d. Отчеты GenerateToken
Эта функция доступна только в настройках рабочего пространства. Используйте отчеты GenerateTokenInGroup.
e. Отчеты GenerateTokenForCreate
Эта функция доступна только в настройках рабочего пространства. Используйте отчеты GenerateTokenForCreateInGroup.
f. Отчеты GenerateTokenForCreateInGroup
Создает маркер вставки, чтобы разрешить создание отчета в предварительно определенной рабочей области в свете предварительно определенного набора данных.
Этот REST API в Power BI применим только к ситуации установки «Приложение обладает информацией».
Обязательное расширение: большая часть
- Content.Create
- Report.ReadWrite.All или Report.Read.All
- Dataset.ReadWrite.All или Dataset.Read.All
Взгляните на сервер отчетов Power BI
g. Отчеты GenerateTokenInGroup
Создает маркер внедрения для просмотра или изменения предопределенного отчета из предопределенной рабочей области.
Этот API подходит только для ситуации вставки «Приложение обладает информацией».
Требуемая степень: большая часть
- Report.ReadWrite.All или Report.Read.All
- Dataset.ReadWrite.All или Dataset.Read.All
- Content.Create – требуется только в том случае, если параметр allowSaveAs указан в GenerateTokenRequest.
h. Плитки GenerateToken
Эта функция доступна только в настройках рабочего пространства. Используйте плитки GenerateTokenInGroup.
i. Плитки GenerateTokenInGroup
Создает маркер установки для просмотра заранее определенной плитки из заранее определенной рабочей области.
Этот REST API в Power BI важен только для имплантации «Приложение обладает информацией».
Требуемое расширение: большая часть
- Dashboard.ReadWrite.All или Dashboard.Read.All
- Report.ReadWrite.All или Report.Read.All
- Dataset.ReadWrite.All или Dataset.Read.All
Давайте обсудим работу с таблицей в информационных панелях и отчетах Power BI
5. API шлюзов Power BI
Rest API в Power BI – API шлюзов
а. Добавить пользователя источника данных
Предоставляет указанному пользователю разрешения, необходимые для использования указанного источника данных.
Требуемая область: Dataset.ReadWrite.All
б. Создать источник данных
На указанном шлюзе создайте новый источник данных
Требуемая область: Dataset.ReadWrite.All
А вы знаете, что такое Power BI Gateway?
c. Удалить источник данных
Удаляет указанный источник данных с указанного шлюза.
Требуемая область: Dataset.ReadWrite.All
d. Удалить пользователя источника данных
Удаляет указанного пользователя из указанного источника данных.
Требуемая область: Dataset.ReadWrite.All
е. Получить источник данных по идентификатору
Возвращает указанный источник данных из указанного шлюза.
Требуемая область: Dataset.ReadWrite.All или Dataset.Read.All
f. Получить источники данных
Возвращает список источников данных от указанного шлюза.
Требуемая область: Dataset.ReadWrite.All или Dataset.Read.All
g. Получить статус источника данных по идентификатору
Проверяет состояние подключения указанного источника данных от указанного шлюза.
Требуемая область: Dataset.ReadWrite.All
h. Получить пользователей источника данных
Возвращает список пользователей, у которых есть доступ к указанному источнику данных.
Требуемая область: Dataset.ReadWrite.All или Dataset.Read.All
Взгляните на условное форматирование Power BI
i. Получить шлюз по идентификатору
Возвращает указанный шлюз.
Требуемая область: Dataset.ReadWrite.All или Dataset.Read.All
j. Получить шлюзы
Возвращает список шлюзов, для которых пользователь является администратором.
Требуемая область: Dataset.ReadWrite.All или Dataset.Read.All
k. Обновить источник данных
Обновляет учетные данные указанного источника данных с указанного шлюза.
Чтобы получить идентификаторы шлюза и источника данных для набора данных, используйте «Получить источники данных» или «Получить источники данных в группе».
Требуемая область: Dataset.ReadWrite.All
6. Power BI Group API
Power BI REST API – API группы
а. Добавить пользователя группы
Предоставляет предопределенному клиенту соглашение с предопределенным рабочим пространством.
Примечание. Сохраняется только права администратора.
Требуемая степень: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
б. Создать группу
Создает новое рабочее пространство.
Требуемая степень: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
c. Удалить группу
Удаляет предопределенное рабочее пространство.
Требуемая степень: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
d. Удалить пользователя в группе
Удаляет определенные авторизации клиентов из определенной рабочей области.
Требуемая степень: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
е. Получить группы
Возвращает краткое содержание рабочих пространств, к которым обращается клиент.
Требуемое расширение: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
f. Получить пользователей группы
Возвращает список клиентов, имеющих доступ к определенной рабочей области.
Требуемое расширение: Group.Read.All или Group.ReadWrite.All или Workspace.Read.All или Workspace.ReadWrite.All
Перейдите по этой ссылке, чтобы узнать о портале администрирования Power BI.
Итак, это все о REST API в Power BI. Надеемся, вам понравилось наше объяснение.
7. Заключение
Таким образом, мы обсудили четыре REST API в Power BI: API информаицонной панели Power BI, API встроенного токена в Power BI, API шлюза в Power BI и API группы в Power BI с их подкатегориями. Следите за обновлениями последней части API.