HubSpot-gegevens opvragen in Snowflake

Nadat u Snowflake aan uw HubSpot-account hebt gekoppeld, kunt u Snowflake's Data Share gebruiken om HubSpot-gegevens te bevragen vanuit uw Snowflake-account.

Gegevensvertraging en uw Snowflake-accountregio

U krijgt toegang tot het schema V2_LIVE, dat elke 15 minuten wordt bijgewerkt, en het schema V2_DAILY, dat elke dag wordt bijgewerkt.

Uw Snowflake-omgeving opzetten

Om uw HubSpot-gegevens in Snowflake te bevragen, moet u het magazijn, de database en het schema selecteren waaruit u query's wilt uitvoeren. U kunt deze op werkbladniveau instellen om ze automatisch in uw query's op te nemen, of u kunt ze handmatig toevoegen.

Om uw magazijn, database en schema op werkbladniveau te selecteren:

• Klik in de bovenste rij van het werkblad op de werkblad-actiebalk.
  
  
• In het pop-up venster:
  • Klik op het Warehouse dropdown menu, selecteer vervolgens je warehouse.
  • Klik op het keuzemenu Database en selecteer je HubSpot-database.
  • Klik op het Schema dropdown menu en selecteer het schema dat je wilt gebruiken:
    • V2_DAILY: het dagelijkse schema om gegevens te bevragen op basis van tabellen. Gegevens in dit schema worden eenmaal per dag bijgewerkt. Het gebruik van dit schema resulteert in snellere query's en wordt aanbevolen voor query's direct in Snowflake.
    • V2_LIVE: het live schema gebaseerd op Secure Views van HubSpot gegevens. Gegevens in dit schema worden tot elke 15 minuten bijgewerkt. Als u een grote set gegevens opvraagt, kunnen query's traag zijn. In dat geval is het raadzaam om de gegevens eerst met een ETL-proces naar een eigen tabel te kopiëren en vervolgens die tabel te bevragen.
    
    
    

Als uw omgeving is geconfigureerd, kunt u query's maken naar uw HubSpot-gegevens zonder dat u uw database- of schema-type handmatig aan query's hoeft toe te voegen.

Om handmatig uw database en schema type aan queries toe te voegen, voegt u de databasenaam gevolgd door het schema toe aan het begin van het FROM veld. Bijvoorbeeld:

Overzicht gegevens

Queries worden opgebouwd met behulp van SQL, en kunnen worden gebruikt om HubSpot-gegevens op te halen zoals:

• Objecten: standaard en aangepaste objecten, zoals contacten, bedrijven, producten.
• Records: individuele records, zoals een individueel contact of bedrijf.
• Associaties: alle beschikbare associatietypen en momenteel geassocieerde records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals e-mailopeningen, als aangepaste gedragsgebeurtenissen.
• Lijsten: HubSpot contact- en bedrijfslijsten.
• Eigenaren: gebruikers in uw HubSpot-account, in relatie tot de records waarvan zij als eigenaar zijn ingesteld.
• Pipelines: deal en ticket pipelines, inclusief pijplijnstadia.
• Eigenschappen: eigenschappen en hun waarden op CRM-records, met inbegrip van de geschiedenis van de eigenschappen.

Meer informatie over het CRM-gegevensmodel van HubSpot.

Let op: Naarmate we het delen van gegevens verder ontwikkelen, zullen we wijzigingen introduceren, waarvan sommige breekbaar zijn. Het is sterk aanbevolen om je te abonneren op HubSpot's developer change log. Deze wijzigingen worden altijd voorafgaand aan een update in het change log geplaatst.

Beperken en ordenen van geretourneerde gegevens

Bij het samenstellen van query's kunt u bepalen hoeveel gegevens worden geretourneerd en in welke volgorde, door LIMIT en ORDER BY in uw query op te nemen. Om bijvoorbeeld alle contactpersonen met hun eigenschappen op te vragen, maar slechts drie resultaten te retourneren en ze te ordenen op contact-ID, zou u uw query als volgt kunnen construeren:

Soorten kolomgegevens

Bij het bevragen van gegevens in Snowflake zijn de kolommen die worden geretourneerd afhankelijk van de gegevens die u bevraagt. U kunt de beschikbare kolommen voor een bepaalde tabel of weergave in Snowflake bekijken door de weergave in de linkerzijbalk te selecteren.

Let op:voor de rest van dit document gebruiken we de term databaseobject wanneer de context van toepassing is op zowel tabellen als views.

Om een specifieke kolom terug te geven, neemt u die kolom op in het SELECT-veld van uw query. De volgende query geeft bijvoorbeeld alleen de kolommen OBJECTID en UpdatedAt:


SELECTobjectId, updatedAt
FROM objects_contacts



Hieronder staan algemene definities voor kolommen die een query kan opleveren. Voor andere definities die hieronder niet zijn opgenomen, zie de individuele weergavedefinities in het artikel hierboven.

• OBJECTTYPEID: een VARCHAR-waarde die het objecttype vertegenwoordigt. Bijvoorbeeld, 0-1 staat voor het contactpersonenobject, 0-2 voor het bedrijvenobject, en 2-1232 kan een aangepast object in uw account vertegenwoordigen. In lijsten verwijst dit naar het type lijst (bijv. contactpersoon of bedrijf). U kunt alle object- en gebeurtenis-ID's in uw account opvragen met de weergave object_en_gebeurtenis_type_definities.
• OBJECTID: een BIGINT nummer dat staat voor een enkele record van een bepaald type object in je HubSpot account. Om een record te identificeren, moet je zowel het objecttype ID als het object ID gebruiken.
• INGESTEDAT: het tijdstempel van wanneer een rij gegevens is toegevoegd aan Snowflake, weergegeven door een TIMESTAMP_NTZ-waarde. Niet gerelateerd aan de logische tijdstempel van een creatie- of updatebewerking in HubSpot.
  • Door de interne verwerking van HubSpot kan de ingestion timestamp van een rij worden bijgewerkt, zelfs als er geen andere kolommen op de rij zijn gewijzigd.
  • Bij het bouwen van ETL processen die recent gewijzigde data kopiëren, is het aanbevolen om je queries te baseren op de ingestion timestamp. Als uw stroom dagelijks gegevens kopieert, is het bovendien raadzaam gegevens van de vorige twee dagen te kopiëren om rekening te houden met vertragingen.
• CREATEDAT en UPDATEDAT: de logische tijdstempel van wanneer gegevens zijn aangemaakt of bijgewerkt in HubSpot, weergegeven door een TIMESTAMP_NTZ waarde. Deze timestamps zullen overeenkomen met timestamps in HubSpot. De tijd die in HubSpot wordt weergegeven voor de aanmaakdatum van een record is bijvoorbeeld dezelfde als de tijdstempel in de kolom CREATEDAT in Snowflake. Deze zijn niet direct gerelateerd aan de ingestion timestamp, en het wordt niet aanbevolen om ETL-processen op deze eigenschappen te baseren.
• COMBINEDASSOCIATIONTYPE: een VARCHAR-waarde die een associatiedefinitie uniek identificeert.

Gegevenstypes transformeren

Soms worden gegevens teruggestuurd uit een query met VARCHAR-kolommen, terwijl het wenselijk is dat ze van een ander type zijn. In dergelijke gevallen wordt aanbevolen het VARCHAR-datatype te converteren naar de gewenste types met behulp van Snowflake-functies. Bijvoorbeeld, eigenschappen van een objectrecord worden in de meeste databaseobjecten opgeslagen als VARCHAR-datatype, maar bevatten soms getallen en datetime-waarden. Functies zoals:
try_to_number, try_to_timestamp_ntz kunnen worden gebruikt om deze VARCHAR-gegevens om te zetten in respectievelijk hun typen NUMBER en DATETIME:


SELECT objectid, waarde AS bedrag_str, try_to_number(waarde) AS bedrag
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



Objectvragen

Hieronder leest u hoe u gegevens van specifieke HubSpot-objecten en -records kunt opvragen, samen met de gegevens die worden geretourneerd.

Objectgegevens van verschillende typen zijn op twee manieren georganiseerd en beschikbaar:

• Individueel: Elk objecttype wordt opgeslagen in zijn eigen view en bevat alleen records van hetzelfde objecttype, bv. objecten_contacten bevat alleen contactrecords. Dit elimineert de noodzaak om een objecttypeid te specificeren tijdens het queryen. Deze views zijn gemakkelijker te bevragen omdat je geen ObjectTypeIds hoeft te kennen. Ze geven ook gegevens terug in een bruikbaarder formaat, waarbij elke rij overeenkomt met een object en de huidige versie van zijn eigenschappen. Zolang u geen trage queries ervaart, is het raadzaam deze views te gebruiken om objectgegevens op te halen. Zie meer in Objects_X views hieronder.
• Gecombineerd: Alle records voor alle objecttypen worden gecombineerd in één databaseobject. Daarom moet u bij een query een filter opgeven zoals "WHERE objectTypeId='0-1'. U kunt bijvoorbeeld de volgende objecttypeids gebruiken bij een query:

Aangepaste objecten krijgen een ID toegewezen bij het aanmaken, en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345. Meer informatie over object_en_event_type_definities.

Deze databaseobjecten zijn over het algemeen geschikt als u betere queryprestaties wenst dan wat haalbaar is met objects_x views. Zie meer details in object_with_object_properties, object_properties, objects en object_properties_history hieronder.

objecten_x weergaven

In dit databaseobject heeft elk beschikbaar objecttype, met inbegrip van aangepaste objecten, zijn eigen specifieke weergave, waarbij elke weergave alleen records bevat voor objecten van dat specifieke objecttype. Deze weergaven worden benoemd volgens het formaat OBJECTS_<objecttypenaam> waarbij <objecttypenaam> de meervoudsvorm van het objecttype is. (Merk op dat indien het objecttype geen meervoudsvorm heeft, <objecttypenaam> gewoon de enkelvoudsvorm van de objecttypenaam is, aaneengesloten met "S").

Query's naar deze weergave leveren een rij op voor elke record binnen een object met elke eigenschap van het object beschikbaar als een aparte kolom.

Zie hieronder de uitgebreide lijst van beschikbare HubSpot (dat wil zeggen, niet aangepaste) objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en hun bijbehorende weergaven:

Elk databankobject levert de volgende kolommen op:

Voorbeeld 1

Ophalen van de voornaam, achternaam en levensfase voor alle contactpersonen.

Vraag:


SELECT objectId, property_firstname AS voornaam, property_lastname AS achternaam, property_lifecyclestage AS lifecyclestage
VAN objecten_contact



Terug:

Voorbeeld 2

Haal de dealnaam en het stadium van maximaal drie deals op.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

VAN objects_deals

LIMIT 3

Terug:

Voorbeeld 3

Zoek de naam en het stadium van de top drie transacties op basis van het bedrag.

Query:

Aangezien de gegevens over het dealbedrag beschikbaar zijn als een getalstype, kunnen ze worden gebruikt om te ordenen zonder dat conversie of casting nodig is.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

VAN objects_deals
ORDER BY property_amount DESC
LIMIT 3




Terug:

object_met_object_eigenschappen

Dit database object bevat gegevens van je HubSpot records. Query's naar dit databaseobject leveren een rij op voor elke record binnen een objecttype (bijvoorbeeld alle contactrecords in het objecttype Contacten). Alle eigenschappen worden opgeslagen in de kolom Eigenschappen, wat een Snowflake Variant / JSON kolom is.

Deze weergave kan de volgende kolommen opleveren:

Let op: Op 25 januari 2022 wordt de kolom, timestamp in object_with_object_properties tabel en view, die de datum en tijd weergeeft waarop de objectrecord voor het laatst is bijgewerkt in HubSpot, updatedat. Dit is om aan te sluiten bij hoe datetime data wordt weergegeven in de rest van de data share.

Omdat dit een breaking change is, is de nieuwe kolom, updatedat toegevoegd aan de tabel en view. Gedurende de komende 90 dagen zullen deze twee nieuwe kolommen naast timestamp bestaan, de kolommen die zij willen vervangen. Dit geeft u de gelegenheid om over te schakelen op het gebruik van de nieuwe kolommen.

Na 90 dagen, op 25 januari 2022, wordt de kolom timestamp uit de tabel en de weergave verwijderd. Na deze datum zal elke poging om de tabel object_with_object_properties of view te bevragen met behulp van timestampkolommen mislukken.

Voorbeeld 1

Alle contacten en hun eigenschappen ophalen.

Query:

Terug:

Voorbeeld 2

Haal de dealnaam en het stadium van maximaal drie dealsop.

Query:

Terug:

objecten

Dit databaseobject is een subset van de gegevens in het databaseobject object_with_object_properties. Elke geretourneerde rij retourneert het object-ID voor elke record. Dit database object retourneert alleen bestaande records. Wanneer een record wordt verwijderd in HubSpot, wordt het verwijderd uit dit databaseobject. Dit databaseobject is een subset van de gegevens in de object_with_object_properties tabel. Elke geretourneerde rij retourneert het object ID voor elke record. Deze weergave retourneert alleen bestaande records. Wanneer een record wordt verwijderd in HubSpot, zal het worden verwijderd uit deze weergave.

Dit databaseobject kan nuttig zijn als uw account een grote hoeveelheid gegevens heeft, waardoor object_with_object_properties en objects_x views traag werken. Het gebruik van dit databaseobject met het object_properties databaseobject maakt het mogelijk om de gegevens in object_with_object_properties te repliceren, met behoud van controle over welke eigenschappen worden geretourneerd.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Alle contactpersonen ophalen.

Query:

Terug:

object_eigenschappen

Dit databaseobject is een deelverzameling van het databaseobject object_with_object_properties. Elke rij bevat de huidige waarde van de eigenschap van een gegeven record. Bijvoorbeeld, een contactpersoon heeft een rij voor de eigenschap Voornaam en een rij voor de eigenschap Achternaam. Als een record geen waarde heeft voor een eigenschap, verschijnt de rij met een lege string of helemaal niet.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Ophalen van de voornaam, achternaam en woonplaats voor alle contactpersonen.

Query:

Terug:

Voorbeeld 2

Haal de voornaam, achternaam en levensfase voor alle contactpersonen op en combineer ze in één rij per contactpersoon. Dit voorbeeld gebruikt de SQL PIVOT syntaxis.

Query:

Terug:

object_eigenschappen_geschiedenis

Dit databaseobject bevat historische waarden van eigenschappen. Voor contactpersonen bevat het de meest recente 45 waarden. Voor alle andere objecten bevat het de meest recente 20 waarden. Toont een rij voor elke historische waarde van een eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT tijdstempel in de geschiedenis van de eigenschap.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Ophalen van de geschiedenis van één eigenschap voor één contactpersoon.

Query:

Terug:

Voorbeeld 2

Haal de huidige naam op van alle contactpersonen die ooit een levenscyclusfase van Abonnee hebben gehad.

Query:

Terug:

Verenigingsvragen

Net als gegevens over objecten worden gegevens over verenigingen op twee manieren georganiseerd:

• Individueel: Elk associatietype wordt opgeslagen in zijn eigen weergave en bevat alleen records van dat type. Bijvoorbeeld, associations_contacts_to_deals bevat alleen associatie records tussen contact en deal objecten. Dit elimineert de noodzaak om een associatietypeid op te geven bij het bevragen. Deze views zijn vrij eenvoudig te bevragen, omdat er geen kennis van het CRM-gegevensmodel nodig is om ze te gebruiken. Ze geven ook een verrijkte beschrijving van de associatierecord tussen twee objecten, die gemakkelijk kan worden gebruikt in joins met objects_x views. Zolang u geen last hebt van trage query's, is het raadzaam deze views te gebruiken om associatiegegevens op te halen. Zie meer in associations_x_to_y views hieronder.
• Gecombineerd: Alle records voor alle associatietypen worden gecombineerd in één databaseobject. U moet dus bij een query een filter opgeven zoals "WHERE combinedassociationtypeid='0-32'". Zie meer in associaties en associatie_definities hieronder.

associaties_x_tot_y standpunten

Elk associatietype heeft zijn eigen weergave, gelabeld als associations_<associatietype naam> bijv. associations_contacts_to_deals. Elke weergave is een deelverzameling van de gegevens in het databankobject associaties en bevat alleen records van een specifiek gecombineerd associatietypeid.

Elk databaseobject geeft de volgende kolommen terug:

Voorbeeld 1

Alle deals ophalen die met een specifiek contact te maken hebben.

Query:

Terug:

Voorbeeld 2

Zoek alle contacten in de tijdzone Bogota en hun deals.

Voorbeeld 3

Zoek alle contacten en de totale som van de gesloten deals voor elk contact.

Terug:

associatie_definities

Dit databaseobject bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype. Je kunt dit database object koppelen aan het associaties database object om record-specifieke associatie informatie te krijgen.

Er kunnen meerdere typen associaties zijn tussen dezelfde objecten. Het belangrijkste associatietype, dat is het type dat in HubSpot wordt weergegeven wanneer records worden geassocieerd, gebruikt de associatie waarbij ISMAINASSOCIATIONDEFINITION waar is.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Zoek de soorten verenigingen die beschikbaar zijn in uw account.

Query:

Terug:

Voorbeeld 2

Ophalen van de beschikbare associatietypen tussen deals en bedrijven.

Query:

Terug:

verenigingen

Dit databaseobject bevat informatie over de associaties tussen specifieke records. Elke rij vertegenwoordigt een associatie van een object naar een ander object. Rijen kunnen in dit databaseobject aanwezig zijn, ook al zijn de records waarnaar verwezen wordt, verwijderd. U kunt controleren of er records bestaan door zich te verbinden met de tabel Objecten.

Dit databaseobject kan nuttig zijn als uw account een grote hoeveelheid gegevens heeft, waardoor associaties_x_naar_y weergaven traag werken.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Alle geassocieerde deals en contacten ophalen.

Query:

Terug:

Voorbeeld 2

Ophalen van alle tickets gekoppeld aan een specifiek contact (contact ID: 3005).

Query:

Terug:

Voorbeeld 3

Ophalen van alle deals die gekoppeld zijn aan een specifiek contact (contact ID: 4464). In plaats van hard-coding combinedAssociationTypeId, voegt dit voorbeeld samen met association_definitions.

Query:

Terug:

Vragen van de eigenaar

eigenaren

Dit database object bevat informatie over de gebruikers in je HubSpot account. Gebruikers kunnen worden ingesteld als record eigenaar, en zullen zowel een gebruiker ID als een eigenaar ID bevatten, afhankelijk van hun context. Beide ID's kunnen worden gebruikt om dezelfde gebruiker te identificeren.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Alle gebruikers ophalen. Het filter WHERE archived = false verwijdert verwijderde gebruikers uit de geretourneerde gegevens.

Query:

Terug:

Voorbeeld 2

Ophalen van een specifieke eigenaar aan de hand van zijn eigenaars-ID.

Query:

Terug:

Voorbeeld 3

Ophalen van alle contacten en hun eigenaren. Deze query koppelt records aan eigenaren met object_with_object_properties en de contacteigenschap hubspot_owner_id.

Terug:

Pijplijn vragen

Hieronder leest u hoe u deal- en ticketpijplijngegevens kunt opvragen, zoals de beschikbare pijplijnen in uw account en hun stadia.

U kunt deze gegevens combineren met objectgegevens voor een volledig overzicht van uw pijplijnen. U kunt bijvoorbeeld deals en hun pijplijnen bevragen door de objects_deals_view of de object_with_object_properties data te verbinden met pijplijn data.

pijpleidingen

Dit database object bevat informatie over de deal en ticket pijplijnen in uw account. Elke geretourneerde rij vertegenwoordigt een enkele pijplijn.

Deze tabel kan de volgende kolommen opleveren:

Voorbeeld 1

Haal alle beschikbare deal pipelines op, gerangschikt op hun volgorde in HubSpot.

Query:

Terug:

Voorbeeld 2

Ophalen van deals binnen een specifieke pijplijn. Verbindt object_met_object_eigenschappen en pijplijnen.

Query:

Terug:

Voorbeeld 3

Hetzelfde als voorbeeld 2 hierboven, deals ophalen binnen een specifieke pijplijn. Maar, in plaats van objects_deals te gebruiken in joins, gebruik object_with_object_properties.

Terug:

pijplijn_stadia

Deze weergave bevat informatie over individuele fasen binnen een pijplijn. Identificeer fasen door objecttype-ID, pijplijn-ID en fase-ID te combineren. Gebruik bij het verbinden met pijpleidingen de objecttype-ID en pijplijn-ID.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Haal pijplijnstadia op voor een dealpijplijn met de naam Verkooppijplijn.

Query:

Terug:

Voorbeeld 2

Alle transacties en hun respectieve pijplijnstadia ophalen.

Query:

Terug:

Vragen over onroerend goed

eigendom_definities

Dit database object bevat informatie over object eigenschappen en gebeurtenis eigenschappen in je HubSpot account. Gebeurtenis eigenschappen omvatten standaard gebeurtenissen, zoals e-mail opens en klikken, en aangepaste gedragsgebeurtenis eigenschappen. Deze informatie kan nuttig zijn voor het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

U kunt specifieke eigenschappen identificeren door hun objecttype-ID en naam te combineren. U kunt soortgelijke informatie opvragen met de eigenschappen-API.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Haal de namen en beschrijvingen op voor alle contacteigenschappen.

Query:

Terug:

Evenement vragen

Evenementen omvatten standaard HubSpot gebeurtenissen en aangepaste gedragsevenementen. Elk evenement heeft zijn eigen database object, gelabeld als events_eventname.

U kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die worden teruggegeven hangen af van de gebeurtenis, met één kolom voor elke eigenschap van de gebeurtenis. Alle gebeurtenissen geven de volgende kolommen terug:

Voorbeeld 1

Haal de 50 meest recente e-mail klikgebeurtenissen op.

Query:

Terug:

Voorbeeld 2

Alle e-mail klikgebeurtenissen ophalen bij de contacten die geklikt hebben. Deze query krijgt contactgegevens door samen te voegen met object_met_object_eigenschappen.

Query:

Terug:

Object_en_gebeurtenis_type_queries

object_en_gebeurtenis_type_definities

Dit databaseobject bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in uw HubSpot-account.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Haal alle objecten en gebeurtenissen op die beschikbaar zijn in uw HubSpot-account.

Query:

Terug:

Lijsten met vragen

Hieronder leest u hoe u uw lijsten kunt bevragen, zoals de beschikbare contact- en bedrijfslijsten en de records in die lijsten.

lijsten

Dit databaseobject bevat informatie over HubSpot contact- en bedrijfslijsten. Geeft één rij per lijst, en kolommen bevatten lijstdetails zoals lijstnaam, grootte, en het objecttype van de records die het bevat. Bevat geen informatie over de individuele records binnen elke lijst (zie list_membership).

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

Alle contactlijsten ophalen.

Query:

Terug:

Voorbeeld 2

Haal een specifieke contactlijst op met de naam Top abonnees 2021.

Query:

Terug:

lijst_lidmaatschap

Dit database-object bevat informatie over welke records lid zijn van welke lijsten, met één rij per record in de lijst. Als u bijvoorbeeld een lijst met Blog-abonnees hebt met 500 contacten, retourneert het database-object 500 rijen.

Bevat alleen lijst-ID's en object-ID's. Sluit voor meer informatie aan bij het databaseobject lijsten.

Dit databaseobject kan de volgende kolommen teruggeven:

Voorbeeld 1

De ID's ophalen van alle contactpersonen in de lijst Top-abonnees 2021.

Query:

Terug:

Voorbeeld 2

Haal de voor- en achternamen op van details van contactpersonen in de lijst Top-abonnees 2021.

Query:

Terug:

FAQ's

Ik wil gegevens genereren die lijken op een rapport van de Hubspot-app, hoe pak ik dat aan?

In het algemeen wilt u kijken naar de kolommen in het rapport waarmee u vergelijkt. Als de rapportvisualisatie niet in tabelvorm is, zal het converteren naar een tabel de kolommen tonen die het rapport bevat. Deze kolommen zijn meestal eigenschappen van een objecttype of een gebeurtenistype. De volgende stap is uitzoeken met welke objecttype-eigenschap een kolom overeenkomt. U kunt dit doen door property_definitions te bevragen:

Er is niet altijd een exacte overeenkomst omdat sommige namen van eigenschappen gewoonlijk worden omgezet in een meer beschrijvende naam in de app. In zulke gevallen kan een fuzzy search met de LIKE operator op de label (of zelfs de beschrijving) kolom in property_definitions helpen.

Nadat is vastgesteld bij welk objecttype de kolom hoort, is het triviaal om te bepalen waarnaar moet worden gezocht. U kunt gewoon zoeken naar de object_x view die overeenkomt met het type.

Hoe koppel ik dit gegevenstype aan een ander, bijvoorbeeld hoe haal ik formulieren voor een campagne op?

Als je twee of meer verschillende records aan elkaar moet koppelen, kijk dan eens naar associaties. Associaties vertegenwoordigen de relaties tussen objecten in het HubSpot CRM. Alle verschillende associaties die mogelijk zijn tussen twee typen staan vermeld in association_definitions. In het bovenstaande voorbeeld, om te weten aan welke formulieren een campagne is gekoppeld, moet je ASSOCIATIONS_CAMPAIGNS_TO_FORMS bevragen: