Newer Version Available

This content describes an older version of this product. View Latest

Datacloud Class

Purchase Data.com contact or company records, and retrieve purchase information.

Usage

Use the ConnectApi.Datacloud class to purchase contact or company records from Data.com by using points, and get Data.com record purchase information for your organization.

Datacloud Methods

The following are methods for Datacloud. All methods are static.

getCompaniesFromOrder(String, String, String)

Retrieves a list of purchased company records for a specific orderId, call getCompaniesFromOrder(orderId, page, pageSize).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudCompanies getCompaniesFromOrder(String orderId, String pageSize, String page)

Parameters

orderId
Type: String
A unique number that identifies an order.
page
Type: String
The number of the page that you want returned.
pageSize
Type: String
The number of companies to show on a page. The default pageSize is 25.

Return Value

Type: ConnectApi.DatacloudCompanies

getCompany(String)

Retrieves a company record from an identification number, call getCompany(companyId).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudCompany getCompany(String companyId)

Parameters

companyId
Type: String
A numeric identifier for a company in the Data.com database.

Return Value

Type: ConnectApi.DatacloudCompany

Example

1ConnectApi.DatacloudCompany DatacloudCompanyRep = ConnectApi.Datacloud.getCompany(companyId);

getContact(String)

Retrieves a contact record from an identification number, call getContact(contactId).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudContact getContact(String contactId)

Parameters

contactId
Type: String
A unique numeric string that identifies a contact in the Data.com database.

Return Value

Type: ConnectApi.DatacloudContact

Example

1ConnectApi.DatacloudContact DatacloudContactRep = ConnectApi.Datacloud.getContact(contactId);

getContactsFromOrder(String, String, String)

Retrieves a list of purchased contacts for a specific orderId , call getContactsFromOrder(orderId, page, pageSize).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudContacts getContactsFromOrder(String orderId, String page, String pageSize)

Parameters

orderId
Type: String
A unique number that’s associated with an order.
page
Type: String
The number of the page that you want returned.
pageSize
Type: String
The number of contacts to show on a page. The default pageSize is 25.

Return Value

Type: ConnectApi.DatacloudContacts

getOrder(String)

Retrieves purchased records for a specific orderId , call getOrder(orderId).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudOrder getOrder(String orderId)

Parameters

orderId
Type: String
A unique number that identifies an order.

Return Value

Type: ConnectApi.DatacloudOrder

Example

1ConnectApi.DatacloudOrder datacloudOrderRep = ConnectApi.Datacloud.getOrder(orderId);

getUsage(String)

Retrieves purchase usage information for a specific user, call getUsage(userId).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudPurchaseUsage getUsage(String userId)

Parameters

userId
Type: String
A unique number that identifies a single user.

Example

1ConnectApi.DatacloudPurchaseUsage datacloudPurchaseUsageRep = ConnectApi.Datacloud.getUsage(userId);

postOrder(ConnectApi.DatacloudOrderInput)

Purchase records that are listed in an input file, call postOrder(ConnectApi.DatacloudOrderInput orderInput).

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.DatacloudOrder postOrder(ConnectApi.DatacloudOrderInput orderInput)

Parameters

orderInput
Type: ConnectApi.DatacloudOrderInput
A list that contains IDs for the contacts or companies that you want to see.

Return Value

Type: ConnectApi.DatacloudOrder

Example

1ConnectApi.DatacloudOrderInput inputOrder=new ConnectApi.DatacloudOrderInput();
2List<String> ids=new List<String>();
3ids.add('1234');
4inputOrder.companyIds=ids;
5ConnectApi.DatacloudOrder datacloudOrderRep = ConnectApi.Datacloud.postOrder(inputOrder);