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

Interfejs API łączenia

Wprowadzenie

Połączenie API zapewnia niezawodny interfejs do konfigurowania i przekazywania użytkowników bezpośrednio do raportu Looker Studio za pomocą adresu URL. Gdy użytkownicy korzystają z interfejsu API łączenia Adres URL, który będą mogli łatwo przeglądać i wchodzić z nimi w interakcję, będzie prostszy. swoje dane.

W tym dokumencie opisano wymagany format adresów URL interfejsów API połączeń oraz dostępnych parametrów.

Przypadek użycia i zalety

Za pomocą interfejsu Connectivity API możesz przekazywać klientom wstępnie skonfigurowane raporty aby wyświetlać ich dane i wchodzić z nimi w interakcję. Najważniejsze zalety interfejsu Connectivity API to: następujące:

Tworzenie raportów dla klientów jednym kliknięciem
- Konfiguracja danych jest podana w adresie URL, więc użytkownicy nie muszą skonfigurować raport pod kątem swoich danych.
- Użytkownicy mogą zapisać raport jednym kliknięciem i wyświetlić go ponownie na stronie w dowolnym momencie.
Tworzenie raportów na dużą skalę Interfejs Links API skraca czas potrzebny do duplikowanie raportów lub tworzenie nowych.
Włącz integracje usług. Stabilny interfejs umożliwia zintegrowania 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 Connectivity API.

Przepływ pracy programisty interfejsu API łączenia

Deweloper przygotowuje szablony raportów, źródła danych i formaty Adres URL interfejsu API. Typowy przepływ pracy dla programistów wygląda tak:

Podjęcie decyzji o użyciu pustego raportu (domyślnego szablonu raportu) lub utwórz raport Looker Studio, który posłuży szablon. Obejmuje to konfigurowanie źródeł danych szablonów.
Sformatuj adres URL interfejsu Connectivity API zgodnie z konkretnym przypadkiem użycia. W razie potrzeby podaj szablon raportu oraz inne parametry, w tym nazwę raportu, dane nazwy i konfiguracji źródła danych.
Użyj adresu URL interfejsu API łączenia, aby kierować użytkowników do raportu.

Interfejs API łączenia

Użytkownik korzysta z adresu URL interfejsu APIs API, który został prawidłowo skonfigurowany przez dewelopera, przekieruje ich do raportu Looker Studio, który pozwoli mu wyświetlić i wchodzić w interakcje z danymi, do których mają dostęp. Typowy odzew użytkowników może być następujące:

Użytkownik odwiedza w przeglądarce usługę zintegrowaną z połączeniem. API.
Wezwanie do działania zawiera prośbę o kliknięcie linku i wyświetlenie danych Looker Studio
Użytkownik klika link i jest przekierowywany do raportu Looker Studio. raport zostanie wczytany, a użytkownik będzie mógł przeglądać swoje dane i wchodzić z nimi w interakcję.
Użytkownik klika „Edytuj i udostępnij”. Raport zostanie zapisany w narzędziu Looker Studio. koncie.
Użytkownik ma teraz pełny dostęp do własnej kopii raportu i może ją kontrolować. Mogą oni wyświetlać, edytować i udostępniać pliki w dowolnym momencie.

Wymagania

Aby adres URL interfejsu API łączenia działał zgodnie z oczekiwaniami, wymagane są te elementy:

Raport, który posłuży za szablon. Jeśli nie zostanie podany, pusty raport lub możesz użyć domyślnego raportu udostępnianego przez Looker Studio.
Użytkownicy adresu URL interfejsu API łączenia muszą mieć co najmniej uprawnienia do wyświetlania szablonu raportu. W zależności od typu źródeł danych używanych w raporcie a konfiguracją udostępnianą za pomocą interfejsu Links API, użytkownicy mogą również wymagać uprawnienia do wyświetlania źródeł danych. Zobacz Uprawnienia do szablonów dla: .
Typ oprogramowania sprzęgającego każdego źródła danych musi obsługiwać konfigurację za pomocą Interfejs API łączenia. Listę obsługiwanych funkcji znajdziesz w dokumentacji oprogramowania sprzęgającego i łączników danych.
Użytkownicy adresu URL interfejsu API łączenia muszą mieć dostęp do danych skonfigurowanych w Adres URL interfejsu API łączenia. Jeśli użytkownik nie ma dostępu do danych bazowych, wszystkie zależne komponenty raportu będą zawierały błąd.

Parametry adresu URL

Adres URL interfejsu API łączenia musi mieć następujący format:

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

Adres URL powinien być używany w kontekście przeglądarki, zwykle gdy użytkownik kliknie link lub zostanie przekierowany do adresu URL. Można jej też używać do: Umieszczanie raportu

Przykładowy URL

Poniżej znajduje się przykładowy adres URL interfejsu API łączenia. Nazwa raportu jest ustawiona Ź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 inne opcjonalne. Oto lista parametrów używanych do zdefiniowania adresu URL interfejsu APIs API:

Parametry kontrolne

Parametry kontrolne określają stan raportu wyświetlanego po połączeniu Adres URL interfejsu API.

Nazwa parametru	Opis
`c.reportId`	Opcjonalnie: Identyfikator raportu szablonu. Narzędzie Looker Studio zostanie otwarte i skonfigurowane określonego raportu. Szczegółowe informacje o tym, jak znaleźć identyfikator, znajdziesz na stronie Identyfikator raportu. Jeśli nie określono inaczej, pusty raport lub jest używany domyślny szablon raportu. Więcej informacji znajdziesz w sekcji Używanie pusty lub domyślny raport.
`c.pageId`	Opcjonalnie: Identyfikator strony początkowej do wczytania w raporcie. Domyślna wartość to pierwszą stronę raportu, jeśli nie określono inaczej, .
`c.mode`	Opcjonalnie: Tryb wstępnego raportu. Jedna z tych wartości: `view` lub . `edit` Jeśli nie określono inaczej, domyślna wartość to `view`.
`c.explain`	Opcjonalnie: Widoczność okna informacji/debugowania. Ustaw na `true`, aby wyświetlić przycisk okna. Domyślna wartość to `false`, jeśli nie określono inaczej. Zobacz Rozwiązywanie problemów z konfiguracją, aby dowiedzieć się więcej.

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ślna wartość to nazwę szablonu raportu.
`r.measurementId`	Opcjonalnie: Ustawia identyfikatory pomiaru Google Analytics na Pomiar o korzystaniu z raportów. Poszczególne identyfikatory rozdzielaj przecinkami. Jeśli `r.measurementId` i `r.keepMeasurementId` nie są określone, raport Identyfikatory pomiaru Google Analytics domyślnie jest nieskonfigurowana. Jeśli `r.measurementId` i Wartość `r.keepMeasurementId` jest ustawiona, `r.keepMeasurementId` ma pierwszeństwo przed ustawieniem identyfikatora.
`r.keepMeasurementId`	Opcjonalnie: Ustaw jako `true`, aby korzystać z raportu szablonu Identyfikatory pomiaru Google Analytics. Domyślna wartość to `false` jeśli nie określono inaczej. Jeśli `r.measurementId` i `r.keepMeasurementId` nie są określone, raport Identyfikatory pomiaru Google Analytics domyślnie jest nieskonfigurowana. Jeśli `r.measurementId` i Wartość `r.keepMeasurementId` jest ustawiona, `r.keepMeasurementId` ma pierwszeństwo przed ustawieniem identyfikatora.

r.reportName

Opcjonalnie: Określa nazwę raportu. Jeśli nie określono inaczej, domyślna wartość to nazwę szablonu raportu.

r.measurementId

Opcjonalnie: Ustawia identyfikatory pomiaru Google Analytics na Pomiar o korzystaniu z raportów. Poszczególne identyfikatory rozdzielaj przecinkami.

Jeśli r.measurementId i r.keepMeasurementId nie są określone, raport Identyfikatory pomiaru Google Analytics domyślnie jest nieskonfigurowana. Jeśli r.measurementId i Wartość r.keepMeasurementId jest ustawiona, r.keepMeasurementId ma pierwszeństwo przed ustawieniem identyfikatora.

r.keepMeasurementId

Opcjonalnie: Ustaw jako true, aby korzystać z raportu szablonu Identyfikatory pomiaru Google Analytics. Domyślna wartość to false jeśli nie określono inaczej.

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 pozwalają zdefiniować konfigurację źródła danych aby uzyskać dostęp do źródeł danych w raporcie z szablonu.

Pole alias służy do odwoływania się do źródła danych w istniejącym raporcie. Za pomocą alias zapewnia zgodność wsteczną, jeśli źródło danych zostanie dodane/usunięte z szablon raportu.

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

Parametry źródła danych

Poniższe parametry są wspólne we wszystkich typach oprogramowania sprzęgającego:

Nazwa	Opis
`ds.alias.datasourceName`	Opcjonalnie: Określa nazwę źródła danych. Jeśli `ds.datasourceName` i `ds.keepDatasourceName` nie są określone, nazwa źródła danych domyślnie stosowana jest konwencja nazewnictwa obejmująca typ oprogramowania sprzęgającego czas utworzenia (np. próbki – 12.12.2021, 22:53). Jeśli `ds.datasourceName` i `ds.keepDatasourceName` są jest ustawione, pierwszeństwo ma `ds.datasourceName` do ustawiania danych nazwa źródła.
`ds.alias.keepDatasourceName`	Opcjonalnie: Ustaw jako `true`, aby używać źródła danych szablonu imię i nazwisko. Jeśli nie określono inaczej, domyślna wartość to `false`. Jeśli `ds.datasourceName` i `ds.keepDatasourceName` nie są określone, nazwa źródła danych domyślnie stosowana jest konwencja nazewnictwa obejmująca typ oprogramowania sprzęgającego czas utworzenia (np. próbki – 12.12.2021, 22:53). Jeśli `ds.datasourceName` i `ds.keepDatasourceName` są jest ustawione, pierwszeństwo ma `ds.datasourceName` do ustawiania danych nazwa źródła.
`ds.alias.connector`	Opcjonalnie: Typ oprogramowania sprzęgającego źródła danych. Więcej informacji na temat: obsługiwanych typów oprogramowania sprzęgającego, zapoznaj się z sekcją Oprogramowanie sprzęgające odniesienie. Jeśli jest ustawione, wszystkie wymagane parametry oprogramowania sprzęgającego muszą być określone w Adres URL interfejsu API łączenia i konfiguracja źródła danych szablonu zostaną zastąpiono w całości. Jeśli wartość nie jest określona, wartość wynosi zero lub więcej . parametry oprogramowania sprzęgającego można określić w Adres URL interfejsu API łączenia. Konfiguracja źródła danych szablonu będzie używana do określać wszelkie parametry niepodane w adresie URL interfejsu Links API. Więcej informacji jak zidentyfikować typ oprogramowania sprzęgającego w źródle danych szablonu, zapoznaj się z artykułem Typ oprogramowania sprzęgającego. Aby dowiedzieć się więcej o wpływie parametru `ds.connector` czy konfiguracja źródła danych szablonu jest zastąpiona w całości lub służy do aktualizacji nieokreślonych parametrów, zobacz Wymiana a aktualizacja
`ds.alias.refreshFields`	Opcjonalnie: Ustaw jako `true`, aby używać konfiguracji źródła danych określone za pomocą interfejsu APIs API do odśwież pól źródła danych i zaktualizować komponenty raportu nowym polem wybrane opcje. `true` to zwykle określonego podczas przełączania typu oprogramowania sprzęgającego lub dla typów oprogramowania sprzęgającego, w przypadku których zmiana konfiguracji powoduje wygenerowanie innych pól (np. pola źródeł danych BigQuery często zmieniają się zależnie od tabeli konfiguracji). Ustaw jako `false`, aby opuścić pola źródła danych bez zmian w stosunku do szablonu raportu. `false` to zwykle jest określone, gdy nowa konfiguracja danych zwraca dokładnie te same pola i chcesz zachować wszelkie zmiany wprowadzone w polach szablonu 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. Zapoznaj się z Informacje o oprogramowaniu sprzęgającym dotyczące konkretnego oprogramowania sprzęgającego w przypadku, gdy chcesz zastąpić działanie domyślne. O czym warto pamiętać podczas korzystania z narzędzia `refreshFields`: Jeśli `refreshFields` ma wartość `false`, a parametry konfiguracja źródła danych określona za pomocą interfejsu API łączenia są różne od pól użytych w raporcie szablonu, może napotkać 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 Ustawienie `refreshFields` ma wartość `true`. Ustaw `refreshFields` do `false`, aby zachować pole ze źródła danych szablonu. pola obliczeniowe oraz Parametry zdefiniowane w źródłach danych szablonu będą zawsze kopiowane do nowo utworzonych źródeł danych i nie mają na nie wpływu wartość `refreshFields`.
`ds.alias.connectorParameters`	Wymagany. Konfiguracja źródła danych dla typ oprogramowania sprzęgającego. Szczegółowe informacje na temat identyfikacji za pomocą oprogramowania sprzęgającego użytego do utworzenia źródła danych, zobacz Typ oprogramowania sprzęgającego. Szczegółowe informacje na temat danych parametrów źródłowych dostępnych dla poszczególnych typów oprogramowania sprzęgającego znajdziesz w Odniesienie do oprogramowania sprzęgającego.

Zastąpienie a aktualizacja – konfiguracje źródła danych

Przy ustawianiu parametrów źródła danych obecność lub pominięcie funkcji Parametr ds.connector w adresie URL interfejsu API łączenia wskazuje parametr zamierza zastąpić lub zaktualizować konfigurację ź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 została w całości zastąpiona lub użyta do aktualizacji nieokreślone parametry:

Czy ustawienie `ds.connector` jest skonfigurowane?	Oczekiwana konfiguracja i działanie	Typowe zastosowanie
Tak	Zastąp – Konfiguracja źródła danych szablonu jest zastąpiona w z użyciem parametrów źródła danych określonych w Adres URL interfejsu API. Musisz określić wszystkie wymagane parametry parametru typu oprogramowania sprzęgającego. Patrz sekcja Parametry wymagane, gdy Wartość `ds.connector` jest ustawiona.	Zmiana typu oprogramowania sprzęgającego źródła danych. Na przykład: Jeśli skonfigurował(a) źródło danych BigQuery w raporcie szablonu, ale chcesz skonfigurować źródło danych Arkuszy za pomocą interfejsu APIs API. To będzie wymagać nową konfigurację oprogramowania sprzęgającego, która ma zostać zdefiniowana w całości. Gdy chcesz zagwarantować konfigurację źródła danych. Zastąpienie konfiguracji pozwala uniknąć potencjalnych nieznanych wartości. ze źródła danych szablonu.
Nie	Aktualizuj. Konfiguracja źródła danych szablonu będzie używana do określać wszelkie parametry niepodane w adresie URL interfejsu Links API. Wszystkie wtyczki parametry dla typu oprogramowania sprzęgającego są opcjonalne, chyba że określono inaczej. Upraszcza to adres URL interfejsu APIs API i jest zazwyczaj zalecany, znają konfigurację źródła danych szablonu i chcą i zastępować podzbiór parametrów.	Jeśli chcesz podawać tylko wartości parametrów różniące się od wartości w kolumnie szablonu danych szablonu i możesz polegać na danych szablonu. dla dowolnych nieokreślonych parametrów oprogramowania sprzęgającego. Na przykład: Zmień tylko wartość Identyfikator projektu rozliczeniowego konfiguracji źródła danych BigQuery i użyj parametru konfigurację szablonu dla wszystkich pozostałych parametrów.

Parametry wymagane, jeśli ustawiono `ds.connector`

Jeśli jest określony parametr ds.connector źródła danych, wszystkie parametry oprogramowania sprzęgającego oznaczone jako Wymagane muszą być określone dla źródła danych. Jeśli parametr ds.connector źródła danych to wszystkie parametry oprogramowania sprzęgającego, nawet te oznaczone jako wymagane, może być traktowana jako opcjonalna, o ile nie podano inaczej.

Przykłady

Konfiguruje raport z jednym źródłem danych BigQuery (ds0) i zastępuje konfigurację źródła danych w całości:

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 jednym źródłem danych BigQuery (ds0) i aktualizuje tylko identyfikator projektu rozliczeniowego źródło 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 i Źródło danych Google Analytics (ds1). Konfiguracja źródła danych BigQuery to zastąpione w całości, natomiast konfiguracja Google Analytics aktualizuje pojedynczy parametr i korzysta ze źródła danych szablonu ds1 w przypadku dowolnych nieokreślone parametry 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 to samo źródło danych może być przydatne w wielu raportach, zmian w źródle danych wpływa na wszystkie raporty. Podczas tworzenia raportu za pomocą interfejsu Grouping API możesz ponownie dodać źródło danych z aby wygenerować szablon raportu, upewniając się, że są spełnione wszystkie poniższe warunki:

źródła danych można używać wielokrotnie (zobacz umieszczone i używane źródła danych),
Adres URL nie odnosi się do źródła danych przez alias
W adresie URL nie jest używany alias z symbolem wieloznacznym (patrz Symbol wieloznaczny aliasu źródła danych).

Podczas tworzenia nowego źródła danych za pomocą interfejsu Links API używane są dane logowania. użytkownika, który kliknął URL. Oznacza to, że użytkownik musi mieć dostęp do bazowych 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ć dane logowania, aby użytkownicy mogli nadal korzystać z danych w nowych raportach.

Symbol wieloznaczny aliasu źródła danych

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

Jest to pomocne przy usuwaniu powtarzających się parametrów z URL-a. Dla: Jeśli np. masz szablon z 3 dołączonymi źródłami danych BigQuery, chcesz zastąpić projectId i datasetId w ale zachować właściwość tableId, możesz wpisać ją w taki 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ć symbolu wieloznacznego ds.*, aby użyć takiego odpowiednika adresu URL:

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

Parametry udostępnione do interfejsu Connectivity API, które nie używają symbolu wieloznacznego ds.*, to: mają pierwszeństwo przed tymi, które są. W przykładzie powyżej możesz dodać atrybut alias źródła danych w celu zastąpienia wartości 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ść obowiązywania parametrów jest taka:

Parametr podany z określonym aliasem (ds.ds1.datasetId)
Parametr podany z użyciem symbolu wieloznacznego (ds.*.datasetId)
Wartość pozyskana ze źródła danych szablonu, jeśli nie podano DS.connector (patrz Zastępowanie a aktualizacja).
Wartość domyślna parametru, jeśli jest opcjonalna.

Dokumentacja oprogramowania sprzęgającego

Interfejs Connectivity API obsługuje poniższe oprogramowanie sprzęgające i konfiguracje. Dla każdej wartości 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 typy zapytań: TABLE, w którym podajesz identyfikator tabeli, której ma dotyczyć zapytanie, oraz identyfikator CUSTOM_QUERY, przy czym podasz instrukcję SQL, aby wykonać zapytanie dotyczące tabeli.

Zapytania TABLE

Te parametry mają zastosowanie, gdy type ma wartość TABLE, a podaj identyfikator tabeli, której ma dotyczyć zapytanie.

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie: Ustaw na `bigQuery` dla BigQuery . Jeśli jest ustawione, zastępuje źródło danych elementem podaną konfigurację BigQuery. Zobacz Wymiana a aktualizacja
`ds.alias.type`	Wymagany** – typ zapytania. Ustaw na `TABLE`
`ds.alias.projectId`	Wymagany** – identyfikator projektu tabeli. do zapytań.
`ds.alias.datasetId`	Wymagany** – identyfikator zbioru danych tabeli, do której zapytania.
`ds.alias.tableId`	Wymagany** – identyfikator tabeli, do której należy query. Daty w tabelach podzielonych na fragmenty: , * (Symbol wieloznaczny) lub sufiks `YYYYMMDD` podczas wysyłania zapytań dotyczących tabel podzielonych na fragmenty. Jeśli tabela zostanie zidentyfikowana jako Google Analytics, Firebase Analytics lub Firebase Crashlytics – pola domyślne zostanie wybrany szablon, o ile go nie określisz. Zobacz fields template.
`ds.alias.billingProjectId`	Opcjonalnie: Identyfikator projektu, który ma być używany do rozliczeń. Jeśli zasada nie jest skonfigurowana, Użyjemy konta `projectId`.
`ds.alias.isPartitioned`	Opcjonalnie: Ustaw na `true`, jeśli tabela jest partycjonowana, chcesz użyć kolumny partycjonowania jako wymiaru zakresu dat. To jest ma zastosowanie tylko do partycjonowania na podstawie czasu (np. za pomocą funkcji kolumny partycjonowania lub pseudokolumny `_PARTITIONTIME`) oraz nie działa w przypadku tabel partycjonowanych według zakresu liczb całkowitych. Domyślna wartość to `false`, jeśli nie określono inaczej. Aby dowiedzieć się więcej, zobacz Wprowadzenie do tabel partycjonowanych
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `true`. Zobacz 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 do ustawiania szablonu pól. Jeśli nie określono, zostanie wybrany szablon domyślny.

Nazwa	Opis
`ds.alias.gaTemplateLevel`	Opcjonalnie: Szablon pól Google Analytics do użycia. Dotyczy tylko gdy są wysyłane zapytania o dane BigQuery Export dla tabeli Google Analytics. Jeden z `ALL`, `SESSION`, `HITS`. Dla Google tabel Analytics. Jeśli nie określono inaczej, domyślna wartość to `ALL`.
`ds.alias.firebaseTemplateLevel`	Opcjonalnie: Szablon pól Firebase Analytics do użycia. Ma zastosowanie tylko wtedy, gdy wysyłane są zapytania do tabeli BigQuery Export dla Firebase Analytics. Można ustawić tylko wartość `EVENTS`. W przypadku tabel Firebase Analytics Jeśli nie określono inaczej, domyślna wartość to `EVENTS`.
`ds.alias.crashlyticsTemplateLevel`	Szablon pól Firebase Crashlytics do wykorzystania. Można ustawić tylko na `DEFAULT` Ma zastosowanie tylko wtedy, gdy eksport z BigQuery jest przeprowadzany w Firebase Wykonuję zapytanie dotyczące tabeli Crashlytics. W przypadku tabel Firebase Crashlytics Jeśli nie określono inaczej, domyślna wartość to `DEFAULT`.

Zapytania: CUSTOM

Te parametry mają zastosowanie, gdy type ma wartość CUSTOM_QUERY oraz podasz instrukcję SQL, aby wykonać zapytanie dotyczące tabeli.

Nazwa parametru	Opis
`ds.alias.connector`	Opcjonalnie: Ustaw na `bigQuery` dla BigQuery . Jeśli jest ustawione, zastępuje źródło danych elementem podaną konfigurację BigQuery. Zobacz Wymiana a aktualizacja
`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 zasada nie jest skonfigurowana, Użyjemy konta `projectId`. Jeśli zasada `projectId` nie jest ustawiona zostanie użyty projekt tabeli, której dotyczy zapytanie.
`ds.alias.sqlReplace`	Opcjonalnie: Lista rozdzielonych przecinkami wzorców i ciągów zastępczych ciągu do stosowane do zapytania SQL. Zastępowanie ciągu znaków jest stosowane tylko wtedy, gdy do wzorca. Użyj przecinka do rozdzielania wzorca i ciągu zastępczego pary. Na przykład: `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `true`. Zobacz 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ń dotyczących tabeli podzielonej na fragmenty z użyciem symbolu wieloznacznego sufiks znaku:

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ń dotyczących tabeli podzielonej na fragmenty daty za pomocą funkcji YYYYMMDD sufiks:

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ń dotyczących BigQuery Export dla Google Analytics tabeli za pomocą 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ń dotyczących tabeli partycjonowanej podczas pozyskiwania użyj 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ą kodu 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

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

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 danych szablonu źródło jest aktualizowane przy użyciu 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` dla Chmura Oprogramowanie sprzęgające Spannera. Jeśli jest ustawione, zastępuje źródło danych elementem podaną konfigurację Cloud Spanner. Zobacz Wymiana a aktualizacja
`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 określono inaczej, domyślna wartość to `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: Ustaw jako `community` dla Społecznościowe oprogramowanie sprzęgające. Jeśli źródło danych jest ustawione, zastępuje źródło danych udostępnionym społecznościowym oprogramowaniem sprzęgającym. konfiguracji. Zobacz Wymiana a aktualizacja
`ds.alias.connectorId`	Wymagane** społecznościowe oprogramowanie sprzęgające `connectorId` (`deploymentId`).
`ds.alias.parameters`	Opcjonalnie: Dodatkowe parametry oprogramowania sprzęgającego określone przez społecznościowe oprogramowanie sprzęgające konfiguracji oprogramowania sprzęgającego.
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `true`. Zobacz refreshFields.

Przykład

Połącz się ze społecznościowym oprogramowaniem sprzęgającym za pomocą konfiguracji state i city parametry:

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 na `googleAnalytics` dla Google Oprogramowanie sprzęgające Analytics. Jeśli jest ustawione, zastępuje źródło danych wartością w podanej konfiguracji Google Analytics. Zobacz Wymiana a aktualizacja
`ds.alias.accountId`	Wymagany** identyfikator konta.
`ds.alias.propertyId`	Wymagany** identyfikator usługi.
`ds.alias.viewId`	Identyfikator widoku danych. Wymagany** w przypadku reklam Universal Usługi w Analytics. Nie ustawiaj dla usług Google Analytics 4.
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `false`. Zobacz refreshFields.

Przykłady

Konfiguracja Google Analytics na potrzeby usługi w 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 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 jako `googleCloudStorage` Google Oprogramowanie sprzęgające Cloud Storage. Jeśli jest ustawione, zastępuje źródło danych z udostępnioną konfiguracją Google Cloud Storage. Zobacz Wymiana a aktualizacja
`ds.alias.pathType`	Wymagany** typ ścieżki. Używaj `FILE`, aby wybrać pojedynczy plik, lub `FOLDER`, aby wybrać wszystkich plików w podanej ścieżce.
`ds.alias.path`	Wymagane** – ścieżka pliku (np. MyBucket/MyData/MyFile.csv), jeśli `pathType` ma wartość `FILE` lub ścieżka folderu (np. *MójZasobnik/MojeDane), jeśli `pathType` wynosi `FOLDER`.
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `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 na `googleSheets` dla Google Oprogramowanie sprzęgające Arkuszy. Jeśli jest ustawione, zastępuje źródło danych elementem masz konfigurację Arkuszy Google. Zobacz Wymiana a aktualizacja
`ds.alias.spreadsheetId`	Wymagany** – identyfikator arkusza kalkulacyjnego.
`ds.alias.worksheetId`	Wymagany** – identyfikator arkusza.
`ds.alias.hasHeader`	Opcjonalnie: Ustaw jako `true`, aby używać zawartości pierwszego wiersza jako nagłówków. Jeśli nie określono inaczej, domyślna wartość to `true`. Nagłówki kolumn muszą być i niepowtarzalna. Kolumny z pustymi nagłówkami nie zostaną dodane do źródła danych.
`ds.alias.includeHiddenCells`	Opcjonalnie: Aby uwzględnić ukryte komórki, ustaw wartość `true`. Jeśli nie określono inaczej, domyślna wartość to `true`.
`ds.alias.includeFilteredCell`	Opcjonalnie: Aby uwzględnić odfiltrowane komórki, ustaw wartość `true`. Jeśli nie określono inaczej, domyślna wartość to `true`.
`ds.alias.range`	Opcjonalnie: Zakres, np. A1:B52:
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `true`. Zobacz 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 i ukrytym uwzględnione filtrowane komórki:

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 na `looker` dla Oprogramowanie sprzęgające Lookera. Jeśli jest ustawione, zastępuje źródło danych elementem masz podaną konfigurację Lookera. Zobacz Wymiana a aktualizacja
`ds.alias.instanceUrl`	Wymagany** adres URL instancji Lookera.
`ds.alias.model`	Wymagany** model Lookera.
`ds.alias.explore`	Wymagany** Wgląd Lookera.
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `false`. Zobacz 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 na `searchConsole` dla Wyszukiwarka Oprogramowanie sprzęgające konsoli. Jeśli jest ustawione, zastępuje źródło danych elementem masz podaną konfigurację Search Console. Zobacz Wymiana a aktualizacja
`ds.alias.siteUrl`	Wymagany** adres URL witryny. Dla Domena właściwości, prefiks `sc-domain\:`.
`ds.alias.tableType`	Wymagane** określa typ tabeli. Może być jeden z tych elementów: `SITE_IMPRESSION` lub `URL_IMPRESSION`.
`ds.alias.searchType`	Wymagane** określa typ wyszukiwania. Może być jedna z tych list: `WEB`, `IMAGE`, `VIDEO` lub `NEWS`
`ds.alias.refreshFields`	Opcjonalnie: Jeśli nie określono inaczej, domyślna wartość to `false`. Zobacz refreshFields.

Przykład

Konfiguracja w Search Console 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 do szablonu

Aby zadbać o wygodę użytkowników, zadbaj o prawidłowe ustawienie uprawnienia dostępu do raportu do szablonu raportu i powiązanych danych źródeł. Wymagane uprawnienia zależą od tego, czy szablon raportu korzysta ze źródeł danych osadzonych i wielokrotnego użytku oraz wskazuje, czy interfejs Links API jest ustawiona na zastąpienie lub zaktualizowanie konfigurację źródła danych.

W tabeli poniżej znajdziesz zalecany dostęp do źródła danych, który zapewnia optymalizację wrażenia użytkowników na podstawie szablonów źródeł danych i interfejsu API łączenia Konfiguracja:

Typ źródła danych	Konfiguracja interfejsu API łączenia dla źródła danych	Rekomendacja dotycząca uprawnień do źródła danych	Uwagi
Wbudowany	Zamień	Nie dotyczy – uprawnienia do wyświetlania zostaną odziedziczone z raportu.	Jeśli użytkownik ma uprawnienia do wyświetlania szablonu raportu, automatycznie mają uprawnienia do wyświetlania dowolnych umieszczonych źródeł danych.
Wbudowany	Aktualizuj	Nie dotyczy – uprawnienia do wyświetlania zostaną odziedziczone z raportu.	Jeśli użytkownik ma uprawnienia do wyświetlania szablonu raportu, automatycznie mają uprawnienia do wyświetlania dowolnych umieszczonych źródeł danych.
Możliwość wielokrotnego użytku	Zamień	Użytkownik nie musi mieć uprawnień do wyświetlania.	Ponieważ konfiguracja źródła danych jest zastępowana w całości za pomocą interfejsu APIs API uprawnienia do wyświetlania nie są wymagane.
Możliwość wielokrotnego użytku	Aktualizuj	Użytkownik musi mieć uprawnienia do wyświetlania.	Dostęp do źródła danych jest wymagany, aby interfejs API łączenia mógł działać może odczytywać konfigurację ze źródła danych szablonu i jej używać. Jeśli użytkownicy nie mają uprawnień do wyświetlania. Jeśli tego nie zrobisz, pojawi się błąd wczytanie raportu.

Użyj pustego lub domyślnego raportu

Aby użyć pustego raportu lub raportu domyślnego, skonfiguruj interfejs Connect API jako następujące:

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. Przy określaniu źródła danych nie musisz używać aliasu źródła danych parametrów źródła danych dla raportu domyślnego, ponieważ raport domyślny zawiera za pomocą jednego osadzonego źródła danych.

Raport domyślny jest dostarczany przez Looker Studio.

Przy określaniu źródła danych nie musisz używać aliasu źródła danych parametrów źródła danych dla raportu domyślnego, ponieważ raport domyślny zawiera za pomocą jednego osadzonego źródła danych.

Poniższe przykłady pokazują różne adresy URL interfejsów API połączeń, które zawierają puste lub domyślne wartości raport.

Rozpocznij tworzenie raportu z pustym raportem:

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

Rozpocznij przepływ pracy z pustym raportem i ustaw go nazwa:

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 APIs API, ustaw wartość Parametry adresu URL i uwzględnij ścieżkę /embed/. Interfejs API łączenia adres URL do umieszczenia musi mieć następujący 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 raport. Część między reporting/ a /page to identyfikator raportu. Dla: w tym adresie URL 0B_U5RNpwhcE6SF85TENURnc4UjA jest raportem Identyfikator:

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

Pasek adresu przeglądarki z adresem URL raportu Looker Studio.
Identyfikator raportu jest zaznaczony. — 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 powinna się odwoływać funkcja i jej aliasie.

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

Przeprowadź edycję raportu.
Na pasku narzędzi kliknij Zasób > Zarządzaj dodanymi źródłami danych.
Przejrzyj kolumnę Alias, aby znaleźć informacje o aliasie poszczególnych źródeł danych.

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

Lista źródeł danych na stronie zarządzania zasobami źródeł danych.
Zaznaczona jest kolumna Alias. — Znajdź alias źródła danych w sekcji zarządzania *źródłami danych*.

Typ wtyczki

Raport może mieć wiele źródeł danych, a każde utworzone przez skonfigurowanie . Aby znaleźć typ oprogramowania sprzęgającego użytego do utworzenia źródła danych:

Przeprowadź edycję raportu.
Na pasku narzędzi kliknij Zasób > Zarządzaj dodanymi źródłami danych.
Sprawdź kolumnę Typ oprogramowania sprzęgającego, aby zidentyfikować oprogramowanie sprzęgające użyte do utworzyć źródło danych.

Lista źródeł danych na stronie zarządzania zasobami źródeł danych.
Zaznaczona jest kolumna Typ oprogramowania sprzęgającego. — Typ oprogramowania sprzęgającego źródła danych znajdziesz w sekcji *Źródła danych* do zarządzania kontem.

Wskazówki i rozwiązywanie problemów

Jeśli masz problem, zapoznaj się z poniższymi informacjami, aby zidentyfikować potencjalne problemy. i typowych błędów konfiguracji.

Okno debugowania

W oknie debugowania sprawdź konfigurację interfejsu Connect API zinterpretowaną przez Looker Studio Może pomóc w debugowaniu problemów z interfejsem API.

Gdy podczas analizy interfejsu API łączenia wystąpił błąd automatycznie wyświetli się okno ze szczegółowymi informacjami na temat .
Jeśli po wystąpieniu błędu nie zostanie automatycznie wyświetlone żadne okno, sprawdź, kliknij przycisk informacji w prawym górnym rogu raportu. Kliknij dodatkowe informacje na potrzeby debugowania.
Jeśli nie ma dostępnego przycisku informacji, możesz go włączyć, wykonując te czynności: umieszczasz parametr &c.explain=true na końcu parametru dowolny adres URL interfejsu APIs API.

Uprawnienia

Sprawdź, czy masz ustawione odpowiednie uprawnienia do szablonów dla typów źródeł danych i łączenia API. Zobacz Uprawnienia do szablonów dla: .

Aktualizacja a zastąpienie

Jeśli aktualizujesz konfigurację źródła danych na podstawie szablonu źródła danych, zapoznaj się z konfiguracji źródła danych szablonu i konfiguracji interfejsu Connect API, aby zapewnić, są zgodne. Sprawdź, czy pola pochodzące z nowej konfiguracji są zgodne z komponentami i konfiguracją raportu.

Podczas przeprowadzania aktualizacji lub wymiany możesz ustawić nieprawidłową z niezdefiniowanym zachowaniem. Zobacz Więcej informacji znajdziesz w artykule Zastępowanie a aktualizacja.

Odśwież pola

Jeśli masz skonfigurowane nazwy pól, typy lub agregacje danych szablonu: te zmiany zostaną przeniesione tylko do danych skonfigurowanych w interfejsie Links API źródła, jeśli parametr ds.refreshFields ma wartość false

Sprawdź parametr źródła danych ds.refreshFields w sekcji Adres URL interfejsu API łączenia. Jeśli zostanie pominięty, sprawdź, czy domyślna wartość parametru dla czy typ oprogramowania sprzęgającego jest odpowiedni do Twojego zastosowania.

Jeśli w źródle danych szablonu masz skonfigurowane pola, masz pewność, że nowe konfiguracje źródeł danych utworzone przez interfejs API łączenia będą zawsze uzyskać dokładnie takie same pola, ustawienie refreshFields na false jest zalecane.

Jeśli na przykład podczas tworzenia szablonu raportu narzędzie Looker Studio identyfikuje określone pole źródła danych jako typ Liczba, a potem zmieniasz je na wpisz Rok, ta zmiana konfiguracji pola jest teraz częścią danych szablonu źródła. Każdy wykres w szablonie raportu, który korzysta z poprawionego pola, będzie oczekiwany rok, a jeśli wykres jest oparty na czasie, może nie wyświetlić się inaczej. Jeśli interfejs API łączenia służy do utworzenia nowej konfiguracji źródła danych, tych samych pól, otrzymasz 2 wyniki w zależności od wartości Parametr refreshFields:

Jeśli ustawisz wartość true, konfiguracja pola ze źródła danych szablonu będzie nie są przenoszone, a wykresy mogą się nie wczytać, jeśli są zależne w 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 przeniesione do nowego źródła danych, a wykresy te same pola o tej samej konfiguracji i wczytywane.

Opinie i pomoc

Za pomocą narzędzia do śledzenia problemów możesz zgłosić problemy z interfejsem API łączenia lub przesłać opinię. Zobacz Pomoc dotycząca ogólnych zasobów pomocy i zadawania pytań.

Historia zmian

2023-06-06

Dodano r.measurementId i r.keepMeasurementId parametry raportu do skonfigurowania ustawienie raportu Identyfikatory pomiaru Google Analytics.
Dodano: ds.keepDatasourceName, aby kontrolować ponowne wykorzystanie: nazwę źródła danych szablonu.
Dodano sekcję Umieszczanie raportu.
Oprogramowanie sprzęgające BigQuery
- Dodano: sqlReplace. Umożliwia określenie wzorca i ciągów zastępczych w celu aktualizacji zapytania SQL szablonu źródła danych.

2023-05-22

Dodano 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ść używania pustego raportu. Zobacz Używanie raportu pustego lub domyślnego
Sekcja refreshFields została dodana do Wskazówki rozwiązywania problemów.

2022-11-14

Usunięto odniesienie do oprogramowania sprzęgającego Ankiety z powodu Wycofanie Ankiet Google.

2022-06-15

Koniec wersji beta
- Nazwa interfejsu Integration API została zmieniona na Linking API.
- Interfejs API łączenia nie jest w wersji beta.
Dodano parametr kontrolny pageId, aby umożliwić połączenie z konkretnym raportem stronę.
dodano parametr mode pozwalający ustawić stan raportu na Wyświetl lub Edytuj po wczytaniu.
Konfiguracje źródeł danych można teraz zastąpić całkowicie lub częściowo Zaktualizowano. Działanie to zależy od tego, czy Ustawiono parametr ds.connector. Patrz sekcja Zastępowanie a aktualizacja. .
Jeśli szablon raportu nie został udostępniony za pomocą metody c.reportId.
Dodano parametr źródła danych ds.refreshFields. Dzięki temu możesz: określ, czy pola źródła danych mają być odświeżane podczas wczytywania źródła danych konfiguracji.
Oprogramowanie sprzęgające BigQuery
- Pole projectId nie jest wymagane, gdy pole type ma wartość CUSTOM_QUERY.
- Jeśli zasada billingProjectId nie jest skonfigurowana, projekt rozliczeniowy wartość zastępcza do projectId lub projektu tabeli, której dotyczy zapytanie.
- Dodano obsługę tabel partycjonowanych według daty. Ustaw isPartitioned na true, by użyć pola partycji jako zakresu dat .
- Dodano obsługę zapytań dotyczących tabel partycjonowanych według daty przy użyciu symbolu wieloznacznego znak lub sufiks tabeli YYYYMMDD.
- Dodaliśmy obsługę zapytań w Google Analytics, Firebase Analytics oraz Tabele Crashlytics i wybór szablonu pól.
Arkusze Google,
- hasHeader ma wartość domyślną true, zgodnie z wartością domyślną interfejsu internetowego.
- includeHiddenAndFilteredCell dzieli się na includeHiddenCells i
- includeFilteredCells Oba modele mają teraz domyślną wartość true, zgodnie z domyślny interfejs internetowy.
Oprogramowanie sprzęgające usługi Search Console
- Nazwa parametru propertyType została zmieniona na searchType.
Oprogramowanie sprzęgające Ankiety
- surveyId akceptuje teraz pojedynczy identyfikator ankiety lub listę rozdzielonych przecinkami identyfikatory ankiet.

2021-12-16

Pierwsza wersja interfejsu Integration API.
- Umożliwia połączenie z istniejącym raportem i ustawienie jego nazwy.
- Można skonfigurować wiele źródeł danych, a nazwę każdego źródła danych można ustawiony.
- Obsługa tych typów oprogramowania sprzęgającego: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Arkusze Google, Ankiety Google Search Console.

Interfejs API łączenia

Wprowadzenie

Przypadek użycia i zalety

Jak to działa

Przepływ pracy programisty interfejsu API łączenia

Interfejs API łączenia

Wymagania

Parametry adresu URL

Parametry kontrolne

Parametry raportu

Parametry źródła danych

Parametry źródła danych

Zastąpienie a aktualizacja – konfiguracje źródła danych

Parametry wymagane, jeśli ustawiono ds.connector

Przykłady

Tworzenie a dodawanie

Symbol wieloznaczny aliasu źródła danych

Dokumentacja oprogramowania sprzęgającego

BigQuery

Zapytania TABLE

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żyj 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ąpienie

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, jeśli ustawiono `ds.connector`