complexType "ns:GetCharitiesRequestType"

Overview

Namespace

WSDL

Schema

Component

Index

PREV C-TYPE NEXT C-TYPE

FRAMES NO FRAMES NS-Bindings

SUMMARY: XML REP | DERIVED | USE

DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD

eBay Trading API

complexType "ns:GetCharitiesRequestType"

Namespace:	urn:ebay:apis:eBLBaseComponents
Content:	complex, 19 elements, elem. wildcard
Defined:	globally in Schema in ebaySvc.wsdl; see XML source
Includes:	definitions of 9 elements
Used:	at 1 location

Component Diagram

XML Representation Summary

<...>

Content:

</...>

All Direct / Indirect Based Elements (1):

ns:GetCharitiesRequest

Known Usage Locations

As direct type of elements (1):

ns:GetCharitiesRequest

Annotation

The GetCharities call is used to search for nonprofit organizations that are registered with the eBay for Charity program. This call allows users to search for a specific nonprofit organization, or to search for multiple nonprofit organizations from a particular charitable domain, and/or geographical region, or by using a search string.

Type Definition Detail

Type Derivation Tree

ns:AbstractRequestType (extension)

ns:GetCharitiesRequestType

XML Source (w/o annotations (10); see within schema source)

<xs:complexType name="GetCharitiesRequestType">

<xs:complexContent>

<xs:extension base="ns:AbstractRequestType">

<xs:sequence>

<xs:element minOccurs="0" name="CharityID" type="xs:string"/>

<xs:element minOccurs="0" name="CharityName" type="xs:string"/>

<xs:element minOccurs="0" name="Query" type="xs:string"/>

<xs:element minOccurs="0" name="CharityRegion" type="xs:int"/>

<xs:element minOccurs="0" name="CharityDomain" type="xs:int"/>

<xs:element minOccurs="0" name="IncludeDescription" type="xs:boolean"/>

<xs:element minOccurs="0" name="MatchType" type="ns:StringMatchCodeType"/>

<xs:element minOccurs="0" name="Featured" type="xs:boolean"/>

<xs:element minOccurs="0" name="CampaignID" type="xs:long"/>

</xs:sequence>

</xs:extension>

</xs:complexContent>

</xs:complexType>

Content Element Detail (all declarations defined in this component; 9/20)

ns:CampaignID

Type:

xs:long, predefined, simple content

Reserved for future use.

XML Representation Summary

<ns:CampaignID>

Content:

{ xs:long }

</ns:CampaignID>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="CampaignID" type="xs:long"/>

ns:CharityDomain

Type:

xs:int, predefined, simple content

This field can be used to search for registered nonprofit organizations within a specified charitable domain. Each charitable domain will have an integer value associated with it. This integer value is what is passed in to this field. Nonprofit organizations can be associated with multiple charitable domains.

XML Representation Summary

<ns:CharityDomain>

Content:

{ xs:int }

</ns:CharityDomain>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="CharityDomain" type="xs:int"/>

ns:CharityID

Type:

xs:string, predefined, simple content

The unique identifier that eBay creates and assigns to each nonprofit organization. This is NOT the unique identifier used by the PayPal Giving Fund. This eBay unique identifier is returned in the Charity.CharityID field of a GetItem call for charitable listings.

If a CharityID value is used in the request, all other search filters set in the call request will be ignored, as the call will only search for the specified nonprofit organization.

XML Representation Summary

<ns:CharityID>

Content:

{ xs:string }

</ns:CharityID>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="CharityID" type="xs:string"/>

ns:CharityName

Type:

xs:string, predefined, simple content

This field will accept the full or partial name of a registered nonprofit organization. For example, if you pass in a value of heart, all registered nonprofit organizations with "heart" in their name may be returned in the response. If the MatchType field is used and set to StartsWith (default value), or is not used at all, the phrase "heart" must come at the beginning of the nonprofit organization's name to be returned. However, if the MatchType field is used and set to Contains, all registered nonprofit organizations with "heart" in their name should be returned in the response. The string passed in this field is not case-sensitive.

XML Representation Summary

<ns:CharityName>

Content:

{ xs:string }

</ns:CharityName>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="CharityName" type="xs:string"/>

ns:CharityRegion

Type:

xs:int, predefined, simple content

This field can be used to search for registered nonprofit organizations within a specified geographical region. Each geographical region will have an integer value associated with it. This integer value is what is passed in to this field.

XML Representation Summary

<ns:CharityRegion>

Content:

{ xs:int }

</ns:CharityRegion>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="CharityRegion" type="xs:int"/>

ns:Featured

Type:

xs:boolean, predefined, simple content

This boolean field is used and set to true if the user wants to search for nonprofit organizations currently featured on the eBay for Charity site.

XML Representation Summary

<ns:Featured>

Content:

{ xs:boolean }

</ns:Featured>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="Featured" type="xs:boolean"/>

ns:IncludeDescription

Type:

xs:boolean, predefined, simple content

This field should be included and set to true if a user wants the charity's description to appear in the response. Note that not all charitable organizations will have defined descriptions.

XML Representation Summary

<ns:IncludeDescription>

Content:

{ xs:boolean }

</ns:IncludeDescription>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="IncludeDescription" type="xs:boolean"/>

ns:MatchType

Type:

ns:StringMatchCodeType, simple content

This filter is used if the user wants to specify where to look for the string specified in the CharityName field. The enumeration value input into this field controls the type of string matching to use when a value is submitted in the CharityName field. If this field is omitted, and a CharityName string is used, this parameter value defaults to StartsWith.

This field is not applicable when a Query value is used.

XML Representation Summary

<ns:MatchType>

Content:

{ enumeration of xs:token }

</ns:MatchType>

Simple Content

Enumeration:

"CustomCode"	-	(in) Reserved for internal or future use.
"StartsWith"	-	(in) Matches strings that begin with the submitted value. For example, submitting a CharityName value of "heart" matches "Heart of Gold," but not "Open Hearts." Default behavior if no value is specified.
"Contains"	-	(in) Matches strings that contain the submitted value. For example, submitting a CharityName value of "heart" matches both "Heart of Gold" and "Open Hearts."

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="MatchType" type="ns:StringMatchCodeType"/>

ns:Query

Type:

xs:string, predefined, simple content

This field accepts any string up to 350 characters in length. The functionality of this field is similar to the CharityName field, except that the call will also search for the supplied query string within the charity's mission statement (which is returned under the Charity.Mission field in the response). If you pass in a value of heart, all registered nonprofit organizations with "heart" in their name or in their mission statement may be returned in the response.

The string passed in this field is not case-sensitive. The MatchType field will have no effect if the Query field is used, as the MatchType field will only have an effect if a CharityName string field is included.

XML Representation Summary

<ns:Query>

Content:

{ xs:string }

</ns:Query>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="Query" type="xs:string"/>

Overview

Namespace

WSDL

Schema

Component

Index

PREV C-TYPE NEXT C-TYPE

FRAMES NO FRAMES NS-Bindings

SUMMARY: XML REP | DERIVED | USE

DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD

eBay Trading API

WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.