> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/b2b-enrichment/g2.md).
# G2
Integrieren Sie Ihren Workflow mit G2
Der G2-Integrationsschritt ermöglicht es Ihnen, Ihre AirOps-Workflows direkt mit Ihrem G2-Konto zu verbinden. Diese Integration ermöglicht es Ihnen, Produktdaten, Bewertungen und Umfragefragen programmgesteuert von G2 abzurufen.
{% hint style="info" %}
Diese Integration verbindet sich mit G2s **Data API**, die ein separates, kostenpflichtiges G2-Produkt ist. Sie ist nicht dasselbe wie die öffentliche Website g2.com und gibt nur die Produkte zurück, auf die Ihr G2-Konto lizenzierten Zugriff hat. Ein Produkt auf g2.com finden zu können bedeutet nicht, dass es über die API verfügbar ist. Wenn Ihr G2-Tarif keinen Zugriff auf die Data API umfasst oder Ihrem Konto keine Produkte zugeordnet sind, geben Aktionen keine Ergebnisse zurück. Bestätigen Sie Ihren Zugriff mit Ihrem G2-Administrator.
{% endhint %}
## So konfigurieren Sie den G2-Integrationsschritt
### Authentifizierung
Bevor Sie die G2-Integration in Ihren Workflows verwenden, müssen Sie zuerst Ihr G2-Konto in den AirOps-Einstellungen verbinden:
1. Öffnen **Einstellungen → Integrationen**.
2. Suchen Sie den **G2** Bereich und klicken Sie auf **Konfigurieren**.
3. Schließen Sie den OAuth-Authentifizierungsprozess ab, indem Sie AirOps die erforderlichen Berechtigungen gewähren.
### MCP-Konnektoren und Playbooks
Sie können G2 auch über **Einstellungen → MCP-Connectoren** und in Playbooks verwenden. AirOps verwendet für den standardmäßigen Connector-Flow seine OAuth-App.
1. Öffnen **Einstellungen → MCP-Connectoren** und verbinden **G2**.
2. Öffne den Playbook-Editor.
3. Öffnen Sie das **Tools** Bereich und aktivieren Sie **G2**.
4. Beschreiben Sie, welche G2-Bewertungsdaten das Playbook während des Inhalts-Erstellungsdurchlaufs verwenden soll.
Verwenden Sie Ihre eigene G2-OAuth-App
Wenn Ihr Team seine eigene OAuth-App mit eingeschränkten Berechtigungen verwendet, schließen Sie das erweiterte Setup ab, bevor Sie den G2-OAuth-Ablauf in AirOps fortsetzen.
1. Öffnen Sie in My.G2 Ihre G2-OAuth-App und suchen Sie die Client-ID und die Secret-ID.
2. Fügen Sie in AirOps beide Werte in **den erweiterten OAuth-Client-Einstellungen**.
3. Klicken Sie auf **Speichern**, und kopieren Sie dann die AirOps-Callback-URL: `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Kehren Sie zur G2-OAuth-App in My.G2 zurück und fügen Sie die Callback-URL zu den Redirect-URIs hinzu.
5. Kehren Sie zu AirOps zurück und setzen Sie den OAuth-Ablauf fort.
### Aktionstypen
Die G2-Integration unterstützt die folgenden Aktionen:
* **Produkte abrufen**: Eine Liste der auf G2 gelisteten Produkte abrufen
* **Produkte suchen**: Nach G2-Produkten per Stichwort oder Thema suchen
* **Umfragefragen abrufen**: Die Definitionen der Fragen abrufen, die G2 in Produktumfragen stellt. Dies gibt keine Bewertungsantworten zurück. Verwenden Sie **Bewertungen abrufen** für das schriftliche Feedback, das Bewerter hinterlassen haben.
* **Bewertungen abrufen**: Bewertungen für ein bestimmtes Produkt abrufen
### Aktionsspezifische Parameter
**Produkte abrufen**
* **Produktname (optional)**: Nach genauem Produktnamen filtern (z. B. `Salesforce`)
* **Slug (optional)**: Nach dem G2-Produkt-URL-Slug filtern (z. B. `salesforce-crm`)
* **Suchabfrage (optional)**: Freitextsuche über Produktnamen hinweg (z. B. `CRM`)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Zu abrufende Seitennummer (Standard 1)
**Produkte suchen**
* **Stichwort (erforderlich)**: Nach G2-Produkten per Stichwort oder Thema suchen (z. B. `CRM`, `Projektmanagement`)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Zu abrufende Seitennummer (Standard 1)
**Umfragefragen abrufen**
* **Aktualisiert nach (optional)**: Fragen zurückgeben, die nach diesem Datum aktualisiert wurden (RFC3339-Format, z. B. `2024-01-01T00:00:00Z`)
* **Aktualisiert vor (optional)**: Fragen zurückgeben, die vor diesem Datum aktualisiert wurden (RFC3339-Format)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Zu abrufende Seitennummer (Standard 1)
**Bewertungen abrufen**
* **Produkt-ID (erforderlich)**: Die G2-Produkt-UUID, für die Bewertungen abgerufen werden sollen (z. B. `5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1`). Dies ist nicht der Produktname. Um sie zu finden, führen Sie zuerst einen **Produkte abrufen** oder **Produkte suchen** Schritt aus und kopieren Sie dann die `id` des Produkts, das Sie aus den Ergebnissen möchten.
* **Erstellt nach (optional)**: Bewertungen zurückgeben, die nach diesem Datum erstellt wurden (RFC3339-Format, z. B. `2024-01-01T00:00:00Z`)
* **Erstellt vor (optional)**: Bewertungen zurückgeben, die vor diesem Datum erstellt wurden (RFC3339-Format)
* **Aktualisiert nach (optional)**: Bewertungen zurückgeben, die nach diesem Datum aktualisiert wurden (RFC3339-Format)
* **Aktualisiert vor (optional)**: Bewertungen zurückgeben, die vor diesem Datum aktualisiert wurden (RFC3339-Format)
* **Mindestanzahl Sterne (optional)**: Nur Bewertungen mit einer Sternebewertung auf diesem Wert oder höher zurückgeben (1–5)
* **Maximale Anzahl Sterne (optional)**: Nur Bewertungen mit einer Sternebewertung auf diesem Wert oder niedriger zurückgeben (1–5)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Zu abrufende Seitennummer (Standard 1)
## Was der Schritt zurückgibt
Jede Aktion gibt eine vereinfachte Antwort zurück:
* **Daten**: die Liste der gefundenen Datensätze (Produkte, Bewertungen oder Umfragefragen).
* **record\_count**: die Gesamtzahl der übereinstimmenden Datensätze.
* **Links**: `nächste` und `vorherige` : Paginierungslinks, sofern verfügbar.
* **Meldung**: nur enthalten, wenn `Daten` leer ist und die wahrscheinlichste Ursache erläutert (siehe unten „Warum erhalte ich keine Ergebnisse?“).
Für **Umfragefragen abrufen**, `Daten` enthält G2s Umfragefragen-Definitionen, und `record_count` spiegelt die Gesamtzahl der Fragen im Katalog von G2 wider, nicht eine auf ein Produkt bezogene Anzahl.
## Häufige Anwendungsfälle
* Suche nach Konkurrenzprodukten per Stichwort und Abruf ihrer Bewertungen für die Wettbewerbsanalyse
* Bewertungen nach Sternebewertung filtern, um Promoter- oder Detraktor-Feedback in großem Umfang sichtbar zu machen
* Kundenfeedback mit einem KI-Schritt zusammenfassen, um wichtige Themen sichtbar zu machen
* Stimmungstrends im Zeitverlauf anhand von nach Datum gefilterten Bewertungsdaten überwachen
* Inhalte mit echtem Social Proof und Bewertungszitaten von G2 anreichern
## Warum erhalte ich keine Ergebnisse?
Wenn eine Aktion erfolgreich ausgeführt wird, aber keine Produkte oder Bewertungen zurückgibt, bedeutet das fast immer, dass das verbundene G2-Konto nichts zurückzugeben hat, nicht dass der Schritt fehlerhaft ist. Die häufigsten Ursachen sind:
* **Ihr G2-Tarif umfasst keinen Zugriff auf die Data API.** Diese Integration verwendet die kostenpflichtige Data API von G2. Ein standardmäßiges oder kostenloses G2-Login hat diesen Zugriff nicht.
* **Ihrem Konto sind keine Produkte zugeordnet.** Die API gibt nur Produkte zurück, auf die Ihr Konto lizenziert ist und die auf G2s Seite zugeordnet sind (zum Beispiel über das G2-Partner-Dashboard). Sie durchsucht nicht den gesamten öffentlichen g2.com-Katalog.
* **Sie suchen nach einem Produkt, das Sie nicht besitzen.** Das Abrufen von Produkten und Bewertungen anderer Unternehmen (für Wettbewerbsrecherchen) erfordert in Ihrer G2-Vereinbarung einen umfassenderen Katalogzugriff.
In all diesen Fällen liegt die Lösung auf G2-Seite. Bestätigen Sie mit Ihrem G2-Administrator oder Kundenbetreuer, was Ihr Data-API-Zugriff umfasst und dass die benötigten Produkte Ihrem Konto zugeordnet sind.
## Fehlerbehandlung
Standardmäßig beendet der G2-Integrationsschritt den Workflow, wenn er fehlschlägt. Sie können ihn so konfigurieren, dass er fortfährt, indem Sie in den Schritteeinstellungen statt „Workflow beenden“ „Fortfahren“ auswählen.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/b2b-enrichment/g2.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.