Interfejs API łączenia

Wprowadzenie

Linking API to niezawodny interfejs do konfigurowania i przekierowywania użytkowników bezpośrednio do raportu Looker Studio za pomocą adresu URL. Gdy użytkownicy klikną adres URL interfejsu Linking API, będą mogli szybko wyświetlać swoje dane i z nich korzystać.

W tym dokumencie opisujemy wymagany format adresów URL interfejsu Linking API i dostępne parametry.

Przypadek użycia i korzyści

Interfejs Linking API umożliwia udostępnianie klientom wstępnie skonfigurowanych raportów, w których mogą oni wyświetlać swoje dane i wchodzić z nimi w interakcje. Najważniejsze zalety interfejsu Linking API:

Tworzenie raportów jednym kliknięciem dla Twoich klientów.
- Konfiguracja danych jest podana w adresie URL, więc użytkownicy nie muszą konfigurować raportu pod kątem swoich danych.
- Użytkownicy mogą zapisać raport jednym kliknięciem i w dowolnym momencie do niego wrócić.
Tworzenie raportów na dużą skalę Interfejs Linking API skraca czas potrzebny na duplikowanie lub tworzenie nowych raportów.
Włącz integracje usług. Stabilny interfejs umożliwia zintegrowanie Looker Studio z przepływem pracy produktu.

Jak to działa

Poniżej opisujemy, jak deweloperzy i użytkownicy korzystają z interfejsu Linking API.

Proces programisty interfejsu Linking API

Deweloper przygotowuje raporty szablonu, źródła danych i formatuje adres URL interfejsu Linking API. Typowy proces pracy deweloperów wygląda tak:

Zdecyduj, czy chcesz użyć pustego raportu, domyślnego szablonu raportu udostępnionego przez Looker Studio, czy utworzyć raport Looker Studio, który będzie służyć jako szablon. Obejmuje to konfigurowanie źródeł danych szablonu.
Sformatuj adres URL interfejsu Linking API pod kątem konkretnego przypadku użycia. W razie potrzeby określ szablon raportu i inne parametry, w tym nazwę raportu, nazwę źródła danych i konfiguracje źródła danych.
Użyj adresu URL interfejsu Linking API, aby kierować użytkowników do raportu.

Wrażenia użytkowników interfejsu Linking API

Użytkownik klika adres URL interfejsu Linking API, który, jeśli został prawidłowo skonfigurowany przez dewelopera, przekierowuje go do raportu Looker Studio, w którym może wyświetlać dane, do których ma dostęp, i z nimi wchodzić w interakcję. Typowe wrażenia użytkownika mogą wyglądać tak:

W przeglądarce użytkownik odwiedza usługę zintegrowaną z interfejsem Linking API.
Wezwanie do działania zachęca użytkownika do kliknięcia linku, aby wyświetlić dane w Looker Studio.
Użytkownik klika link i jest przekierowywany do raportu Looker Studio. Raport się wczyta, a użytkownik będzie mógł wyświetlać dane i z nich korzystać.
Użytkownik klika „Edytuj i udostępnij”. Raport zostaje zapisany na jego koncie Looker Studio.
Użytkownik ma teraz pełny dostęp do własnej kopii raportu i pełną kontrolę nad nią. Mogą je w każdej chwili wyświetlać, edytować i udostępniać.

Wymagania

Aby mieć pewność, że adres URL interfejsu Linking API działa prawidłowo, musisz:

Raport, który będzie służyć jako szablon. Jeśli nie podasz raportu, możesz użyć pustego lub domyślnego raportu udostępnianego przez Looker Studio.
Użytkownicy adresu URL interfejsu Linking API muszą mieć co najmniej uprawnienia do wyświetlania raportu szablonu. W zależności od typów źródeł danych użytych w raporcie i konfiguracji podanej za pomocą interfejsu Linking API użytkownicy mogą też potrzebować dostępu do wyświetlania źródeł danych. Więcej informacji znajdziesz w sekcji Uprawnienia do szablonu.
Typ łącznika każdego źródła danych musi obsługiwać konfigurację za pomocą interfejsu Linking API. Listę obsługiwanych złączy znajdziesz w dokumentacji złączy.
Użytkownicy adresu URL interfejsu Linking API muszą mieć dostęp do danych skonfigurowanych w tym adresie. Jeśli użytkownik nie ma dostępu do danych źródłowych, wszystkie zależne komponenty raportu będą wyświetlać błąd.

Parametry adresu URL

Adres URL interfejsu Linking API musi mieć format:

https://lookerstudio.google.com/reporting/create?parameters

Adres URL powinien być używany w kontekście przeglądarki internetowej, zwykle przez użytkownika, który klika link lub jest przekierowywany na ten adres. Możesz też za jej pomocą osadzić raport.

Przykładowy URL

Oto przykładowy adres URL interfejsu Linking API. Nazwa raportu jest ustawiona i skonfigurowane jest pojedyncze źródło danych BigQuery:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.connector=bigQuery
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

Niektóre parametry adresu URL są wymagane, a inne – opcjonalne. Poniżej znajdziesz listę parametrów używanych do definiowania adresu URL interfejsu Linking API:

Parametry sterowania

Parametry sterujące określają stan raportu wyświetlanego za pomocą adresu URL interfejsu Linking API.

Nazwa parametru	Opis
`c.reportId`	Opcjonalnie. Identyfikator raportu szablonu. Otworzy się narzędzie Looker Studio, które skonfiguruje wskazany raport. Szczegółowe informacje o tym, jak znaleźć identyfikator, znajdziesz w sekcji Identyfikator zgłoszenia. Jeśli nie zostanie określony, używany będzie pusty raport lub domyślny szablon raportu. Więcej informacji znajdziesz w artykule Używanie pustego lub domyślnego raportu.
`c.pageId`	Opcjonalnie. Identyfikator strony początkowej, która ma być wczytana w raporcie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość pierwszej strony raportu.
`c.mode`	Opcjonalnie. Początkowy tryb raportowania. Jeden z tych elementów: `view` lub `edit`. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `view`.
`c.explain`	Opcjonalnie. Widoczność okna informacji/debugowania. Ustaw wartość `true`, aby wyświetlić przycisk okna. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Więcej informacji znajdziesz w sekcji Rozwiązywanie problemów z konfiguracją.

Przykład

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &c.pageId=g7u8s9
  &c.mode=edit
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

Parametry raportu

Parametry raportu zastępują właściwości raportu.

Nazwa parametru Opis

Nazwa parametru	Opis
`r.reportName`	Opcjonalnie. Ustawia nazwę raportu. Jeśli nie podasz tu żadnej wartości, zostanie użyta domyślna nazwa raportu szablonu.
`r.measurementId`	Opcjonalnie. Ustawia identyfikatory pomiaru Google Analytics na Mierz użycie raportu. Poszczególne identyfikatory oddziel przecinkami. Jeśli wartości `r.measurementId` i `r.keepMeasurementId` nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics przyjmuje domyślnie wartość „nieokreślone”. Jeśli ustawione są parametry `r.measurementId` i `r.keepMeasurementId`, pierwszeństwo ma parametr `r.keepMeasurementId`.
`r.keepMeasurementId`	Opcjonalnie. Ustaw na `true`, aby używać raportu szablonu Identyfikatory pomiaru Google Analytics. Jeśli nie zostanie podana, domyślna wartość to `false`. Jeśli wartości `r.measurementId` i `r.keepMeasurementId` nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics przyjmuje domyślnie wartość „nieokreślone”. Jeśli ustawione są parametry `r.measurementId` i `r.keepMeasurementId`, pierwszeństwo przy ustawianiu identyfikatora ma parametr `r.keepMeasurementId`.

r.reportName

Opcjonalnie. Ustawia nazwę raportu. Jeśli nie podasz tu żadnej wartości, zostanie użyta domyślna nazwa raportu szablonu.

r.measurementId

Opcjonalnie. Ustawia identyfikatory pomiaru Google Analytics na Mierz użycie raportu. Poszczególne identyfikatory oddziel przecinkami.

Jeśli wartości r.measurementId i r.keepMeasurementId nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics przyjmuje domyślnie wartość „nieokreślone”. Jeśli ustawione są parametry r.measurementId i r.keepMeasurementId, pierwszeństwo ma parametr r.keepMeasurementId.

r.keepMeasurementId

Opcjonalnie. Ustaw na true, aby używać raportu szablonu Identyfikatory pomiaru Google Analytics. Jeśli nie zostanie podana, domyślna wartość to false.

Przykład

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &r.measurementId=G-XXXXXXXXXX
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

Parametry źródła danych

Parametry źródła danych umożliwiają zdefiniowanie konfiguracji źródła danych i danych, do których ma ono mieć dostęp w raporcie szablonu.

alias służy do odwoływania się do źródła danych w istniejącym raporcie. Użycie aliasu zapewnia zgodność wsteczną, jeśli źródło danych zostanie dodane do raportu szablonu lub z niego usunięte.

Szczegółowe informacje o tym, jak znaleźć źródło danych alias, znajdziesz w artykule Alias źródła danych.

Parametry źródła danych

Te parametry są wspólne dla wszystkich typów łączników:

Nazwa	Opis
`ds.alias.datasourceName`	Opcjonalnie. Ustawia nazwę źródła danych. Jeśli nie podasz wartości `ds.datasourceName` i `ds.keepDatasourceName`, nazwa źródła danych będzie domyślnie zgodna z konwencją nazewnictwa, która obejmuje typ oprogramowania sprzęgającego i czas utworzenia (np. przykłady – 12.12.21, 22:53). Jeśli ustawione są parametry `ds.datasourceName` i `ds.keepDatasourceName`, parametr `ds.datasourceName` ma pierwszeństwo przy ustawianiu nazwy źródła danych.
`ds.alias.keepDatasourceName`	Opcjonalnie. Ustaw wartość `true`, aby użyć nazwy źródła danych szablonu. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Jeśli nie podasz wartości `ds.datasourceName` i `ds.keepDatasourceName`, nazwa źródła danych będzie domyślnie zgodna z konwencją nazewnictwa, która obejmuje typ oprogramowania sprzęgającego i czas utworzenia (np. przykłady – 12.12.21, 22:53). Jeśli ustawione są parametry `ds.datasourceName` i `ds.keepDatasourceName`, parametr `ds.datasourceName` ma pierwszeństwo przy ustawianiu nazwy źródła danych.
`ds.alias.connector`	Opcjonalnie. Typ oprogramowania sprzęgającego źródła danych. Więcej informacji o obsługiwanych typach oprogramowania sprzęgającego znajdziesz w dokumentacji oprogramowania sprzęgającego. Jeśli to ustawienie jest włączone, w adresie URL interfejsu Linking API muszą być określone wszystkie wymagane parametry łącznika dla danego typu łącznika, a konfiguracja źródła danych szablonu zostanie w całości zastąpiona. Jeśli nie jest określony, w adresie URL interfejsu Linking API można podać co najmniej 1 parametr łącznika dla danego typu łącznika. Konfiguracja źródła danych szablonu będzie używana do określania parametrów, które nie zostały podane w adresie URL interfejsu Linking API. Szczegółowe informacje o tym, jak określić typ oprogramowania sprzęgającego źródła danych szablonu, znajdziesz w sekcji Typ oprogramowania sprzęgającego. Aby dowiedzieć się więcej o tym, jak parametr `ds.connector` wpływa na to, czy konfiguracja źródła danych szablonu jest w całości zastępowana, czy używana do aktualizowania nieokreślonych parametrów, zapoznaj się z sekcją Zastępowanie a aktualizowanie.
`ds.alias.refreshFields`	Opcjonalnie. Ustaw na `true`, aby używać konfiguracji źródła danych określonej za pomocą interfejsu Linking API do odświeżania pól źródła danych i aktualizowania komponentów raportu za pomocą nowych wyborów pól. `true` jest zwykle określany podczas przełączania typu łącznika lub w przypadku typów łączników, w których zmiana konfiguracji powoduje pojawienie się innych pól (np. pola źródeł danych BigQuery często zmieniają się w zależności od konfiguracji tabeli). Ustaw wartość `false`, aby pozostawić pola źródła danych bez zmian w stosunku do raportu z szablonu. `false` jest zwykle określane, gdy nowa konfiguracja danych daje dokładnie te same pola i chcesz zachować wszelkie zmiany pól wprowadzone w źródle danych szablonu. Jeśli nie podasz tu żadnej wartości, zostaną użyte wartości domyślne, które różnią się w zależności od typu łącznika. Zapoznaj się z dokumentacją oprogramowania sprzęgającego, aby poznać domyślne ustawienia poszczególnych oprogramowań sprzęgających, jeśli chcesz zastąpić domyślne działanie. O czym warto pamiętać podczas korzystania z `refreshFields`: Jeśli parametr `refreshFields` ma wartość `false`, a konfiguracja źródła danych określona za pomocą interfejsu Linking API zwraca inne pola niż te używane w raporcie z szablonu, użytkownik prawdopodobnie zobaczy błąd konfiguracji w przypadku odpowiednich komponentów. Zmiany w polach w źródle danych szablonu (np. nazwa, typ, agregacja itp.) nie są przenoszone do nowych źródeł danych, gdy parametr `refreshFields` ma wartość `true`. Ustaw wartość `refreshFields` na `false`, aby zachować konfiguracje pól ze źródła danych szablonu. Pola obliczeniowe i parametry zdefiniowane w szablonowych źródłach danych będą zawsze kopiowane do nowo utworzonych źródeł danych i nie mają na nie wpływu wartości parametru `refreshFields`.
`ds.alias.connectorParameters`	Wymagany. Konfiguracja źródła danych dla typu oprogramowania sprzęgającego. Szczegółowe informacje o tym, jak rozpoznać oprogramowanie sprzęgające użyte do utworzenia źródła danych, znajdziesz w sekcji Typ oprogramowania sprzęgającego. Szczegółowe informacje o parametrach źródła danych dostępnych w przypadku każdego typu łącznika znajdziesz w dokumentacji łączników.

Zastępowanie a aktualizowanie – konfiguracje źródeł danych

Podczas ustawiania parametrów źródła danych obecność lub brak parametru ds.connector w adresie URL interfejsu Linking API wskazuje odpowiednio zamiar zastąpienia lub zaktualizowania konfiguracji źródła danych szablonu.

W tabeli poniżej znajdziesz informacje o tym, jak parametr ds.connector wpływa na to, czy konfiguracja źródła danych szablonu jest w całości zastępowana, czy używana do aktualizowania nieokreślonych parametrów:

Czy wartość `ds.connector` jest ustawiona?	Oczekiwana konfiguracja i działanie	Typowe zastosowanie
Tak	Zastąp Konfiguracja źródła danych szablonu jest w całości zastępowana parametrami źródła danych określonymi w adresie URL interfejsu Linking API. Musisz określić wszystkie wymagane parametry typu oprogramowania sprzęgającego. Zobacz Wymagane parametry, gdy ustawiony jest parametr `ds.connector`.	Podczas zmiany typu oprogramowania sprzęgającego źródła danych. Na przykład jeśli w raporcie szablonu skonfigurowano źródło danych BigQuery, ale chcesz skonfigurować źródło danych Arkuszy za pomocą interfejsu Linking API. Wymaga to zdefiniowania w całości nowej konfiguracji oprogramowania sprzęgającego. Gdy chcesz zagwarantować konfigurację źródła danych. Zastąpienie konfiguracji zapobiega używaniu nieznanych wartości z źródła danych szablonu.
Nie	Aktualizacja Konfiguracja źródła danych szablonu będzie używana do określania parametrów, które nie zostały podane w adresie URL interfejsu Linking API. Wszystkie parametry łącznika dla danego typu łącznika są opcjonalne, o ile nie podano inaczej. Upraszcza to adres URL interfejsu Linking API i jest ogólnie zalecane, gdy znasz konfigurację źródła danych szablonu i chcesz zastąpić tylko podzbiór parametrów.	Gdy chcesz podać tylko wartości parametrów, które różnią się od źródła danych szablonu, i nie masz nic przeciwko korzystaniu ze źródła danych szablonu w przypadku nieokreślonych parametrów łącznika. Np. zmień tylko identyfikator projektu rozliczeniowego konfiguracji źródła danych BigQuery i użyj konfiguracji szablonu dla wszystkich pozostałych parametrów.

Wymagane parametry, gdy ustawiony jest parametr `ds.connector`

Jeśli parametr ds.connector źródła danych jest określony, wszystkie parametry łącznika oznaczone jako Wymagane muszą być określone dla źródła danych. Jeśli parametr ds.connector źródła danych nie jest określony, wszystkie parametry oprogramowania sprzęgającego, nawet te oznaczone jako wymagane, mogą być traktowane jako opcjonalne, chyba że podano inaczej.

Przykłady

Konfiguruje raport z 1 źródłem danych BigQuery (ds0) i całkowicie zastępuje konfigurację źródła danych:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare

Alias źródła danych można pominąć, gdy raport ma tylko 1 źródło danych. Powyższy adres URL można uprościć do postaci:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.datasourceName=MyNewDataSource
  &ds.connector=bigQuery
  &ds.type=TABLE
  &ds.projectId=bigquery-public-data
  &ds.datasetId=samples
  &ds.tableId=shakespeare

Konfiguruje raport z jednym źródłem danych BigQuery (ds0) i aktualizuje tylko identyfikator projektu rozliczeniowego źródła danych:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

Konfiguruje raport z 2 źródłami danych: źródłem danych BigQuery (ds0) i źródłem danych Google Analytics (ds1). Konfiguracja źródła danych BigQuery jest w całości zastępowana, a konfiguracja Google Analytics aktualizuje jeden parametr i w przypadku nieokreślonych parametrów łącznika korzysta ze źródła danych szablonu ds1:

https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &r.reportName=MyNewReportWithMultipleDataSources
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds1.viewId=92320289

Tworzenie a dodawanie

Czasami przydatne jest używanie tego samego źródła danych w wielu raportach, aby aktualizacje źródła danych wpływały na wszystkie raporty jednocześnie. Podczas tworzenia raportu za pomocą interfejsu Linking API możesz ponownie dodać źródło danych z raportu szablonu, jeśli spełnione są wszystkie te warunki:

Źródło danych jest przeznaczone do wielokrotnego użytku (więcej informacji znajdziesz w artykule Źródła danych osadzone i przeznaczone do wielokrotnego użytku).
Adres URL nie odwołuje się do źródła danych za pomocą aliasu
Adres URL nie używa aliasu z symbolem wieloznacznym (patrz Alias źródła danych z symbolem wieloznacznym).

Gdy nowe źródło danych jest tworzone za pomocą interfejsu Linking API, używa danych logowania użytkownika, który kliknął adres URL. Oznacza to, że użytkownik musi mieć dostęp do danych źródłowych, w przeciwnym razie połączenie nie będzie działać. Ponowne dodanie źródła danych do nowo wygenerowanego raportu pozwala zachować jego dane logowania, dzięki czemu użytkownicy mogą nadal uzyskiwać dostęp do danych w nowych raportach.

Symbol wieloznaczny aliasu źródła danych

Aby zastosować parametr interfejsu Linking API do wielu źródeł danych, zamiast aliasu źródła danych można użyć aliasu z symbolem wieloznacznym ds.*.

Może to być przydatne do usuwania powtarzających się parametrów z adresu URL. Jeśli na przykład masz szablon z 3 źródłami danych BigQuery i chcesz zastąpić w każdym z nich znaki projectId i datasetId, ale zachować znak tableId, możesz to zapisać w ten sposób:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.ds1.projectId=client-project
  &ds.ds1.datasetId=client-dataset
  &ds.ds2.projectId=client-project
  &ds.ds2.datasetId=client-dataset
  &ds.ds3.projectId=client-project
  &ds.ds3.datasetId=client-dataset

Możesz też użyć tego równoważnego adresu URL z symbolem wieloznacznym ds.*:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

Parametry przekazywane do interfejsu Linking API, które nie używają symbolu wieloznacznego ds.*, mają wyższy priorytet niż te, które go używają. W powyższym przykładzie możesz dodać konkretny alias źródła danych, aby zastąpić wartość z symbolu wieloznacznego.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset
  &ds.ds1.datasetId=client-dataset

Ogólnie kolejność pierwszeństwa parametrów jest następująca:

Parametr podany z określonym aliasem (ds.ds1.datasetId)
parametr podany z użyciem symbolu wieloznacznego (ds.*.datasetId);
Wartość pochodząca ze źródła danych szablonu, jeśli nie podano ds.connector (patrz Zastępowanie a aktualizowanie).
Wartość domyślna parametru, jeśli jest on opcjonalny.

Odniesienie do oprogramowania sprzęgającego

Interfejs Linking API obsługuje te oprogramowania sprzęgające i konfiguracje. W przypadku każdego konektora podana jest lista dostępnych parametrów źródła danych.

BigQuery

Złącze BigQuery obsługuje 2 typy zapytań: TABLE, w którym podajesz identyfikator tabeli, do której chcesz wysłać zapytanie, oraz CUSTOM_QUERY, w którym podajesz instrukcję SQL, aby wysłać zapytanie do tabeli.

Zapytania do tabeli

Poniższe parametry mają zastosowanie, gdy parametr type ma wartość TABLE i podasz identyfikator tabeli, z której chcesz wysłać zapytanie.

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `bigQuery` dla oprogramowania sprzęgającego BigQuery. Jeśli ta opcja jest ustawiona, zastępuje źródło danych podaną konfiguracją BigQuery. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.type`	Wymagany** – typ zapytania. Ustaw na `TABLE`.
`ds.alias.projectId`	Wymagany** Identyfikator projektu tabeli, z której chcesz wysyłać zapytania.
`ds.alias.datasetId`	Wymagany** Identyfikator zbioru danych tabeli, z której chcesz wykonać zapytanie.
`ds.alias.tableId`	Wymagany** Identyfikator tabeli, z której chcesz wysłać zapytanie. Tabele podzielone według daty: podczas wysyłania zapytań do tabel podzielonych według daty obsługiwany jest symbol wieloznaczny * lub sufiks `YYYYMMDD`. Jeśli tabela jest zidentyfikowana jako Google Analytics, Firebase Analytics lub Firebase Crashlytics, zostanie wybrany domyślny szablon pól, chyba że określono inny. Zobacz parametry związane z tabelą szablonu pól.
`ds.alias.billingProjectId`	Opcjonalnie. Identyfikator projektu, który ma być używany do rozliczeń. Jeśli nie zostanie ustawiona, użyta zostanie wartość `projectId`.
`ds.alias.isPartitioned`	Opcjonalnie. Ustaw wartość `true`, jeśli tabela jest partycjonowana i chcesz użyć kolumny partycjonowania jako wymiaru zakresu dat. Dotyczy to tylko partycjonowania opartego na czasie (np. przy użyciu kolumny partycjonowania opartego na czasie lub pseudokolumny `_PARTITIONTIME`) i nie działa w przypadku tabel partycjonowanych według zakresu liczb całkowitych. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Więcej informacji znajdziesz we wprowadzeniu do tabel partycjonowanych.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Szablon pól dla Google Analytics, Firebase Analytics i Crashlytics

W przypadku tabel zidentyfikowanych jako Google Analytics, Firebase Analytics lub Firebase Crashlytics dostępne są dodatkowe parametry, które umożliwiają ustawienie szablonu pól. Jeśli nie zostanie określony, zostanie wybrany szablon domyślny.

Nazwa	Opis
`ds.alias.gaTemplateLevel`	Opcjonalnie. Szablon pól Google Analytics, którego chcesz użyć. Dotyczy tylko zapytań kierowanych do tabeli BigQuery Export dla Google Analytics. Jedna z tych wartości: `ALL`, `SESSION`, `HITS`. W przypadku tabel Google Analytics domyślna wartość to `ALL`.
`ds.alias.firebaseTemplateLevel`	Opcjonalnie. Szablon pól Firebase Analytics, którego chcesz użyć. Dotyczy tylko zapytań dotyczących tabeli BigQuery Export dla Firebase Analytics. Można ustawić tylko wartość `EVENTS`. W przypadku tabel Analytics w Firebase domyślnie jest to `EVENTS`.
`ds.alias.crashlyticsTemplateLevel`	Szablon pól Firebase Crashlytics, którego chcesz użyć. Można ustawić tylko wartość `DEFAULT`. Dotyczy tylko zapytań dotyczących tabeli BigQuery Export dla Firebase Crashlytics. W przypadku tabel Firebase Crashlytics domyślna wartość to `DEFAULT`.

Zapytania CUSTOM

Te parametry mają zastosowanie, gdy parametr type ma wartość CUSTOM_QUERY i podasz instrukcję SQL do wysyłania zapytań do tabeli.

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `bigQuery` dla oprogramowania sprzęgającego BigQuery. Jeśli ta opcja jest ustawiona, zastępuje źródło danych podaną konfiguracją BigQuery. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.type`	Wymagany** – typ zapytania. Ustaw na `CUSTOM_QUERY`.
`ds.alias.sql`	Wymagane** Zapytanie SQL do uruchomienia.
`ds.alias.billingProjectId`	Opcjonalnie. Identyfikator projektu, który ma być używany do rozliczeń. Jeśli nie zostanie ustawiona, użyta zostanie wartość `projectId`. Jeśli `projectId` nie jest ustawiony, używany jest projekt tabeli, do której wysyłane jest zapytanie.
`ds.alias.sqlReplace`	Opcjonalnie. Lista rozdzielonych przecinkami wzorców i ciągów zastępujących, które mają być stosowane w zapytaniu SQL. Zastępowanie ciągów znaków jest stosowane tylko wtedy, gdy występuje dopasowanie wzorca. Pary wzorzec i ciąg zastępujący oddzielaj przecinkami. Na przykład: `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Przykłady

Konfiguracja typu TABLE, w której zapytanie jest zdefiniowane za pomocą identyfikatora tabeli:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

Konfiguracja typu TABLE do wykonywania zapytań w tabeli podzielonej na partycje według daty za pomocą sufiksu z symbolem wieloznacznym:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_*

Konfiguracja typu TABLE do wysyłania zapytań do tabeli podzielonej na partycje według daty za pomocą YYYYMMDD sufiksu:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD

Konfiguracja typu TABLE do wykonywania zapytań w tabeli BigQuery Export dla Google Analytics z użyciem szablonu pól SESSION:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=my-gabq-project
  &ds.ds0.datasetId=1234567
  &ds.ds0.tableId=ga_sessions_YYYYMMDD
  &ds.ds0.gaTemplateLevel=SESSION

Konfiguracja typu TABLE do wykonywania zapytań w tabeli partycjonowanej według czasu przesyłania i używania kolumny partycjonowania jako wymiaru zakresu dat:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=acme-co-logs
  &ds.ds0.datasetId=logs
  &ds.ds0.tableId=logs_table
  &ds.ds0.isPartitioned=true

Konfiguracja typu CUSTOM_QUERY, w której zapytanie jest zdefiniowane za pomocą instrukcji SQL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=CUSTOM_QUERY
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
  &ds.ds0.billingProjectId=myProject

Konfiguracja typu CUSTOM_QUERY, w której aktualizowany jest tylko instrukcja SQL, a w pozostałej części konfiguracji używane jest źródło danych szablonu:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60

Konfiguracja typu CUSTOM_QUERY, w której instrukcja SQL szablonowego źródła danych jest aktualizowana za pomocą sqlReplace:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset

# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
#   SELECT word, word_count FROM big-query-public-data.samples.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
#   SELECT word, word_count FROM new-project.new-dataset.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM new-project.new-dataset.raleigh

Cloud Spanner

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw na `cloudSpanner`w przypadku złącza Cloud Spanner. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją Cloud Spanner. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.projectId`	Wymagany** Identyfikator projektu.
`ds.alias.instanceId`	Wymagany** Identyfikator instancji.
`ds.alias.databaseId`	Wymagany** Identyfikator bazy danych.
`ds.alias.sql`	Wymagane** Zapytanie SQL do uruchomienia.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Przykład

Konfiguracja Cloud Spanner z instrukcją SQL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=456def
  &ds.ds1.connector=cloudSpanner
  &ds.ds1.projectId=myProject
  &ds.ds1.instanceId=production
  &ds.ds1.datasetId=transactions
  &ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B

Społecznościowe oprogramowanie sprzęgające

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `community` dla społecznościowego oprogramowania sprzęgającego. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją łącznika społecznościowego. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.connectorId`	Wymagany** Konektor społecznościowy`connectorId` (nazywany też `deploymentId`).
`ds.alias.parameters`	Opcjonalnie. Dodatkowe parametry specyficzne dla oprogramowania sprzęgającego, zdefiniowane w konfiguracji oprogramowania sprzęgającego łącznika społecznościowego.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Przykład

Połącz się z łącznikiem społecznościowym za pomocą parametrów konfiguracji state i city:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=community
  &ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
  &ds.ds5.state=CA
  &ds.ds5.city=Sacramento

Google Analytics

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `googleAnalytics` dla złącza Google Analytics. Jeśli jest ustawione, zastępuje źródło danych podaną konfiguracją Google Analytics. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.accountId`	Wymagany** Identyfikator konta.
`ds.alias.propertyId`	Wymagany** Identyfikator usługi.
`ds.alias.viewId`	Identyfikator widoku. Wymagany** w przypadku usług Universal Analytics. Nie ustawiaj go w przypadku usług w Google Analytics 4.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Więcej informacji znajdziesz w artykule refreshFields.

Przykłady

Konfiguracja Google Analytics dla usługi Universal Analytics:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=UA-54516992-1
  &ds.ds2.viewId=92320289

Konfiguracja Google Analytics dla usługi w Google Analytics 4:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=213025502

Google Cloud Storage

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw na `googleCloudStorage` Google Cloud Storage Connector. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją Google Cloud Storage. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.pathType`	Wymagany** Typ ścieżki. Użyj klawisza `FILE`, aby wybrać pojedynczy plik, lub klawisza `FOLDER`, aby wybrać wszystkie pliki w danym folderze.
`ds.alias.path`	Wymagany** Ścieżka do pliku (np. MyBucket/MyData/MyFile.csv), jeśli `pathType` ma wartość `FILE`, lub ścieżka do folderu (np. *MyBucket/MyData), jeśli `pathType` ma wartość `FOLDER`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Przykład

Konfiguracja Google Cloud Storage dla jednego pliku:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FILE
  &ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv

Konfiguracja Google Cloud Storage dla wszystkich plików w ścieżce:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FOLDER
  &ds.ds50.path=MyBucket%2FMyData

Arkusze Google

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `googleSheets` dla złącza Arkuszy Google. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją Arkuszy Google. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.spreadsheetId`	Wymagany** Identyfikator arkusza kalkulacyjnego.
`ds.alias.worksheetId`	Wymagany** Identyfikator arkusza.
`ds.alias.hasHeader`	Opcjonalnie. Ustaw na `true`, aby użyć pierwszego wiersza jako nagłówków. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Nagłówki kolumn muszą być unikalne. Kolumny z pustymi nagłówkami nie zostaną dodane do źródła danych.
`ds.alias.includeHiddenCells`	Opcjonalnie. Ustaw wartość `true`, aby uwzględnić ukryte komórki. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`.
`ds.alias.includeFilteredCell`	Opcjonalnie. Ustaw na `true`, aby uwzględniać odfiltrowane komórki. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`.
`ds.alias.range`	Opcjonalnie. Zakres, np. A1:B52.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `true`. Więcej informacji znajdziesz w artykule refreshFields.

Przykłady

Konfiguracja Arkuszy Google:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437

Konfiguracja Arkuszy Google z pierwszym wierszem używanym jako nagłówki oraz ukrytymi i filtrowanymi komórkami:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.hasHeader=true
  &ds.ds3.includeHiddenCells=true
  &ds.ds3.includeFilteredCells=true

Konfiguracja Arkuszy Google z zakresem (A1:D20):

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.range=A1%3AD20

Looker

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `looker` dla oprogramowania sprzęgającego Lookera. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją Lookera. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.instanceUrl`	Wymagany** Adres URL instancji Lookera.
`ds.alias.model`	Wymagany** Model Lookera.
`ds.alias.explore`	Wymagane** Wgląd Lookera.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Więcej informacji znajdziesz w artykule refreshFields.

Przykład

Połącz się z funkcją Explore w Lookerze:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=looker
  &ds.ds5.instanceUrl=my.looker.com
  &ds.ds5.model=thelook
  &ds.ds5.explore=orders

Search Console

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `searchConsole` dla oprogramowania sprzęgającego Search Console. Jeśli jest ustawiona, zastępuje źródło danych podaną konfiguracją Search Console. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.siteUrl`	Wymagany** Adres URL witryny. W przypadku usługi domeny dodaj przedrostek `sc-domain\:`.
`ds.alias.tableType`	Wymagany** Ustawia typ tabeli. Może to być `SITE_IMPRESSION` lub `URL_IMPRESSION`.
`ds.alias.searchType`	Wymagany** Ustawia typ wyszukiwania. Może to być jedna z tych wartości: `WEB`, `IMAGE`, `VIDEO` lub `NEWS`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie zostanie określona, domyślnie przyjmuje wartość `false`. Więcej informacji znajdziesz w artykule refreshFields.

Przykład

Konfiguracja Search Console dla usługi z prefiksem adresu URL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

Konfiguracja Search Console dla usługi domeny:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=sc-domain%3Aexample.com
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

Uprawnienia do szablonu

Aby zapewnić użytkownikom jak najlepsze wrażenia, ważne jest, aby prawidłowo skonfigurować uprawnienia dostępu do raportu w przypadku raportu szablonu i powiązanych z nim źródeł danych. Wymagane uprawnienia zależą od tego, czy szablon raportu korzysta z osadzonych czy wielokrotnego użytku źródeł danych, oraz od tego, czy konfiguracja interfejsu Linking API jest ustawiona na zastępowanie czy aktualizowanie konfiguracji źródła danych.

W tabeli poniżej znajdziesz zalecany dostęp do źródła danych, który zapewnia optymalną wygodę użytkownika na podstawie źródeł danych szablonu i konfiguracji interfejsu Linking API:

Typ źródła danych	Konfiguracja interfejsu API do łączenia ze źródłem danych	Rekomendacja dotycząca uprawnień do źródła danych	Uwagi
Wbudowane	Zamień	Nie dotyczy – uprawnienia do wyświetlania zostaną odziedziczone z raportu.	Jeśli użytkownik ma dostęp do wyświetlania raportu z szablonu, automatycznie uzyska dostęp do wyświetlania każdego osadzonego źródła danych.
Wbudowane	Aktualizuj	Nie dotyczy – uprawnienia do wyświetlania zostaną odziedziczone z raportu.	Jeśli użytkownik ma dostęp do wyświetlania raportu z szablonu, automatycznie uzyska dostęp do wyświetlania każdego osadzonego źródła danych.
Możliwość wielokrotnego użytku	Zamień	Użytkownicy nie potrzebują dostępu do wyświetlania.	Konfiguracja źródła danych jest w całości zastępowana za pomocą interfejsu Linking API, więc dostęp do wyświetlania nie jest wymagany.
Możliwość wielokrotnego użytku	Aktualizuj	Użytkownicy muszą mieć uprawnienia do wyświetlania.	Aby interfejs Linking API mógł odczytywać i używać konfiguracji ze źródła danych szablonu, musisz mieć dostęp do wyświetlania tego źródła danych. Jeśli użytkownik nie ma dostępu do wyświetlania, podczas wczytywania raportu otrzyma komunikat o błędzie.

Używanie pustego lub domyślnego raportu

Aby użyć pustego lub domyślnego raportu, skonfiguruj interfejs Linking API w ten sposób:

Typ raportu Ustaw parametr sterowania reportId. Ustaw parametry źródła danych (ds). Uwagi

Pusty raport Nie Nie

Raport domyślny

Nie

Tak

Typ raportu	Ustaw parametr sterowania `reportId`.	Ustaw parametry źródła danych (`ds`).	Uwagi
Pusty raport	Nie	Nie
Raport domyślny	Nie	Tak	Domyślny raport jest dostarczany przez Looker Studio. Podczas określania parametrów źródła danych dla raportu domyślnego nie musisz używać aliasu źródła danych, ponieważ raport domyślny ma jedno umieszczone źródło danych.

Domyślny raport jest dostarczany przez Looker Studio.

Podczas określania parametrów źródła danych dla raportu domyślnego nie musisz używać aliasu źródła danych, ponieważ raport domyślny ma jedno umieszczone źródło danych.

Poniższe przykłady pokazują różne adresy URL interfejsu Linking API, które używają pustego lub domyślnego raportu.

Rozpocznij proces tworzenia raportu od pustego raportu:

https://lookerstudio.google.com/reporting/create

Uruchamia przepływ pracy tworzenia raportu z pustym raportem i ustawia nazwę raportu:

https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport

Użyj domyślnego szablonu raportu z konfiguracją łącznika Arkuszy Google:

https://lookerstudio.google.com/reporting/create?
  ds.connector=googleSheets
  &ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
  &ds.worksheetId=0

Umieszczanie raportu

Aby osadzić raport utworzony za pomocą interfejsu Linking API, ustaw parametry adresu URL i uwzględnij ścieżkę /embed/. Adres URL do umieszczenia interfejsu Linking API musi mieć format:

https://lookerstudio.google.com/embed/reporting/create?parameters

Znajdowanie identyfikatorów i aliasów

Identyfikator raportu

Aby znaleźć identyfikator raportu:

Otwórz raport, którego chcesz użyć jako szablonu. Sprawdź adres URL raportu. Część między reporting/ a /page to identyfikator raportu. Na przykład w tym adresie URL identyfikatorem raportu jest 0B_U5RNpwhcE6SF85TENURnc4UjA:

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

Pasek adresu przeglądarki z adresem URL raportu Looker Studio.
Identyfikator raportu jest wyróżniony. — Znajdź identyfikator raportu w adresie URL raportu.

Alias źródła danych

Raport może mieć wiele źródeł danych. Do źródła danych należy odwoływać się za pomocą jego aliasu.

Aby znaleźć alias źródła danych:

Przeprowadź edycję raportu.
Na pasku narzędzi wybierz Zasób > Zarządzaj dodanymi źródłami danych.
W kolumnie Alias znajdziesz informacje o aliasach poszczególnych źródeł danych.

Możesz edytować nazwy aliasów, aby zapewnić zgodność wsteczną, gdy źródło danych zostanie dodane lub usunięte.

Lista źródeł danych na stronie zarządzania zasobami Źródło danych.
Kolumna Alias jest wyróżniona. — Alias źródła danych znajdziesz na stronie zarządzania *Źródła danych*.

Typ wtyczki

Raport może mieć wiele źródeł danych, z których każde zostało utworzone przez skonfigurowanie złącza. Aby sprawdzić typ łącznika użytego do utworzenia źródła danych:

Przeprowadź edycję raportu.
Na pasku narzędzi wybierz Zasób > Zarządzaj dodanymi źródłami danych.
Sprawdź kolumnę Typ oprogramowania sprzęgającego, aby określić oprogramowanie sprzęgające użyte do utworzenia źródła danych.

Lista źródeł danych na stronie zarządzania zasobami Źródło danych.
Kolumna Typ oprogramowania sprzęgającego jest wyróżniona. — Znajdź typ konektora źródła danych na stronie zarządzania *Źródła danych*.

Wskazówki i rozwiązywanie problemów

Jeśli masz problemy, zapoznaj się ze szczegółowymi informacjami poniżej, aby zidentyfikować potencjalne problemy i częste błędy konfiguracji.

Okno debugowania

Użyj okna debugowania, aby sprawdzić konfigurację interfejsu Linking API zinterpretowaną przez Looker Studio. Może to pomóc w debugowaniu problemów z interfejsem API.

Jeśli podczas analizowania adresu URL interfejsu Linking API wystąpi błąd, automatycznie wyświetli się okno z informacjami o tym błędzie.
Jeśli wystąpi błąd i nie pojawi się automatycznie okno dialogowe, poszukaj przycisku informacji w prawym górnym rogu raportu. Kliknij, aby uzyskać dodatkowe informacje na potrzeby debugowania.
Jeśli przycisk informacji nie jest dostępny, możesz go włączyć, dodając parametr &c.explain=true na końcu dowolnego adresu URL interfejsu Linking API.

Uprawnienia

Sprawdź, czy masz prawidłowe uprawnienia do szablonu ustawione dla typów źródeł danych i konfiguracji interfejsu Linking API. Więcej informacji znajdziesz w sekcji Uprawnienia do szablonu.

Aktualizacja a zastępowanie

Jeśli aktualizujesz konfigurację źródła danych na podstawie szablonu źródła danych, sprawdź konfigurację źródła danych szablonu i konfigurację interfejsu Linking API, aby upewnić się, że są one ze sobą zgodne. Sprawdź, czy pola uzyskane z nowej konfiguracji są zgodne z komponentami i konfiguracją raportu.

Podczas aktualizacji w porównaniu z zastępowaniem można ustawić nieprawidłową konfigurację z niezdefiniowanym działaniem. Więcej informacji znajdziesz w artykule Zastępowanie a aktualizowanie.

Odśwież pola

Jeśli w przypadku źródła danych szablonu skonfigurowano nazwy, typy lub agregacje pól, te zmiany zostaną przeniesione do źródła danych skonfigurowanego za pomocą interfejsu Linking API tylko wtedy, gdy parametr ds.refreshFields będzie miał wartość false.

Sprawdź parametr źródła danych ds.refreshFields w adresie URL interfejsu Linking API. Jeśli go pominiesz, sprawdź, czy wartość domyślna parametru dla każdego typu łącznika jest odpowiednia w Twoim przypadku.

Jeśli pola w źródle danych szablonu są skonfigurowane i masz pewność, że nowe konfiguracje źródła danych za pomocą interfejsu Linking API zawsze będą dawać dokładnie te same pola, zalecamy ustawienie wartości refreshFields na false.

Jeśli na przykład podczas tworzenia szablonu raportu Looker Studio zidentyfikuje określone pole źródła danych jako typ Liczba, a Ty zmienisz je na typ Rok, ta zmiana konfiguracji pola będzie teraz częścią źródła danych szablonu. Każdy wykres w szablonie raportu, który korzysta z poprawionego pola, będzie oczekiwać wartości Year. Jeśli wykres jest oparty na czasie, w przeciwnym razie może się nie wyświetlać. Jeśli do podania nowej konfiguracji źródła danych, która daje dokładnie te same pola, używany jest interfejs Linking API, możliwe są 2 wyniki w zależności od wartości parametru refreshFields:

Jeśli ta opcja jest ustawiona na true, konfiguracja pola ze źródła danych szablonu nie zostanie przeniesiona, a wykresy mogą się nie wczytać, jeśli zależą od tej samej konfiguracji pola (np. oczekiwane jest pole typu Rok).
Jeśli ustawisz wartość false, konfiguracja pola ze źródła danych szablonu zostanie przeniesiona do nowego źródła danych, a wykresy raportu będą zawierać te same pola z tą samą konfiguracją i zostaną wczytane prawidłowo.

Opinie i pomoc

Aby zgłosić problemy z interfejsem Linking API lub przesłać opinię, użyj narzędzia do śledzenia problemów. Więcej informacji o uzyskiwaniu pomocy i zadawaniu pytań znajdziesz w sekcji Pomoc.

Historia zmian

2023-06-06

Dodaliśmy parametry raportu r.measurementId i r.keepMeasurementId, aby skonfigurować ustawienie raportu Identyfikatory pomiaru Google Analytics.
Dodano parametr ds.keepDatasourceName, aby kontrolować ponowne użycie nazwy źródła danych szablonu.
Dodaliśmy sekcję Osadzanie raportu.
Oprogramowanie sprzęgające BigQuery
- Dodano sqlReplace. Umożliwia określenie wzorca i ciągów zastępujących w celu zaktualizowania zapytania SQL źródła danych szablonu.

2023-05-22

Dodaliśmy obsługę oprogramowania sprzęgającego Looker.
Dodaliśmy obsługę złączy społeczności.

2022-11-21

Dodaliśmy możliwość korzystania z pustego raportu. Zobacz Korzystanie z pustego lub domyślnego raportu
Dodano sekcję refreshFields do artykułu Wskazówki i rozwiązywanie problemów.

2022-11-14

Odwołanie do oprogramowania sprzęgającego Ankiet zostało usunięte z powodu wycofania Ankiet Google.

2022-06-15

Koniec wersji beta
- Interfejs Integration API został zmieniony na Linking API.
- Interfejs Linking API nie jest już w wersji beta.
Dodaliśmy parametr sterujący pageId, który umożliwia tworzenie linków do konkretnej strony raportu.
Dodaliśmy parametr sterujący mode, aby ustawić stan raportu na tryb Wyświetl lub Edytuj podczas wczytywania.
Konfiguracje źródeł danych można teraz całkowicie zastępować lub częściowo aktualizować. To zachowanie zależy od tego, czy ustawiony jest parametr ds.connector. Więcej informacji znajdziesz w artykule Zastępowanie a aktualizowanie.
Jeśli szablon raportu nie zostanie podany za pomocą parametru c.reportId, będzie teraz używany szablon domyślny.
Dodano parametr źródła danych ds.refreshFields. Dzięki temu możesz kontrolować, czy pola źródła danych są odświeżane podczas wczytywania konfiguracji źródła danych.
Oprogramowanie sprzęgające BigQuery
- Właściwość projectId nie jest wymagana, gdy właściwość type ma wartość CUSTOM_QUERY.
- Jeśli parametr billingProjectId nie jest ustawiony, projekt rozliczeniowy powróci do parametru projectId lub projektu tabeli, której dotyczy zapytanie.
- Dodaliśmy obsługę tabel partycjonowanych według daty. Ustaw parametr isPartitioned na true, aby używać pola partycji jako wymiaru zakresu dat.
- Dodaliśmy obsługę zapytań dotyczących tabel partycjonowanych według daty za pomocą symbolu wieloznacznego lub sufiksu tabeli YYYYMMDD.
- Dodaliśmy obsługę zapytań dotyczących tabel Google Analytics, Firebase Analytics lub Crashlytics oraz wybierania szablonu pól.
Arkusze Google
- hasHeader ma domyślnie wartość true, co jest zgodne z domyślną wartością w interfejsie internetowym.
- includeHiddenAndFilteredCell podzielony na includeHiddenCells i
- includeFilteredCells. Obie opcje mają teraz domyślnie wartość true, co jest zgodne z domyślnym ustawieniem interfejsu internetowego.
Oprogramowanie sprzęgające Search Console
- Zmieniono nazwę parametru propertyType na searchType.
Złącze ankiet
- surveyId akceptuje teraz pojedynczy identyfikator ankiety lub listę identyfikatorów ankiet rozdzielonych przecinkami.

2021-12-16

Pierwsza wersja interfejsu Integration API.
- Umożliwia połączenie z istniejącym raportem i ustawienie nazwy raportu.
- Możesz skonfigurować wiele źródeł danych i ustawić nazwę każdego z nich.
- Obsługa tych typów łączników: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Arkusze Google, Ankiety Google, Search Console.

Interfejs API łączenia Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wprowadzenie

Przypadek użycia i korzyści

Jak to działa

Proces programisty interfejsu Linking API

Wrażenia użytkowników interfejsu Linking API

Wymagania

Parametry adresu URL

Parametry sterowania

Parametry raportu

Parametry źródła danych

Parametry źródła danych

Zastępowanie a aktualizowanie – konfiguracje źródeł danych

Wymagane parametry, gdy ustawiony jest parametr ds.connector

Przykłady

Tworzenie a dodawanie

Symbol wieloznaczny aliasu źródła danych

Odniesienie do oprogramowania sprzęgającego

BigQuery

Zapytania do tabeli

Szablon pól dla Google Analytics, Firebase Analytics i Crashlytics

Zapytania CUSTOM

Cloud Spanner

Społecznościowe oprogramowanie sprzęgające

Google Analytics

Google Cloud Storage

Arkusze Google

Looker

Search Console

Uprawnienia do szablonu

Używanie pustego lub domyślnego raportu

Umieszczanie raportu

Znajdowanie identyfikatorów i aliasów

Identyfikator raportu

Alias źródła danych

Typ wtyczki

Wskazówki i rozwiązywanie problemów

Okno debugowania

Uprawnienia

Aktualizacja a zastępowanie

Odśwież pola

Opinie i pomoc

Historia zmian

2023-06-06

2023-05-22

2022-11-21

2022-11-14

2022-06-15

2021-12-16

Interfejs API łączenia

Wymagane parametry, gdy ustawiony jest parametr `ds.connector`