{id}

Updated on

Returns a single adspaceItem, as queried by its ID. See adspaceItem element definition in WSDL/XSD.

This resource requires connectid, nonce, date and signature for authentication. See Authentication documentation for REST and SOAP. Passing authentication information as query parameters in REST is supported.

Resource URL

XML: http://api.zanox.com/xml/2011-03-01/adspaces/adspace/{id}

JSON: http://api.zanox.com/json/2011-03-01/adspaces/adspace/{id}

Parameters

id
required

this URL path parameter specifies the ID of the adspace you want to get.

Value Type: Integer adspace ID.
Example Value: 12345

callback
optional

Supported if format is JSON. Returns the name of the JS function the result is wrapped in.

Value Type: String

Example Value:

Example Request

REST authentication information must be included in request headers or added as query parameters

https://api.zanox.com/xml/2011-03-01/adspaces/adspace/1654774

Example Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GetAdspaceResponse>
    <adspaceItem id="1654774">
        <name>namre</name>
        <url>http://www.test.com</url>
        <description>test</description>
        <adspaceType>website</adspaceType>
        <visitors>1</visitors>
        <impressions>1</impressions>
        <scope>private</scope>
        <regions>
            <region>DE</region>
        </regions>
        <categories>
            <category id="37">HiFi, TV & Video</category>
            <category id="49">Traffic Broker / Arbitrage</category>
        </categories>
        <language>de</language>
        <checkNumber>157587607</checkNumber>
    </adspaceItem>
</GetAdspaceResponse>

Resource Information

Rate Limited?	No
Authentication	Requires signature. See REST Authentication SOAP Authentication
Response Formats	json, xml
HTTP Methods	GET
Resource family	AdSpaces
Response Object	adspaceItem
API Version	2011-03-01