Ta strona została przetłumaczona przez Cloud Translation API.

Interfejs API łączenia

Wprowadzenie

Interfejs Linking API zapewnia niezawodny interfejs do konfigurowania i przekazywania użytkowników bezpośrednio do raportu w Looker Studio za pomocą adresu URL. Po kliknięciu adresu URL interfejsu Links API użytkownicy będą mogli w prosty sposób przeglądać swoje dane i wchodzić z nimi w interakcje.

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

Przypadek użycia i zalety

Interfejs Linking API może służyć do dostarczania klientom wstępnie skonfigurowanych raportów, dzięki którym będą mogli przeglądać ich dane i wchodzić z nimi w interakcje. Najważniejsze zalety interfejsu Links API:

Tworzenie dla klientów raportów jednym kliknięciem
- Konfiguracja danych jest podana w adresie URL, więc użytkownicy nie muszą konfigurować raportu na potrzeby swoich danych.
- Użytkownicy mogą zapisać raport jednym kliknięciem i wrócić do niego w każdej chwili.
Tworzenie raportów na dużą skalę. Interfejs Links API skraca czas potrzebny na duplikowanie raportów i tworzenie nowych.
Włącz integracje usług. Stabilny interfejs umożliwia integrację Looker Studio z przepływem pracy związanym z usługą.

Jak to działa

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

Proces łączenia interfejsu API

Programista przygotowuje raporty szablonów, źródła danych i formatuje adres URL interfejsu Linking API. Typowy przepływ pracy programistów wygląda tak:

Zdecyduj, czy chcesz użyć pustego raportu lub domyślnego szablonu raportu udostępnianego przez Looker Studio, czy utworzyć raport Looker Studio, który będzie szablonem. Obejmuje to konfigurowanie źródeł danych szablonów.
Sformatuj adres URL interfejsu Links API odpowiednio do swojego przypadku użycia. W razie potrzeby podaj szablon raportu i inne parametry, w tym nazwę raportu i źródło danych oraz jego konfiguracje.
Aby przekierować użytkowników do raportu, użyj adresu URL interfejsu Linking API.

Wygoda użytkowników interfejsu Linking API

Użytkownik korzysta z adresu URL interfejsu Linking API, który jeśli został prawidłowo skonfigurowany przez dewelopera, przekierowuje go do raportu narzędzia Looker Studio umożliwiającego wyświetlanie danych, do których ma dostęp, i wchodzenie z nimi w interakcję. Oto typowe wrażenia użytkownika:

W przeglądarce użytkownik odwiedza usługę, która została zintegrowana z interfejsem Linking API.
Wezwanie do działania zachęca użytkownika do kliknięcia linku w celu wyświetlenia jego danych w Looker Studio.
Użytkownik klika link i zostaje przekierowany do raportu w Looker Studio. Raport zostanie wczytany, a użytkownik będzie mógł wyświetlać swoje dane i wchodzić z nimi w interakcje.
Użytkownik klika „Edytuj i udostępnij”. Raport zostanie zapisany na jego koncie Looker Studio.
Użytkownik ma teraz pełny dostęp do własnej kopii raportu i może ją kontrolować. Mogą wyświetlać, edytować i udostępniać pliki w dowolnym momencie.

Wymagania

Aby adres URL interfejsu Links API działał zgodnie z oczekiwaniami, należy spełnić te wymagania:

Raport, który posłuży za szablon. Jeśli go nie podasz, możesz użyć pustego raportu lub raportu domyślnego z Looker Studio.
Użytkownicy adresu URL interfejsu Links API muszą mieć co najmniej uprawnienia do wyświetlania raportu szablonu. W zależności od typu źródeł danych użytych w raporcie i konfiguracji udostępnionej za pomocą interfejsu Linking API użytkownicy mogą też wymagać uprawnień do wyświetlania źródeł danych. Więcej informacji znajdziesz w sekcji Uprawnienia szablonu.
Typ oprogramowania sprzęgającego każdego źródła danych musi obsługiwać konfigurację za pomocą interfejsu Linking API. Listę obsługiwanych programów sprzęgających znajdziesz w dokumentacji oprogramowania sprzęgającego.
Użytkownicy z adresem URL interfejsu Linking API muszą mieć dostęp do danych skonfigurowanych w tym adresie URL interfejsu Linking API. Jeśli użytkownik nie ma dostępu do danych bazowych, wszystkie zależne komponenty raportu wyświetlą błąd.

Parametry adresu URL

Adres URL interfejsu Links API musi mieć taką postać:

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

Adres URL powinien być używany w kontekście przeglądarki, zwykle przez kliknięcie linku lub przekierowanie do adresu URL. Mogą też posłużyć do umieszczenia raportu.

Przykładowy URL

Poniżej znajdziesz przykładowy adres URL interfejsu Linking API. Nazwa raportu jest ustawiona, a pojedyncze źródło danych BigQuery jest skonfigurowane:

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 niektóre opcjonalne. Poniżej znajdziesz listę parametrów używanych do definiowania adresu URL interfejsu Linking API:

Parametry kontrolne

Parametry kontrolne określają stan raportu wyświetlanego pod adresem URL interfejsu Linking API.

Nazwa parametru	Opis
`c.reportId`	Opcjonalnie. Identyfikator szablonu raportu. Looker Studio otworzy i skonfiguruje wskazany raport. Szczegółowe informacje o tym, jak znaleźć identyfikator, znajdziesz w sekcji Identyfikator raportu. Jeśli nie określono inaczej, zostanie użyty pusty raport lub domyślny szablon raportu. Szczegółowe informacje znajdziesz w sekcji Używanie pustego lub domyślnego raportu.
`c.pageId`	Opcjonalnie. Identyfikator strony początkowej do załadowania w raporcie. Jeśli nie określono inaczej, domyślnie ustawiana jest pierwsza strona raportu.
`c.mode`	Opcjonalnie. Początkowy tryb raportu. Jedna z wartości `view` lub `edit`. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `view`.
`c.explain`	Opcjonalnie. Widoczność okna informacyjnego/debugowania. Aby wyświetlić przycisk okna, ustaw wartość `true`. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość `false`. Więcej informacji znajdziesz w artykule 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. Określa nazwę raportu. Jeśli nie określono inaczej, domyślnie przyjmuje się nazwę szablonu raportu.
`r.measurementId`	Opcjonalnie. Ustawia identyfikatory pomiaru Google Analytics na Pomiar wykorzystania raportu. Poszczególne identyfikatory rozdziel przecinkami. Jeśli wartości `r.measurementId` i `r.keepMeasurementId` nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics jest domyślnie nieskonfigurowane. Jeśli ustawiono `r.measurementId` i `r.keepMeasurementId`, parametr `r.keepMeasurementId` ma pierwszeństwo przed ustawieniem identyfikatora.
`r.keepMeasurementId`	Opcjonalnie. Ustaw jako `true`, aby korzystać z szablonu raportu Identyfikatory pomiaru Google Analytics. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość `false`. Jeśli wartości `r.measurementId` i `r.keepMeasurementId` nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics jest domyślnie nieskonfigurowane. Jeśli ustawiono `r.measurementId` i `r.keepMeasurementId`, parametr `r.keepMeasurementId` ma pierwszeństwo przed ustawieniem identyfikatora.

r.reportName

Opcjonalnie. Określa nazwę raportu. Jeśli nie określono inaczej, domyślnie przyjmuje się nazwę szablonu raportu.

r.measurementId

Opcjonalnie. Ustawia identyfikatory pomiaru Google Analytics na Pomiar wykorzystania raportu. Poszczególne identyfikatory rozdziel przecinkami.

Jeśli wartości r.measurementId i r.keepMeasurementId nie są określone, ustawienie raportu Identyfikatory pomiaru Google Analytics jest domyślnie nieskonfigurowane. Jeśli ustawiono r.measurementId i r.keepMeasurementId, parametr r.keepMeasurementId ma pierwszeństwo przed ustawieniem identyfikatora.

r.keepMeasurementId

Opcjonalnie. Ustaw jako true, aby korzystać z szablonu raportu Identyfikatory pomiaru Google Analytics. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość 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ódeł danych i dostępu do danych dla źródeł danych w raporcie opartym na szablonie.

Atrybut alias służy do odwoływania się do źródła danych w istniejącym raporcie. Użycie aliasu zapewnia zgodność wsteczną w przypadku dodania źródła danych do raportu opartego na szablonie lub z niego usuniętego.

Aby dowiedzieć się, jak znaleźć źródło danych alias, zobacz Alias źródła danych.

Parametry źródła danych

Poniższe parametry są wspólne dla wszystkich typów oprogramowania sprzęgającego:

Nazwa	Opis
`ds.alias.datasourceName`	Opcjonalnie. Określa nazwę źródła danych. Jeśli właściwości `ds.datasourceName` i `ds.keepDatasourceName` są nieokreślone, domyślnie nazwa źródła danych przyjmuje konwencję nazewnictwa obejmującą typ oprogramowania sprzęgającego i godzinę utworzenia (np. przykłady – 12.12.2021, 22:53). Jeśli są ustawione `ds.datasourceName` i `ds.keepDatasourceName`, `ds.datasourceName` ma pierwszeństwo przed ustawieniem nazwy źródła danych.
`ds.alias.keepDatasourceName`	Opcjonalnie. Aby używać nazwy źródła danych szablonu, ustaw wartość `true`. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `false`. Jeśli właściwości `ds.datasourceName` i `ds.keepDatasourceName` są nieokreślone, domyślnie nazwa źródła danych przyjmuje konwencję nazewnictwa obejmującą typ oprogramowania sprzęgającego i godzinę utworzenia (np. przykłady – 12.12.2021, 22:53). Jeśli są ustawione `ds.datasourceName` i `ds.keepDatasourceName`, `ds.datasourceName` ma pierwszeństwo przed ustawieniem 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 zasada jest skonfigurowana, wszystkie parametry oprogramowania sprzęgającego wymagane dla typu oprogramowania sprzęgającego muszą być określone w adresie URL interfejsu Links API, a konfiguracja źródła danych szablonu zostanie w całości zastąpiona. Jeśli nie określono inaczej, w adresie URL interfejsu Links API można określić zero lub więcej parametrów oprogramowania sprzęgającego dla typu oprogramowania sprzęgającego. Do określenia parametrów niepodanych w adresie URL interfejsu Links API zostanie użyta konfiguracja źródła danych szablonu. Szczegółowe informacje o tym, jak zidentyfikować typ oprogramowania sprzęgającego w źródle danych szablonu, znajdziesz w sekcji Typ oprogramowania sprzęgającego. Więcej informacji o tym, jak parametr `ds.connector` wpływa na to, czy konfiguracja źródła danych szablonu jest zastępowana w całości lub używana do aktualizowania nieokreślonych parametrów, znajdziesz w sekcji Zastępowanie a aktualizowanie.
`ds.alias.refreshFields`	Opcjonalnie. Ustaw wartość `true`, aby używać konfiguracji źródła danych określonej za pomocą interfejsu Linking API do odświeżania pól źródeł danych i aktualizowania komponentów raportów o nowe pola. `true` jest zwykle określony podczas przełączania typu oprogramowania sprzęgającego lub typów oprogramowania sprzęgającego, w przypadku których zmiana konfiguracji powoduje utworzenie różnych pól (np. pola źródeł danych BigQuery często zmieniają się w zależności od konfiguracji tabel). Aby pozostawić pola źródła danych w raporcie szablonu bez zmian, ustaw wartość `false`. Wartość `false` jest zwykle podawana, gdy nowa konfiguracja danych zwraca dokładnie te same pola i chcesz zachować wszelkie zmiany w polach wprowadzone w źródle danych szablonu. Jeśli nie określono inaczej, wartości domyślne różnią się w zależności od typu oprogramowania sprzęgającego. Jeśli chcesz zastąpić domyślne działanie, zapoznaj się z informacjami o oprogramowaniu sprzęgającym, aby znaleźć domyślne ustawienia oprogramowania sprzęgającego. Co warto wziąć pod uwagę podczas korzystania z `refreshFields`: Jeśli `refreshFields` ma wartość `false`, a konfiguracja źródła danych określona za pomocą interfejsu Linking API generuje inne pola niż w raporcie opartym na szablonie, użytkownik prawdopodobnie zobaczy błąd konfiguracji komponentów, których dotyczy problem. 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 `refreshFields` na `false`, aby zachować konfiguracje pól ze źródła danych szablonu. Pola obliczeniowe i parametry zdefiniowane w źródłach danych szablonów są zawsze kopiowane do nowo utworzonych źródeł danych, a wartość `refreshFields` nie ma na nie wpływu.
`ds.alias.connectorParameters`	Wymagany. Konfiguracja źródła danych dla typu oprogramowania sprzęgającego. Szczegółowe informacje o tym, jak zidentyfikować 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ódeł danych dostępnych dla każdego typu oprogramowania sprzęgającego znajdziesz w dokumentacji oprogramowania sprzęgającego.

Zastąp a aktualizowanie – konfiguracje źródła danych

Obecność lub pominięcie parametru ds.connector w adresie URL interfejsu Links API wskazuje na zamiar zastępowania lub aktualizowania 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 zastępowana w całości czy używana do aktualizowania nieokreślonych parametrów:

Czy `ds.connector` jest ustawiony?	Oczekiwana konfiguracja i działanie	Typowe zastosowanie
Tak	Zamień. Konfiguracja źródła danych szablonu zostanie zastąpiona w całości przy użyciu parametrów źródła danych określonych w adresie URL interfejsu Links API. Musisz określić wszystkie parametry wymagane dla typu oprogramowania sprzęgającego. Zobacz Parametry wymagane, gdy ustawiona jest wartość `ds.connector`.	Gdy zmieniasz typ oprogramowania sprzęgającego źródła danych. np. jeśli w raporcie dotyczącym szablonu masz skonfigurowane źródło danych BigQuery, ale chcesz skonfigurować źródło danych Arkuszy za pomocą interfejsu Linking API. Będzie to wymagać zdefiniowania całej nowej konfiguracji oprogramowania sprzęgającego. gdy chcesz zagwarantować konfigurację źródła danych. Zastąpienie konfiguracji zapobiega wykorzystywaniu nieznanych wartości ze źródła danych szablonu.
Nie	Aktualizacja – Do określenia parametrów niepodanych w adresie URL interfejsu Links API zostanie użyta konfiguracja źródła danych szablonu. Jeśli nie określono inaczej, wszystkie parametry oprogramowania sprzęgającego tego typu są opcjonalne. Upraszcza to adres URL interfejsu Links API i zwykle jest zalecane, jeśli 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, a nie musisz polegać na źródle danych szablonu w przypadku nieokreślonych parametrów oprogramowania sprzęgającego. Przykład: zmień tylko identyfikator projektu rozliczeniowego konfiguracji źródła danych BigQuery i użyj konfiguracji szablonu w przypadku wszystkich pozostałych parametrów.

Parametry wymagane, gdy ustawiona jest wartość `ds.connector`

Jeśli określisz parametr ds.connector źródła danych, w przypadku źródła danych musisz określić wszystkie parametry oprogramowania sprzęgającego oznaczone jako Wymagane. Jeśli parametr ds.connector źródła danych jest nieokreślony, wszystkie parametry oprogramowania sprzęgającego, nawet te określone jako wymagane, mogą być traktowane jako opcjonalne, chyba że określono inaczej.

Przykłady

Konfiguruje raport z 1 źródłem danych BigQuery (ds0) i zastępuje w całości 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ąć, jeśli raport zawiera 1 źródło danych. Powyższy URL można uprościć do takiego:

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 1 ź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 zostanie zastąpiona w całości, a konfiguracja Google Analytics aktualizuje jeden parametr i korzysta ze źródła danych szablonu ds1 w przypadku nieokreślonych parametrów oprogramowania sprzęgającego:

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 warto mieć to samo źródło danych w wielu raportach, więc aktualizacje źródła danych wpływają łącznie na wszystkie raporty. Podczas tworzenia raportu za pomocą interfejsu Linking API możesz ponownie dodać źródło danych z szablonu raportu, upewniając się, że są spełnione wszystkie te warunki:

Źródło danych jest przeznaczone do wielokrotnego użytku (patrz Źródła danych osadzonych i wielokrotnego użytku).
Adres URL nie odwołuje się do źródła danych za pomocą aliasu
Adres URL nie korzysta z aliasu symbolu wieloznacznego (patrz Symbol wieloznaczny w aliasie źródła danych).

Gdy nowe źródło danych jest tworzone za pomocą interfejsu Linking API, wykorzystuje ono dane logowania użytkownika, który kliknął adres URL. Oznacza to, że użytkownik musi mieć dostęp do podstawowych danych, w przeciwnym razie połączenie nie będzie działać. Dodając ponownie źródło danych do nowo wygenerowanego raportu, możesz zachować jego dane logowania, aby użytkownicy mogli nadal uzyskiwać dostęp do danych w nowych raportach.

Symbol wieloznaczny dla aliasu źródła danych

Aby zastosować parametr łączący interfejs API do wielu źródeł danych, zamiast aliasu źródła danych można użyć aliasu ds.*.

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

  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ć symbolu wieloznacznego ds.*, który odpowiada temu adresowi URL:

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

Parametry podane w interfejsie Links API, które nie używają symbolu wieloznacznego ds.*, mają pierwszeństwo przed parametrami, które mają w tym celu symbole. W przykładzie powyżej możesz dodać określony 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 rzecz biorąc, kolejność pierwszeństwa parametrów jest następująca:

Parametr podany z określonym aliasem (ds.ds1.datasetId)
Parametr podany za pomocą symbolu wieloznacznego (ds.*.datasetId)
Jeśli nie podano źródła danych ds.connector, wartość pobrana ze źródła danych szablonu (patrz Zastępowanie a aktualizowanie).
Wartość domyślna parametru, jeśli jest opcjonalna.

Dokumentacja oprogramowania sprzęgającego

Interfejs Links API obsługuje poniższe oprogramowanie sprzęgające i konfiguracje. Dla każdego oprogramowania sprzęgającego wyświetlana jest lista dostępnych parametrów źródła danych.

BigQuery

Oprogramowanie sprzęgające BigQuery obsługuje 2 rodzaje zapytań: zapytanie TABLE, w którym podajesz identyfikator tabeli, której ma dotyczyć zapytanie, oraz CUSTOM_QUERY, w którym podajesz instrukcję SQL umożliwiającą wykonanie zapytania dotyczącego tabeli.

Zapytania dotyczące TABLE

Poniższe parametry mają zastosowanie, gdy type ma wartość TABLE i podajesz identyfikator tabeli, której ma dotyczyć zapytanie.

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie. Ustaw wartość `bigQuery` dla oprogramowania sprzęgającego BigQuery. Jeśli jest ustawiony, 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, którego ma dotyczyć zapytanie.
`ds.alias.datasetId`	Wymagany** Identyfikator zbioru danych tabeli, której ma dotyczyć zapytanie.
`ds.alias.tableId`	Wymagany** Identyfikator tabeli, której ma dotyczyć zapytanie. Tabele podzielone na fragmenty: Przy wysyłaniu zapytań do tabel z fragmentami dat obsługiwany jest sufiks * (symbol wieloznaczny) lub `YYYYMMDD`. Jeśli tabela jest identyfikowana jako Google Analytics, Firebase Analytics lub Firebase Crashlytics, zostanie wybrany domyślny szablon pól, chyba że go określisz. Sprawdź parametry związane z tabelą szablonów pól.
`ds.alias.billingProjectId`	Opcjonalnie. Identyfikator projektu, który ma być używany do rozliczeń. Jeśli nie jest skonfigurowana, używana będzie wartość `projectId`.
`ds.alias.isPartitioned`	Opcjonalnie. Ustaw jako `true`, jeśli tabela jest partycjonowana i chcesz używać kolumny partycjonowania jako wymiaru zakresu dat. Ma to zastosowanie tylko do partycjonowania według czasu (np. z użyciem kolumny partycjonowania według czasu lub pseudokolumny `_PARTITIONTIME`) i nie działa w przypadku tabel partycjonowanych według zakresu liczb całkowitych. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość `false`. Więcej informacji znajdziesz we wprowadzeniu do tabel partycjonowanych.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Więcej informacji znajdziesz w sekcji refreshFields.

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

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

Nazwa	Opis
`ds.alias.gaTemplateLevel`	Opcjonalnie. Szablon pól Google Analytics, których chcesz użyć. Ma zastosowanie tylko w przypadku zapytania o eksport BigQuery do tabeli Google Analytics. Jedna z wartości `ALL`, `SESSION`, `HITS`. W przypadku tabel Google Analytics wartość domyślna to `ALL`, jeśli nie określono inaczej.
`ds.alias.firebaseTemplateLevel`	Opcjonalnie. Szablon pól Firebase Analytics, których chcesz użyć. Ma zastosowanie tylko w przypadku zapytania o eksport BigQuery dla Firebase Analytics. Można ustawić tylko na `EVENTS`. W przypadku tabel Firebase Analytics wartość domyślna to `EVENTS`, jeśli nie określono inaczej.
`ds.alias.crashlyticsTemplateLevel`	Szablon pól Firebase Crashlytics, których chcesz użyć. Można ustawić tylko na `DEFAULT`. Ma zastosowanie tylko wtedy, gdy jest wysyłane zapytanie do tabeli Crashlytics wyeksportowanej z BigQuery. W tabelach Firebase Crashlytics domyślnie ustawiona jest wartość `DEFAULT`, jeśli nie określono inaczej.

Zapytania NIESTANDARDOWE

Poniższe parametry mają zastosowanie, gdy type ma wartość CUSTOM_QUERY i udostępniasz 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 jest ustawiony, 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 jest skonfigurowana, używana będzie wartość `projectId`. Jeśli `projectId` nie jest skonfigurowany, używany będzie projekt tabeli, której dotyczy zapytanie.
`ds.alias.sqlReplace`	Opcjonalnie. Lista rozdzielonych przecinkami wzorców i ciągów zastępczych, które mają być zastosowane do zapytania SQL. Ciąg znaków jest zastępowany tylko wtedy, gdy występuje dopasowanie do wzorca. Rozdzielaj pary ciągów znaków za pomocą przecinka. Na przykład: `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Więcej informacji znajdziesz w sekcji 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 wysyłania zapytań do tabeli podzielonej na fragmenty z użyciem sufiksu znaków wieloznacznych:

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 fragmenty z użyciem sufiksu YYYYMMDD:

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 wysyłania zapytań do tabeli BigQuery Export dla Google Analytics przy użyciu 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 wysyłania zapytań do tabeli partycjonowanej według czasu przetwarzania i użycia 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 zapytania są 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 aktualizowana jest tylko instrukcja SQL, a przez resztę 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 źródła danych szablonu jest aktualizowana za pomocą metody 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 wartość `cloudSpanner` dla łącznika Cloud Spanner. Jeśli jest ustawiony, 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 podano tej wartości, przyjmuje się wartość domyślną `true`. Szczegółowe informacje znajdziesz w sekcji 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. W przypadku społecznościowego oprogramowania sprzęgającego ustaw wartość `community`. Jeśli jest ustawiony, zastępuje źródło danych podaną konfiguracją społecznościowego oprogramowania sprzęgającego. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.connectorId`	Wymagany** społecznościowym oprogramowaniem sprzęgającym `connectorId` (nazywanym też `deploymentId`).
`ds.alias.parameters`	Opcjonalnie. Dodatkowe parametry związane z oprogramowaniem sprzęgającym określone w konfiguracji oprogramowania sprzęgającego tego oprogramowania.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Więcej informacji znajdziesz w sekcji refreshFields.

Przykład

Połącz się ze społecznościowym oprogramowaniem sprzęgającym za pomocą parametrów konfiguracyjnych 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 oprogramowania sprzęgającego Google Analytics. Jeśli jest ustawiony, 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 danych. Wymagany** w przypadku usług w Universal Analytics. Nie ustawiaj go w usługach Google Analytics 4.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `false`. Więcej informacji znajdziesz w sekcji refreshFields.

Przykłady

Konfiguracja Google Analytics na potrzeby 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 na potrzeby usługi 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` łącznik Google Cloud Storage. Jeśli jest ustawiony, zastępuje źródło danych podaną konfiguracją Google Cloud Storage. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.pathType`	Required** – typ ścieżki. Użyj `FILE`, aby wybrać pojedynczy plik lub `FOLDER`, aby wybrać wszystkie pliki dla danej ścieżki.
`ds.alias.path`	Wymagany** Ścieżka pliku (np. MójZasobnik/MojeDane/MójPlik.csv), jeśli `pathType` to `FILE`, lub ścieżka folderu (np. *MójZasobnik/MojeDane), jeśli `pathType` to `FOLDER`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Szczegółowe informacje znajdziesz w sekcji refreshFields.

Przykład

Konfiguracja Google Cloud Storage dla pojedynczego 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 łącznika Arkuszy Google. Jeśli jest ustawiony, 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`	Required** – identyfikator arkusza.
`ds.alias.hasHeader`	Opcjonalnie. Ustaw wartość `true`, aby użyć pierwszego wiersza jako nagłówków. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Nagłówki kolumn muszą być unikalne. Kolumny z pustymi nagłówkami nie będą dodane do źródła danych.
`ds.alias.includeHiddenCells`	Opcjonalnie. Aby uwzględnić ukryte komórki, ustaw wartość `true`. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`.
`ds.alias.includeFilteredCell`	Opcjonalnie. Aby uwzględnić odfiltrowane komórki, ustaw wartość `true`. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`.
`ds.alias.range`	Opcjonalnie. Zakres, np. A1:B52.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `true`. Więcej informacji znajdziesz w sekcji 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 odfiltrowanymi 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 Looker. Jeśli jest ustawiony, zastępuje źródło danych podaną konfiguracją Lookera. Zobacz Zastępowanie a aktualizowanie.
`ds.alias.instanceUrl`	Wymagany** – URL instancji Lookera.
`ds.alias.model`	Wymagany** model Lookera.
`ds.alias.explore`	Wymagany** Eksplorowanie Lookera.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `false`. Więcej informacji znajdziesz w sekcji refreshFields.

Przykład

Połącz z funkcją Wgląd 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 ustawiony, 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 prefiks `sc-domain\:`.
`ds.alias.tableType`	Required** (Wymagane) – określa typ tabeli. Może mieć wartość `SITE_IMPRESSION` lub `URL_IMPRESSION`.
`ds.alias.searchType`	Wymagane** – określa typ wyszukiwania. Może mieć wartość `WEB`, `IMAGE`, `VIDEO` lub `NEWS`.
`ds.alias.refreshFields`	Opcjonalnie. Jeśli nie podano tej wartości, przyjmuje się wartość domyślną `false`. Więcej informacji znajdziesz w sekcji refreshFields.

Przykład

Konfiguracja Search Console dla usługi z prefiksem 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 szablonu

Aby zadbać o wygodę użytkowników, musisz prawidłowo skonfigurować uprawnienia dostępu do raportów do szablonu raportu i powiązanych źródeł danych. Wymagane uprawnienia zależą od tego, czy szablon raportu korzysta ze osadzonych źródeł danych czy źródeł danych wielokrotnego użytku oraz od tego, czy konfiguracja interfejsu Links API ma na celu zastępowanie lub aktualizowanie konfiguracji źródła danych.

W tabeli poniżej znajdziesz zalecane ustawienia dostępu do źródła danych pozwalające zapewnić optymalny komfort użytkowania na podstawie źródeł danych szablonów i konfiguracji interfejsu Linking API:

Typ źródła danych	Konfiguracja interfejsu API łączenia ze źródłem danych	Zalecenie dotyczące uprawnień do źródła danych	Uwagi
Umieszczony	Zastąp	Nie dotyczy – uprawnienia do wyświetlania będą przejmowane z raportu.	Jeśli użytkownik ma uprawnienia do wyświetlania szablonu raportu, automatycznie otrzyma też uprawnienia do wyświetlania wszystkich umieszczonych źródeł danych.
Umieszczony	Aktualizuj	Nie dotyczy – uprawnienia do wyświetlania będą przejmowane z raportu.	Jeśli użytkownik ma uprawnienia do wyświetlania szablonu raportu, automatycznie otrzyma też uprawnienia do wyświetlania wszystkich umieszczonych źródeł danych.
Możliwość wielokrotnego użytku	Zastąp	Użytkownik nie potrzebuje uprawnień do wyświetlania.	Konfiguracja źródła danych jest zastępowana w całości za pomocą interfejsu Linking API, więc uprawnienia do wyświetlania nie są wymagane.
Możliwość wielokrotnego użytku	Aktualizuj	Użytkownik wymaga uprawnień do wyświetlania.	Uprawnienia do wyświetlania źródła danych są wymagane, aby interfejs Linking API mógł odczytywać konfigurację ze źródła danych szablonu i korzystać z niej. Jeśli użytkownik nie ma uprawnień do wyświetlania, podczas wczytywania raportu pojawi się błąd.

Użyj pustego lub domyślnego raportu

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

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

Pusty raport Nie Nie

Raport domyślny

Nie

Tak

Typ raportu	Ustaw parametr kontrolny `reportId`.	Ustaw parametry źródła danych (`ds`).	Uwagi
Pusty raport	Nie	Nie
Raport domyślny	Nie	Tak	Raport domyślny jest dostarczany przez Looker Studio. Do określania parametrów źródła danych na potrzeby raportu domyślnego nie musisz używać aliasu źródła danych, ponieważ zawiera on 1 umieszczone źródło danych.

Raport domyślny jest dostarczany przez Looker Studio.

Do określania parametrów źródła danych na potrzeby raportu domyślnego nie musisz używać aliasu źródła danych, ponieważ zawiera on 1 umieszczone źródło danych.

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

Rozpocznij tworzenie raportu od pustego raportu:

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

Rozpocznij tworzenie raportu od pustego raportu i nadaj mu jego nazwę:

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

Użyj domyślnego szablonu raportu z konfiguracją oprogramowania sprzęgającego Arkuszy Google:

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

Umieszczanie raportu

Aby umieścić raport utworzony za pomocą interfejsu Linking API, ustaw parametry adresu URL i uwzględnij ścieżkę /embed/. Adres URL do umieszczania interfejsu Links API musi mieć taką postać:

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

Znajdowanie identyfikatorów i aliasów

Identyfikator zgłoszenia

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 0B_U5RNpwhcE6SF85TENURnc4UjA jest identyfikatorem raportu:

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

Pasek adresu przeglądarki z adresem URL raportu narzędzia Looker Studio.
Identyfikator raportu jest zaznaczony. — Znajdź identyfikator raportu w jego adresie URL.

Alias źródła danych

Raport może zawierać wiele źródeł danych. Do źródła danych powinien się odwoływać alias.

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

Przeprowadź edycję raportu.
Na pasku narzędzi kliknij 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ą w przypadku dodawania lub usuwania źródła danych.

Lista źródeł danych na stronie zarządzania zasobami źródła danych.
Kolumna Alias zostanie podświetlona. — Znajdź alias źródła danych na stronie zarządzania *Źródłami danych*.

Typ oprogramowania sprzęgającego

Raport może zawierać wiele źródeł danych. Każde z nich zostanie utworzone za pomocą oprogramowania sprzęgającego. Aby znaleźć typ oprogramowania sprzęgającego użyty do utworzenia źródła danych:

Przeprowadź edycję raportu.
Na pasku narzędzi kliknij Zasób > Zarządzaj dodanymi źródłami danych.
W kolumnie Typ oprogramowania sprzęgającego zidentyfikuj oprogramowanie sprzęgające służące do utworzenia źródła danych.

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

Wskazówki i rozwiązywanie problemów

W razie problemów zapoznaj się z podanymi niżej szczegółami, aby zidentyfikować potencjalne problemy i typowe błędy konfiguracji.

Okno debugowania

W oknie debugowania sprawdź konfigurację interfejsu Links API jako interpretowaną przez Looker Studio. Może 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 ze szczegółowymi informacjami o błędzie.
Jeśli wystąpi błąd i nie wyświetli się automatycznie żadne okno, poszukaj przycisku informacji w prawym górnym rogu raportu. Kliknij, aby wyświetlić dodatkowe informacje na potrzeby debugowania.
Jeśli przycisk informacji nie jest dostępny, możesz go włączyć, dołączając parametr &c.explain=true na końcu dowolnego adresu URL interfejsu Links API.

Uprawnienia

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

Aktualizuj a zastąp

Jeśli aktualizujesz konfigurację źródła danych na podstawie szablonu źródła danych, sprawdź, czy konfiguracja źródła danych szablonu i interfejs API połączenia są zgodne. Sprawdź, czy pola uzyskane z nowej konfiguracji są zgodne ze składnikami i konfiguracją raportu.

Podczas przeprowadzania aktualizacji lub wymiany można ustawić nieprawidłową konfigurację i niezdefiniowane zachowanie. Więcej informacji znajdziesz w artykule Zastępowanie a aktualizacja.

Odśwież pola

Jeśli w przypadku źródła danych szablonu masz skonfigurowane nazwy pól, typy lub agregacje, zmiany te zostaną przeniesione do źródła danych skonfigurowanego na potrzeby interfejsu Links API tylko wtedy, gdy parametr ds.refreshFields ma wartość false.

Sprawdź parametr źródła danych ds.refreshFields w adresie URL interfejsu Linking API. Jeśli go pominiesz, sprawdź, czy domyślna wartość parametru dla każdego typu oprogramowania sprzęgającego jest prawidłowa w Twoim przypadku użycia.

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

Jeśli np. podczas tworzenia szablonu raportu Looker Studio rozpozna konkretne pole źródła danych jako typ Liczba i wpiszesz w nim wartość Rok, ta zmiana konfiguracji pola stanie się teraz częścią źródła danych szablonu. Każdy wykres w szablonie raportu, który korzysta z poprawionego pola, będzie oczekiwać na Rok. Jeśli wykres jest oparty na czasie, może nie zostać wyświetlony w inny sposób. Jeśli za pomocą interfejsu Linking API utworzysz nową konfigurację źródła danych, która zwróci dokładnie te same pola, wartość parametru refreshFields będzie miała 2 wyniki:

Jeśli ustawiona jest wartość 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 (tzn. wymagane jest pole typu Rok).
Jeśli ustawiona jest wartość false, konfiguracja pola ze źródła danych szablonu zostanie przeniesiona do nowego źródła danych, a wykresy raportów otrzymają te same pola z tą samą konfiguracją i z taką samą konfiguracją.

nie ma na nie wpływu.

Opinie i pomoc

Aby zgłosić problemy z interfejsem API łączenia lub przesłać opinię, użyj narzędzia do śledzenia problemów. Na stronie Pomoc znajdziesz ogólne zasoby związane z uzyskiwaniem pomocy i zadawaniem pytań.

Historia zmian

2023-06-06

Dodaliśmy parametry raportów r.measurementId i r.keepMeasurementId, aby skonfigurować ustawienie raportów Identyfikatory pomiaru Google Analytics.
Dodano narzędzie ds.keepDatasourceName, które umożliwia kontrolowanie ponownego wykorzystywania nazwy źródła danych szablonu.
Dodaliśmy sekcję Umieść raport.
Oprogramowanie sprzęgające BigQuery
- Dodano: sqlReplace. Umożliwia określenie wzorca i ciągów zastępczych w celu aktualizowania zapytania SQL źródła danych szablonu.

2023-05-22

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

2022-11-21

Dodaliśmy możliwość korzystania z pustego raportu. Przeczytaj sekcję Używanie pustego lub domyślnego raportu.
Do sekcji Wskazówki i rozwiązywanie problemów dodaliśmy sekcję refreshFields.

2022-11-14

Oprogramowanie sprzęgające Ankiety Google zostało usunięte z powodu wycofania Ankiet Google.

2022-06-15

Poza wersją beta
- Nazwa interfejsu Integration API to teraz Linking API.
- Interfejs Linking API nie jest już w wersji beta.
Dodano parametr kontrolny pageId, aby umożliwić połączenie ze stroną konkretnego raportu.
Dodano parametr kontrolny mode, aby ustawić stan raportu na Widok lub Edytuj po wczytaniu.
Konfiguracje źródeł danych można teraz zastąpić całkowicie lub częściowo. To zachowanie zależy od tego, czy jest ustawiony parametr ds.connector. Szczegółowe informacje znajdziesz w sekcji Zastępowanie a aktualizowanie.
Jeśli szablon raportu nie zostanie podany za pomocą parametru c.reportId, używany jest teraz domyślny szablon.
Dodano parametr źródła danych ds.refreshFields. Dzięki temu możesz kontrolować, czy pola źródła danych mają być odświeżane podczas wczytywania konfiguracji źródła danych.
Oprogramowanie sprzęgające BigQuery
- Pole projectId nie jest wymagane, gdy zasada type ma wartość CUSTOM_QUERY.
- Jeśli billingProjectId nie jest skonfigurowany, projekt rozliczeniowy przełączy się na projectId lub projekt tabeli, której dotyczy zapytanie.
- Dodano 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 przy użyciu znaku wieloznacznego lub sufiksu tabeli YYYYMMDD.
- Dodaliśmy obsługę zapytań dotyczących tabel Google Analytics, Firebase Analytics i Crashlytics oraz wyboru szablonu pól.
Arkusze Google
- hasHeader przyjmuje domyślnie wartość true, zgodnie z domyślnym ustawieniem domyślnym w interfejsie internetowym.
- includeHiddenAndFilteredCell podzielone na includeHiddenCells i
- includeFilteredCells. Obie opcje domyślnie mają wartość true, zgodnie z domyślnym ustawieniem w interfejsie internetowym.
Oprogramowanie sprzęgające Search Console
- Zmieniono nazwę parametru propertyType na searchType.
Oprogramowanie sprzęgające 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 określanie jego nazwy.
- Można skonfigurować wiele źródeł danych i nadać każdej z nich nazwę każdego z nich.
- Obsługa tych typów oprogramowania sprzęgającego: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Arkusze Google, Ankiety Google i Search Console.

Interfejs API łączenia

Wprowadzenie

Przypadek użycia i zalety

Jak to działa

Proces łączenia interfejsu API

Wygoda użytkowników interfejsu Linking API

Wymagania

Parametry adresu URL

Parametry kontrolne

Parametry raportu

Parametry źródła danych

Parametry źródła danych

Zastąp a aktualizowanie – konfiguracje źródła danych

Parametry wymagane, gdy ustawiona jest wartość ds.connector

Przykłady

Tworzenie a dodawanie

Symbol wieloznaczny dla aliasu źródła danych

Dokumentacja oprogramowania sprzęgającego

BigQuery

Zapytania dotyczące TABLE

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

Zapytania NIESTANDARDOWE

Cloud Spanner

Społecznościowe oprogramowanie sprzęgające

Google Analytics

Google Cloud Storage

Arkusze Google,

Looker

Search Console

Uprawnienia szablonu

Użyj pustego lub domyślnego raportu

Umieszczanie raportu

Znajdowanie identyfikatorów i aliasów

Identyfikator zgłoszenia

Alias źródła danych

Typ oprogramowania sprzęgającego

Wskazówki i rozwiązywanie problemów

Okno debugowania

Uprawnienia

Aktualizuj a zastąp

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

Parametry wymagane, gdy ustawiona jest wartość `ds.connector`