Einführung
Die Linking API bietet eine zuverlässige Oberfläche zum Konfigurieren von Looker Studio-Berichten und zum Weiterleiten von Nutzern direkt über eine URL. Wenn Nutzer einer Linking API-URL folgen, können sie ihre Daten schnell aufrufen und mit ihnen interagieren.
In diesem Dokument werden das erforderliche Format von Linking API-URLs und die verfügbaren Parameter beschrieben.
Anwendungsfall und Vorteile
Mit der Linking API können Sie vorkonfigurierte Berichte für Ihre Kunden zur Verfügung stellen, damit diese ihre Daten aufrufen und mit ihnen interagieren können. Dies sind die wichtigsten Vorteile der Linking API:
- Berichte mit nur einem Klick erstellen:
- Die Datenkonfiguration wird in der URL bereitgestellt, sodass Nutzer den Bericht für ihre Daten nicht konfigurieren müssen.
- Nutzer können den Bericht mit nur einem Klick speichern und ihn jederzeit wieder aufrufen.
- Berichte in großem Umfang erstellen Mit der Linking API lässt sich die Zeit für das Duplizieren oder Erstellen neuer Berichte reduzieren.
- Aktivieren Sie Produktintegrationen. Über die stabile Benutzeroberfläche können Sie Looker Studio in einen Produktworkflow einbinden.
Funktionsweise
Im Folgenden wird beschrieben, wie Entwickler und Nutzer mit der Linking API interagieren.
Verknüpfungs-API-Entwickler-Workflow
Der Entwickler bereitet die Berichtsvorlagen und Datenquellen vor und formatiert eine Linking API-URL. Typischer Workflow für Entwickler:
- Entscheiden Sie, ob Sie einen leeren Bericht (die von Looker Studio bereitgestellte Standardberichtsvorlage) verwenden oder einen Looker Studio-Bericht erstellen möchten, der als Vorlage dient. Dazu gehört auch das Konfigurieren der Vorlagendatenquellen.
- Formatieren Sie eine Linking API-URL für Ihren spezifischen Anwendungsfall. Geben Sie gegebenenfalls die Berichtsvorlage und andere Parameter an, einschließlich Berichtsname, Name der Datenquelle und Datenquellenkonfigurationen.
- Verwenden Sie die URL der Linking API, um Nutzer zum Bericht weiterzuleiten.
Nutzerfreundlichkeit der Linking API
Der Nutzer folgt einer Linking API-URL, die bei korrekter Konfiguration vom Entwickler zu einem Looker Studio-Bericht weitergeleitet wird. Dort kann er Daten aufrufen und mit ihnen interagieren, auf die er Zugriff hat. Eine typische User Experience könnte so aussehen:
- In einem Browser ruft der Nutzer einen Dienst auf, der in die Linking API eingebunden ist.
- Mit einem Call-to-Action werden Nutzer dazu eingeladen, auf einen Link zu klicken, um ihre Daten in Looker Studio aufzurufen.
- Der Nutzer klickt auf den Link und wird zu einem Looker Studio-Bericht weitergeleitet. Der Bericht wird geladen und der Nutzer kann seine Daten ansehen und mit ihnen interagieren.
- Der Nutzer klickt auf „Bearbeiten und freigeben“. Der Bericht wird in seinem Looker Studio-Konto gespeichert.
- Der Nutzer hat jetzt vollständigen Zugriff und die Kontrolle über seine eigene Kopie des Berichts. Sie können sie jederzeit ansehen, bearbeiten und freigeben.
Voraussetzungen
Damit eine Linking API-URL wie erwartet funktioniert, ist Folgendes erforderlich:
- Ein Bericht, der als Vorlage dient. Ist dies nicht der Fall, kann ein leerer Bericht oder Standardbericht von Looker Studio verwendet werden.
- Nutzer einer Linking API-URL müssen mindestens Lesezugriff auf die Berichtsvorlage haben. Je nach Typ der im Bericht verwendeten Datenquellen und der über die Linking API bereitgestellten Konfiguration benötigen Nutzer möglicherweise auch Lesezugriff auf Datenquellen. Weitere Informationen finden Sie unter Vorlagenberechtigungen.
- Der Connector-Typ jeder Datenquelle muss die Konfiguration über die Linking API unterstützen. Eine Liste der unterstützten Connectors finden Sie in der Connector-Referenz.
- Nutzer der Linking API-URL müssen Zugriff auf die Daten haben, die in der Linking API-URL konfiguriert sind. Wenn der Nutzer keinen Zugriff auf die zugrunde liegenden Daten hat, wird für alle abhängigen Berichtskomponenten ein Fehler angezeigt.
URL-Parameter
Eine Link-API-URL muss das folgende Format haben:
https://lookerstudio.google.com/reporting/create?parameters
Die URL wird im Kontext eines Webbrowsers verwendet, in der Regel von einem Nutzer, der auf einen Link klickt oder zur URL weitergeleitet wird. Es kann auch zum Einbetten eines Berichts verwendet werden.
Beispiel-URL
Hier sehen Sie ein Beispiel für eine Linking API-URL. Der Berichtsname ist festgelegt und eine einzelne BigQuery-Datenquelle ist konfiguriert:
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
Bestimmte URL-Parameter sind erforderlich, während andere optional sind. Im Folgenden finden Sie eine Liste von Parametern, die zum Definieren einer Linking API-URL verwendet werden:
Parameter der Kontrollgruppe
Steuerparameter bestimmen den Status des Berichts, wenn er über die Linking API-URL aufgerufen wird.
Parametername | Beschreibung |
---|---|
Optional. Die Berichts-ID der Vorlage. Der angegebene Bericht wird in Looker Studio geöffnet. Weitere Informationen zum Ermitteln der ID findest du unter Berichts-ID. Wenn kein Wert angegeben ist, wird ein leerer Bericht oder eine Standardberichtsvorlage verwendet. Weitere Informationen finden Sie unter Leeren oder Standardbericht verwenden. | |
Optional. Die ID der ersten Seite, die im Bericht geladen werden soll. Wenn kein Wert angegeben ist, wird standardmäßig die erste Seite des Berichts verwendet. | |
Optional. Ursprünglicher Berichtsmodus Entweder
view oder
edit . Wenn keine Angabe gemacht wird, wird standardmäßig view verwendet.
|
|
Optional. Die Sichtbarkeit des Info-/Debug-Dialogfelds. Legen Sie true fest, um die Schaltfläche „Dialog“ einzublenden. Wenn kein Wert angegeben ist, wird standardmäßig false verwendet. Weitere Informationen finden Sie unter
Konfigurationsprobleme beheben.
|
Beispiel
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
Berichtsparameter
Berichtsparameter überschreiben die Berichtseigenschaften.
Parametername | Beschreibung |
---|---|
Optional. Legt den Berichtsnamen fest. Wenn kein Wert angegeben ist, wird standardmäßig der Name des Vorlagenberichts verwendet. | |
Optional. Legt die Google Analytics-Mess-IDs zum Messen der Nutzung von Berichten fest. Trennen Sie mehrere IDs durch ein Komma. Wenn |
|
Optional. Legen Sie Wenn |
Beispiel
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
Datenquellenparameter
Mit Datenquellenparametern können Sie die Konfiguration der Datenquelle und die Daten definieren, auf die Datenquellen im Vorlagenbericht zugreifen sollen.
Mit alias
wird auf eine Datenquelle in einem vorhandenen Bericht verwiesen. Die Verwendung eines Alias ermöglicht die Abwärtskompatibilität, wenn eine Datenquelle im Vorlagenbericht hinzugefügt oder daraus entfernt wird.
Weitere Informationen dazu, wie Sie die Datenquelle alias
finden, finden Sie unter Datenquellenalias.
Datenquellenparameter
Die folgenden Parameter gelten für alle Connector-Typen:
Name | Beschreibung |
---|---|
Optional. Legt den Namen der Datenquelle fest. Wenn |
|
Optional. Legen Sie Wenn |
|
Optional.
Der Connector-Typ der Datenquelle. Weitere Informationen zu unterstützten Connector-Typen finden Sie in der Connector-Referenz. Wenn festgelegt, müssen alle erforderlichen Connector-Parameter für den Connector-Typ in der Linking API-URL angegeben werden. Die Konfiguration der Vorlage für die Datenquelle wird dann vollständig ersetzt. Wenn kein Wert angegeben ist, können in der Linking API-URL null oder mehr Connector-Parameter für den Connector-Typ angegeben werden. Parameter, die nicht in der URL der Linking API enthalten sind, werden in der Konfiguration der Datenquelle der Vorlage angegeben. Wie Sie den Connector-Typ der Vorlagendatenquelle identifizieren, erfahren Sie unter Connector-Typ. Weitere Informationen dazu, wie sich der Parameter |
|
Optional.
Legen Sie Legen Sie Wenn nicht angegeben, variieren die Standardeinstellungen je nach Connector-Typ. In der Connector-Referenz finden Sie Connector-spezifische Standardeinstellungen, falls Sie das Standardverhalten überschreiben möchten. Überlegungen bei der Verwendung von
refreshFields :
|
|
Erforderlich. Die Konfiguration der Datenquelle für den Connector-Typ Weitere Informationen dazu, wie Sie den Connector ermitteln, mit dem eine Datenquelle erstellt wurde, finden Sie unter Connector-Typ. Weitere Informationen zu den Datenquellenparametern, die für die einzelnen Connector-Typen verfügbar sind, finden Sie in der Connector-Referenz. |
Ersetzen oder aktualisieren – Datenquellenkonfigurationen
Wenn beim Festlegen von Datenquellenparametern der Parameter ds.connector
in der URL der Linking API vorhanden ist oder fehlt, weist dies darauf hin, dass die Konfiguration der Vorlagendatenquelle entsprechend ersetzt oder aktualisiert werden soll.
In der folgenden Tabelle wird beschrieben, wie sich der Parameter ds.connector
darauf auswirkt, ob die Konfiguration einer Vorlagendatenquelle vollständig ersetzt oder zum Aktualisieren nicht angegebener Parameter verwendet wird:
Ist „ds.connector “ festgelegt? |
Erwartete Konfiguration und erwartetes Verhalten | Typischer Einsatzzweck |
---|---|---|
Ja |
Ersetzen: Die Konfiguration der Vorlage für die Datenquelle wird vollständig ersetzt. Dazu werden die Datenquellenparameter verwendet, die in der URL der Linking API angegeben sind. Sie müssen alle erforderlichen Parameter für den Connector-Typ angeben. Siehe Erforderliche Parameter, wenn ds.connector festgelegt ist.
|
|
Nein | Aktualisieren: Parameter, die nicht in der URL der Linking API enthalten sind, werden in der Konfiguration der Datenquelle der Vorlage angegeben. Sofern nicht anders angegeben, sind alle Connector-Parameter für den Connector-Typ optional.
Das vereinfacht die Linking API-URL und wird in der Regel empfohlen, wenn Sie mit der Konfiguration der Vorlagendatenquelle vertraut sind und nur einen Teil der Parameter überschreiben möchten. |
|
Erforderliche Parameter, wenn ds.connector
festgelegt ist
Wenn der Parameter ds.connector
einer Datenquelle angegeben ist, müssen alle Connector-Parameter, die als Erforderlich gekennzeichnet sind, für die Datenquelle angegeben werden. Wenn der Parameter ds.connector
der Datenquelle nicht angegeben ist, können alle Connector-Parameter – auch die als erforderlich gekennzeichneten – als optional behandelt werden, sofern nicht anders angegeben.
Beispiele
Konfiguriert einen Bericht mit einer einzelnen BigQuery-Datenquelle (ds0
) und ersetzt die Konfiguration der Datenquelle vollständig:
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
Der Datenquellenalias kann weggelassen werden, wenn der Bericht eine einzelne Datenquelle hat. Die obige URL kann so vereinfacht werden:
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
Konfiguriert einen Bericht mit einer einzelnen BigQuery-Datenquelle (ds0
) und aktualisiert nur die Abrechnungsprojekt-ID der Datenquelle:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.billingProjectId=my-billing-project
Mit dieser Richtlinie wird ein Bericht mit zwei Datenquellen konfiguriert: einer BigQuery-Datenquelle (ds0
) und einer Google Analytics-Datenquelle (ds1
). Die Konfiguration der BigQuery-Datenquelle wird vollständig ersetzt, während bei der Google Analytics-Konfiguration ein einzelner Parameter aktualisiert wird und für alle nicht angegebenen Connector-Parameter die Datenquelle der Vorlage ds1
verwendet wird:
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
Erstellen oder hinzufügen
Es kann sinnvoll sein, dieselbe Datenquelle in mehreren Berichten zu verwenden, sodass Aktualisierungen der Datenquelle alle Berichte gemeinsam betreffen. Wenn Sie einen Bericht mit der Linking API erstellen, können Sie eine Datenquelle aus der Berichtsvorlage wieder hinzufügen. Achten Sie darauf, dass die folgenden Bedingungen erfüllt sind:
- Die Datenquelle ist wiederverwendbar (siehe Eingebettete und wiederverwendbare Datenquellen).
- Die URL verweist nicht anhand des Alias auf die Datenquelle.
- In der URL wird kein Platzhalteralias verwendet (siehe Platzhalter für Datenquellenalias).
Wenn eine neue Datenquelle mit der Linking API erstellt wird, werden die Anmeldedaten des Nutzers verwendet, der auf die URL geklickt hat. Das bedeutet, dass der Nutzer Zugriff auf die zugrunde liegenden Daten haben muss, damit die Verbindung funktioniert. Wenn Sie die Datenquelle dem neu erstellten Bericht wieder hinzufügen, bleiben die Anmeldedaten erhalten, sodass Nutzer weiterhin auf Daten in ihren neuen Berichten zugreifen können.
Platzhalter für Datenquellenalias
Wenn Sie einen Linking API-Parameter auf mehrere Datenquellen anwenden möchten, kann anstelle des Datenquellenalias der Platzhalteralias ds.*
verwendet werden.
Dies kann hilfreich sein, wenn Sie sich wiederholende Parameter aus Ihrer URL entfernen möchten. Wenn Sie beispielsweise eine Vorlage mit drei angehängten BigQuery-Datenquellen haben und projectId
und datasetId
in jeder ersetzen, aber tableId
beibehalten möchten, können Sie sie so schreiben:
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
Mit dem Platzhalter ds.*
können Sie auch die folgende entsprechende URL verwenden:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
Parameter, die an die Linking API gesendet werden, aber nicht den Platzhalter ds.*
verwenden, haben Vorrang vor solchen. Im obigen Beispiel können Sie einen bestimmten Datenquellenalias hinzufügen, um den Wert des Platzhalters zu überschreiben.
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
&ds.ds1.datasetId=client-dataset
Im Allgemeinen lautet die Reihenfolge der Parameterpriorität wie folgt:
- Ein Parameter mit einem spezifischen Alias (
ds.ds1.datasetId
) - Ein Parameter, der mit dem Platzhalter (
ds.*.datasetId
) angegeben wird - Ein Wert, der aus der Datenquelle der Vorlage abgeleitet ist, wenn ds.connector nicht angegeben ist (siehe Ersetzen oder aktualisieren)
- Der Standardwert für den Parameter, falls er optional ist.
Connector-Referenz
Die Linking API unterstützt die folgenden Connectors und Konfigurationen. Für jeden Connector ist eine Liste der verfügbaren Datenquellenparameter verfügbar.
BigQuery
Der BigQuery-Connector unterstützt zwei Arten von Abfragen: eine TABLE
-Abfrage, bei der Sie die Tabellen-ID der abzufragenden Tabelle angeben, und einen CUSTOM_QUERY
, in dem Sie eine SQL-Anweisung zum Abfragen einer Tabelle bereitstellen.
TABLE-Abfragen
Die folgenden Parameter sind anwendbar, wenn type
auf TABLE
gesetzt ist und Sie die ID der abzufragenden Tabelle angeben.
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den BigQuery-Connector auf bigQuery fest.Wenn festgelegt, wird die Datenquelle durch die angegebene BigQuery-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Der Abfragetyp. Legen Sie dafür TABLE fest. |
|
Erforderlich** Die Projekt-ID der abzufragenden Tabelle. | |
Erforderlich** Die Dataset-ID der abzufragenden Tabelle. | |
Erforderlich** Die Tabellen-ID der abzufragenden Tabelle. Nach Datum fragmentierte Tabellen: Das Suffix * (Platzhalterzeichen) oder YYYYMMDD wird beim Abfragen von datumsfragmentierten Tabellen unterstützt.Wenn eine Tabelle als Google Analytics, Firebase Analytics oder Firebase Crashlytics identifiziert wird, wird eine Standardvorlage für Felder ausgewählt, sofern keine angegeben ist. Weitere Informationen finden Sie in der Tabelle mit den Parametern der Feldvorlage. |
|
Optional. Die ID des Projekts, das für die Abrechnung verwendet werden soll. Wenn nichts anderes festgelegt ist, wird projectId verwendet. |
|
Optional. Legen Sie dafür true fest, wenn die Tabelle partitioniert ist und Sie die Partitionierungsspalte als Zeitraumdimension verwenden möchten. Dies gilt nur für die zeitbasierte Partitionierung (z.B. Verwendung einer zeitbasierten Partitionierungsspalte oder der Pseudospalte _PARTITIONTIME ) und nicht für nach Ganzzahlbereich partitionierte Tabellen. Wenn kein Wert angegeben ist, wird standardmäßig false verwendet. Weitere Informationen finden Sie unter
Einführung in partitionierte Tabellen. |
|
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true . Weitere Informationen finden Sie unter refreshFields. |
Vorlage für Felder für Google Analytics, Firebase Analytics und Crashlytics
Für Tabellen, die als Google Analytics, Firebase Analytics oder Firebase Crashlytics identifiziert werden, sind zusätzliche Parameter verfügbar, um die Feldvorlage festzulegen. Wenn keine Angabe erfolgt, wird eine Standardvorlage ausgewählt.
Name | Beschreibung |
---|---|
Optional. Die zu verwendende Google Analytics-Feldvorlage. Gilt nur, wenn ein BigQuery-Export für eine Google Analytics-Tabelle abgefragt wird. Mögliche Werte: ALL , SESSION , HITS . Für Google Analytics-Tabellen wird standardmäßig ALL verwendet, falls nicht angegeben. |
|
Optional. Die zu verwendende Firebase Analytics-Feldvorlage. Gilt nur, wenn ein BigQuery-Export für eine Firebase Analytics-Tabelle abgefragt wird.
Kann nur auf EVENTS festgelegt werden. Für Firebase Analytics-Tabellen wird standardmäßig EVENTS verwendet, falls nicht angegeben. |
|
Die zu verwendende Firebase Crashlytics-Feldvorlage. Kann nur auf DEFAULT festgelegt werden. Gilt nur, wenn eine BigQuery-Export für Firebase Crashlytics-Tabelle abgefragt wird. Für Firebase Crashlytics-Tabellen wird standardmäßig DEFAULT verwendet, falls nicht angegeben. |
BENUTZERDEFINIERTE Abfragen
Die folgenden Parameter sind anwendbar, wenn type
auf CUSTOM_QUERY
gesetzt ist und Sie eine SQL-Anweisung zum Abfragen einer Tabelle bereitstellen.
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den BigQuery-Connector auf bigQuery fest.Wenn festgelegt, wird die Datenquelle durch die angegebene BigQuery-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Der Abfragetyp. Legen Sie dafür CUSTOM_QUERY fest. |
|
Erforderlich** Die auszuführende SQL-Abfrage. | |
Optional. Die ID des Projekts, das für die Abrechnung verwendet werden soll. Wenn nichts anderes festgelegt ist, wird projectId verwendet. Wenn projectId nicht festgelegt ist, wird das Projekt der abgefragten Tabelle verwendet. |
|
Optional. Eine durch Kommas getrennte Liste von Muster- und Ersatzstrings, die auf die SQL-Abfrage angewendet werden sollen. Die Stringersetzung wird nur angewendet, wenn eine Musterübereinstimmung besteht. Verwenden Sie ein Komma, um Muster- und Ersatzstringpaare zu trennen. Beispiel: |
|
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true . Weitere Informationen finden Sie unter refreshFields. |
Beispiele
Konfiguration des Typs TABLE
, bei der die Abfrage mit einer Tabellen-ID definiert wird:
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
Eine Konfiguration des Typs TABLE
zum Abfragen einer datumsfragmentierten Tabelle mit dem Platzhalterzeichensuffix:
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_*
Eine Konfiguration des Typs TABLE
zum Abfragen einer datumsfragmentierten Tabelle mit dem Suffix 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
Eine Konfiguration des Typs TABLE
zum Abfragen eines BigQuery Exports für eine Google Analytics-Tabelle mithilfe der Vorlage für SESSION
-Felder:
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
Eine Konfiguration des Typs TABLE
, um eine nach Aufnahmezeit partitionierte Tabelle abzufragen und die Partitionierungsspalte als Zeitraumdimension zu verwenden:
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
Eine Konfiguration des Typs CUSTOM_QUERY
, bei der Abfragen mit einer SQL-Anweisung definiert werden:
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
Konfiguration des Typs CUSTOM_QUERY
, bei der nur die SQL-Anweisung aktualisiert und die Datenquelle der Vorlage für den Rest der Konfiguration verwendet wird:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60
Konfiguration des Typs CUSTOM_QUERY
, bei der die SQL-Anweisung der Vorlagendatenquelle mit sqlReplace
aktualisiert wird:
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
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den Cloud Spanner-Connector auf cloudSpanner fest.Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Cloud Spanner-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Die Projekt-ID. | |
Erforderlich** Die Instanz-ID. | |
Erforderlich** Die Datenbank-ID. | |
Erforderlich** Die auszuführende SQL-Abfrage. | |
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true .
Weitere Informationen finden Sie unter refreshFields. |
Beispiel
Eine Cloud Spanner-Konfiguration mit einer SQL-Anweisung:
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
Community-Connectors
Parametername | Beschreibung |
---|---|
Optional. Legen Sie dafür community für einen Community-Connector fest.Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Community-Connector-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Der Community-Connector connectorId (auch als deploymentId bezeichnet).
| |
Optional. Zusätzliche Connector-spezifische Parameter, die in der Connector-Konfiguration des Community-Connectors definiert sind. | |
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true . Weitere Informationen finden Sie unter refreshFields. |
Beispiel
Stellen Sie eine Verbindung zu einem Community-Connector mit den Konfigurationsparametern state
und city
her:
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
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den Google Analytics-Connector auf googleAnalytics fest.Wenn festgelegt, wird die Datenquelle durch die angegebene Google Analytics-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Die Konto-ID. | |
Erforderlich** Die Property-ID. | |
Die ID der Datenansicht Erforderlich** für Universal Analytics-Properties. Für Google Analytics 4-Properties nicht festlegen. |
|
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert false . Weitere Informationen finden Sie unter refreshFields. |
Beispiele
Eine Google Analytics-Konfiguration für eine Universal Analytics-Property:
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
Eine Google Analytics-Konfiguration für eine Google Analytics 4-Property:
https://lookerstudio.google.com/reporting/create?
c.reportId=789ghi
&ds.ds2.connector=googleAnalytics
&ds.ds2.accountId=54516992
&ds.ds2.propertyId=213025502
Google Cloud Storage
Parametername | Beschreibung |
---|---|
Optional. Legen Sie dafür googleCloudStorage
Google Cloud Storage-Connector fest.Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Google Cloud Storage-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich**: Der Pfadtyp. Verwenden Sie FILE , um eine einzelne Datei auszuwählen, oder FOLDER , um alle Dateien für den angegebenen Pfad auszuwählen. |
|
Erforderlich** Der Dateipfad (z.B. MeinBucket/MeineDaten/MeineDatei.csv), wenn pathType auf FILE gesetzt ist, oder der Ordnerpfad (z.B. *MeinBucket/MeineDaten), wenn pathType den Wert FOLDER hat. |
|
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true .
Weitere Informationen finden Sie unter refreshFields. |
Beispiel
Eine Google Cloud Storage-Konfiguration für eine einzelne Datei:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FILE
&ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv
Eine Google Cloud Storage-Konfiguration für alle Dateien im Pfad:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FOLDER
&ds.ds50.path=MyBucket%2FMyData
Google Tabellen
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den Google Tabellen-Connector auf googleSheets fest.Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Google Tabellen-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Die Tabellen-ID. | |
Erforderlich** Die Arbeitsblatt-ID. | |
Optional. Legen Sie true fest, um die erste Zeile für Kopfzeilen zu verwenden.
Wenn keine Angabe gemacht wird, wird standardmäßig true verwendet. Spaltenüberschriften müssen eindeutig sein. Spalten ohne Kopfzeileneintrag werden nicht zur Datenquelle hinzugefügt.
|
|
Optional. Legen Sie true fest, um ausgeblendete Zellen einzuschließen.
Wenn keine Angabe gemacht wird, wird standardmäßig true verwendet. |
|
Optional. Legen Sie true fest, um gefilterte Zellen einzuschließen.
Wenn keine Angabe gemacht wird, wird standardmäßig true verwendet. |
|
Optional. Bereich, z.B. A1:B52. | |
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true . Weitere Informationen finden Sie unter refreshFields. |
Beispiele
Eine Google Tabellen-Konfiguration:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
Eine Google Tabellen-Konfiguration, bei der die erste Zeile als Kopfzeile verwendet und ausgeblendete und gefilterte Zellen enthalten sind:
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
Eine Google Tabellen-Konfiguration mit einem Bereich (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
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den
Looker-Connector auf looker fest.Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Looker-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Die URL der Looker-Instanz. | |
Erforderlich** Das Looker-Modell. | |
Erforderlich** Das Looker-Explore. | |
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert false . Weitere Informationen finden Sie unter refreshFields. |
Beispiel
Verbindung zu einem Looker-Explore herstellen:
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
Parametername | Beschreibung |
---|---|
Optional. Legen Sie diesen Wert für den Search Console-Connector auf searchConsole fest.Wenn festgelegt, wird die Datenquelle durch die angegebene Search Console-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen oder aktualisieren. |
|
Erforderlich** Die Website-URL. Für eine Domain-Property muss das Präfix sc-domain\: vorangestellt werden. |
|
Erforderlich** Legt den Tabellentyp fest. Kann SITE_IMPRESSION oder URL_IMPRESSION sein. |
|
Erforderlich** Legt den Suchtyp fest. Kann WEB , IMAGE , VIDEO oder NEWS sein. |
|
Optional. Wenn kein Wert angegeben wird, gilt der Standardwert false . Weitere Informationen finden Sie unter refreshFields. |
Beispiel
Eine Search Console-Konfiguration für eine URL-Präfix-Property:
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
Eine Search Console-Konfiguration für eine Domain-Property:
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
Vorlagenberechtigungen
Für eine optimale Nutzererfahrung ist es wichtig, die Zugriffsberechtigungen für Berichte für Ihre Berichtsvorlage und die zugehörigen Datenquellen richtig festzulegen. Welche Berechtigungen erforderlich sind, hängt davon ab, ob die Berichtsvorlage eingebettete oder wiederverwendbare Datenquellen verwendet und ob in der Linking API-Konfiguration die Konfiguration einer Datenquelle ersetzt oder aktualisiert wird.
Die folgende Tabelle enthält den empfohlenen Zugriff auf Datenquellen für eine optimale Nutzererfahrung basierend auf den Vorlagendatenquellen und der Konfiguration der Linking API:
Typ der Datenquelle | Verknüpfungs-API-Konfiguration für Datenquelle | Empfehlung für Berechtigungen für Datenquellen | Hinweise |
---|---|---|---|
Eingebettet | Ersetzen | – – Der Lesezugriff wird vom Bericht übernommen. | Wenn ein Nutzer Lesezugriff auf die Berichtsvorlage hat, erhält er automatisch Lesezugriff auf jede eingebettete Datenquelle. |
Eingebettet | Aktualisieren | – – Der Lesezugriff wird vom Bericht übernommen. | Wenn ein Nutzer Lesezugriff auf die Berichtsvorlage hat, erhält er automatisch Lesezugriff auf jede eingebettete Datenquelle. |
Wiederverwendbar | Ersetzen | Die Nutzer benötigen keinen Lesezugriff. | Da die Konfiguration der Datenquelle vollständig über die Linking API ersetzt wird, ist kein Lesezugriff erforderlich. |
Wiederverwendbar | Aktualisieren | Nutzer benötigen Lesezugriff. | Damit die Linking API die Konfiguration aus der Datenquelle der Vorlage lesen und verwenden kann, ist Lesezugriff auf die Datenquelle erforderlich. Wenn die Nutzer keinen Lesezugriff haben, erhalten sie beim Laden des Berichts eine Fehlermeldung. |
Leeren oder Standardbericht verwenden
Wenn Sie einen leeren Bericht oder den Standardbericht verwenden möchten, konfigurieren Sie die Linking API so:
Berichtstyp | Steuerelementparameter reportId festlegen |
Parameter der Datenquelle ( ) festlegen. |
Hinweise |
---|---|---|---|
Leerer Bericht | Nein | Nein | |
Standardbericht | Nein | Ja | Der Standardbericht wird von Looker Studio bereitgestellt. Bei der Angabe von Datenquellenparametern für den Standardbericht muss kein Datenquellenalias verwendet werden, da der Standardbericht eine einzelne eingebettete Datenquelle hat. |
Die folgenden Beispiele zeigen verschiedene Linking API-URLs, für die ein leerer oder Standardbericht verwendet wird.
So starten Sie den Workflow zur Berichterstellung mit einem leeren Bericht:
https://lookerstudio.google.com/reporting/create
Starten Sie den Workflow zur Berichtserstellung mit einem leeren Bericht und legen Sie den Berichtsnamen fest:
https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport
Verwenden Sie die Standardberichtsvorlage mit einer Google Tabellen-Connector-Konfiguration:
https://lookerstudio.google.com/reporting/create?
ds.connector=googleSheets
&ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
&ds.worksheetId=0
Berichte einbetten
Wenn Sie einen mit der Linking API erstellten Bericht einbetten möchten, legen Sie URL-Parameter fest und fügen Sie den Pfad /embed/
ein. Eine Linking API-Einbettungs-URL muss das folgende Format haben:
https://lookerstudio.google.com/embed/reporting/create?parameters
IDs und Aliasse suchen
Berichts-ID
So finden Sie die Berichts-ID:
- Öffnen Sie den Bericht, den Sie als Vorlage verwenden möchten. Überprüfen Sie die URL des Berichts. Der Teil zwischen
reporting/
und/page
ist die Berichts-ID. In der folgenden URL ist beispielsweise0B_U5RNpwhcE6SF85TENURnc4UjA
die Berichts-ID:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
![Adressleiste des Browsers mit der URL eines Looker Studio-Berichts.
Die Berichts-ID ist markiert.](https://developers.google.cn/static/looker-studio/integrate/images/reportId-parameter.png?authuser=6&hl=de)
Datenquellenalias
Ein Bericht kann mehrere Datenquellen haben. Auf eine Datenquelle sollte mit ihrem Alias verwiesen werden.
So finden Sie einen Datenquellenalias:
- Öffnen Sie den Bericht zum Bearbeiten.
- Wählen Sie in der Symbolleiste Ressource > Hinzugefügte Datenquellen verwalten aus.
- In der Spalte Alias finden Sie Alias-Informationen für jede Datenquelle.
Sie können Aliasnamen bearbeiten, um beim Hinzufügen oder Entfernen einer Datenquelle die Abwärtskompatibilität sicherzustellen.
![Eine Liste der Datenquellen auf der Seite für die Ressourcenverwaltung der Datenquelle.
Die Spalte „Alias“ ist markiert.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-alias.png?authuser=6&hl=de)
Connector-Typ
Ein Bericht kann mehrere Datenquellen enthalten, die jeweils durch Konfigurieren eines Connectors erstellt werden. So finden Sie den Connector-Typ, mit dem eine Datenquelle erstellt wurde:
- Öffnen Sie den Bericht zum Bearbeiten.
- Wählen Sie in der Symbolleiste Ressource > Hinzugefügte Datenquellen verwalten aus.
- Suchen Sie in der Spalte Connector-Typ nach dem Connector, mit dem die Datenquelle erstellt wurde.
![Eine Liste der Datenquellen auf der Seite für die Ressourcenverwaltung der Datenquelle.
Die Spalte „Connector-Typ“ ist markiert.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-connector.png?authuser=6&hl=de)
Tipps und Fehlerbehebung
Wenn Sie Probleme haben, lesen Sie die folgenden Details, um potenzielle Probleme und häufige Fehlkonfigurationen zu identifizieren.
Dialogfeld zur Fehlerbehebung
Im Dialogfeld zur Fehlerbehebung können Sie die Konfiguration der Linking API so prüfen, wie sie von Looker Studio interpretiert wird. Es kann hilfreich sein, Probleme mit der API zu beheben.
- Wenn beim Parsen der URL der Linking API ein Fehler auftritt, wird automatisch ein Dialogfeld mit Details zum Fehler angezeigt.
- Wenn ein Fehler auftritt und kein Dialogfeld automatisch angezeigt wird, suchen Sie nach der Infoschaltfläche oben rechts im Bericht. Klicken Sie hier, um weitere Informationen zur Fehlerbehebung zu erhalten.
- Wenn keine Infoschaltfläche verfügbar ist, kannst du die Schaltfläche aktivieren, indem du den Parameter
&c.explain=true
an das Ende einer Linking API-URL anfügst.
Berechtigungen
Prüfen Sie, ob Sie die richtigen Vorlagenberechtigungen für die Datenquellentypen und die Linking API-Konfiguration festgelegt haben. Weitere Informationen finden Sie unter Vorlagenberechtigungen.
Aktualisieren oder ersetzen
Wenn Sie eine Datenquellenkonfiguration über eine Datenquellenvorlage aktualisieren, prüfen Sie, ob die Konfiguration der Vorlage für die Datenquelle und die Konfiguration der Linking API kompatibel sind. Prüfen Sie, ob die von der neuen Konfiguration zurückgegebenen Felder mit den Berichtskomponenten und der Konfiguration kompatibel sind.
Beim Aktualisieren oder Ersetzen ist es möglich, eine ungültige Konfiguration mit undefiniertem Verhalten festzulegen. Weitere Informationen finden Sie unter Ersetzen und aktualisieren.
Felder aktualisieren
Wenn Sie für eine Vorlage als Datenquelle Feldnamen, Typen oder Zusammenfassungen konfiguriert haben, werden diese Änderungen nur dann auf eine für die Linking API konfigurierte Datenquelle übertragen, wenn der Parameter ds.refreshFields
auf false
gesetzt ist.
Prüfen Sie den Datenquellenparameter ds.refreshFields
der URL der Linking API. Wenn nichts angegeben ist, prüfen Sie, ob der Standardwert des Parameters für jeden Connector-Typ für Ihren Anwendungsfall korrekt ist.
Allgemein gilt: Wenn Sie Felder in der Datenquelle der Vorlage konfiguriert haben und sicher sind, dass neue Datenquellenkonfigurationen über die Linking API immer genau dieselben Felder liefern, wird empfohlen, refreshFields
auf false
festzulegen.
Wenn beispielsweise beim Erstellen einer Berichtsvorlage in Looker Studio ein bestimmtes Datenquellenfeld als Typ Zahl gekennzeichnet wird und Sie es in Jahr ändern, ist diese Änderung der Feldkonfiguration jetzt Teil der Datenquelle der Vorlage. Für jedes Diagramm in der Berichtsvorlage, in dem das korrigierte Feld verwendet wird, wird ein Jahr erwartet. Wenn das Diagramm zeitbasiert ist, wird es andernfalls möglicherweise nicht gerendert. Wenn die Linking API verwendet wird, um eine neue Datenquellenkonfiguration bereitzustellen, die dieselben Felder liefert, gibt es basierend auf dem Wert des Parameters refreshFields
zwei Ergebnisse:
Wenn
true
festgelegt ist, wird die Feldkonfiguration aus der Vorlagendatenquelle nicht übertragen und Diagramme können möglicherweise nicht geladen werden, wenn sie von derselben Feldkonfiguration abhängen (d.h. ein Feld vom Typ Year wird erwartet).Wenn
false
festgelegt ist, wird die Feldkonfiguration aus der Vorlagendatenquelle in die neue Datenquelle übernommen und die Berichtsdiagramme erhalten die gleichen Felder mit derselben Konfiguration und werden erfolgreich geladen.
Feedback und Support
Verwenden Sie den Issue Tracker, um Probleme mit der Verknüpfung mit der API zu melden oder Feedback zu geben. Unter Support finden Sie allgemeine Ressourcen dazu, wie Sie Hilfe erhalten und Fragen stellen.
Änderungsprotokoll
2023-06-06
- Die Berichtsparameter
r.measurementId
undr.keepMeasurementId
wurden hinzugefügt, um die Berichtseinstellung Google Analytics-Mess-IDs zu konfigurieren. ds.keepDatasourceName
wurde hinzugefügt, um die Wiederverwendung des Namens der Vorlagendatenquelle zu steuern.- Der Abschnitt Bericht einbetten wurde hinzugefügt.
- BigQuery-Connector
sqlReplace
wurde hinzugefügt. Hiermit können Sie Muster- und Ersatzstrings angeben, um die SQL-Abfrage der Vorlage für die Datenquelle zu aktualisieren.
2023-05-22
- Der Looker-Connector wird jetzt unterstützt.
- Community-Connectors werden jetzt unterstützt.
2022-11-21
- Leere Berichte können jetzt verwendet werden. Weitere Informationen finden Sie unter Leeren oder Standardbericht verwenden.
- Der Abschnitt
refreshFields
wurde zu Tipps und Fehlerbehebung hinzugefügt.
2022-11-14
- Die Referenz zum Surveys-Connector wurde eingestellt.
2022-06-15
- Betaphase beendet
- Die Integration API wurde in Linking API umbenannt.
- Die Linking API hat die Betaphase.
- Der Steuerungsparameter
pageId
wurde hinzugefügt, um Verknüpfungen zu einer bestimmten Berichtsseite zu ermöglichen. - Der Steuerparameter
mode
wurde hinzugefügt, um den Berichtsstatus beim Laden auf den Modus Anzeigen oder Bearbeiten zu setzen. - Datenquellenkonfigurationen können jetzt vollständig oder teilweise ersetzt werden. Dieses Verhalten hängt davon ab, ob der Parameter
ds.connector
festgelegt ist. Weitere Informationen finden Sie unter Ersetzen und aktualisieren. - Wenn keine Berichtsvorlage mit dem Parameter
c.reportId
bereitgestellt wird, wird jetzt eine Standardvorlage verwendet. - Der Datenquellenparameter
ds.refreshFields
wurde hinzugefügt. So können Sie steuern, ob Datenquellenfelder beim Laden einer Datenquellenkonfiguration aktualisiert werden. - BigQuery-Connector
projectId
ist nicht erforderlich, wenntype
aufCUSTOM_QUERY
gesetzt ist.- Wenn
billingProjectId
nicht festgelegt ist, erfolgt ein Fallback aufprojectId
oder das Projekt der abgefragten Tabelle. - Nach Datum partitionierte Tabellen werden jetzt unterstützt. Legen Sie den Parameter
isPartitioned
auftrue
fest, um das Partitionsfeld als Zeitraumdimension zu verwenden. - Zusätzliche Unterstützung für die Abfrage von nach Datum partitionierten Tabellen mit dem Platzhalterzeichen oder dem Tabellensuffix
YYYYMMDD
. - Unterstützung für die Abfrage von Google Analytics-, Firebase Analytics- oder Crashlytics-Tabellen und die Auswahl einer Feldvorlage wurde hinzugefügt.
- Google Tabellen
- Für
hasHeader
ist standardmäßigtrue
festgelegt, was der Standardeinstellung der Web-UI entspricht. includeHiddenAndFilteredCell
aufgeteilt inincludeHiddenCells
undincludeFilteredCells
: Beide sind jetzt standardmäßig auftrue
gesetzt, was der Standardeinstellung der Web-UI entspricht.
- Für
- Search Console-Connector
- Der Parameter
propertyType
wurde insearchType
umbenannt.
- Der Parameter
- Surveys-Connector
surveyId
akzeptiert jetzt eine einzelne Umfrage-ID oder eine durch Kommas getrennte Liste von Umfrage-IDs.
2021-12-16
- Erste Version der Integration API.
- Sie können Verknüpfungen zu einem vorhandenen Bericht erstellen und einen Berichtsnamen festlegen.
- Es können mehrere Datenquellen konfiguriert und jeder Datenquellenname festgelegt werden.
- Folgende Connector-Typen werden unterstützt: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Tabellen, Google Surveys, Search Console.