Zum Hauptinhalt springen
GET
/
integrators
/
timeline
/
v3
/
events
/
{eventTemplateId}
/
{eventId}
イベントインスタンスを取得
curl --request GET \
  --url https://api.hubapi.com/integrators/timeline/v3/events/{eventTemplateId}/{eventId} \
  --header 'Authorization: Bearer <token>'
{
  "objectType": "contacts",
  "id": "petspot:1001298:[email protected]",
  "eventTemplateId": "1001298",
  "email": "[email protected]",
  "objectId": "28001",
  "timestamp": "2020-01-30T18:37:15.569Z",
  "tokens": {
    "petName": "Art3mis",
    "petColor": "black",
    "petAge": "3"
  },
  "extraData": {
    "questions": [
      {
        "question": "Who's a good girl?",
        "answer": "Bark!"
      },
      {
        "question": "Do you wanna go on a walk?",
        "answer": "Woof!"
      }
    ]
  },
  "timelineIFrame": {
    "linkLabel": "View Art3mis",
    "headerLabel": "Art3mis dog",
    "url": "https://my.petspot.com/pets/Art3mis",
    "width": 600,
    "height": 400
  }
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -Starter
この API には、次のいずれかのスコープが必要です。
crm.objects.companies.highly_sensitive.read.v2
crm.objects.companies.read
crm.objects.companies.sensitive.read.v2
crm.objects.contacts.highly_sensitive.read.v2
crm.objects.contacts.read
crm.objects.contacts.sensitive.read.v2
crm.objects.deals.highly_sensitive.read.v2
crm.objects.deals.read
crm.objects.deals.sensitive.read.v2
crm.schemas.companies.read
crm.schemas.contacts.read
crm.schemas.deals.read
tickets
tickets.highly_sensitive.v2
tickets.sensitive.v2
timeline

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
eventId
string
required

イベントID。

​
eventTemplateId
string
required

イベントテンプレートID。

Response

successful operation

The current state of the timeline event.

​
eventTemplateId
string
required

イベントテンプレートID。

​
id
string
required

イベントのID。アプリやイベントテンプレートに対して固有である必要があります。異なるCRMオブジェクトに同じIDを使用すると、最後に処理したオブジェクトが残り、最初のオブジェクトにはレコードがなくなります。IDの任意の場所で「{{uuid}}」を使用して固有の文字列を生成し、確実に重複させないようにすることもできます。

​
objectType
string
required

EventTemplateに関連付けられているObjectType。

​
tokens
object
required

テンプレートトークンに関連付けられているトークンキーと値のコレクション。

​
createdAt
string<date-time>
​
domain
string

イベントドメイン（UTKとペアになることが多い）。

​
email
string

コンタクト固有のイベントに使用されるEメールアドレス。既存のコンタクトの特定、新規作成、既存のコンタクトのEメールの変更に使用できます（「objectId」とペアになっている場合）。

​
extraData
object

テンプレートのMarkdownによって解釈可能な追加のイベント固有データ。

​
objectId
string

CRMオブジェクトID。コンタクト以外の全てのイベントに必要です（コンタクトの場合は、UTKまたはEメールを使用できます）。

​
timelineIFrame
object
Example:
{
  "linkLabel": "View Art3mis",
  "headerLabel": "Art3mis dog",
  "url": "https://my.petspot.com/pets/Art3mis",
  "width": 600,
  "height": 400
}
​
timestamp
string<date-time>

イベントが発生した日時。渡されなかった場合、現在の時刻であると想定されます。イベントがCRMオブジェクトのタイムラインに表示される場所を決定するために使用されます。

​
utk
string

「utk」パラメーターを使用して、「usertoken」によってイベントをコンタクトに関連付けます。ユーザーのEメールアドレスは分からないが、Cookieにユーザーを特定するトークンが含まれている場合にお勧めします。