Udostępnij przez

Dynamics 365 Customer Insights (wersja zapoznawcza)

Łącznik Usługi Dynamics 365 Customer Insights udostępnia zestaw interfejsów API do interakcji z wystąpieniami usługi Dynamics 365 Customer Insights.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft

Aby zarejestrować się w usłudze Dynamics 365 Customer Insights, kliknij tutaj.

Aby użyć tego łącznika w usłudze Power Apps, dowiedz się więcej tutaj.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizuj element (wersja zapoznawcza)

Ta operacja aktualizuje element w jednostce
Pobieranie danych z partycji (wersja zapoznawcza)

Pobieranie danych z partycji.
Pobieranie elementu

Ta operacja pobiera element z jednostki
Pobieranie elementów z jednostki

Ta operacja pobiera elementy z jednostki. W zależności od jednostki pola można zdefiniować jako filtry:

  • Jednostka UnifiedActivity: pola ActivityId i CustomerId
  • Jednostka klienta: pole CustomerId i wszystkie inne pola indeksowane w wystąpieniu usługi Customer Insights
  • Wszystkie inne jednostki: pole CustomerId.
Pobieranie jednostek

Ta operacja pobiera jednostki z wystąpienia
Pobieranie partycji dla jednostki (wersja zapoznawcza)

Pobieranie partycji dla jednostki.
Pobieranie partycji dla jednostki w wersji 2 (wersja zapoznawcza)

Pobieranie partycji dla jednostki w wersji 2.
Tworzenie elementu (wersja zapoznawcza)

Ta operacja tworzy element w jednostce
Wysyła raport o stanie

Wysyła raport o stanie.
Wysyła raport o stanie w wersji 2

Wysyła raport o stanie w wersji 2.

Aktualizuj element (wersja zapoznawcza)

Identyfikator operacji:
PatchItem

Ta operacja aktualizuje element w jednostce

Parametry

Nazwa Klucz Wymagane Typ Opis
instanceId
 dataset True string

Identyfikator wystąpienia
entityName
 table True string

Nazwa jednostki
itemIdentifier
 id True string

Identyfikator elementu
recordItem
 item True dynamic

Rekord do aktualizacji

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie danych z partycji (wersja zapoznawcza)

Identyfikator operacji:
GetPartitionData

Pobieranie danych z partycji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zestaw danych usługi Customer Insights
 dataset True string

Zestaw danych usługi Customer Insights.
Jednostka
 table True string

Jednostka.
Odwołanie (identyfikator URI lub nazwa) partycji
 partitionUri True string

Odwołanie (identyfikator URI lub nazwa) partycji.
Rozdzielona przecinkami linia kolumn
 select string

Rozdzielona przecinkami linia kolumn.
Położenie od miejsca do rozpoczęcia czytania w bajtach
 offsetStart integer

Położenie od miejsca do rozpoczęcia czytania w bajtach.
Maksymalna liczba bajtów do odczytania
 maxSize integer

Maksymalna liczba bajtów do odczytania.
Maksymalna liczba rekordów do zwrócenia
 maxResults integer

Maksymalna liczba rekordów do zwrócenia.

Zwraca

Dane z partycji.

Body
PartitionDataResponse

Pobieranie elementu

Identyfikator operacji:
GetItem

Ta operacja pobiera element z jednostki

Parametry

Nazwa Klucz Wymagane Typ Opis
instanceId
 dataset True string

Identyfikator wystąpienia
entityName
 table True string

Nazwa jednostki
itemIdentifier
 id True string

Identyfikator elementu

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie elementów z jednostki

Identyfikator operacji:
GetItems

Ta operacja pobiera elementy z jednostki. W zależności od jednostki pola można zdefiniować jako filtry:

  • Jednostka UnifiedActivity: pola ActivityId i CustomerId
  • Jednostka klienta: pole CustomerId i wszystkie inne pola indeksowane w wystąpieniu usługi Customer Insights
  • Wszystkie inne jednostki: pole CustomerId.

Parametry

Nazwa Klucz Wymagane Typ Opis
instanceId
 dataset True string

Identyfikator wystąpienia
entityName
 table True string

Nazwa jednostki
Filtruj zapytanie
 $filter string

Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Liczba pierwszych
 $top integer

Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Wybieranie zapytania
 $select string

Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie jednostek

Identyfikator operacji:
GetTables

Ta operacja pobiera jednostki z wystąpienia

Parametry

Nazwa Klucz Wymagane Typ Opis
instanceId
 dataset True string

Identyfikator wystąpienia

Zwraca

Reprezentuje listę tabel.

Body
TablesList

Pobieranie partycji dla jednostki (wersja zapoznawcza)

Identyfikator operacji:
GetPartitions

Pobieranie partycji dla jednostki.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zestaw danych usługi Customer Insights
 dataset True string

Zestaw danych usługi Customer Insights.
Jednostka
 table True string

Jednostka.

Zwraca

response
array of Table

Pobieranie partycji dla jednostki w wersji 2 (wersja zapoznawcza)

Identyfikator operacji:
GetPartitionsV2

Pobieranie partycji dla jednostki w wersji 2.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zestaw danych usługi Customer Insights
 dataset True string

Zestaw danych usługi Customer Insights.
Jednostka
 table True string

Jednostka.
Wartość partitionDisplayName do filtrowania dla
 partitionDisplayName string

Wartość partitionDisplayName do filtrowania.

Zwraca

Lista partycji

Body
PartitionListResponse

Tworzenie elementu (wersja zapoznawcza)

Identyfikator operacji:
PostItem

Ta operacja tworzy element w jednostce

Parametry

Nazwa Klucz Wymagane Typ Opis
instanceId
 dataset True string

Identyfikator wystąpienia
entityName
 table True string

Nazwa jednostki
recordItem
 item True dynamic

Rekord do utworzenia

Wysyła raport o stanie

Identyfikator operacji:
SendStatusReport

Wysyła raport o stanie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wystąpienia
 dataset True string

Wybierz wystąpienie.
Typ raportu
 reportType True string

Wybierz typ raportu.

Wysyła raport o stanie w wersji 2

Identyfikator operacji:
SendStatusReportV2

Wysyła raport o stanie w wersji 2.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wystąpienia
 dataset True string

Wybierz wystąpienie.
Typ raportu
 reportType True string

Wybierz typ raportu.

Wyzwalacze

Wyzwala przepływ po przekroczeniu progu miary biznesowej

Ta operacja wyzwala przepływ po przekroczeniu progu miary biznesowej w usłudze Dynamics 365 Customer Insights.
Wyzwala przepływ po przekroczeniu progu segmentu

Ta operacja wyzwala przepływ po przekroczeniu progu segmentu w usłudze Dynamics 365 Customer Insights.
Wyzwala przepływ po zakończeniu pełnego odświeżania usługi Customer Insights

Ta operacja wyzwala przepływ po zakończeniu pełnego odświeżania usługi Customer Insights (źródeł danych, segmentów, miar,...).
Wyzwala przepływ po zakończeniu procesu w usłudze Customer Insights

Przepływ jest wyzwalany dla zaplanowanych odświeżeń wybranego procesu. Ponadto możesz wyzwolić przepływ na potrzeby odświeżania ręcznego.
Wyzwala przepływ ze źródła danych po zakończeniu odświeżania

Ta operacja wyzwala przepływ ze źródła danych po zakończeniu odświeżania w usłudze Dynamics 365 Customer Insights.
Wyzwala przepływ ze źródła danych w przypadku niepowodzenia odświeżania

Ta operacja wyzwala przepływ ze źródła danych, gdy odświeżanie nie powiodło się w usłudze Dynamics 365 Customer Insights.

Wyzwala przepływ po przekroczeniu progu miary biznesowej

Identyfikator operacji:
GetOnBusinessMeasureUpdated

Ta operacja wyzwala przepływ po przekroczeniu progu miary biznesowej w usłudze Dynamics 365 Customer Insights.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa wystąpienia
 dataset True string

Wybierz wystąpienie.
Nazwa miary biznesowej
 measure True string

Wybierz miarę.
Próg
 threshold True double

Ustaw dowolną liczbę jako wartość progową.

Zwraca

Dane miary biznesowej

Body
MeasureData

Wyzwala przepływ po przekroczeniu progu segmentu

Identyfikator operacji:
GetOnSegmentUpdated

Ta operacja wyzwala przepływ po przekroczeniu progu segmentu w usłudze Dynamics 365 Customer Insights.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa wystąpienia
 dataset True string

Wybierz wystąpienie.
Nazwa segmentu
 segment True string

Wybierz segment.
Próg
 threshold True integer

Ustaw dowolną liczbę jako wartość progową.

Zwraca

Dane segmentu

Body
SegmentData

Wyzwala przepływ po zakończeniu pełnego odświeżania usługi Customer Insights

Identyfikator operacji:
GetOnFullDagRefreshCompleted

Ta operacja wyzwala przepływ po zakończeniu pełnego odświeżania usługi Customer Insights (źródeł danych, segmentów, miar,...).

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa wystąpienia
 dataset True string

Wybierz wystąpienie.

Zwraca

Informacje o wykonanym pełnym odświeżeniu

Body
FullRefreshProcessData

Wyzwala przepływ po zakończeniu procesu w usłudze Customer Insights

Identyfikator operacji:
GetOnProcessCompleted

Przepływ jest wyzwalany dla zaplanowanych odświeżeń wybranego procesu. Ponadto możesz wyzwolić przepływ na potrzeby odświeżania ręcznego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa wystąpienia
 dataset True string

Wybierz wystąpienie.
Proces
 process string

Wybierz proces.
Uwzględnij proces wyzwalany ręcznie
 includingManualRefreshes boolean

Wybierz pozycję Tak, jeśli powinien zostać uwzględniony proces wyzwalany ręcznie.

Zwraca

Informacje o wykonanym procesie

Body
ProcessData

Wyzwala przepływ ze źródła danych po zakończeniu odświeżania

Identyfikator operacji:
GetOnDataSourceRefreshComplete

Ta operacja wyzwala przepływ ze źródła danych po zakończeniu odświeżania w usłudze Dynamics 365 Customer Insights.

Parametry

Nazwa Klucz Wymagane Typ Opis
Środowisko
 dataset True string

nazwa zestawu danych.

Zwraca

DataSourcesList

Body
DataSourcesList

Wyzwala przepływ ze źródła danych w przypadku niepowodzenia odświeżania

Identyfikator operacji:
GetOnDataSourceRefreshFail

Ta operacja wyzwala przepływ ze źródła danych, gdy odświeżanie nie powiodło się w usłudze Dynamics 365 Customer Insights.

Parametry

Nazwa Klucz Wymagane Typ Opis
Środowisko
 dataset True string

nazwa zestawu danych.

Zwraca

DataSourcesList

Body
DataSourcesList

Definicje

DataSourcesList

DataSourcesList

Nazwa Ścieżka Typ Opis
value
 value array of DataSource

Lista źródeł danych

Źródło danych

DataSource, klasa

Nazwa Ścieżka Typ Opis
RefreshType
 RefreshType string

Typ odświeżania danych
RefreshObjectId
 RefreshObjectId string

Identyfikator obiektu odświeżania
RefreshObjectVersion
 RefreshObjectVersion integer

Wersja obiektu odświeżania
Operation
 Operation string

Nazwa operacji
Typ zadania
 JobType string

Typ zadania
ErrorCode
 ErrorCode string

Kod błędu podczas odświeżania danych.
Komunikat o błędzie
 ErrorMessage string

Komunikat o błędzie podczas odświeżania
ErrorSeverity (Zależnie od błędów)
 ErrorSeverity string

Serwerowość błędów podczas odświeżania
StartTimeUtc
 StartTimeUtc string

Godzina rozpoczęcia odświeżania danych
EndTimeUtc
 EndTimeUtc string

Godzina zakończenia odświeżania danych

SegmentData

Dane segmentu

Nazwa Ścieżka Typ Opis
Name
 Name string

Nazwa segmentu
Nazwa wyświetlana
 DisplayName string

Nazwa wyświetlana segmentu
Dane ewaluacyjne
 EvaluationDate date-time

Data oceny segmentu
EntityCount
 EntityCount integer

Rzeczywista liczba elementów członkowskich segmentu
Próg
 Threshold integer

Próg segmentu

MeasureData

Dane miary biznesowej

Nazwa Ścieżka Typ Opis
Name
 Name string

Nazwa miary
Nazwa wyświetlana
 DisplayName string

Nazwa wyświetlana miary
Dane ewaluacyjne
 EvaluationDate date-time

Data oceny miary
Wartość
 Value double

Wartość miary
ValueDisplayName
 ValueDisplayName string

Nazwa wyświetlana wartości
Próg
 Threshold double

Próg miary

FullRefreshProcessData

Informacje o wykonanym pełnym odświeżeniu

Nazwa Ścieżka Typ Opis
NumberOfFailedTasks
 NumberOfFailedTasks integer

Liczba zadań zakończonych niepowodzeniem
StartTime
 StartTime date-time

Godzina rozpoczęcia kroku przepływu pracy
EndTime
 EndTime date-time

Godzina zakończenia kroku przepływu pracy
Czas trwania
 Duration integer

Czas trwania procesu w minutach
Status
 Status string

Stan kroku przepływu pracy
StatusPage
 StatusPage string

Link do strony stanu

ProcessData

Informacje o wykonanym procesie

Nazwa Ścieżka Typ Opis
StartTime
 StartTime date-time

Godzina rozpoczęcia kroku przepływu pracy
EndTime
 EndTime date-time

Godzina zakończenia kroku przepływu pracy
Czas trwania
 Duration integer

Czas trwania procesu w minutach
Status
 Status string

Stan kroku przepływu pracy
StatusPage
 StatusPage string

Link do strony stanu

Tabela

Reprezentuje tabelę.

Nazwa Ścieżka Typ Opis
Name
 Name string

Nazwa tabeli. Nazwa jest używana w czasie wykonywania.
Nazwa wyświetlana
 DisplayName string

Nazwa wyświetlana tabeli.
Właściwości dynamiczne
 DynamicProperties object

Dodatkowe właściwości tabeli udostępniane przez łącznik klientom.

PartitionListResponse

Lista partycji

Nazwa Ścieżka Typ Opis
Header
 Header string

Nagłówek zawierający atrybuty jednostki
Partitions
 Partitions array of Table

Lista partycji

PartitionDataResponse

Dane z partycji.

Nazwa Ścieżka Typ Opis
PrzesunięcieStart
 OffsetStart integer

Przesunięcie początkowe.
OffsetEnd
 OffsetEnd integer

Przesunięcie końcowe.
Rozmiar
 Size integer

Liczba zwracanych danych.
Przedmioty
 Items array of object

Słownik zawierający dane o maksymalnym rozmiarze elementów z partycji z przesunięcia "OffsetStart" do "OffsetEnd".
items
 Items object

TablesList

Reprezentuje listę tabel.

Nazwa Ścieżka Typ Opis
value
 value array of Table

Lista tabel