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 |
---|---|
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. | |
Opcjonalnie. Identyfikator strony początkowej do załadowania w raporcie. Jeśli nie określono inaczej, domyślnie ustawiana jest pierwsza strona raportu. | |
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 .
|
|
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 |
---|---|
Opcjonalnie. Określa nazwę raportu. Jeśli nie określono inaczej, domyślnie przyjmuje się nazwę szablonu raportu. | |
Opcjonalnie. Ustawia identyfikatory pomiaru Google Analytics na Pomiar wykorzystania raportu. Poszczególne identyfikatory rozdziel przecinkami. Jeśli wartości |
|
Opcjonalnie. Ustaw jako Jeśli wartości |
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 |
---|---|
Opcjonalnie. Określa nazwę źródła danych. Jeśli właściwości |
|
Opcjonalnie. Aby używać nazwy źródła danych szablonu, ustaw wartość Jeśli właściwości |
|
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 |
|
Opcjonalnie.
Ustaw wartość Aby pozostawić pola źródła danych w raporcie szablonu bez zmian, ustaw wartość 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 :
|
|
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 .
|
|
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. |
|
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 |
---|---|
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. |
|
Wymagany** – typ zapytania. Ustaw na TABLE . |
|
Wymagany** – identyfikator projektu tabeli, którego ma dotyczyć zapytanie. | |
Wymagany** Identyfikator zbioru danych tabeli, której ma dotyczyć zapytanie. | |
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. |
|
Opcjonalnie. Identyfikator projektu, który ma być używany do rozliczeń. Jeśli nie jest skonfigurowana, używana będzie wartość projectId . |
|
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. |
|
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 |
---|---|
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. |
|
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. |
|
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 |
---|---|
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. |
|
Wymagany** – typ zapytania. Ustaw na CUSTOM_QUERY . |
|
Wymagane** – zapytanie SQL do uruchomienia. | |
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. |
|
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: |
|
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 |
---|---|
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. |
|
Wymagany** Identyfikator projektu. | |
Wymagany** Identyfikator instancji. | |
Wymagany** Identyfikator bazy danych. | |
Wymagane** – zapytanie SQL do uruchomienia. | |
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 |
---|---|
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. |
|
Wymagany** społecznościowym oprogramowaniem sprzęgającym connectorId (nazywanym też deploymentId ).
| |
Opcjonalnie. Dodatkowe parametry związane z oprogramowaniem sprzęgającym określone w konfiguracji oprogramowania sprzęgającego tego oprogramowania. | |
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 |
---|---|
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. |
|
Wymagany** – identyfikator konta. | |
Wymagany** – identyfikator usługi. | |
Identyfikator widoku danych. Wymagany** w przypadku usług w Universal Analytics. Nie ustawiaj go w usługach Google Analytics 4. |
|
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 |
---|---|
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. |
|
Required** – typ ścieżki. Użyj FILE , aby wybrać pojedynczy plik lub FOLDER , aby wybrać wszystkie pliki dla danej ścieżki. |
|
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 . |
|
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 |
---|---|
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. |
|
Wymagany** – identyfikator arkusza kalkulacyjnego. | |
Required** – identyfikator arkusza. | |
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.
|
|
Opcjonalnie. Aby uwzględnić ukryte komórki, ustaw wartość true .
Jeśli nie podano tej wartości, przyjmuje się wartość domyślną true . |
|
Opcjonalnie. Aby uwzględnić odfiltrowane komórki, ustaw wartość true .
Jeśli nie podano tej wartości, przyjmuje się wartość domyślną true . |
|
Opcjonalnie. Zakres, np. A1:B52. | |
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 |
---|---|
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. |
|
Wymagany** – URL instancji Lookera. | |
Wymagany** model Lookera. | |
Wymagany** Eksplorowanie Lookera. | |
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 |
---|---|
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. |
|
Wymagany** – adres URL witryny. W przypadku usługi domeny dodaj prefiks sc-domain\: . |
|
Required** (Wymagane) – określa typ tabeli. Może mieć wartość SITE_IMPRESSION lub URL_IMPRESSION . |
|
Wymagane** – określa typ wyszukiwania. Może mieć wartość WEB , IMAGE , VIDEO lub NEWS . |
|
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 ( ). |
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. |
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 URL0B_U5RNpwhcE6SF85TENURnc4UjA
jest identyfikatorem raportu:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
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.
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.
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ą.
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
ir.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.
- Dodano:
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 zasadatype
ma wartośćCUSTOM_QUERY
. - Jeśli
billingProjectId
nie jest skonfigurowany, projekt rozliczeniowy przełączy się naprojectId
lub projekt tabeli, której dotyczy zapytanie. - Dodano obsługę tabel partycjonowanych według daty. Ustaw parametr
isPartitioned
natrue
, 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.
- Pole
- Arkusze Google
hasHeader
przyjmuje domyślnie wartośćtrue
, zgodnie z domyślnym ustawieniem domyślnym w interfejsie internetowym.includeHiddenAndFilteredCell
podzielone naincludeHiddenCells
iincludeFilteredCells
. 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
nasearchType
.
- Zmieniono nazwę parametru
- 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.