get_publishers

Gets the publishers associated with your account. Publishers are created when a publisherID parameter is passed in via the video player. A publisherID is a free-from string, but should match some "key" value of your content management system, such that they do not change!

Explorer

Explore this method

Request URL

http://api.tubemogul.com/api/v3/

HTTP method

GET

Arguments

NOTE: Unless otherwise denoted, strings are limited to 256 UTF-8 encoded characters.

NOTE: The arguments for this method do not require all of the Global Arguments specified on the Overview page. The complete list of what is required is provided here.

partner_id (string)

A unique partner identifier generated by TubeMogul and given to the partner site.

method (string)

The name of the method being called.

date (integer)

A UNIX timestamp displaying the number of seconds elapsed since January 1st, 1970 (UTC).

auth (string)

A SHA-1 hash that concatenates the query string with the partners secret key (see Authenticating for details).

index (string)

Start index of the request when dealing with lists. Each response that contains a <details> list will contain <list_size> (of the complete list) and <has_more_items> elements. In addition, the <details> list contains a count attribute indicating how many items are in this page. Paging through lists is supported by providing an <index> to successive requests, which has been incremented by the count of the previous <details> list response. Defaults to 1.

max_results (string)

The maximum count value to be returned in a single response. Limited to 1000, and defaults to 50.

filter (string) — Optional

A free-form filter to apply to the list. The syndicating domain will be searched for a case-insensitive match of the provided string.

Response Parameters

details (list)

A list of publishers for this account. The entries will scoped based on the arguments provided in the request.

publisher_id (string)

The identifier for this publisher.

Example Response

http://api.tubemogul.com/api/v3?date=1232395951&user_id=123456
&method=get_publishers&index=1&max_results=100
&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="get_publishers" status="ok">
  <details has_more_items="false" list_size="5000" count="100">
    <entry>
      <publisher_id>Fred</publisher_id>
    </entry>
    ..
    <entry>
      <publisher_id>lonelygirl15</publisher_id>
    </entry>
  </details>
</response>

Error Codes

Standard error codes