HubSpotでは所有者を使用して特定のユーザーにCRMオブジェクトを割り当てます。これらのAPIエンドポイントはアカウント上で利用可能な所有者のリストを取得するために使用します。
GET
リクエストを/crm/v3/owners
に送信します。レスポンスでは、各ユーザーの名前、Eメール、ID値、作成/更新日付、および該当する場合はチーム情報が返されます。返される次の2つのID値は、それぞれ異なる目的で使用されます。
id
:所有者のID。この値は、特定の所有者に関する情報を取得するとき、および所有者をレコードまたはアクティビティーに割り当てるときに使用されます。userId
:ユーザーのID。この値を使用して設定APIでユーザーを指定できます。ただし所有権の割り当てにこれを使用するとエラーが発生します。true
に設定したarchived
パラメーターを追加します。アーカイブされたユーザーにもid
値はありますが、userId
値はnull
になります。この場合、ユーザーIDはuserIdIncludingInactive
フィールドに格納されます。
例:
GET
リクエストを/crm/v3/owners/{ownerId}
に送信します。詳細を取得する対象の所有者を指定するには、id
値を使用する必要があります。
updatedAt
値は、Ownerオブジェクト自体の更新に基づいて変更されます。Userオブジェクトに変更が加えられても更新されません。例えば、ユーザーの権限を変更してもupdatedAt
値は更新されません。