> 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, Produktdaten, Bewertungen und Umfragefragen programmgesteuert von G2 abzurufen.

{% hint style="info" %}
Diese Integration stellt eine Verbindung zu G2s **Data API**, einem separaten, kostenpflichtigen G2-Produkt. Es ist nicht dasselbe wie die öffentliche g2.com-Website, und es gibt nur die Produkte zurück, auf die Ihr G2-Konto lizenziert ist. Ein Produkt auf g2.com finden zu können, bedeutet nicht, dass es über die API verfügbar ist. Wenn Ihr G2-Plan keinen Data-API-Zugriff beinhaltet oder Ihrem Konto keine Produkte zugeordnet sind, liefern Aktionen keine Ergebnisse. 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 zunächst Ihr G2-Konto in den AirOps-Einstellungen verbinden:

1. Öffnen **Einstellungen → Integrationen**.
2. Finden Sie den **G2** Abschnitt und klicken Sie auf **Konfigurieren**.
3. Schließen Sie den OAuth-Authentifizierungsprozess ab, indem Sie AirOps die erforderlichen Berechtigungen erteilen.

### MCP-Connectoren und Playbooks

Sie können G2 auch über **Einstellungen → MCP-Konnektoren** verbinden und in Playbooks verwenden. AirOps verwendet für den Standard-Connector-Flow seine OAuth-App.

1. Öffnen **Einstellungen → MCP-Konnektoren** und verbinden **G2**.
2. Öffnen Sie den Playbook-Editor.
3. Öffne das **Tools** Bereich und aktivieren Sie **G2**.
4. Beschreiben Sie, welche G2-Bewertungsdaten das Playbook während des Content-Erstellungs-Laufs verwenden soll.

<details>

<summary>Verwende deine eigene G2-OAuth-App</summary>

Wenn dein Team eine eigene OAuth-App mit definierten Berechtigungen verwendet, schließe die erweiterte Einrichtung ab, bevor du den G2-OAuth-Ablauf in AirOps fortsetzt.

1. Öffne in My.G2 deine G2-OAuth-App und finde die Client-ID und die Secret-ID.
2. Füge in AirOps beide Werte in **Erweiterte OAuth-Client-Einstellungen**.
3. Klicken Sie auf **Speichern**, und kopiere dann die AirOps-Callback-URL: `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Kehre zur G2-OAuth-App in My.G2 zurück und füge die Callback-URL zu den Redirect-URIs hinzu.
5. Kehre zu AirOps zurück und setze den OAuth-Ablauf fort.

</details>

### Aktionstypen

Die G2-Integration unterstützt die folgenden Aktionen:

* **Produkte abrufen**: Eine Liste der auf G2 gelisteten Produkte abrufen
* **Produkte suchen**: Nach G2-Produkten anhand eines Stichworts oder Themas 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

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f4115b0282a639a55bb0a39ebf2986fee9d2def2%2Fg2-01-actions.png?alt=media" alt="G2 Integration step with the Action dropdown listing Get Products, Get Reviews, Get Survey Questions, and Search Products by Keyword"><figcaption><p>Wählen Sie eine G2-Aktion.</p></figcaption></figure>

### Aktion-spezifische Parameter

**Produkte abrufen**

* **Produktname (optional)**: Nach genauem Produktnamen filtern (z. B. `Salesforce`)
* **Slug (optional)**: Nach dem URL-Slug des G2-Produkts filtern (z. B. `salesforce-crm`)
* **Suchanfrage (optional)**: Freitextsuche über Produktnamen hinweg (z. B. `CRM`)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Abzurufende Seitennummer (Standard 1)

**Produkte suchen**

* **Schlüsselwort (erforderlich)**: Suchen Sie nach G2-Produkten anhand eines Stichworts oder Themas (z. B. `CRM`, `Projektmanagement`)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Abzurufende Seitennummer (Standard 1)

**Umfragefragen abrufen**

* **Aktualisiert nach (optional)**: Gibt Fragen zurück, die nach diesem Datum aktualisiert wurden (RFC3339-Format, z. B. `2024-01-01T00:00:00Z`)
* **Aktualisiert vor (optional)**: Gibt Fragen zurück, die vor diesem Datum aktualisiert wurden (RFC3339-Format)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Abzurufende 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 ihn zu finden, führen Sie zuerst einen **Produkte abrufen** oder **Produkte suchen** Schritt aus und kopieren Sie dann die `id` des Produkts, das Sie möchten, aus seinen Ergebnissen.
* **Erstellt nach (optional)**: Gibt Bewertungen zurück, die nach diesem Datum erstellt wurden (RFC3339-Format, z. B. `2024-01-01T00:00:00Z`)
* **Erstellt vor (optional)**: Gibt Bewertungen zurück, die vor diesem Datum erstellt wurden (RFC3339-Format)
* **Aktualisiert nach (optional)**: Gibt Bewertungen zurück, die nach diesem Datum aktualisiert wurden (RFC3339-Format)
* **Aktualisiert vor (optional)**: Gibt Bewertungen zurück, die vor diesem Datum aktualisiert wurden (RFC3339-Format)
* **Mindestanzahl an Sternen (optional)**: Gibt nur Bewertungen mit einer Sternebewertung von mindestens diesem Wert zurück (1–5)
* **Maximale Anzahl an Sternen (optional)**: Gibt nur Bewertungen mit einer Sternebewertung von höchstens diesem Wert zurück (1–5)
* **Seitengröße (optional)**: Anzahl der Ergebnisse pro Seite (max. 100, Standard 10)
* **Seitennummer (optional)**: Abzurufende Seitennummer (Standard 1)

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-38392fb9733689c7d80bbaf9a316f6c81cd48657%2Fg2-02-get-reviews.png?alt=media" alt="G2 Get Reviews action filtering recent four- and five-star reviews"><figcaption><p>Filtern Sie Bewertungen nach Datum und Sternebewertung.</p></figcaption></figure>

## Was der Schritt zurückgibt

Jede Aktion gibt eine vereinfachte Antwort zurück:

* **Daten**: die Liste der gefundenen Datensätze (Produkte, Bewertungen oder Umfragefragen).
* **Anzahl der Datensätze**: die Gesamtzahl der übereinstimmenden Datensätze.
* **Links**: `nächste` und `vorherige` Seitennavigations-Links, 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 die Definitionsangaben zu G2s Umfragefragen, und `Anzahl der Datensätze` spiegelt die Gesamtzahl der Fragen im G2-Katalog wider, nicht die Anzahl für ein bestimmtes Produkt.

## Häufige Anwendungsfälle

* Nach Konkurrenzprodukten anhand von Stichwörtern suchen und deren Bewertungen für Wettbewerbsanalysen abrufen
* Bewertungen nach Sternebewertung filtern, um Promoter- oder Detraktor-Feedback in großem Umfang sichtbar zu machen
* Kundenfeedback mit einem KI-Schritt zusammenfassen, um die wichtigsten Themen herauszuarbeiten
* Sentiment-Trends im Zeitverlauf mithilfe von nach Datum gefilterten Bewertungsdaten überwachen
* Inhalte mit echten 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-Plan enthält keinen Zugriff auf die Data API.** Diese Integration verwendet G2s kostenpflichtige Data API. Mit einem Standard- oder kostenlosen G2-Login haben Sie diesen Zugriff nicht.
* **Es sind keine Produkte Ihrem Konto 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 Ihnen nicht gehört.** Das Abrufen von Produkten und Bewertungen anderer Unternehmen (für Wettbewerbsrecherchen) erfordert in Ihrer G2-Vereinbarung einen erweiterten Katalogzugriff.

In all diesen Fällen liegt die Lösung auf G2s Seite. Klären Sie mit Ihrem G2-Administrator oder Account-Vertreter, was Ihr Data-API-Zugriff umfasst und dass die von Ihnen 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 Schritteinstellungen 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=<question>&goal=<user_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.
