セールス担当者

営業担当者エンドポイント参照

営業担当者APIは、Microsoft Dynamics SyncまたはSFDC Syncが有効になっているサブスクリプションに対して、読み取り専用アクセスを提供します。

セールスパーソンは、リードレコードのセールスオーナーを表す個人レコードです。 各リードレコードのexternalSalesPersonId フィールドは、リードを営業担当者に関連付けます。 このフィールドが入力されると、Marketoはリードレコードの対応するリード所有者のルックアップフィールドに入力します。 その後、関連するフィルターとトークンを使用できます。

externalSalesPersonId属性を対応するエンドポイントに渡すことにより、セールス担当者を他のレコードに関連付けます。

セールス担当者レコードは、API 経由でのみ編集可能です。

説明

リードデータベースオブジェクトの標準パターンを使用して、セールス担当者のレコードを記述します。

GET /rest/v1/salespersons/describe.json
{
   "requestId":"185d6#14b51985ff0",
   "success":true,
   "result":[
      {
         "name":"SalesPerson",
         "createdAt":"2015-02-03T22:36:23Z",
         "updatedAt":"2015-02-03T22:36:24Z",
         "idField":"id",
         "dedupeFields":[
            "externalSalesPersonId"
         ],
         "searchableFields":[
            [
               "email"
            ],
            [
               "id"
            ],
            [
               "externalSalesPersonId"
            ]
         ],
         "fields":[
            {
               "name":"id",
               "displayName":"Marketo Id",
               "dataType":"integer",
               "updateable":false
            },
            {
               "name":"createdAt",
               "displayName":"Created At",
               "dataType":"datetime",
               "updateable":false
            },
            {
               "name":"updatedAt",
               "displayName":"Updated At",
               "dataType":"datetime",
               "updateable":false
            },
            {
               "name":"email",
               "displayName":"Email",
               "dataType":"string",
               "length":255,
               "updateable":false
            },
            {
               "name":"externalSalesPersonId",
               "displayName":"External Sales Person Id",
               "dataType":"string",
               "length":255,
               "updateable":false
            }
         ]
      }
   ]
}

デフォルトでは、営業担当者idFieldは「id」で、dedupeFieldsは「externalSalesPersonId」です。

クエリ

シンプルなキーに対して標準のクエリパターンを使用して、営業担当者に対してクエリを実行します。 次の例では、ユーザーのメールをexternalSalesPersonIdとして使用します。

デフォルトでは、クエリは、一致するレコードの入力されたすべてのフィールドを返します。

GET /rest/v1/salespersons.json?filterType=dedupeFields&filterValues=david@test.com,sam@test.com
 {
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "seq":0,
         "id":53453,
         "externalSalesPersonId":"sam@test.com",
         "createdAt":"2015-02-03T22:36:23Z",
         "updatedAt":"2015-02-03T22:36:23Z"
      },
      {
         "seq":1,
         "id":53454,
         "externalSalesPersonId":"david@test.com",
         "createdAt":"2015-02-03T22:36:23Z",
         "updatedAt":"2015-02-03T22:36:23Z"
      }
   ]
}

作成と更新

標準の更新パターンを使用して、営業担当者を作成または更新します。

POST /rest/v1/salespersons.json
{
   "action":"createOrUpdate",
   "dedupeBy":"dedupeFields",
   "input":[
      {
         "externalSalesPersonId":"sam@test.com",
         "email":"sam@test.com",
         "firstName":"Sam",
         "lastName":"Sanosin"
      },
      {
         "externalSalesPersonId":"david@test.com",
         "email":"david@test.com",
         "firstName":"David",
         "lastName":"Aulassak"
      }
   ]
}
{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "seq":0,
         "status": "updated",
         "id":45232
      },
      {
         "seq":1,
         "status": "created",
         "id":45236
      }
   ]
}

削除

標準の削除パターンを使用して営業担当者を削除します。

「使用中」の営業担当者を削除することはできません。 次の場合、リクエストは営業担当者をスキップします。

  • セールス担当者は、アクティブなリードに関連付けられています。
  • 営業担当者は、削除された会社に関連付けられています。
POST /rest/v1/salespersons/delete.json
{
   "deleteBy":"dedupeFields",
   "input":[
      {
         "externalSalesPersonId":"sam@test.com"
      },
      {
         "externalSalesPersonId":"david@test.com"
      },
      {
         "externalSalesPersonId":"raj@test.com"
      }
   ]
}
{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "seq":0,
         "id":56343,
         "status": "deleted"
      },
      {
         "seq":1,
         "id":53453,
         "status": "deleted"
      },
      {
         "seq":2,
         "status": "skipped"
         "reasons":[
            {
               "code":"1013",
               "message":"Record not found"
            }
         ]
      }
   ]
}

タイムアウト

  • 特に明記されていない限り、営業担当者のエンドポイントのタイムアウトは30秒です。
  • Sync Sales Personのタイムアウトは60秒です。
  • 営業担当者の削除のタイムアウトは60秒です。
recommendation-more-help
marketo-developer-help