この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Lead

見込み客またはリードを表します。

サポートされているコール

create()、delete()、describeLayout()、describeSObjects()、getDeleted()、getUpdated()、merge()、query()、retrieve()、search()、undelete()、update()、upsert()

項目

項目	詳細
Address	型 address プロパティ Filter、Nillable 説明複合型の住所。参照のみ。複合住所項目についての詳細は、「住所複合項目」を参照してください。
AnnualRevenue	型 currency プロパティ Create、Filter、Nillable、Sort、Update 説明リードの会社の年間売上。
City	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の市区郡。
CleanStatus	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明レコードのクリーンアップ状況を Data.com との比較で示します。`Matched`、`Different`、`Acknowledged`、`NotFound`、`Inactive`、`Pending`、`SelectMatch`、`Skipped` などの値があります。 CleanStatus のいくつかの値は、異なる表示ラベルでリードレコードに表示されます。 `Matched` は `[同期済み]` として表示される `Acknowledged` は `[レビュー済み]` として表示される `Pending` は `[未比較]` として表示される
Company	型 string プロパティ Create、Filter、Group、Sort、Update 説明必須。リードの会社。個人取引先レコードタイプが有効化されており、Company の値が null の場合、リードは個人取引先に変換されます。メモ
CompanyDunsNumber	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 Data Universal Numbering System (D-U-N-S) Number。これは、Dun & Bradstreet データベース内の、それぞれ事業が異なる一意の各事業所に割り当てられた一意の 9 桁の番号です。D-U-N-S Number は、事業の識別と追跡のための世界標準として��界と企業で使用されています。最大 9 文字です。この項目は、Data.com Prospector または Data.com Clean を使用する組織でのみ使用できます。メモ
ConnectionReceivedId	型 reference プロパティ Filter、Group、Nillable、Sort 説明組織とこのレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。
ConnectionSentId	型 reference プロパティ Filter、Group、Nillable、Sort 説明このレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。この項目は、API バージョン 15.0 以前を使用する場合にサポートされます。他の API バージョンでは、この項目の値は null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
ConvertedAccountId	型 reference プロパティ Filter、Group、Nillable、Sort 説明リードの変換先である取引先を示すオブジェクト参照 ID。
ConvertedContactId	型 reference プロパティ Filter、Group、Nillable、Sort 説明リードの変換先である取引先責任者を示すオブジェクト参照 ID。
ConvertedDate	型 date プロパティ Filter、Group、Nillable、Sort 説明このリードが変換された日付。
ConvertedOpportunityId	型 reference プロパティ Filter、Group、Nillable、Sort 説明リードの変換先である商談を示すオブジェクト参照 ID。
Country	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの国。
CountryCode	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の ISO 国コード。
CurrencyIsoCode	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明複数の currency 機能を有効化している組織にのみ使用できます。組織で使用できる currency の ISO コードが指定されています。
Description	型 textarea プロパティ Create、Nillable、Update 説明リードの説明。
Division	型 picklist プロパティ Defaulted on create、Filter、Group、Restricted picklist、Sort 説明組織のデータの論理セグメントです。たとえば、会社がさまざまな事業単位によって構成されている場合、「北米」、「ヘルスケア」、「コンサルティグ」など、各事業単位のディビジョンを作成することができます。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
Email	型 email プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードのメールアドレス。
EmailBouncedDate	型 dateTime プロパティ Filter、Nillable��Sort、Update 説明不達管理が有効化されているときに、リードに送信したメールが宛先不明で戻ってきた場合のメールの返送日時。
EmailBouncedReason	型 string プロパティ Filter、Group、Nillable、Sort、Update 説明不達管理が有効化されているときに、リードに送信したメールが宛先不明で戻ってきた場合のメールの返送理由。
Fax	型 phone プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの FAX 番号。
FirstName	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明最大 40 文字のリードの名。
HasOptedOutOfEmail	型 boolean プロパティ Create、Defaulted on create、Filter、Update 説明リードが Salesforce からのメールの受信を希望しないか (`true`)、希望するか (`false`) を示します。表示ラベルは Email Opt Out です。
GeocodeAccuracy	型 picklist プロパティ Retrieve、Query、Restricted picklist、Nillable 説明住所の地理コードの精度レベル。地理位置情報複合項目についての詳細は、「複合項目の考慮事項と制限」を参照してください。
IndividualId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明このリードに関連付けられたデータプライバシーレコードの ID。この項目は、[設定] で [データ保護とプライバシー] が有効になっている場合に使用できます。
Industry	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの業種。
IsConverted	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明リードが変換されているか (`true`)、否か (`false`) を示します。表示ラベルは [取引開始済み] です。
IsDeleted	型 boolean プロパティ Defaulted on create、Filter 説明オブジェクトがごみ箱に移動したか (`true`)、否か (`false`) を示します。表示ラベルは Deleted です。
IsUnreadByOwner	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明 true の場合、リードは割り当てられますが、参照されません。詳細は、「未読のリード」を参照してください。表示ラベルは [所有者未読フラグ] です。
Jigsaw	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 Data.com の取引先責任者の ID を参照します。リードのこの項目に値がある場合、その取引先責任者が Data.com からリードとしてインポートされたことを意味します。Data.com から取引先責任者 (リードに変換済み) がインポートされていない場合は、この項目の値は null です。最大 20 文字です。API バージョン 22.0 以降で使用できます。表示ラベルは Data.com Key です。 Jigsaw 項目は、インポートエラーのトラブルシューティングと訂正されたデータの再インポートをサポートするために、API に表示されています。Jigsaw 項目の値を変更しないでください。重要
LastActivityDate	型 date プロパティ Filter、Group、Nillable、Sort 説明値は、次のいずれか新しい方になります。レコードに対して記録された直近の行動の期日。レコードに関連付けられた ToDo のうち直近に完了したものの期日。
LastName	型 string プロパティ Create、Filter、Group、Sort、Update 説明必須。最大 80 文字のリードの姓。
LastReferencedDate	型 date プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate	型 date プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
Latitude	型 double プロパティ Create、Filter、Nillable、Sort、Update 説明 Longitude と一緒に使用して、住所の正確な地理位置情報を指定します。許容値は、–90 ～ 90 (小数点以下 15 桁まで) の数値です。地理位置情報複合項目についての詳細は、「複合項目の考慮事項と制限」を参照してください。
Longitude	型 double プロパティ Create、Filter、Nillable、Sort、Update 説明 Latitude と一緒に使用して、住所の正確な地理位置情報を指定します。許容値は、–180 ～ 180 (小数点以下 15 桁まで) の数値です。地理位置情報複合項目についての詳細は、「複合項目の考慮事項と制限」を参照してください。
LeadSource	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの供給元。
MasterRecordId	型 reference プロパティ Filter、Group、Nillable、Sort 説明このレコードが結合の結果として削除された場合、この項目には保存されていたレコードの ID が入力されます。他の理由でこのレコードが削除された場合、または削除されていない場合、値は `null` となります。 Apex トリガを使用してマージイベントで削除されたレコードを判断する場合、この項目の値は `Trigger.old` に残っているレコードの ID となります。`Trigger.new` では、値は `null` となります。メモ
MiddleName	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明最大 40 文字のリードのミドルネーム。この項目を有効化するには、Salesforce カスタマーサポートに依頼してください。
MobilePhone	型 phone プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの携帯電話番号。
Name	型 string プロパティ Filter、Group、Sort 説明 FirstName、MiddleName、LastName、Suffix の連結 (最大 121 文字)。
NumberOfEmployees	型 int プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの会社の従業員数。表示ラベルは [従業員数] です。
OwnerId	型 reference プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明リードの所有者の ID。
PartnerAccountId	型 reference プロパティ Filter、Nillable 説明このリードを所有するパートナーユーザのパートナー取引先の ID。PRM 機能が有効な場合、またはコミュニティが有効になっていて、パートナーポータルライセンスを所有している場合に使用できます。 API バージョン 15.0 以前を使用してリードをアップロードしており、バッチのいずれかのリードにパートナーユーザが所有者として指定されている場合、バッチ内のすべてのリードの [パートナー取引先] 項目が、パートナーユーザが所有者であるかどうかに関係なく、パートナーユーザの取引先に設定されます。バージョン 16.0 では、[パートナー取引先] 項目は、リードを所有するパートナーユーザの該当する取引先に設定されます。リードの所有者がパートナーユーザでない場合、この項目は空のままです。メモ
Phone	型 phone プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの電話番号。
PhotoUrl	型 url プロパティ Filter、Group、Sort 説明リードと関連付けられたソーシャルネットワークプロファイルの画像を要求するための URL を生成するために Salesforce インスタンス (例: https://`yourInstance`.salesforce.com/ など) の URL と組み合わせるパス。生成された URL から、リードのソーシャルネットワークプロファイルの画像への HTTP リダイレクト (コード 302) が返されます。 [ソーシャル取引先と取引先責任者] が有効になっていない場合、または要求ユーザに対して [ソーシャル取引先と取引先責任者] が無効になっている場合は、空になります。
PostalCode	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の郵便番号。表示ラベルは [郵便番号] です。
Rating	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの評価。
RecordTypeId	型 reference プロパティ Create、Filter、Nillable、Update 説明このオブジェクトに割り当てられるレコードタイプの ID。
Salutation	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの敬称。
ScoreIntelligenceId	型 reference プロパティ Filter、Group、Nillable、Sort 説明リードスコアを含むインテリジェントな項目レコードの ID。
State	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の都道府県。
StateCode	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の ISO 都道府県コード。
Status	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明変換されたリードの状況コード。状況コードは、Status に定義され、LeadStatus オブジェクトごとに API に表示されます。
Street	型 textarea プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの住所の地名、番地。
Suffix	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明最大 40 文字のリードの名前サフィックス。この項目を有効化するには、Salesforce カスタマーサポートに依頼してください。
Title	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 CFO や CEO など、リードの役職。
Website	型 url プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの Web サイト。

リードデータをインポートし、CreatedDate など、監査項目に値を設定する必要がある場合は、Salesforce にお問い合わせください。これらの項目を自身で設定する必要がない限り、監査項目は API 操作時に自動的に更新されます。

メモ

変換済みのリード

リードが取引先、取引先責任者、商談 (オプション) に変換されていることを示す特別な状態になっています。クライアントアプリケーションは、convertLead() コールを使用してリードを変換することができます。また、ユーザは Salesforce でリードを変換することもできます。リードは変換されると参照のみになります。ただし、変換されたリードレコードを照会することはできます。

リードには、変換された状況を示すいくつかの項目があります。これらの項目は、ユーザインターフェースでリードを変換する場合に設定されます。

ConvertedAccountId
ConvertedContactId
ConvertedDate
ConvertedOpportunityId
IsConverted
Status

個人取引先レコードタイプが有効化されており、Company の値が null の場合、リードは個人取引先に変換されます。

メモ

未読のリード

リードには、リード所有者が参照していないまたは編集していないことを示す特別な状況があります。Salesforce では、これは、ユーザに割り当てられたがまだ処理されていないリードを把握するのに役立ちます。リード所有者がまだリードを参照も編集もしていない場合、IsUnreadByOwner 項目が true になります。リード所有者がリードを少なくとも一度は参照または編集している場合は false となります。

リード状況選択リスト

Status の値は、ユーザインターフェースで定義されているように、リード状況選択リストの変換された状況または変換されていない状況に対応します。選択リストでリードの状況値を取得するには、クライアントアプリケーションは、LeadStatus を照会できます。

API を使用して、変換済みのリードの状態を示すいずれかの値に Status を変更することで、リードを変換することはできません。評価済みリードを取引先、取引先責任者、商談に変換する際に、リードに対して、変換済みであることを示す状況のタイプを 1 つ選択できます。こうしたタイプを割り当てられたリードは、レポートに含めることはできますが、[リード] タブには表示されなくなります。

使用方法

リードを更新するか、convertLead() を使用してリードを変換するには、リードに対する「編集」権限でクライアントアプリケーションにログインします。

リードを作成、更新、または更新/挿入する場合、クライアントアプリケーションは、Salesforce で設定された割り当てルールに基づいて、リードを複数のユーザレコードに割り当てることができます。

この機能を使用するために、クライアントアプリケーションは、create または update で使用する AssignmentRuleHeader に次のオプションのいずれか (両方ではない) を設定する必要があります。

項目	データ型	詳細
assignmentRuleId	reference	使用する割り当てルールの名前。無効な割り当てルールの場合があります。指定されていない場合および useDefaultRule が `true` の場合、デフォルトの割り当てルールが使用されます。指定された割り当てルールの ID を検索するには、AssignmentRule オブジェクトを照会し (`RuleType="leadAssignment"` を指定)、返される AssignmentRule レコードを反復し、使用する割り当てルールを検索してその ID を取得し、AssignmentRuleHeader のこの項目に取得した ID を設定します。
useDefaultRule	boolean	ルールに基づいた割り当てのデフォルトルールを使用するか (`true`)、否か (`false`) を示します。デフォルトのルールは、ユーザインターフェースで割り当てられます。

Java のサンプル

次の Java のサンプルでは、新しく作成されたリードを自動的にどのように割り当てるかを示しています。

C# のサンプル

次の C# のサンプルでは、新しく作成されたリードを自動的にどのように割り当てるかを示しています。

Salesforce および Lightning プラットフォームのオブジェクトリファレンス