HubSpot V3 データモデル
CData Cmdlets PowerShell Module for HubSpot は、HubSpot CRM API v3 オブジェクトをリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。 このセクションでは、API の制限および要件について説明します。既定の SupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。
テーブル
テーブル describes a sample of the available standard tables. The standard table definitions and custom tables are dynamically retrieved during runtime; here, we show the sample table definitions for the standard HubSpot Objects. Note that Custom Objects are exposed as tables with a "__c" appended to the end of the name.
You can find more detailed information for the available HubSpot Custom Objects by querying the views: CustomObjects, CustomObjectProperties and CustomObjectAssociations.
You can Create new HubSpot Custom Objects (tables) or Update and Delete existing ones via the stored procedures: CreateCustomObject, UpdateCustomObject and DeleteCustomObject. Additionally, you can add, update or remove Custom Properties (columns) to both Standard and Custom HubSpot Objects (tables) through the stored procedures: CreateCustomProperty, UpdateCustomProperty and DeleteCustomProperty.
The HubSpot Data Provider exposes the HubSpot Object Associations as tables, through which the user can retrieve and manage the associated records between different object types. By default, and if the ExpandAssociations connection property is false, one associations table is exposed for each HubSpot object with available associations (ex. DealAssociations, CompanyAssociations, ContactAssociations, etc.). In case the ExpandAssociations connection property is true, the driver exposes one associations table for each association between two HubSpot object types (for example, CompaniesToContactsAssociations, ContactsToDealsAssociations, DealsToLineitemsAssociations, etc.). Refer to ContactAssociations and ContactsToDealsAssociations for a simple guide with examples on how to get the associated records, add new associated records and remove existing ones.
To retrieve, add and remove associations between a custom object type and other objects types (standard or custom objects) the user can utilize the table CustomObjectAssociations.
ストアドプロシージャ
ストアドプロシージャ は、データソースのファンクションライクなインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。
CRM API V3 の改善(V1 およびV2 との比較)
- 最も重要なテーブルのフィルタリング機能。次の演算子がサポートされています:=、!=、>、<、<=、>=。
- Filtering using AND and OR combinations. A maximum of 2 OR operators are supported server-side, with each of these operators supporting up to 2 AND operators inside of them.
- 最も重要なテーブルのソート機能。API によるソートがサポートされているのは1カラムのみです。
- Support for 'Batch' operations (Batch INSERT, Batch Update, Batch Delete).
- Support for Creating, Updating and Deleting Custom HubSpot Objects (tables) and Properties (columns).
CRM API V3 の制限
- PageSize を100より大きくすることはできません。
- フィルタリングは、返される行数が10,000 より小さい場合にのみ使用可能です。クエリに対して返される行がさらにある場合は、すべての行が先に取得され、本製品 によってフィルタリングが適用されます。
- フィルタリングリクエストまたはソートリクエストのいずれかを発行する場合、1秒あたり1リクエストまで許可されます。
- いくつかのカラム("CreatedAt" や"UpdatedAt" など)はフィルタをサポートしていません。
- The stored procedures to Create/Update Custom Objects may not work for the OAuth Authentication Scheme, since the OAuth apps are limited to the read-only access scope for Custom Objects. To work around this limitation, you can connect via a Private App Token.