NAME

eBay::API::XML::Call::GetCharities

DESCRIPTION

SYNOPSIS

INHERITANCE

eBay::API::XML::Call::GetCharities inherits from the eBay::API::XML::BaseCall class

Subroutines:

setCharityDomain()

Domain (mission area) that a nonprofit charity organization belongs to. Nonprofit charity organizations may belong to multiple mission areas. Meaning of input values differs depending on the site. See GetCharities in the API Developer's Guide for the meaning of each input/output value. CharityDomain input value must be valid for that SiteID.

RequiredInput: No
#    Argument: 'xs:int'

setCharityID()

A unique identification number assigned by eBay to registered nonprofit charity organizations.

RequiredInput: No
#    Argument: 'xs:string'

setCharityName()

A name assigned to a specified nonprofit organization. Accepts full charity nonprofit name or partial name as input. For example, enter a CharityName of "heart" (case-insensitive) to return all charity nonprofits that start with "heart." Use with a MatchType value of "Contains" to return all charity nonprofits that contain the string "heart."

MaxLength: 150

RequiredInput: No
#    Argument: 'xs:string'

setCharityRegion()

Region that the nonprofit charity organization is associated with. A specific nonprofit charity organization may be associated with only one region. Meaning of input values differs depending on the site. See GetCharities in the API Developer's Guide for the meaning of each input/output value. CharityRegion input value must be valid for that SiteID.

RequiredInput: No
#    Argument: 'xs:int'

setFeatured()

Used to decide if the search is only for featured charities. A value of true will search for only featured charities.

RequiredInput: No
#    Argument: 'xs:boolean'

setIncludeDescription()

Used with Query to search for charity nonprofit organizations. A value of true will search the Mission field as well as the CharityName field for a string specified in Query.

RequiredInput: No
#    Argument: 'xs:boolean'

setMatchType()

Indicates the type of string matching to use when a value is submitted in CharityName. If no value is specified, default behavior is "StartsWith." Does not apply to Query.

RequiredInput: No
#    Argument: 'ns:StringMatchCodeType'

setQuery()

Accepts a case-insensitive string used to find a nonprofit charity organization. Default behavior is to search the CharityName field. Use with an IncludeDescription value of true to include the Mission field in the search.

MaxLength: 350 (characters)

RequiredInput: No
#    Argument: 'xs:string'

getCharity()

Contains information about charity nonprofit organizations that meet the criteria specified in the request. One Charity node is returned for each applicable nonprofit charity organization. The CharityID value is returned as an id attribute of this node. If no nonprofit charity organization is applicable, this node is not returned.

Returned: Conditionally
#    Returns: reference to an array  
                    of 'ns:CharityInfoType'