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

Lead

見込みの、または潜在的な Opportunity を表します。

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

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 との比較で示します。値は、`[同期済み]`、`[不一致]`、`[レビュー済み]`、`[該当なし]`、`[無効]`、`[未比較]`、`[一致を選択]`、`[スキップしました]` のいずれかです。
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 プロスペクタまたは Data.com クリーンアップを使用する組織でのみ使用できます。メモ
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 以降では、ConnectionSentId 項目はサポートされていません。ConnectionSentId 項目は使用できますが、値は Null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
ConvertedAccountId	型 reference プロパティ Filter、Group、Nillable、Sort 説明 Lead が変換される Account を示すオブジェクト参照 ID。
ConvertedContactId	型 reference プロパティ Filter、Group、Nillable、Sort 説明 Lead が変換される Contact を示すオブジェクト参照 ID。
ConvertedDate	型 date プロパティ Filter、Group、Nillable、Sort 説明この Lead が変換された日付。
ConvertedOpportunityId	型 reference プロパティ Filter、Group、Nillable、Sort 説明 Lead が変換される Opportunity を示すオブジェクト参照 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 プロパティ 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 説明リードのメール送信が除外されているか (`true`)、否か (`false`) を示します。表示ラベルは [メール送信除外] です。
Industry	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの業種。
IsConverted	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明 Lead が変換されているか (`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.com カスタマーサポートにお問い合わせください。
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://na1.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 説明リードの敬称。
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.com カスタマーサポートにお問い合わせください。
Title	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 CFO や CEO など、リードの役職。
Website	型 url プロパティ Create、Filter、Group、Nillable、Sort、Update 説明リードの Web サイト。

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

メモ

変換済みのリード

リードが Account、Contact、Opportunity (オプション) に変換されたことを示す特別な状況があります。クライアントアプリケーションは、convertLead() コールを使用してリードを変換することができます。また、ユーザはユーザインターフェースを使用してリードを変換することもできます。リードが変換されると、参照のみになります。変換されたリードは、更新または削除できません。ただし、変換されたリードレコードをクエリすることはできます。

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

ConvertedAccountId
ConvertedContactId
ConvertedDate
ConvertedOpportunityId
IsConverted
Status

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

メモ

未読のリード

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

リード状況選択リスト

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

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

使用方法

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

リードを作成、更新、または更新/挿入すると、クライアントアプリケーションは、ユーザインターフェースで設定された割り当てルールに基づいて、リードを 1 つ以上の User レコードに自動的に割り当てることができます。

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

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

Java のサンプル

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

C# のサンプル

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

Salesforce および Force.com のオブジェクトリファレンス

No Results