Linking API

Einführung

Sie bietet eine zuverlässige Schnittstelle für die Konfiguration von Looker Studio-Berichten und die direkte Weiterleitung von Nutzern an die Berichte über eine URL. Nutzer, die einer URL der Linking API folgen, können einfach und schnell auf ihre Daten zugreifen und damit interagieren.

In diesem Dokument wird 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 bereitstellen, damit sie ihre Daten ansehen und damit interagieren können. Die wichtigsten Vorteile der Linking API:

• Berichte mit nur einem Klick erstellen:
  • Die Datenkonfiguration ist in der URL enthalten, sodass Nutzer den Bericht nicht für ihre Daten konfigurieren müssen.
  • Nutzer können den Bericht mit einem einzigen Klick speichern und ihn jederzeit wieder aufrufen.
• Berichte in großem Umfang erstellen: Mit der Linking API lässt sich die Zeit verkürzen, die zum Duplizieren oder Erstellen neuer Berichte erforderlich ist.
• Produktintegrationen aktivieren Mit der stabilen Schnittstelle können Sie Looker Studio in einen Produktworkflow einbinden.

Funktionsweise

Im Folgenden wird beschrieben, wie Entwickler und Nutzer mit der Linking API interagieren.

Entwickler-Workflow für die Linking API

Der Entwickler bereitet die Vorlagenberichte und Datenquellen vor und formatiert eine Linking API-URL. Der typische Workflow für Entwickler sieht so aus:

1. Entscheiden Sie, ob Sie einen leeren Bericht oder die von Looker Studio bereitgestellte Standardberichtsvorlage verwenden oder einen Looker Studio-Bericht erstellen möchten, der als Vorlage dienen soll. Dazu gehört auch das Konfigurieren der Vorlagendatenquellen.
2. Formatieren Sie eine Linking API-URL für Ihren speziellen Anwendungsfall. Geben Sie gegebenenfalls die Berichtsvorlage und andere Parameter an, z. B. den Berichtsnamen, den Namen der Datenquelle und die Konfigurationen der Datenquelle.
3. Verwenden Sie die Linking API-URL, um Nutzer zum Bericht weiterzuleiten.

Nutzerfreundlichkeit der Linking API

Der Nutzer folgt einer URL der Linking API, die ihn, sofern sie vom Entwickler richtig konfiguriert wurde, zu einem Looker Studio-Bericht weiterleitet, in dem er Daten, auf die er Zugriff hat, ansehen und mit ihnen interagieren kann. Ein typischer Ablauf könnte so aussehen:

1. Der Nutzer ruft in einem Browser einen Dienst auf, in den die Linking API eingebunden ist.
2. Mit einem Call-to-Action wird der Nutzer aufgefordert, auf einen Link zu klicken, um seine Daten in Looker Studio aufzurufen.
3. Der Nutzer folgt dem Link und wird zu einem Looker Studio-Bericht weitergeleitet. Der Bericht wird geladen und der Nutzer kann seine Daten ansehen und damit interagieren.
4. Der Nutzer klickt auf „Bearbeiten und freigeben“. Der Bericht wird in seinem Looker Studio-Konto gespeichert.
5. Der Nutzer hat jetzt vollen Zugriff auf seine eigene Kopie des Berichts und kann sie vollständig verwalten. Sie können sie jederzeit ansehen, bearbeiten und teilen.

Voraussetzungen

Damit eine Linking API-URL wie erwartet funktioniert, sind folgende Voraussetzungen erforderlich:

1. Ein Bericht, der als Vorlage dienen soll. Wenn keine Angaben gemacht werden, kann ein leerer Bericht oder ein von Looker Studio bereitgestellter Standardbericht verwendet werden.
2. Nutzer einer Linking API-URL müssen mindestens Lesezugriff auf den Vorlagenbericht haben. Je nach Art 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.
3. Der Connectortyp jeder Datenquelle muss die Konfiguration über die Linking API unterstützen. Eine Liste der unterstützten Connectors finden Sie in der Connector-Referenz.
4. Nutzer der Linking API-URL müssen Zugriff auf die in der Linking API-URL konfigurierten Daten haben. Wenn der Nutzer keinen Zugriff auf die zugrunde liegenden Daten hat, wird in allen abhängigen Berichtskomponenten ein Fehler angezeigt.

Hinweis :Mit der Linking API werden weder der vorhandene Datenzugriff noch die Freigabeeinstellungen oder die ursprünglichen Berichtsvorlagen- und Datenquellenkonfigurationen geändert.

URL-Parameter

Eine Linking API-URL muss das folgende Format haben:

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

Die URL wird normalerweise in einem Webbrowser verwendet, in der Regel durch einen Nutzer, der auf einen Link klickt oder zur URL weitergeleitet wird. Sie kann auch zum Einbetten eines Berichts verwendet werden.

Beispiel-URL

Hier ist 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

Hinweis :Es wird empfohlen, Parameter URL-zu codieren. Weitere Informationen zum Erstellen einer gültigen URL finden Sie unter URL-Codierung.

Bestimmte URL-Parameter sind erforderlich, während andere optional sind. Im Folgenden finden Sie eine Liste der Parameter, die zum Definieren einer Linking API-URL verwendet werden:

Kontrollparameter

Mit Kontrollparametern wird der Status des Berichts festgelegt, wenn er über die Linking API-URL aufgerufen wird.

Parametername	Beschreibung
c.reportId	Optional. Die Berichts-ID der Vorlage. Looker Studio wird geöffnet und der angegebene Bericht wird konfiguriert. Weitere Informationen zum Suchen der ID finden Sie unter Meldungs-ID. Wenn nichts angegeben ist, wird ein leerer Bericht oder eine Standardberichtsvorlage verwendet. Weitere Informationen finden Sie unter Leeren Bericht oder Standardbericht verwenden.
c.pageId	Optional. Die ID der ersten Seite, die im Bericht geladen werden soll. Wenn keine Angabe erfolgt, wird standardmäßig die erste Seite des Berichts verwendet.
c.mode	Optional. Der ursprüngliche Berichtsmodus. Entweder view oder edit. Wenn keine Angabe gemacht wird, ist der Standardwert view.
c.explain	Optional. Die Sichtbarkeit des Info-/Debug-Dialogfelds. Auf true festgelegt, um die Schaltfläche für das Dialogfeld anzuzeigen. Wenn keine Angabe gemacht wird, ist der Standardwert false. 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 Berichtseigenschaften.

Parametername	Beschreibung
r.reportName	Optional. Legt den Berichtsnamen fest. Wenn nicht angegeben, wird standardmäßig der Name des Vorlagenberichts verwendet.
r.measurementId	Optional. Legt die Google Analytics-Mess-IDs auf Nutzung von Berichten erfassen fest. Trennen Sie mehrere IDs durch Kommas. Wenn r.measurementId und r.keepMeasurementId nicht angegeben sind, ist die Berichtseinstellung Google Analytics-Mess-IDs standardmäßig nicht festgelegt. Wenn r.measurementId und r.keepMeasurementId festgelegt sind, hat r.keepMeasurementId Vorrang beim Festlegen der ID.
r.keepMeasurementId	Optional. Auf true festgelegt, um den Vorlagenbericht Google Analytics-Mess-IDs zu verwenden. Wenn keine Angabe gemacht wird, ist der Standardwert false. Wenn r.measurementId und r.keepMeasurementId nicht angegeben sind, ist die Berichtseinstellung Google Analytics-Mess-IDs standardmäßig nicht festgelegt. Wenn r.measurementId und r.keepMeasurementId festgelegt sind, hat r.keepMeasurementId Vorrang beim Festlegen der ID.

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 eine Datenquellenkonfiguration und die Daten definieren, auf die für Datenquellen im Vorlagenbericht zugegriffen werden soll.

Mit einem alias wird auf eine Datenquelle in einem vorhandenen Bericht verwiesen. Durch die Verwendung eines Alias wird die Abwärtskompatibilität gewährleistet, wenn eine Datenquelle dem Vorlagenbericht hinzugefügt oder daraus entfernt wird.

Weitere Informationen zum Suchen einer Datenquelle alias finden Sie unter Alias der Datenquelle.

Hinweis :Wenn der Vorlagenbericht nur eine Datenquelle enthält, ist ein Datenquellenalias nicht unbedingt erforderlich. Die Angabe des Alias wird jedoch empfohlen, um Datenquellenkonfigurationen bei der Überprüfung einer Linking API-URL und der zugehörigen Datenquellen besser zu unterscheiden.

Datenquellenparameter

Die folgenden Parameter sind für alle Connectortypen üblich:

Name	Beschreibung
ds.alias.datasourceName	Optional. Legt den Namen der Datenquelle fest. Wenn ds.datasourceName und ds.keepDatasourceName nicht angegeben sind, wird für den Namen der Datenquelle standardmäßig eine Namenskonvention verwendet, die den Connectortyp und die Erstellungszeit enthält (z. B. samples – 12.12.21, 22:53). Wenn ds.datasourceName und ds.keepDatasourceName festgelegt sind, hat ds.datasourceName Vorrang beim Festlegen des Namens der Datenquelle.
ds.alias.keepDatasourceName	Optional. Legen Sie true fest, um den Namen der Vorlagendatenquelle zu verwenden. Wenn keine Angabe gemacht wird, ist der Standardwert false. Wenn ds.datasourceName und ds.keepDatasourceName nicht angegeben sind, wird für den Namen der Datenquelle standardmäßig eine Namenskonvention verwendet, die den Connectortyp und die Erstellungszeit enthält (z. B. samples – 12.12.21, 22:53). Wenn ds.datasourceName und ds.keepDatasourceName festgelegt sind, hat ds.datasourceName Vorrang beim Festlegen des Namens der Datenquelle.
ds.alias.connector	Optional. Der Connectortyp der Datenquelle. Weitere Informationen zu unterstützten Connector-Typen finden Sie in der Connector-Referenz. Wenn dieser Wert festgelegt ist, müssen alle erforderlichen Connector-Parameter für den Connectortyp in der Linking API-URL angegeben werden. Die Konfiguration der Vorlagendatenquelle wird vollständig ersetzt. Wenn nichts angegeben ist, können in der Linking API-URL null oder mehr Connector-Parameter für den Connectortyp angegeben werden. Mit der Konfiguration der Vorlagendatenquelle werden alle Parameter angegeben, die nicht in der Linking API-URL enthalten sind. Weitere Informationen zum Ermitteln des Connectortyps der Vorlagendatenquelle finden Sie unter Connectortyp. Weitere Informationen dazu, wie sich der Parameter ds.connector darauf auswirkt, ob eine Vorlagendatenquellenkonfiguration vollständig ersetzt oder zum Aktualisieren nicht angegebener Parameter verwendet wird, finden Sie unter Ersetzen im Vergleich zu Aktualisieren.
ds.alias.refreshFields	Optional. Auf true festgelegt, um die Datenquellenkonfiguration zu verwenden, die über die Linking API angegeben wurde, um Datenquellenfelder zu aktualisieren und Berichtskomponenten mit neuen Feldauswahlen zu aktualisieren. true wird in der Regel angegeben, wenn der Verbindungstyp gewechselt wird oder bei Verbindungstypen, bei denen eine Konfigurationsänderung zu anderen Feldern führt (z.B. ändern sich Felder für BigQuery-Datenquellen oft mit unterschiedlichen Tabellenkonfigurationen). Wenn false, bleiben die Datenquellenfelder im Vorlagebericht unverändert. false wird in der Regel angegeben, wenn die neue Datenkonfiguration genau dieselben Felder enthält und Sie alle Feldänderungen beibehalten möchten, die Sie an der Vorlagendatenquelle vorgenommen haben. Wenn nichts angegeben ist, variieren die Standardwerte je nach Connectortyp. In der Connector-Referenz finden Sie connectorspezifische Standardwerte, falls Sie das Standardverhalten überschreiben möchten. Überlegungen bei der Verwendung von refreshFields: Wenn refreshFields auf false festgelegt ist und die Datenquellenkonfiguration, die über die Linking API angegeben wird, andere Felder als die im Vorlagebericht verwendeten enthält, wird dem Nutzer wahrscheinlich ein Konfigurationsfehler für die betroffenen Komponenten angezeigt. Änderungen an Feldern in der Vorlagendatenquelle (z. B. Name, Typ, Zusammenfassung) werden nicht auf neue Datenquellen übertragen, wenn refreshFields auf true festgelegt ist. Setzen Sie refreshFields auf false, um die Feldkonfigurationen aus der Vorlagendatenquelle beizubehalten. Berechnete Felder und Parameter, die in Vorlagendatenquellen definiert sind, werden immer in neu erstellte Datenquellen kopiert und sind nicht vom Wert von refreshFields betroffen.
ds.alias.connectorParameters	Erforderlich. Die Datenquellenkonfiguration für den Connectortyp. Weitere Informationen dazu, wie Sie den Connector ermitteln, der zum Erstellen einer Datenquelle verwendet wurde, finden Sie unter Connectortyp. Details zu den Datenquellenparametern, die für die einzelnen Connectortypen verfügbar sind, finden Sie in der Connector-Referenz.

Ersetzen im Vergleich zu Aktualisieren – Datenquellenkonfigurationen

Beim Festlegen von Datenquellenparametern gibt das Vorhandensein oder Fehlen des Parameters ds.connector in der Linking API-URL an, ob die Konfiguration der Vorlagendatenquelle ersetzt oder aktualisiert werden soll.

In der folgenden Tabelle wird beschrieben, wie sich der Parameter ds.connector darauf auswirkt, ob eine Konfiguration der 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 Vorlagendatenquelle wird vollständig durch die Datenquellenparameter ersetzt, die in der Linking API-URL angegeben sind. Sie müssen alle erforderlichen Parameter für den Connectortyp angeben. Weitere Informationen finden Sie unter Erforderliche Parameter, wenn ds.connector festgelegt ist.	Wenn Sie den Connector-Typ einer Datenquelle ändern. Beispiel: Sie haben im Vorlagenbericht eine BigQuery-Datenquelle konfiguriert, möchten aber eine Google-Tabellen-Datenquelle über die Linking API konfigurieren. Dazu muss eine neue Connector-Konfiguration vollständig definiert werden. Wenn Sie die Konfiguration einer Datenquelle garantieren möchten Durch das Ersetzen der Konfiguration wird verhindert, dass möglicherweise unbekannte Werte aus der Vorlagendatenquelle verwendet werden.
Nein	Aktualisieren Mit der Konfiguration der Vorlagendatenquelle werden alle Parameter angegeben, die nicht in der Linking API-URL enthalten sind. Alle Connector-Parameter für den Connectortyp sind optional, sofern nicht anders angegeben. Dadurch wird die Linking API-URL vereinfacht. Diese Methode wird im Allgemeinen empfohlen, wenn Sie mit der Konfiguration der Vorlagendatenquelle vertraut sind und nur eine Teilmenge der Parameter überschreiben möchten.	Wenn Sie nur Parameterwerte angeben möchten, die sich von der Vorlagendatenquelle unterscheiden, und Sie sich für alle nicht angegebenen Connector-Parameter auf die Vorlagendatenquelle verlassen möchten. Ändern Sie beispielsweise nur die Abrechnungsprojekt-ID einer BigQuery-Datenquellenkonfiguration und verwenden Sie die Vorlagenkonfiguration für alle anderen Parameter.

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 nichts anderes angegeben ist.

Beispiele

Konfiguriert einen Bericht mit einer einzelnen BigQuery-Datenquelle (ds0) und ersetzt die Datenquellenkonfiguration 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 nur eine Datenquelle hat. Die URL oben 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

Konfiguriert einen Bericht mit zwei Datenquellen: 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. Außerdem werden alle nicht angegebenen Connector-Parameter aus der Vorlagendatenquelle ds1 übernommen:

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 manchmal nützlich sein, dieselbe Datenquelle in mehreren Berichten zu verwenden, damit sich Aktualisierungen der Datenquelle auf alle Berichte gleichzeitig auswirken. Wenn Sie einen Bericht mit der Linking API erstellen, können Sie eine Datenquelle aus Ihrem Vorlagenbericht wieder hinzufügen, sofern alle folgenden Bedingungen erfüllt sind:

1. Die Datenquelle ist wiederverwendbar (siehe Eingebettete und wiederverwendbare Datenquellen im Vergleich).
2. In der URL wird nicht per Alias auf die Datenquelle verwiesen.
3. Die URL verwendet keinen Platzhalter-Alias (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, da die Verbindung sonst nicht funktioniert. Wenn Sie die Datenquelle dem neu generierten Bericht wieder hinzufügen, bleiben die Anmeldedaten erhalten und Nutzer können weiterhin auf Daten in ihren neuen Berichten zugreifen.

Wildcard für Datenquellenalias

Wenn Sie einen Linking API-Parameter auf mehrere Datenquellen anwenden möchten, können Sie anstelle des Datenquellenalias den Platzhalteralias ds.* verwenden.

Das kann nützlich sein, um sich wiederholende Parameter aus Ihrer URL zu entfernen. Wenn Sie beispielsweise eine Vorlage mit drei BigQuery-Datenquellen haben und projectId und datasetId in jeder Datenquelle ersetzen, aber tableId beibehalten möchten, können Sie Folgendes 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

Alternativ können Sie mit dem Platzhalter ds.* die folgende URL verwenden:

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

Parameter, die für die Linking API bereitgestellt werden und nicht den ds.*-Platzhalter verwenden, haben Vorrang vor Parametern, die ihn verwenden. Im obigen Beispiel können Sie einen bestimmten Alias für die Datenquelle 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 gilt folgende Reihenfolge der Parameterpriorität:

1. Ein Parameter mit einem bestimmten Alias (ds.ds1.datasetId)
2. Ein Parameter, der mit dem Platzhalter (ds.*.datasetId) angegeben wird
3. Ein Wert, der aus der Vorlagendatenquelle abgeleitet wird, wenn „ds.connector“ nicht angegeben ist (siehe Ersetzen im Vergleich zu Aktualisieren)
4. 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 wird die Liste der verfügbaren Datenquellenparameter bereitgestellt.

BigQuery

Der BigQuery-Connector unterstützt zwei Arten von Abfragen: TABLE, bei der Sie die Tabellen-ID der abzufragenden Tabelle angeben, und CUSTOM_QUERY, bei der Sie eine SQL-Anweisung zum Abfragen einer Tabelle angeben.

TABLE-Abfragen

Die folgenden Parameter gelten, wenn type auf TABLE festgelegt ist und Sie die ID der abzufragenden Tabelle angeben.

Parametername	Beschreibung
ds.alias.connector	Optional. Auf bigQuery für den BigQuery-Connector festgelegt.  Falls festgelegt, wird die Datenquelle durch die bereitgestellte BigQuery-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.type	Erforderlich** Der Typ der Anfrage. Legen Sie TABLE fest.
ds.alias.projectId	Erforderlich** Die Projekt-ID der abzufragenden Tabelle.
ds.alias.datasetId	Erforderlich**: Die Dataset-ID der abzufragenden Tabelle.
ds.alias.tableId	Erforderlich** Die Tabellen-ID der Tabelle, die abgefragt werden soll. Nach Datum partitionierte Tabellen: Das * (Platzhalterzeichen) oder das Suffix YYYYMMDD wird bei der Abfrage von nach Datum partitionierten Tabellen unterstützt. Wenn eine Tabelle als Google Analytics-, Firebase Analytics- oder Firebase Crashlytics-Tabelle identifiziert wird, wird eine Standardvorlage für Felder ausgewählt, sofern keine angegeben ist. Weitere Informationen finden Sie in der Tabelle Felder-Vorlage.
ds.alias.billingProjectId	Optional. Die ID des Projekts, das für die Abrechnung verwendet werden soll. Wenn nicht festgelegt, wird projectId verwendet.
ds.alias.isPartitioned	Optional. Auf true setzen, wenn die Tabelle partitioniert ist und Sie die Partitionierungsspalte als Zeitraumdimension verwenden möchten. Dies gilt nur für die zeitbasierte Partitionierung (z.B. mit einer zeitbasierten Partitionierungsspalte oder der Pseudospalte _PARTITIONTIME) und funktioniert nicht für nach Ganzzahlbereich partitionierte Tabellen. Wenn keine Angabe gemacht wird, ist der Standardwert false. Weitere Informationen finden Sie unter Einführung in partitionierte Tabellen.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true. Weitere Informationen finden Sie unter refreshFields.

Feldvorlage 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 Vorlage für Felder festzulegen. Wenn nichts angegeben ist, wird eine Standardvorlage ausgewählt.

Name	Beschreibung
ds.alias.gaTemplateLevel	Optional. Die Vorlage für Google Analytics-Felder, die verwendet werden soll. Gilt nur, wenn eine BigQuery Export für Google Analytics-Tabelle abgefragt wird. Einer der folgenden Werte: ALL, SESSION, HITS. Bei Google Analytics-Tabellen ist der Standardwert ALL, wenn nichts angegeben ist.
ds.alias.firebaseTemplateLevel	Optional. Die Vorlage für Firebase Analytics-Felder, die verwendet werden soll. Gilt nur, wenn eine BigQuery Export für Firebase Analytics-Tabelle abgefragt wird. Kann nur auf EVENTS gesetzt werden. Bei Firebase Analytics-Tabellen ist der Standardwert EVENTS, wenn keine Angabe gemacht wird.
ds.alias.crashlyticsTemplateLevel	Die zu verwendende Firebase Crashlytics-Feldvorlage. Kann nur auf DEFAULT gesetzt werden. Gilt nur, wenn eine BigQuery-Exporttabelle für Firebase Crashlytics abgefragt wird. Bei Firebase Crashlytics-Tabellen wird standardmäßig DEFAULT verwendet, wenn keine Angabe erfolgt.

CUSTOM-Abfragen

Die folgenden Parameter gelten, wenn type auf CUSTOM_QUERY festgelegt ist und Sie eine SQL-Anweisung zum Abfragen einer Tabelle angeben.

Parametername	Beschreibung
ds.alias.connector	Optional. Auf bigQuery für den BigQuery-Connector festgelegt.  Falls festgelegt, wird die Datenquelle durch die bereitgestellte BigQuery-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.type	Erforderlich** Der Typ der Anfrage. Legen Sie CUSTOM_QUERY fest.
ds.alias.sql	Erforderlich** Die auszuführende SQL-Abfrage.
ds.alias.billingProjectId	Optional. Die ID des Projekts, das für die Abrechnung verwendet werden soll. Wenn nicht festgelegt, wird projectId verwendet. Wenn projectId nicht festgelegt ist, wird das Projekt der abgefragten Tabelle verwendet.
ds.alias.sqlReplace	Optional. Eine durch Kommas getrennte Liste von Muster- und Ersetzungs-Strings, die auf die SQL-Abfrage angewendet werden sollen. Der String-Ersatz wird nur angewendet, wenn es eine Musterübereinstimmung gibt. Trennen Sie die Paare aus Muster und Ersetzungsstring durch Kommas. Beispiel: stringPattern1,replacementString1, stringPattern2,replacementString2.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true. Weitere Informationen finden Sie unter refreshFields.

Beispiele

Eine TABLE-Konfiguration, in 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 TABLE-Konfiguration zum Abfragen einer nach Datum partitionierten Tabelle mit dem Platzhalterzeichen-Suffix:

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 TABLE-Konfiguration zum Abfragen einer nach Datum partitionierten 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 vom Typ TABLE zum Abfragen einer BigQuery Export-Tabelle für Google Analytics mit 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 TABLE-Konfiguration zum Abfragen einer nach Aufnahmezeit partitionierten Tabelle und zum Verwenden der Partitionierungsspalte als Zeitraumdimension:

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 vom Typ CUSTOM_QUERY, bei der die Abfrage mit einer SQL-Anweisung definiert wird:

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

Eine CUSTOM_QUERY-Typkonfiguration, bei der nur die SQL-Anweisung aktualisiert wird und die Vorlagendatenquelle 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

Eine Konfiguration vom Typ 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
ds.alias.connector	Optional. Auf cloudSpanner für den Cloud Spanner-Connector festgelegt.  Falls festgelegt, wird die Datenquelle durch die bereitgestellte Cloud Spanner-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.projectId	Erforderlich** Die Projekt-ID.
ds.alias.instanceId	Erforderlich** Die Instanz-ID.
ds.alias.databaseId	Erforderlich**: Die Datenbank-ID.
ds.alias.sql	Erforderlich** Die auszuführende SQL-Abfrage.
ds.alias.refreshFields	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
ds.alias.connector	Optional. Auf community für einen Community Connector festlegen. Wenn festgelegt, wird die Datenquelle durch die angegebene Community Connector-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.connectorId	Erforderlich** Der Community Connector connectorId (auch als deploymentId> bezeichnet).
ds.alias.parameters	Optional. Zusätzliche connectorspezifische Parameter, die in der Connector-Konfiguration des Community-Connectors definiert sind.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true. Weitere Informationen finden Sie unter refreshFields.

Beispiel

So stellen Sie eine Verbindung zu einem Community-Connector mit state- und city-Konfigurationsparametern 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

Hinweis :Für Connectors, die eine schrittweise Konfiguration verwenden, ist keine spezielle Verarbeitung erforderlich.

Google Analytics

Parametername	Beschreibung
ds.alias.connector	Optional. Auf googleAnalytics für den Google Analytics-Connector festgelegt.  Falls festgelegt, wird die Datenquelle durch die angegebene Google Analytics-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.accountId	Erforderlich** Die Konto-ID.
ds.alias.propertyId	Erforderlich** Die Property-ID.
ds.alias.viewId	Die Datenansichts-ID. Erforderlich** für Universal Analytics-Properties. Nicht für Google Analytics 4-Properties festlegen.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert false. Weitere Informationen finden Sie unter refreshFields.

Hinweis :Universal Analytics- (UA) und Google Analytics 4-Konfigurationen (GA4) sind nicht kompatibel, da sie unterschiedliche Dimensionen und Messwerte enthalten. Das Festlegen einer UA-Konfiguration für eine Datenquelle, die für eine GA4-Property erstellt wurde, funktioniert nicht und umgekehrt. Sie können den Parameter ds.refreshFields auf true setzen, wenn Ihre Berichtsvorlage mit beiden Property-Typen funktionieren soll.

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
ds.alias.connector	Optional. Auf googleCloudStorage Google Cloud Storage-Connector festgelegt.  Falls festgelegt, wird die Datenquelle durch die angegebene Google Cloud Storage-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.pathType	Erforderlich** Der Pfadtyp. Verwenden Sie FILE, um eine einzelne Datei auszuwählen, oder FOLDER, um alle Dateien für den angegebenen Pfad auszuwählen.
ds.alias.path	Erforderlich** Der Dateipfad (z.B. MyBucket/MyData/MyFile.csv), wenn pathType FILE ist, oder der Ordnerpfad (z.B. *MyBucket/MyData), wenn pathType FOLDER ist.
ds.alias.refreshFields	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 Sheets

Parametername	Beschreibung
ds.alias.connector	Optional. Auf googleSheets für den Google Sheets-Connector festgelegt.  Wenn festgelegt, wird die Datenquelle durch die angegebene Google Sheets-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.spreadsheetId	Erforderlich** Die Tabellen-ID.
ds.alias.worksheetId	Erforderlich** Die Arbeitsblatt-ID.
ds.alias.hasHeader	Optional. Legen Sie true fest, um die erste Zeile als Kopfzeile zu verwenden. Wenn keine Angabe gemacht wird, ist der Standardwert true. Spaltenüberschriften müssen eindeutig sein. Spalten ohne Kopfzeileneintrag werden nicht zur Datenquelle hinzugefügt.
ds.alias.includeHiddenCells	Optional. Legen Sie true fest, um ausgeblendete Zellen einzuschließen. Wenn keine Angabe gemacht wird, ist der Standardwert true.
ds.alias.includeFilteredCell	Optional. Auf true setzen, um gefilterte Zellen einzuschließen. Wenn keine Angabe gemacht wird, ist der Standardwert true.
ds.alias.range	Optional. Bereich, z.B. A1:B52.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert true. Weitere Informationen finden Sie unter refreshFields.

Beispiele

Google Sheets-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 Überschriften verwendet wird 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 Sheets-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
ds.alias.connector	Optional. Auf looker für den Looker-Connector festgelegt.  Wenn festgelegt, wird die Datenquelle durch die bereitgestellte Looker-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.instanceUrl	Erforderlich**: Die URL der Looker-Instanz.
ds.alias.model	Erforderlich**: Das Looker-Modell.
ds.alias.explore	Erforderlich** Das Looker-Explore.
ds.alias.refreshFields	Optional. Wenn kein Wert angegeben wird, gilt der Standardwert false. Weitere Informationen finden Sie unter refreshFields.

Beispiel

So stellen Sie eine Verbindung zu einem Looker-Explore her:

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
ds.alias.connector	Optional. Legen Sie searchConsole für den Search Console-Connector fest.  Wenn festgelegt, wird die Datenquelle durch die angegebene Search Console-Konfiguration ersetzt. Weitere Informationen finden Sie unter Ersetzen und Aktualisieren.
ds.alias.siteUrl	Erforderlich** Die Website-URL. Bei einer Domain-Property stellen Sie sc-domain\: voran.
ds.alias.tableType	Erforderlich** Legt den Tabellentyp fest. Kann entweder SITE_IMPRESSION oder URL_IMPRESSION sein.
ds.alias.searchType	Erforderlich**: Legt den Suchtyp fest. Kann WEB, IMAGE, VIDEO oder NEWS sein.
ds.alias.refreshFields	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

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

Damit Nutzer die bestmögliche Erfahrung haben, ist es wichtig, die Berechtigungen für den Berichtszugriff für Ihren Vorlagenbericht und die zugehörigen Datenquellen richtig festzulegen. Die erforderlichen Berechtigungen hängen davon ab, ob in der Berichtsvorlage eingebettete oder wiederverwendbare Datenquellen verwendet werden und ob die Linking API-Konfiguration so eingestellt ist, dass eine Datenquellenkonfiguration ersetzt oder aktualisiert wird.

In der folgenden Tabelle finden Sie den empfohlenen Zugriff auf Datenquellen für eine optimale Nutzererfahrung basierend auf den Vorlagendatenquellen und der Linking API-Konfiguration:

Typ der Datenquelle	Linking API-Konfiguration für Datenquelle	Empfehlung für Berechtigungen für Datenquellen	Hinweise
Eingebettet	Ersetzen	Nicht zutreffend – Der Zugriff auf die Datenansicht wird vom Bericht übernommen.	Wenn ein Nutzer Ansichtszugriff auf den Vorlagenbericht hat, hat er automatisch Ansichtszugriff auf alle eingebetteten Datenquellen.
Eingebettet	Aktualisieren	Nicht zutreffend – Der Zugriff auf die Datenansicht wird vom Bericht übernommen.	Wenn ein Nutzer Ansichtszugriff auf den Vorlagenbericht hat, hat er automatisch Ansichtszugriff auf alle eingebetteten Datenquellen.
Wiederverwendbar	Ersetzen	Nutzer benötigen keinen Lesezugriff.	Da die Datenquellenkonfiguration vollständig über die Linking API ersetzt wird, ist kein Ansichtszugriff erforderlich.
Wiederverwendbar	Aktualisieren	Nutzer benötigen Lesezugriff.	Für die Linking API ist der Ansichtszugriff auf die Datenquelle erforderlich, damit die Konfiguration aus der Vorlagendatenquelle gelesen und verwendet werden kann. Wenn Nutzer keinen Lesezugriff haben, erhalten sie beim Laden des Berichts eine Fehlermeldung.

Leeren Bericht oder Standardbericht verwenden

Wenn Sie einen leeren Bericht oder den Standardbericht verwenden möchten, konfigurieren Sie die Linking API so:

Berichtstyp	Legen Sie den Kontrollparameter reportId fest.	Legen Sie die Parameter für die Datenquelle (ds) fest.	Hinweise
Leerer Bericht	Nein	Nein
Standardbericht	Nein	Ja	Der Standardbericht wird von Looker Studio bereitgestellt. Sie müssen keinen Alias für die Datenquelle verwenden, wenn Sie Datenquellenparameter für den Standardbericht angeben, da dieser nur eine eingebettete Datenquelle hat.

Wichtiger Hinweis :Steuerparameter, mit Ausnahme von reportId, und Berichtsparameter können festgelegt werden, wenn Sie einen leeren oder Standardbericht verwenden.

Die folgenden Beispiele zeigen verschiedene Linking API-URLs, die einen leeren oder Standardbericht verwenden.

So starten Sie den Workflow zum Erstellen von Berichten mit einem leeren Bericht:

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

Startet den Workflow zum Erstellen von Berichten mit einem leeren Bericht und legt den Namen des Berichts fest:

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

Standardberichtsvorlage mit einer Google Sheets-Connector-Konfiguration verwenden:

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 Einbettungs-URL für die Linking API muss das folgende Format haben:

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

IDs und Aliase finden

Berichts-ID

So finden Sie die Berichts-ID:

1. Öffnen Sie den Bericht, den Sie als Vorlage verwenden möchten. Prüfen Sie die URL des Berichts. Der Teil zwischen reporting/ und /page ist die Berichts-ID. In der folgenden URL ist 0B_U5RNpwhcE6SF85TENURnc4UjA beispielsweise die Berichts-ID:

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

Die Berichts-ID finden Sie in der Berichts-URL.

Datenquellenalias

Ein Bericht kann mehrere Datenquellen haben. Auf eine Datenquelle sollte über ihren Alias verwiesen werden.

So finden Sie einen Datenquellenalias:

1. Öffnen Sie den Bericht zum Bearbeiten.
2. Wählen Sie in der Symbolleiste Ressource > Hinzugefügte Datenquellen verwalten aus.
3. In der Spalte Alias finden Sie Aliasinformationen für jede Datenquelle.

Sie können Aliasnamen bearbeiten, um die Abwärtskompatibilität zu gewährleisten, wenn eine Datenquelle hinzugefügt oder entfernt wird.

Suchen Sie auf der Seite Datenquellen verwalten nach dem Alias der Datenquelle.

Connector-Typ

Ein Bericht kann mehrere Datenquellen haben, die jeweils durch Konfigurieren eines Connectors erstellt werden. So finden Sie den Connectortyp, der zum Erstellen einer Datenquelle verwendet wurde:

1. Öffnen Sie den Bericht zum Bearbeiten.
2. Wählen Sie in der Symbolleiste Ressource > Hinzugefügte Datenquellen verwalten aus.
3. Sehen Sie sich die Spalte Connector Type an, um den Connector zu ermitteln, der zum Erstellen einer Datenquelle verwendet wurde.

Den Datenquellen-Connectortyp finden Sie auf der Verwaltungsseite Datenquellen.

Tipps und Fehlerbehebung

Wenn Probleme auftreten, finden Sie unten Details zu potenziellen Problemen und häufigen Fehlkonfigurationen.

Dialogfeld zur Fehlerbehebung

Im Debugging-Dialogfeld können Sie die Konfiguration der Linking API ansehen, wie sie von Looker Studio interpretiert wird. Dies kann bei der Fehlerbehebung von Problemen mit der API hilfreich sein.

• Wenn beim Parsen der Linking API-URL ein Fehler auftritt, wird automatisch ein Dialogfeld mit Details zum Fehler angezeigt.
• Wenn ein Fehler auftritt und kein Dialogfeld automatisch angezeigt wird, suchen Sie oben rechts im Bericht nach der Infoschaltfläche. Klicken Sie hier, um zusätzliche Debugging-Informationen zu erhalten.

  

• Wenn keine Infoschaltfläche verfügbar ist, können Sie sie aktivieren, indem Sie den Parameter &c.explain=true an das Ende einer beliebigen Linking API-URL anhängen.

Berechtigungen

Prüfen Sie, ob die richtigen Vorlagenberechtigungen für die Datenquellentypen und die Linking API-Konfiguration festgelegt sind. Weitere Informationen finden Sie unter Vorlagenberechtigungen.

Aktualisieren oder ersetzen

Wenn Sie die Konfiguration einer Datenquelle über eine Datenquellenvorlage aktualisieren, prüfen Sie die Konfiguration der Vorlagendatenquelle und die Linking API-Konfiguration, um sicherzustellen, dass sie kompatibel sind. Prüfen Sie, ob die Felder, die aus der neuen Konfiguration stammen, mit den Berichtskomponenten und der Konfiguration kompatibel sind.

Beim Aktualisieren im Vergleich zum 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 Feldnamen, ‑typen oder ‑aggregationen für eine Vorlagendatenquelle konfiguriert haben, werden diese Änderungen nur auf eine mit der Linking API konfigurierte Datenquelle übertragen, wenn der Parameter ds.refreshFields auf false festgelegt ist.

Überprüfen Sie den Datenquellenparameter ds.refreshFields Ihrer Linking API-URL. Wenn Sie ihn weglassen, prüfen Sie, ob der Standardwert des Parameters für jeden Connectortyp für Ihren Anwendungsfall richtig ist.

Wenn Sie Felder in der Vorlagendatenquelle konfiguriert haben und sicher sind, dass neue Datenquellenkonfigurationen über die Linking API immer genau dieselben Felder ergeben, empfiehlt es sich, refreshFields auf false festzulegen.

Wenn Looker Studio beispielsweise beim Erstellen einer Berichtsvorlage ein bestimmtes Datenquellenfeld als Typ Number (Zahl) identifiziert und Sie es in den Typ Year (Jahr) ändern, ist diese Änderung der Feldkonfiguration jetzt Teil der Vorlagendatenquelle. Für alle Diagramme in der Berichtsvorlage, in denen das korrigierte Feld verwendet wird, ist ein Jahr erforderlich. Andernfalls werden zeitbasierte Diagramme möglicherweise nicht gerendert. Wenn die Linking API verwendet wird, um eine neue Datenquellenkonfiguration bereitzustellen, die genau dieselben Felder enthält, gibt es zwei mögliche Ergebnisse, je nach Wert des Parameters refreshFields:

• Wenn diese Option auf true festgelegt ist, wird die Feldkonfiguration der Vorlagendatenquelle nicht übernommen. Diagramme, die auf derselben Feldkonfiguration basieren (z. B. ein Feld vom Typ Jahr), werden dann möglicherweise nicht geladen.

• Wenn diese Option auf false festgelegt ist, wird die Feldkonfiguration aus der Vorlagendatenquelle in die neue Datenquelle übernommen. Die Berichtsdiagramme enthalten dann dieselben Felder mit derselben Konfiguration und werden erfolgreich geladen.

Wichtiger Hinweis :Berechnete Felder und Parameter, die in Vorlagendatenquellen definiert sind, werden immer in neu erstellte Datenquellen übernommen und sind nicht vom Wert von refreshFields betroffen.

Feedback und Support

Wenn Sie Probleme mit der Linking API melden oder Feedback geben möchten, nutzen Sie dafür bitte den Issue Tracker. Unter Support finden Sie allgemeine Ressourcen, mit denen Sie Hilfe erhalten und Fragen stellen können.

Änderungsprotokoll

2023-06-06

• Die Berichtsparameter r.measurementId und r.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.
• Abschnitt Bericht einbetten hinzugefügt.
• BigQuery-Connector
  • sqlReplace wurde hinzugefügt. Hiermit können Sie Muster- und Ersetzungsstrings angeben, um die SQL-Abfrage der Vorlagendatenquelle zu aktualisieren.

2023-05-22

• Unterstützung für den Looker-Connector hinzugefügt.
• Unterstützung für Community-Connectors hinzugefügt.

2022-11-21

• Es ist jetzt möglich, einen leeren Bericht zu verwenden. Leeren Bericht oder Standardbericht verwenden
• Der Abschnitt refreshFields wurde zu Tipps und Fehlerbehebung hinzugefügt.

2022-11-14

• Die Connector-Referenz für Google Surveys wurde aufgrund der Einstellung von Google Surveys entfernt.

2022-06-15

• Betaphase beendet
  • Die Integration API wurde in Linking API umbenannt.
  • Die Linking API ist nicht mehr in der Betaphase.
• Der Steuerparameter pageId wurde hinzugefügt, um die Verlinkung mit einer bestimmten Berichtsseite zu ermöglichen.
• Der Steuerparameter mode wurde hinzugefügt, um den Berichtsstatus beim Laden auf Anzeigen oder Bearbeiten festzulegen.
• Konfigurationen von Datenquellen können jetzt vollständig ersetzt oder teilweise aktualisiert 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 angegeben wird, wird jetzt eine Standardvorlage verwendet.
• Der Datenquellenparameter ds.refreshFields wurde hinzugefügt. So können Sie festlegen, ob Datenquellenfelder beim Laden einer Datenquellenkonfiguration aktualisiert werden sollen.
• BigQuery-Connector
  • projectId ist nicht erforderlich, wenn type auf CUSTOM_QUERY festgelegt ist.
  • Wenn billingProjectId nicht festgelegt ist, wird als Abrechnungsprojekt projectId oder das Projekt der abgefragten Tabelle verwendet.
  • Unterstützung für nach Datum partitionierte Tabellen hinzugefügt. Setzen Sie den Parameter isPartitioned auf true, um das Partitionierungsfeld als Zeitraumdimension zu verwenden.
  • Es wurde Unterstützung für das Abfragen von nach Datum partitionierten Tabellen mit dem Platzhalterzeichen oder dem Tabellensuffix YYYYMMDD hinzugefügt.
  • Unterstützung für das Abfragen von Google Analytics-, Firebase Analytics- oder Crashlytics-Tabellen und das Auswählen einer Feldvorlage wurde hinzugefügt.
• Google Sheets
  • hasHeader ist standardmäßig auf true eingestellt, was der Standardeinstellung der Web-UI entspricht.
  • includeHiddenAndFilteredCell in includeHiddenCells und
  • includeFilteredCells. Beide verwenden jetzt standardmäßig true, was dem Standardwert der Web-UI entspricht.
• Search Console-Connector
  • Der Parameter propertyType wurde in searchType umbenannt.
• 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.
  • Unterstützt das Verknüpfen mit einem vorhandenen Bericht und das Festlegen des Berichtsnamens.
  • Es können mehrere Datenquellen konfiguriert und für jede Datenquelle ein Name festgelegt werden.
  • Unterstützung für die folgenden Connectortypen: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Sheets, Google Surveys, Search Console.