Zuordnungen v3

ÜberblickEndpunkte

There is a new version of the Associations API that adds the ability to create multiple types of associations between two object types.

Zuordnungen stellen die Beziehungen zwischen Objekten und Aktivitäten im HubSpot CRM dar. Sie können die Zuordnungsendpunkte verwenden, um mehrere Zuordnungen gleichzeitig zu erstellen, abzurufen oder zu entfernen. Sie können die folgenden Objekte oder Interaktionen über die Zuordnungen-API zuordnen:

  • Contacts
  • Companies
  • Deals
  • Tickets
  • Calls
  • Quotes
  • Line_items
  • Meetings
  • Products
  • Feedback_submissions
  • Custom objects (der Name des Objekts)

Erfahren Sie mehr über Objekte, Datensätze, Eigenschaften und Zuordnungen-APIs im Leitfaden Grundlegendes zum CRM. Weitere allgemeine Informationen zu Objekten und Datensätzen in HubSpot finden Sie in diesem Artikel über das Verwalten Ihrer CRM-Datenbank.

Please note: this API doesn't support parent-child associations or special contact-to-company associations. Learn more about how you can use these associations with the previous version of the associations API.

Definitionen von Zuordnungen

Zuordnungen sind nach Objekt und Richtung definiert. Zuordnungstypen sind unidirektional, d. h., Sie müssen je nach Startobjekttyp eine andere Definition verwenden. Zum Beispiel:

  • Um alle Tickets anzuzeigen, die einem Kontakt zugeordnet sind, müssten Sie die Zuordnung mit der Anfrage-URL /crm/v3/associations/Contacts/Tickets/batch/read definieren und den Kontakt im Anfragetext durch seinen objectId identifizieren. In diesem Beispiel ist „Contacts“ der fromObjectType und „Tickets“ der toObjectType.
  • Um einen Kontaktdatensatz einem benutzerdefinierten Objektdatensatz zuzuordnen, bei dem Ihr benutzerdefiniertes Objekt „Pets“ (Haustiere) ist, müssten Sie die Zuordnung mit der Anfrage-URL /crm/v3/associations/Pets/Contacts/batch/create definieren und die Kontakt- und Haustierdatensätze, die Sie dem Anfragetext zuordnen möchten, durch ihre objectIds identifizieren. In diesem Beispiel ist „Pets“ der fromObjectType und „Contacts“ der toObjectType.

Um alle definierten Zuordnungstypen zwischen Objekten anzuzeigen, führen Sie eine GET-Anfrage an /crm/v3/associations/{fromObjectType}/{toObjectType}/types durch.

Zuordnungen erstellen

Um Datensätze in HubSpot zuzuordnen, führen Sie eine POST-Anfrage an /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/create durch. Schließen Sie in Ihrer Anfrage die id-Werte für die Datensätze ein, die Sie zuordnen möchten, sowie den type der Zuordnung, zu der die Datensätze gehören.

Um beispielsweise Kontakte zu Unternehmen zuzuordnen, wäre Ihre Anfrage-URL /crm/v3/associations/Contacts/Companies/batch/create und Ihre Anfrage würde wie folgt aussehen:

///Example request body { "inputs": [ { "from": { "id": "53628" }, "to": { "id": "12726" }, "type": "contact_to_company" } ] }

Zuordnungen abrufen

Um zugeordnete Datensätze abzurufen, führen Sie eine POST-Anfrage an /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/read durch. In Ihrer Anfrage können Sie die id eines bestimmten Datensatzes für den fromObjectType angeben. In Ihrer Antwort rufen Sie die id-Werte aller toObjectType zugeordneten Datensätze ab.

Um beispielsweise alle Deals abzurufen, die einem Unternehmen zugeordnet sind, müsste Ihre Anfrage-URL so aussehen: /crm/v3/associations/Companies/Deals/batch/read. Ihre Antwort würde die id-Werte für alle zugeordneten Deals enthalten.

Zuordnungen entfernen

Um Zuordnungen zwischen Datensätzen zu entfernen, führen Sie eine POST-Anfrage an /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/archive durch.

War dieser Artikel hilfreich?
Dieses Formular dient dazu, Feedback zu unserer Entwicklerdokumentation zu sammeln. Wenn Sie uns Ihre Meinung zu HubSpot-Produkten mitteilen möchten, teilen Sie diese bitte im Ideenforum der Community.