Leads
Marketo の組織のリードを作成、更新、削除、クエリします。
テーブル固有の情報
Select
すべてのカラムは '=' 演算子を使って指定される必要があります。Id およびEmail カラムでは、OR 論理演算子を使って複数の値を指定できます。 OldestUpdatedAt カラムはsince クライテリアとして動作します。until クライテリアを設定するLatestUpdatedAt カラムを追加することで範囲を指定することができます。
取得したい行とカラムだけを指定することで、サーバーからの応答時間を向上できます。
SELECT Id, FirstName, LastName FROM Leads WHERE Email = '[email protected]' OR Email = '[email protected]'
Insert
新しいLead レコードを作成するには、Lead に関するデータベースに入力する情報を指定します。
次の例では、新しいLead を挿入する方法を説明します。
INSERT INTO Leads (Email, FirstName, LastName) VALUES ('[email protected]', 'John', 'Mark')
Update
読み取り専用以外のフィールドは、すべて更新可能です。
UPDATE Leads SET MobilePhone = '111-222-3333' WHERE Id = '1'
Delete
Marketo API はLead の削除を直接サポートしていません。しかし、API 呼び出しから実行されるキャンペーンを作成し、キャンペーンのフローの一部としてLead の削除をトリガすることでLead を削除することができます。 このようなキャンペーンの作成方法についての詳細は、こちらから:http://developers.marketo.com/blog/delete-a-lead-with-the-marketo-api/
Marketo でキャンペーンを作成したら、削除するリードのId またはEmail カラムと併せてCampaignId またはCampaignName カラムのいずれかでキャンペーンを指定することで、削除リクエストを行うことができます。
DELETE FROM Leads WHERE Id = '1000195' AND CampaignId = '1027'
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | Integer | True |
Marketo が割り当てた、アカウントの一意の識別子。 |
| String | False |
リードのメールアドレス。 | |
| Salutation | String | False |
リードの敬称。 |
| FirstName | String | False |
リードのファーストネーム。 |
| MiddleName | String | False |
リードのミドルネーム。 |
| LastName | String | False |
リードのラストネーム。 |
| DateofBirth | Date | False |
リードの生年月日。 |
| Title | String | False |
リードの職位。 |
| Address | String | False |
リードの住所。 |
| City | String | False |
リードの住所(都市)。 |
| State | String | False |
リードの住所(都道府県)。 |
| PostalCode | String | False |
リードの住所(郵便番号)。 |
| Country | String | False |
リードの住所(国)。 |
| Website | String | False |
リードのウェブサイト。 |
| Phone | String | False |
リードの電話番号。 |
| MobilePhone | String | False |
リードの携帯電話。 |
| Fax | String | False |
リードのファックス番号。 |
| Company | String | False |
リードの企業名。 |
| MainPhone | String | False |
リードの企業の電話番号。 |
| SICCode | String | False |
リードの企業のSIC コード。 |
| Site | String | False |
リードの企業のサイト。 |
| BillingStreet | String | False |
リードの企業の請求先住所。 |
| BillingCity | String | False |
リードの企業の請求先住所(都市)。 |
| BillingState | String | False |
リードの企業の請求先住所(都道府県)。 |
| BillingPostalCode | String | False |
リードの企業の請求先住所(郵便番号)。 |
| BillingCountry | String | False |
リードの企業の請求先住所(国)。 |
| NumberOfEmployees | Integer | False |
リードの企業の従業員数。 |
| Industry | String | False |
リードの企業の業界。 |
| AnnualRevenue | Decimal | False |
リードの企業の年間収益。 |
| LeadScore | Integer | False |
リードのスコア。 |
| Rating | String | False |
リードの評価。 |
| Unsubscribed | Boolean | False |
リードが配信停止完了かどうかを決定します。 |
| UnsubscribedReason | String | False |
リードの配信停止の理由。 |
| AnonymousIP | String | False |
リードの匿名IP。 |
| Department | String | False |
リードの部門。 |
| DoNotCall | Boolean | False |
リードが連絡拒否リストに載っているかどうかを識別します。 |
| DoNotCallReason | String | False |
リードが電話連絡拒否の理由。 |
| InferredCompany | String | False |
リードの推測される企業。 |
| InferredCountry | String | False |
リードの推測される国。 |
| LeadRole | String | False |
リードのロール。 |
| LeadSource | String | False |
リードのソース。 |
| LeadStatus | String | False |
リードの現在のステータス。 |
| ForeignSysPersonId | String | False |
外部システムからのリードのId。 |
| ForeignSysType | String | False |
ForeignSysPersonId の値が由来する外部システムのタイプ。 |
| MarketoSocialFacebookDisplayName | String | False |
リードのFacebook の表示名。 |
| MarketoSocialFacebookId | String | False |
リードのFacebook Id。 |
| MarketoSocialFacebookPhotoURL | String | False |
リードのFacebook の画像URL。 |
| MarketoSocialFacebookProfileURL | String | False |
リードのFacebook のプロファイルURL。 |
| MarketoSocialFacebookReach | Integer | False |
リードのFacebook のリーチ。 |
| MarketoSocialFacebookReferredEnrollments | Integer | False |
リードのFacebook を参照元とする登録数。 |
| MarketoSocialFacebookReferredVisits | Integer | False |
リードのFacebook を参照元とする訪問数。 |
| MarketoSocialGender | String | False |
リードのソーシャルジェンダ。 |
| MarketoSocialLastReferredEnrollment | Datetime | False |
リードのソーシャルを最後の参照元とする登録。 |
| MarketoSocialLastReferredVisit | Datetime | False |
リードのソーシャルを最後の参照元とする訪問。 |
| MarketoSocialLinkedInDisplayName | String | False |
リードのLinkedIn の表示名。 |
| MarketoSocialLinkedInId | String | False |
リードのLinkedIn Id。 |
| MarketoSocialLinkedInPhotoURL | String | False |
リードのLinkedIn の画像URL。 |
| MarketoSocialLinkedInProfileURL | String | False |
リードのLinkedIn のプロファイルURL。 |
| MarketoSocialLinkedInReach | Integer | False |
リードのLinkedIn のリーチ。 |
| MarketoSocialLinkedInReferredEnrollments | Integer | False |
リードのLinkedIn を参照元とする登録数。 |
| MarketoSocialLinkedInReferredVisits | Integer | False |
リードのLinkedIn を参照元とする訪問数。 |
| MarketoSocialSyndicationId | String | False |
リードのソーシャルシンジケーションId。 |
| MarketoSocialTotalReferredEnrollments | Integer | True |
リードのソーシャルを参照元とする総登録数。 |
| MarketoSocialTotalReferredVisits | Integer | True |
リードのソーシャルを参照元とする総訪問数。 |
| MarketoSocialTwitterDisplayName | String | False |
リードのTwitter の表示名。 |
| MarketoSocialTwitterId | String | False |
リードのTwitter Id。 |
| MarketoSocialTwitterPhotoURL | String | False |
リードのTwitter の画像URL。 |
| MarketoSocialTwitterProfileURL | String | False |
リードのTwitter のプロファイルURL。 |
| MarketoSocialTwitterReach | Integer | False |
リードのTwitter のリーチ。 |
| MarketoSocialTwitterReferredEnrollments | Integer | False |
リードのTwitter を参照元とする登録数。 |
| MarketoSocialTwitterReferredVisits | Integer | False |
リードのTwitter を参照元とする訪問数。 |
| MarketoSocialYahooDisplayName | String | False |
リードのYahoo の表示名。 |
| MarketoSocialYahooPhotoURL | String | False |
リードのYahoo の画像URL。 |
| MarketoSocialYahooProfileURL | String | False |
リードのYahoo のプロファイルURL。 |
| MarketoSocialYahooReach | Integer | False |
リードのYahoo のリーチ。 |
| MarketoSocialYahooReferredEnrollments | Integer | False |
リードのYahoo を参照元とする登録数。 |
| MarketoSocialYahooReferredVisits | Integer | False |
リードのYahoo を参照元とする訪問数。 |
| MicrosoftAddress2 | String | False |
リードのMicrosoft 登録住所(2行目)。 |
| MicrosoftAddress3 | String | False |
リードのMicrosoft 登録住所(3行目)。 |
| MicrosoftBillingAddress2 | String | False |
リードのMicrosoft 登録の請求先住所(2行目)。 |
| MicrosoftBillingAddress3 | String | False |
リードのMicrosoft 登録の請求先住所(3行目)。 |
| MicrosoftDoNotEmail | Boolean | False |
リードがMicrosoft のメール連絡拒否リストに載っているかどうかを識別します。 |
| MicrosoftDoNotFax | Boolean | False |
リードがMicrosoft のファックス連絡拒否リストに載っているかどうかを識別します。 |
| MicrosoftDoNotSendMarketingMaterial | Boolean | False |
リードがMicrosoft のDo Not Send Marketing Material リストに載っているかどうかを識別します。 |
| MicrosoftHomePhone | String | False |
リードのMicrosoft 登録の自宅電話番号。 |
| MicrosoftPreferredMethodofContact | String | False |
リードのMicrosoft 登録の希望する連絡方法。 |
| MicrosoftTopic | String | False |
リードのMicrosoft トピック。 |
| SAP_CRM_ABCClassification | String | False |
リードのSAP ABC 分類。 |
| SAP_CRM_AccountID | String | False |
リードのSAP アカウントId。 |
| SAP_CRM_Account_CreatedOn | Datetime | False |
リードのSAP アカウント作成日。 |
| SAP_CRM_Account_ExternalID | String | False |
リードのSAP アカウントの外部Id。 |
| SAP_CRM_Account_Fax | String | False |
リードのSAP アカウントのファックス番号。 |
| SAP_CRM_Account_HouseNumber | String | False |
リードのSAP アカウントの家屋番号。 |
| SAP_CRM_Account_IsDeleted | Boolean | False |
リードのSAP アカウントが削除されたかどうかを識別します。 |
| SAP_CRM_Account_Status | String | False |
リードのSAP アカウントのステータス。 |
| SAP_CRM_BestReachedBy | String | False |
リードのSAP の希望コンタクト方法。 |
| SAP_CRM_ContactID | String | False |
リードのSAP コンタクトId。 |
| SAP_CRM_Contact_Name | String | False |
リードのSAP コンタクト名。 |
| SAP_CRM_DepartmentFromBusinessCard | String | False |
名刺から取得したリードのSAP 部門。 |
| SAP_CRM_EmployeeID | String | False |
リードのSAP 従業員Id。 |
| SAP_CRM_ExternalSystem | String | False |
リードのSAP 外部システム。 |
| SAP_CRM_Function | String | False |
リードのSAP ファンクション。 |
| SAP_CRM_Lead_HouseNumber | String | False |
リードのSAP 家屋番号。 |
| SAP_CRM_Name | String | False |
リードのSAP 名。 |
| SAP_CRM_Person_Type | String | False |
リードのSAP パーソンタイプ。 |
| SAP_CRM_PrimaryContact | String | False |
リードのSAP プライマリコンタクト。 |
| SAP_CRM_Qualification | String | False |
リードのSAP クオリフィケーション。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| OldestUpdatedAt | Datetime |
GET の実行時に使用されます。指定した時間以降に更新されたすべてのリードを返します。 |
| LatestUpdatedAt | Datetime |
GET の実行時に使用されます。指定した時間までに更新されたすべてのリードを返します。 |
| StaticListId | Integer |
GET の実行時に使用されます。取得する静的リストのId。 |
| StaticListName | String |
GET の実行時に使用されます。取得する静的リストの名前。 |
| CampaignSource | String |
DELETE の実行時に使用されます。キャンペーンのソースを指定するために使用されます。有効な値は、MKTOWS またはSALES です。指定しない場合は、デフォルトでMKTOWS が使用されます。 |
| CampaignId | Integer |
DELETE の実行時に使用されます。Delete Lead トリガを含むキャンペーンのId を指定するために使用されます。CampaignId およびCampaignName の両方を指定することはできません。 |
| CampaignName | String |
DELETE の実行時に使用されます。Delete Lead トリガを含むキャンペーンの名前を指定するために使用されます。CampaignId およびCampaignName の両方を指定することはできません。 |