Linking API

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:

1. 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.
2. 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.
3. 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:

1. In einem Browser ruft der Nutzer einen Dienst auf, der in die Linking API eingebunden ist.
2. Mit einem Call-to-Action werden Nutzer dazu eingeladen, auf einen Link zu klicken, um ihre Daten in Looker Studio aufzurufen.
3. 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.
4. Der Nutzer klickt auf „Bearbeiten und freigeben“. Der Bericht wird in seinem Looker Studio-Konto gespeichert.
5. 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:

1. Ein Bericht, der als Vorlage dient. Ist dies nicht der Fall, kann ein leerer Bericht oder Standardbericht von Looker Studio verwendet werden.
2. 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.
3. 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.
4. 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.

Hinweis :Die Linking API ändert weder den Datenzugriff noch die Freigabeeinstellungen oder die ursprüngliche Konfiguration der Berichtsvorlage und der Datenquelle.

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

Hinweis: Es wird empfohlen, die URL-Codierung von Parametern zu verwenden. 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 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
c.reportId	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.
c.pageId	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.
c.mode	Optional. Ursprünglicher Berichtsmodus Entweder view oder edit. Wenn keine Angabe gemacht wird, wird standardmäßig view verwendet.
c.explain	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
r.reportName	Optional. Legt den Berichtsnamen fest. Wenn kein Wert angegeben ist, wird standardmäßig der Name des Vorlagenberichts verwendet.
r.measurementId	Optional. Legt die Google Analytics-Mess-IDs zum Messen der Nutzung von Berichten fest. Trennen Sie mehrere IDs durch ein Komma. Wenn r.measurementId und r.keepMeasurementId nicht angegeben sind, ist die Einstellung für den Bericht Google Analytics-Mess-IDs standardmäßig nicht festgelegt. Wenn r.measurementId und r.keepMeasurementId festgelegt sind, hat r.keepMeasurementId beim Festlegen der ID Vorrang.
r.keepMeasurementId	Optional. Legen Sie true fest, um die Berichtsvorlage Google Analytics-Mess-IDs zu verwenden. Wenn kein Wert angegeben ist, wird standardmäßig false verwendet. Wenn r.measurementId und r.keepMeasurementId nicht angegeben sind, ist die Einstellung für den Bericht Google Analytics-Mess-IDs standardmäßig nicht festgelegt. Wenn r.measurementId und r.keepMeasurementId festgelegt sind, hat r.keepMeasurementId beim Festlegen der ID Vorrang.

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.

Hinweis: Wenn die Berichtsvorlage eine einzelne Datenquelle enthält, ist ein Datenquellenalias nicht unbedingt erforderlich. Es wird jedoch empfohlen, den Alias anzugeben, um die Konfigurationen von Datenquellen beim Prüfen einer Linking API-URL und der zugehörigen Datenquellen zu unterscheiden.

Datenquellenparameter

Die folgenden Parameter gelten für alle Connector-Typen:

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 Connector-Typ und den Erstellungszeitpunkt enthält (z. B. Beispiele – 12.12.2021, 22:53 Uhr). Wenn ds.datasourceName und ds.keepDatasourceName festgelegt sind, hat ds.datasourceName beim Festlegen des Namens der Datenquelle Vorrang.
ds.alias.keepDatasourceName	Optional. Legen Sie true fest, um den Namen der Vorlagedatenquelle zu verwenden. Wenn keine Angabe gemacht wird, wird standardmäßig false verwendet. Wenn ds.datasourceName und ds.keepDatasourceName nicht angegeben sind, wird für den Namen der Datenquelle standardmäßig eine Namenskonvention verwendet, die den Connector-Typ und den Erstellungszeitpunkt enthält (z. B. Beispiele – 12.12.2021, 22:53 Uhr). Wenn ds.datasourceName und ds.keepDatasourceName festgelegt sind, hat ds.datasourceName beim Festlegen des Namens der Datenquelle Vorrang.
ds.alias.connector	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 ds.connector darauf auswirkt, ob die Konfiguration einer Vorlagendatenquelle vollständig ersetzt oder zum Aktualisieren nicht angegebener Parameter verwendet wird, finden Sie unter Ersetzen und aktualisieren.
ds.alias.refreshFields	Optional. Legen Sie true fest, um die über die Linking API angegebene Datenquellenkonfiguration zum Aktualisieren von Datenquellenfeldern und zum Aktualisieren von Berichtskomponenten mit neuen Feldauswahlen zu verwenden. true wird in der Regel beim Wechsel des Connector-Typs oder für Connector-Typen angegeben, bei denen eine Konfigurationsänderung andere Felder ergibt (z.B. ändern sich Felder für BigQuery-Datenquellen oft durch andere Tabellenkonfigurationen). Legen Sie false fest, um die Datenquellenfelder unverändert aus dem Vorlagenbericht zu übernehmen. false wird in der Regel angegeben, wenn die neue Datenkonfiguration dieselben Felder liefert und Sie alle Feldänderungen beibehalten möchten, die Sie an der Datenquelle der Vorlage vorgenommen haben. 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: Wenn refreshFields auf false gesetzt ist und die über die Linking API angegebene Konfiguration der Datenquelle andere Felder als die im Vorlagenbericht liefert, wird dem Nutzer wahrscheinlich ein Konfigurationsfehler für die betroffenen Komponenten angezeigt. Änderungen an Feldern in der Datenquelle der Vorlage (z.B. Name, Typ, Zusammenfassung usw.) werden nicht für neue Datenquellen übernommen, wenn refreshFields auf true gesetzt ist. Legen Sie refreshFields auf false fest, um Feldkonfigurationen aus der Vorlagendatenquelle beizubehalten. Berechnete Felder und Parameter, die in Vorlagendatenquellen definiert sind, werden immer in neu erstellte Datenquellen kopiert und sind vom Wert von refreshFields nicht betroffen.
ds.alias.connectorParameters	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.	Wenn Sie den Connector-Typ einer Datenquelle ändern Beispiel: Sie haben in der Berichtsvorlage 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 unbekannte Werte aus der Vorlagendatenquelle verwendet werden.
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.	Wenn Sie nur Parameterwerte angeben möchten, die sich von der Vorlagendatenquelle unterscheiden und die Vorlagendatenquelle für nicht angegebene Connector-Parameter verwendet werden kann. Beispiel: Ändern Sie 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 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:

1. Die Datenquelle ist wiederverwendbar (siehe Eingebettete und wiederverwendbare Datenquellen).
2. Die URL verweist nicht anhand des Alias auf die Datenquelle.
3. 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:

1. Ein Parameter mit einem spezifischen Alias (ds.ds1.datasetId)
2. Ein Parameter, der mit dem Platzhalter (ds.*.datasetId) angegeben wird
3. Ein Wert, der aus der Datenquelle der Vorlage abgeleitet ist, wenn ds.connector nicht angegeben ist (siehe Ersetzen oder 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 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
ds.alias.connector	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.
ds.alias.type	Erforderlich** Der Abfragetyp. Legen Sie dafür 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 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.
ds.alias.billingProjectId	Optional. Die ID des Projekts, das für die Abrechnung verwendet werden soll. Wenn nichts anderes festgelegt ist, wird projectId verwendet.
ds.alias.isPartitioned	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.
ds.alias.refreshFields	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
ds.alias.gaTemplateLevel	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.
ds.alias.firebaseTemplateLevel	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.
ds.alias.crashlyticsTemplateLevel	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
ds.alias.connector	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.
ds.alias.type	Erforderlich** Der Abfragetyp. Legen Sie dafür 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 nichts anderes festgelegt ist, 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 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: stringPattern1,replacementString1, stringPattern2,replacementString2.
ds.alias.refreshFields	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
ds.alias.connector	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.
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. 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.
ds.alias.connectorId	Erforderlich** Der Community-Connector connectorId (auch als deploymentId bezeichnet).
ds.alias.parameters	Optional. Zusätzliche Connector-spezifische 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

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

Hinweis: Für Connectors, die eine abgestufte Konfiguration verwenden, ist keine besondere Behandlung erforderlich.

Google Analytics

Parametername	Beschreibung
ds.alias.connector	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.
ds.alias.accountId	Erforderlich** Die Konto-ID.
ds.alias.propertyId	Erforderlich** Die Property-ID.
ds.alias.viewId	Die ID der Datenansicht Erforderlich** für Universal Analytics-Properties. Für Google Analytics 4-Properties nicht 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 (GA4)-Konfigurationen sind nicht kompatibel, da sie unterschiedliche Dimensionen und Messwerte haben. Das Festlegen einer UA-Konfiguration für eine Datenquelle, die für eine GA4-Property erstellt wurde, funktioniert nicht und umgekehrt. Wenn Ihre Berichtsvorlage mit beiden Properties funktionieren soll, legen Sie den Parameter ds.refreshFields auf true fest.

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. 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.
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. MeinBucket/MeineDaten/MeineDatei.csv), wenn pathType auf FILE gesetzt ist, oder der Ordnerpfad (z.B. *MeinBucket/MeineDaten), wenn pathType den Wert FOLDER hat.
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 Tabellen

Parametername	Beschreibung
ds.alias.connector	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.
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 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.
ds.alias.includeHiddenCells	Optional. Legen Sie true fest, um ausgeblendete Zellen einzuschließen. Wenn keine Angabe gemacht wird, wird standardmäßig true verwendet.
ds.alias.includeFilteredCell	Optional. Legen Sie true fest, um gefilterte Zellen einzuschließen. Wenn keine Angabe gemacht wird, wird standardmäßig true verwendet.
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

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
ds.alias.connector	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.
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

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
ds.alias.connector	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.
ds.alias.siteUrl	Erforderlich** Die Website-URL. Für eine Domain-Property muss das Präfix sc-domain\: vorangestellt werden.
ds.alias.tableType	Erforderlich** Legt den Tabellentyp fest. Kann 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

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 (ds) 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.

Wichtiger Hinweis: Wenn Sie einen leeren oder Standardbericht verwenden, können Sie Kontrollparameter (außer reportId) und Berichtsparameter festlegen.

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:

1. Ö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 beispielsweise 0B_U5RNpwhcE6SF85TENURnc4UjA die Berichts-ID:

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

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

Datenquellenalias

Ein Bericht kann mehrere Datenquellen haben. Auf eine Datenquelle sollte mit ihrem 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 Alias-Informationen für jede Datenquelle.

Sie können Aliasnamen bearbeiten, um beim Hinzufügen oder Entfernen einer Datenquelle die Abwärtskompatibilität sicherzustellen.

Suchen Sie auf der Verwaltungsseite für Datenquellen nach dem Alias der Datenquelle.

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:

1. Öffnen Sie den Bericht zum Bearbeiten.
2. Wählen Sie in der Symbolleiste Ressource > Hinzugefügte Datenquellen verwalten aus.
3. Suchen Sie in der Spalte Connector-Typ nach dem Connector, mit dem die Datenquelle erstellt wurde.

Suchen Sie auf der Verwaltungsseite für Datenquellen nach dem Connector-Typ für die Datenquelle.

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.

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

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 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.
• 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, wenn type auf CUSTOM_QUERY gesetzt ist.
  • Wenn billingProjectId nicht festgelegt ist, erfolgt ein Fallback auf projectId oder das Projekt der abgefragten Tabelle.
  • Nach Datum partitionierte Tabellen werden jetzt unterstützt. Legen Sie den Parameter isPartitioned auf true 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äßig true festgelegt, was der Standardeinstellung der Web-UI entspricht.
  • includeHiddenAndFilteredCell aufgeteilt in includeHiddenCells und
  • includeFilteredCells: Beide sind jetzt standardmäßig auf true gesetzt, was der Standardeinstellung 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.
  • 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.