GetConsumerEmailOptInsRequest
October2010
Returns a consumer email's opt in status.
Service:People
Method:GetPreferences
Permission:GetConsumerEmailOptInsRequest
Properties
| Name | Type | Required | Description |
|---|---|---|---|
| MarketingCategories | MarketingCategoryBulkIdentifier | Required | |
| EmailAddress | String | Required |
Exceptions
| Exception | Severity | Code | Condition |
|---|---|---|---|
| ArgumentMissing | Critical | 10010001 | A required request input has not been specified. |
| IdentifierDoesNotExist | Critical | 10010002 | The specified membership interaction identifier does not exist. |
| MultipleRecordsFound | Critical | 10010004 | Multiple records found for the identifier. |
| DuplicateInputFound | Critical | 10010015 | Duplicate input was found. |
Examples
The following is an XML example of the GetConsumerEmailOptInsRequest sent to the People.GetPreferences method.
<soapenv:Envelope xmlns:ns="http://schemas.gallup.com/oms/2010/10/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header />
<soapenv:Body>
<ns:GetPreferences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ns:request i:type="a:GetConsumerEmailOptInsRequest" xmlns:a="http://schemas.gallup.com/oms/2010/10/People">
<a:MarketingCategories i:type="b:MarketingCategoryBulkCodeNameIdentifier" xmlns:b="http://schemas.gallup.com/oms/2010/10/Identifiers">
<b:CodeNames i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
</a:MarketingCategories>
<a:EmailAddress>someone@somewhere.com</a:EmailAddress>
</ns:request>
</ns:GetPreferences>
</soapenv:Body>
</soapenv:Envelope>