Aufgabe „Tabellen – Abrufen“

Mit der Aufgabe Tabellen – Abrufen können Sie einen einzelnen Wertebereich aus einer Google Tabelle lesen und abrufen.

Google Tabellen ist eine der vielen cloudbasierten Produktivitätslösungen in Google Workspace. Mit dieser Funktion können Sie Onlinetabellen mit Funktionen für die Zusammenarbeit in Echtzeit erstellen und bearbeiten.

Hinweise

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie die Aufgabe Tabellen – Abrufen konfigurieren:

  1. Google Sheets API (sheets.googleapis.com) aktivieren.

    Google Sheets API aktivieren

  2. Authentifizierungsprofil erstellen. Apigee Integration verwendet ein Authentifizierungsprofil, um eine Verbindung zu einem Authentifizierungsendpunkt für die Aufgabe Tabellen – Abrufen herzustellen.

    Informationen zum Zuweisen zusätzlicher Rollen oder Berechtigungen für ein Dienstkonto finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

  3. Informieren Sie sich über die gängigen Terminologien, die in Google Tabellen verwendet werden.

Aufgabe „Tabellen – Abrufen“ konfigurieren

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

  4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Aufgaben, um die Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf das Element Tabellen – Abrufen und platzieren Sie es im Integrationsdesigner.
  6. Klicken Sie im Designer auf das Element Tabellen – Abrufen, um den Konfigurationsbereich Tabellen – Abrufen zu öffnen.
  7. Rufen Sie die Authentifizierung auf und wählen Sie ein vorhandenes Authentifizierungsprofil aus, das Sie verwenden möchten.

    Optional. Wenn Sie vor der Konfiguration der Aufgabe kein Authentifizierungsprofil erstellt haben, klicken Sie auf + Neues Authentifizierungsprofil und folgen Sie der Anleitung unter Neues Authentifizierungsprofil erstellen.

  8. Wechseln Sie zu Aufgabeneingabe und konfigurieren Sie die angezeigten Eingabefelder mit der folgenden Tabelle Aufgabeneingabeparameter.

    Änderungen an den Eingabefeldern werden automatisch gespeichert.

Aufgabeneingabeparameter

In der folgenden Tabelle werden die Eingabeparameter der Aufgabe Tabellen – Abrufen beschrieben:

Attribut Datentyp Beschreibung
SpreadsheetId String Die ID Ihrer Tabelle.

Sie finden die ID Ihrer Tabelle über die Web-URL. Beispiel: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

MajorDimension enum (Dimension) Die primäre Kategorie oder Dimension, die angewendet werden soll. Beispiel: ROWS oder COLUMNS.

Standardwert: DIMENSION_UNSPECIFIED

Bereich String Die A1-Notation oder R1C1-Notation des Bereichs, aus dem Werte abgerufen werden sollen.
dateTimeRenderOption enum (DateTimeRenderOption) Gibt an, wie Werte in Bezug auf Datum, Uhrzeit und Dauer in der Ausgabe dargestellt werden.

Standardwert: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) Gibt an, wie die abgerufenen Werte in der Ausgabe dargestellt werden.

Standardwert: FORMATTED_VALUE

Aufgabenausgabe

Die Aufgabe Tabellen – Abrufen gibt die Antwortausgabe zurück, die ein ValueRange-Objekt enthält, das dem angeforderten Bereich entspricht. Das folgende Beispiel zeigt die Ausgabe:

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.

Nächste Schritte

  1. Edges und Edge-Bedingungen hinzufügen
  2. Integration testen und veröffentlichen
  3. Trigger konfigurieren
  4. Aufgabe „Datenabgleich“ hinzufügen
  5. Alle Aufgaben für Google Cloud-Dienste ansehen