(Beta) Erstellen Sie eine Zoho CRM Basisverbindung mit Flow Service API

HINWEIS

Die Zoho CRM Quelle befindet sich in der Beta-Version. Siehe Quellübersicht für weitere Informationen zur Verwendung von Beta-gekennzeichneten Steckverbindern.

Eine Basisverbindung stellt die authentifizierte Verbindung zwischen einer Quelle und Adobe Experience Platform dar.

Dieses Tutorial führt Sie durch die Schritte zum Erstellen einer Basisverbindung für Zoho CRM mit Flow Service API.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Erfassung von Daten aus verschiedenen Quellen und bietet Ihnen gleichzeitig die Möglichkeit, eingehende Daten zu strukturieren, zu kennzeichnen und zu verbessern, indem Sie Platform Dienstleistungen.
  • Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um erfolgreich eine Verbindung zu Zoho CRM mit Flow Service API.

Erforderliche Anmeldedaten sammeln

In der Reihenfolge Flow Service Verbindung herstellen mit Zoho CRM, müssen Sie Werte für die folgenden Verbindungseigenschaften bereitstellen:

Anmeldedaten Beschreibung
endpoint Der Endpunkt des Zoho CRM Server, an den Sie Ihre Anforderung senden.
accountsUrl Die Konto-URL wird verwendet, um Ihren Zugriff zu generieren und Token zu aktualisieren. Die URL muss domänenspezifisch sein.
clientId Die Client-ID, die Ihrer Zoho CRM Benutzerkonto.
clientSecret Das Client-Geheimnis, das Ihrem Zoho CRM Benutzerkonto.
accessToken Das Zugriffstoken autorisiert Ihren sicheren und temporären Zugriff auf Ihre Zoho CRM Konto.
refreshToken Ein Aktualisierungstoken ist ein Token, das verwendet wird, um ein neues Zugriffstoken zu generieren, sobald Ihr Zugriffstoken abgelaufen ist.
connectionSpec.id Die Verbindungsspezifikation gibt die Verbindungseigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für das Erstellen der Basis- und Quellverbindungen. Verbindungsspezifikations-ID für Zoho CRM ist: 929e4450-0237-4ed2-9404-b7e1e0a00309.

Weitere Informationen zu diesen Anmeldedaten finden Sie in der Dokumentation zu Zoho CRM Authentifizierung.

Verwenden von Plattform-APIs

Informationen dazu, wie Sie erfolgreich Aufrufe von Plattform-APIs durchführen, finden Sie im Handbuch zu Erste Schritte mit Plattform-APIs.

Basisverbindung erstellen

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Plattform gespeichert, einschließlich der Authentifizierungsinformationen Ihrer Quelle, des aktuellen Zustands der Verbindung und Ihrer eindeutigen Basis-Verbindungs-ID. Die Basis-Verbindungs-ID ermöglicht es Ihnen, Dateien von der Quelle aus zu erkunden und zu navigieren und die spezifischen Elemente zu identifizieren, die Sie aufnehmen möchten, einschließlich Informationen zu den Datentypen und Formaten.

Um eine Basis-Verbindungs-ID zu erstellen, stellen Sie eine POST an /connections Endpunkt beim Bereitstellen von Zoho CRM Authentifizierungsdaten als Teil der Anforderungsparameter.

API-Format

POST /connections

Anfrage

TIPP

Die URL-Domäne Ihrer Konten muss Ihrem entsprechenden Domänenstandort entsprechen. Die folgenden Domänen und die zugehörigen Konto-URLs sind angegeben:

  • Vereinigte Staaten: https://accounts.zoho.com
  • Australien: https://accounts.zoho.com.au
  • Europa: https://accounts.zoho.eu
  • Indien: https://accounts.zoho.in
  • China: https://accounts.zoho.com.cn

Die folgende Anforderung erstellt eine Basisverbindung für Zoho CRM:

curl -X POST \
    'https://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json'
    -d '{
        "name": "Zoho CRM base connection",
        "description": "Base Connection for Zoho CRM",
        "auth": {
            "specName": "Basic Authentication",
            "params": {
                "endpoint": "{ENDPOINT}",
                "accountsUrl": "{ACCOUNTS_URL}",
                "clientId": "{CLIENT_ID}",
                "clientSecret": "{CLIENT_SECRET}",
                "accessToken": "{ACCESS_TOKEN}",
                "refreshToken": "{REFRESH_TOKEN}"
            }
        },
        "connectionSpec": {
            "id": "929e4450-0237-4ed2-9404-b7e1e0a00309",
            "version": "1.0"
        }
    }'
Parameter Beschreibung
name Der Name Ihrer Zoho CRM Basisverbindung. Sie können diesen Namen verwenden, um Ihre Zoho CRM Basisverbindung.
description Eine optionale Beschreibung für Ihre Zoho CRM Basisverbindung.
auth.specName Der für die Verbindung verwendete Authentifizierungstyp.
auth.params.endpoint Der Endpunkt des Zoho CRM Server, an den Sie Ihre Anforderung senden.
auth.params.accountsUrl Die Konto-URL wird verwendet, um Ihren Zugriff zu generieren und Token zu aktualisieren. Die URL muss domänenspezifisch sein.
auth.params.clientId Die Client-ID, die Ihrer Zoho CRM Benutzerkonto.
auth.params.clientSecret Das Client-Geheimnis, das Ihrem Zoho CRM Benutzerkonto.
auth.params.accessToken Das Zugriffstoken autorisiert Ihren sicheren und temporären Zugriff auf Ihre Zoho CRM Konto.
auth.params.refreshToken Ein Aktualisierungstoken ist ein Token, das verwendet wird, um ein neues Zugriffstoken zu generieren, sobald Ihr Zugriffstoken abgelaufen ist.
connectionSpec.id Verbindungsspezifikations-ID für Zoho CRM: 929e4450-0237-4ed2-9404-b7e1e0a00309.

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Basisverbindung einschließlich ihrer eindeutigen Kennung (id). Diese ID ist im nächsten Schritt zum Erstellen einer Quellverbindung erforderlich.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Nächste Schritte

In diesem Tutorial haben Sie eine Zoho CRM Basisverbindung mit Flow Service API und haben den eindeutigen ID-Wert der Verbindung erhalten. Sie können diese ID im nächsten Tutorial verwenden, während Sie lernen, wie Sie diese ID verwenden können. CRM-Systeme mithilfe der Flow Service-API erkunden.

Auf dieser Seite