Google Affiliate Network API v1beta1

Version: 5.3

Google Affiliate Network API v1beta1

This documentation has been automatically generated using information supplied by the Google API Discovery service.

Lets you have programmatic access to your Google Affiliate Network data. Google documentation.

(require gapi/macro)

(require-gapi-doc "gan.v1beta1.js")

1 API Parameters

The following optional keyword arguments may be passed to all functions for this web service:

procedure
(_ [ #:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

This is not actually a function. This is just using Scribble’s defproc form to list the optional keyword arguments that may be passed to all functions for this service.

alt: Data format for the response.

fields: Selector specifying which fields to include in a partial response.

key: API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

oauth_token: OAuth 2.0 token for the current user.

prettyPrint: Returns response with indentations and line breaks.

quotaUser: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.

userIp: IP address of the site where the request originates. Use this if you want to enforce per-user limits.

2 Resources

2.1 advertisers

procedure
(gan-advertisers-list #:roleId roleId
#:role role
[ #:advertiserCategory advertiserCategory
#:minNinetyDayEpc minNinetyDayEpc
#:minPayoutRank minPayoutRank
#:minSevenDayEpc minSevenDayEpc
#:relationshipStatus relationshipStatus
#:maxResults maxResults
#:pageToken pageToken
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp])
→ jsexpr?
  roleId : string?
  role : string?
  advertiserCategory : string? = 'N/A
  minNinetyDayEpc : string? = 'N/A
  minPayoutRank : string? = 'N/A
  minSevenDayEpc : string? = 'N/A
  relationshipStatus : string? = 'N/A
  maxResults : string? = 'N/A
  pageToken : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves data about all advertisers that the requesting advertiser/publisher has access to.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

advertiserCategory: Caret(^) delimted list of advertiser categories. Valid categories are defined here: http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581. Filters out all advertisers not in one of the given advertiser categories. Optional.

minNinetyDayEpc: Filters out all advertisers that have a ninety day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.

minPayoutRank: A value between 1 and 4, where 1 represents the quartile of advertisers with the lowest ranks and 4 represents the quartile of advertisers with the highest ranks. Filters out all advertisers with a lower rank than the given quartile. For example if a 2 was given only advertisers with a payout rank of 25 or higher would be included. Optional.

minSevenDayEpc: Filters out all advertisers that have a seven day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.

relationshipStatus: Filters out all advertisers for which do not have the given relationship status with the requesting publisher.

maxResults: Max number of items to return in this page. Optional. Defaults to 20.

pageToken: The value of ’nextPageToken’ from the previous page. Optional.

procedure
(gan-advertisers-get #:roleId roleId
#:role role
[ #:advertiserId advertiserId
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  roleId : string?
  role : string?
  advertiserId : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves data about a single advertiser if that the requesting advertiser/publisher has access to it. Only publishers can lookup advertisers. Advertisers can request information about themselves by omitting the advertiserId query parameter.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

advertiserId: The ID of the advertiser to look up. Optional.

2.2 ccOffers

procedure
(gan-ccOffers-list #:publisher publisher
[ #:advertiser advertiser
#:projection projection
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  publisher : string?
  advertiser : string? = 'N/A
  projection : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves credit card offers for the given publisher.

publisher: The ID of the publisher in question.

advertiser: The advertiser ID of a card issuer whose offers to include. Optional, may be repeated.

projection: The set of fields to return.

2.3 events

procedure
(gan-events-list #:roleId roleId
#:role role
[ #:sku sku
#:advertiserId advertiserId
#:chargeType chargeType
#:memberId memberId
#:orderId orderId
#:publisherId publisherId
#:eventDateMax eventDateMax
#:eventDateMin eventDateMin
#:linkId linkId
#:modifyDateMax modifyDateMax
#:modifyDateMin modifyDateMin
#:productCategory productCategory
#:type type
#:maxResults maxResults
#:status status
#:pageToken pageToken
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  roleId : string?
  role : string?
  sku : string? = 'N/A
  advertiserId : string? = 'N/A
  chargeType : string? = 'N/A
  memberId : string? = 'N/A
  orderId : string? = 'N/A
  publisherId : string? = 'N/A
  eventDateMax : string? = 'N/A
  eventDateMin : string? = 'N/A
  linkId : string? = 'N/A
  modifyDateMax : string? = 'N/A
  modifyDateMin : string? = 'N/A
  productCategory : string? = 'N/A
  type : string? = 'N/A
  maxResults : string? = 'N/A
  status : string? = 'N/A
  pageToken : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves event data for a given advertiser/publisher.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

sku: Caret(^) delimited list of SKUs. Filters out all events that do not reference one of the given SKU. Optional.

advertiserId: Caret(^) delimited list of advertiser IDs. Filters out all events that do not reference one of the given advertiser IDs. Only used when under publishers role. Optional.

chargeType: Filters out all charge events that are not of the given charge type. Valid values: ’other’, ’slotting_fee’, ’monthly_minimum’, ’tier_bonus’, ’credit’, ’debit’. Optional.

memberId: Caret(^) delimited list of member IDs. Filters out all events that do not reference one of the given member IDs. Optional.

orderId: Caret(^) delimited list of order IDs. Filters out all events that do not reference one of the given order IDs. Optional.

publisherId: Caret(^) delimited list of publisher IDs. Filters out all events that do not reference one of the given publishers IDs. Only used when under advertiser role. Optional.

eventDateMax: Filters out all events later than given date. Optional. Defaults to 24 hours after eventMin.

eventDateMin: Filters out all events earlier than given date. Optional. Defaults to 24 hours from current date/time.

linkId: Caret(^) delimited list of link IDs. Filters out all events that do not reference one of the given link IDs. Optional.

modifyDateMax: Filters out all events modified later than given date. Optional. Defaults to 24 hours after modifyDateMin, if modifyDateMin is explicitly set.

modifyDateMin: Filters out all events modified earlier than given date. Optional. Defaults to 24 hours before the current modifyDateMax, if modifyDateMax is explicitly set.

productCategory: Caret(^) delimited list of product categories. Filters out all events that do not reference a product in one of the given product categories. Optional.

type: Filters out all events that are not of the given type. Valid values: ’action’, ’transaction’, ’charge’. Optional.

maxResults: Max number of offers to return in this page. Optional. Defaults to 20.

status: Filters out all events that do not have the given status. Valid values: ’active’, ’canceled’. Optional.

pageToken: The value of ’nextPageToken’ from the previous page. Optional.

2.4 links

procedure
(gan-links-list #:roleId roleId
#:role role
[ #:advertiserId advertiserId
#:authorship authorship
#:linkType linkType
#:promotionType promotionType
#:advertiserCategory advertiserCategory
#:relationshipStatus relationshipStatus
#:assetSize assetSize
#:startDateMax startDateMax
#:startDateMin startDateMin
#:maxResults maxResults
#:pageToken pageToken
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp])
→ jsexpr?
  roleId : string?
  role : string?
  advertiserId : string? = 'N/A
  authorship : string? = 'N/A
  linkType : string? = 'N/A
  promotionType : string? = 'N/A
  advertiserCategory : string? = 'N/A
  relationshipStatus : string? = 'N/A
  assetSize : string? = 'N/A
  startDateMax : string? = 'N/A
  startDateMin : string? = 'N/A
  maxResults : string? = 'N/A
  pageToken : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves all links that match the query parameters.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

advertiserId: Limits the resulting links to the ones belonging to the listed advertisers.

authorship: The role of the author of the link.

linkType: The type of the link.

promotionType: The promotion type.

advertiserCategory: The advertiser’s primary vertical.

relationshipStatus: The status of the relationship.

assetSize: The size of the given asset.

startDateMax: The end of the start date range.

startDateMin: The beginning of the start date range.

maxResults: Max number of items to return in this page. Optional. Defaults to 20.

pageToken: The value of ’nextPageToken’ from the previous page. Optional.

procedure
(gan-links-get #:roleId roleId
#:linkId linkId
#:role role
[ #:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  roleId : string?
  linkId : string?
  role : string?
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves data about a single link if the requesting advertiser/publisher has access to it. Advertisers can look up their own links. Publishers can look up visible links or links belonging to advertisers they are in a relationship with.

roleId: The ID of the requesting advertiser or publisher.

linkId: The ID of the link to look up.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

procedure
(gan-links-insert
#:roleId roleId
#:role role
[ #:id id
#:advertiserId advertiserId
#:authorship authorship
#:availability availability
#:clickTrackingUrl clickTrackingUrl
#:createDate createDate
#:destinationUrl destinationUrl
#:duration duration
#:endDate endDate
#:imageAltText imageAltText
#:impressionTrackingUrl impressionTrackingUrl
#:isActive isActive
#:linkType linkType
#:promotionType promotionType
#:startDate startDate
#:name name
#:description description
#:kind kind
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp])
→ jsexpr?
  roleId : string?
  role : string?
  id : string? = 'N/A
  advertiserId : string? = 'N/A
  authorship : string? = 'N/A
  availability : string? = 'N/A
  clickTrackingUrl : string? = 'N/A
  createDate : string? = 'N/A
  destinationUrl : string? = 'N/A
  duration : string? = 'N/A
  endDate : string? = 'N/A
  imageAltText : string? = 'N/A
  impressionTrackingUrl : string? = 'N/A
  isActive : string? = 'N/A
  linkType : string? = 'N/A
  promotionType : string? = 'N/A
  startDate : string? = 'N/A
  name : string? = 'N/A
  description : string? = 'N/A
  kind : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Inserts a new link.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

id: The ID of this link.

advertiserId: The advertiser id for the advertiser who owns this link.

authorship: Authorship

availability: Availability.

clickTrackingUrl: Tracking url for clicks.

createDate: Date that this link was created.

destinationUrl: The destination URL for the link.

duration: Duration

endDate: Date that this link becomes inactive.

imageAltText: image alt text.

impressionTrackingUrl: Tracking url for impressions.

isActive: Flag for if this link is active.

linkType: The link type.

promotionType: Promotion Type

startDate: Date that this link becomes active.

name: The logical name for this link.

description: Description.

kind: The kind for one entity.

2.5 publishers

procedure
(gan-publishers-list #:roleId roleId
#:role role
[ #:minNinetyDayEpc minNinetyDayEpc
#:minPayoutRank minPayoutRank
#:minSevenDayEpc minSevenDayEpc
#:relationshipStatus relationshipStatus
#:publisherCategory publisherCategory
#:maxResults maxResults
#:pageToken pageToken
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp])
→ jsexpr?
  roleId : string?
  role : string?
  minNinetyDayEpc : string? = 'N/A
  minPayoutRank : string? = 'N/A
  minSevenDayEpc : string? = 'N/A
  relationshipStatus : string? = 'N/A
  publisherCategory : string? = 'N/A
  maxResults : string? = 'N/A
  pageToken : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves data about all publishers that the requesting advertiser/publisher has access to.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

minNinetyDayEpc: Filters out all publishers that have a ninety day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.

minPayoutRank: A value between 1 and 4, where 1 represents the quartile of publishers with the lowest ranks and 4 represents the quartile of publishers with the highest ranks. Filters out all publishers with a lower rank than the given quartile. For example if a 2 was given only publishers with a payout rank of 25 or higher would be included. Optional.

minSevenDayEpc: Filters out all publishers that have a seven day EPC average lower than the given value (inclusive). Min value 0.0. Optional.

relationshipStatus: Filters out all publishers for which do not have the given relationship status with the requesting publisher.

maxResults: Max number of items to return in this page. Optional. Defaults to 20.

pageToken: The value of ’nextPageToken’ from the previous page. Optional.

procedure
(gan-publishers-get #:roleId roleId
#:role role
[ #:publisherId publisherId
#:alt alt
#:fields fields
#:key key
#:oauth_token oauth_token
#:prettyPrint prettyPrint
#:quotaUser quotaUser
#:userIp userIp]) → jsexpr?
  roleId : string?
  role : string?
  publisherId : string? = 'N/A
  alt : string? = 'N/A
  fields : string? = 'N/A
  key : string? = (api-key)
  oauth_token : string? = 'N/A
  prettyPrint : string? = 'N/A
  quotaUser : string? = 'N/A
  userIp : string? = 'N/A

Retrieves data about a single advertiser if that the requesting advertiser/publisher has access to it. Only advertisers can look up publishers. Publishers can request information about themselves by omitting the publisherId query parameter.

roleId: The ID of the requesting advertiser or publisher.

role: The role of the requester. Valid values: ’advertisers’ or ’publishers’.

publisherId: The ID of the publisher to look up. Optional.