Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel3
typeflat

...

Overview

The following operations allow you to work with email groups. Click an operation name to see details on how to use it.

For a sample proxy service that illustrates how to work with email groups, see Sample configuration.

OperationDescription
1Working with Email Groups in EloquagetEmailGroupsRetrieves all email groups that match the criteria specified in the parameters..
1Working with Email Groups in EloquagetEmailGroupByIdRetrieves the email group with the specified id.

Operation Details

This section provides further details on the operations related to email groups.

Anchor
getEmailGroups
getEmailGroups
Get Email Groups

The getEmailGroups operation retrieves all email groups that match the specified criteria.

Code Block
languagexml
titlegetEmailGroups
<eloqua.getEmailGroups>
    <limit>{$ctx:limit}</limit>
    <offset>{$ctx:offset}</offset>
    <orderBy>{$ctx:orderBy}</orderBy>
    <q>{$ctx:q}</q>
	<totalResults>{$ctx:totalResults}</totalResults>
</eloqua.getEmailGroups>
properties
  • limit: Specifies maximum number of records to return.

  • offset : Specifies an offset that allows to retrieve the next batch of records.

  • orderBy : Term to order the results by..

  • q : Specifies query criteria used to filter resultl.

  • totalResults: The total number of records that satisfy the request.
Anchor
sampleRequest
sampleRequest
Sample request

Following is a sample REST/JSON request that can be handled by the getEmailGroups operation.

Code Block
languagexml
titleSample request for getEmailGroups
{
    "refreshToken":"MTYXXXXU5MDoxc2FtZGNnazJWay03SYWhYflNJTlkxY2VtQ2M1RDFrVmpifjlXaEJFV35Ddk9qelplQXXXXXXVNoT25D",
    "redirectUri":"https://esbconnectors.blogspot.com",
    "clientId":"1dxxx80-3848-4a3f-a225-6s92fexxxa8",
    "clientSecret":"1K-yOHxxxgHr-Dm5saaskn0wsOj3eouQnbzXXXVT~NXXhdkldszB-dRad9TxHzcxxxFiiSSLtuL8zBZeXZ",
    "apiVersion":"2.0",
    "scope":"full",
    "totalResults":"true",
    "q":"name='Email*'",
    "orderBy":"name DESC",
    "offset":"0",
    "limit":"10"   
}
Related Eloqua documentation

http://docs.oracle.com/cloud/latest/marketingcs_gs/OMCBB/Content/D_Reference/endpoints/emailGroups/get.htm

Anchor
getEmailGroupById
getEmailGroupById
Get Email Group By Id

The getEmailGroupById operation retrieves the email group with the specified id..

Code Block
languagexml
titlegetEmailGroupById
<eloqua.getEmailGroupById>
	<emailGroupId>{$ctx:emailGroupId}</emailGroupId>
</eloqua.getEmailGroupById>
properties
  • emailGroupId: The id of the email group.

Sample Request

Following is a sample REST/JSON request that can be handled by the getEmailGroupById operation.

Code Block
languagexml
titleSample request for getEmailGroupById
{
    "refreshToken":"MTYXXXXU5MDoxc2FtZGNnazJWay03SYWhYflNJTlkxY2VtQ2M1RDFrVmpifjlXaEJFV35Ddk9qelplQXXXXXXVNoT25D",
    "redirectUri":"https://esbconnectors.blogspot.com",
    "clientId":"1dxxx80-3848-4a3f-a225-6s92fexxxa8",
    "clientSecret":"1K-yOHxxxgHr-Dm5saaskn0wsOj3eouQnbzXXXVT~NXXhdkldszB-dRad9TxHzcxxxFiiSSLtuL8zBZeXZ",
    "apiVersion":"2.0",
    "scope":"full",
	"emailGroupId":"1"  
}
Related Eloqua documentation

http://docs.oracle.com/cloud/latest/marketingcs_gs/OMCBB/Content/D_Reference/endpoints/emailGroups/get-id.htm

Anchor
sampleProxyEmailGroups
sampleProxyEmailGroups
Sample Configuration

Following is a sample proxy service that illustrates how to connect to Eloqua with the getAccessTokenFromRefreshToken operation and use the getEmailGroups operation. The sample request for this proxy can be found in getEmailGroups sample request. You can use this sample as a template for using other operations in this category.

...