Ad Exchange Buyer API . accounts

Instance Methods

close()

Close httplib2 connections.

get(id)

Gets one account by ID.

list()

Retrieves the authenticated user's list of accounts.

patch(id, body=None, confirmUnsafeAccountChange=None)

Updates an existing account. This method supports patch semantics.

update(id, body=None, confirmUnsafeAccountChange=None)

Updates an existing account.

Method Details

close()
Close httplib2 connections.
get(id)
Gets one account by ID.

Args:
  id: integer, The account id (required)

Returns:
  An object of the form:

    { # Configuration data for an Ad Exchange buyer account.
  "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
  "bidderLocation": [ # Your bidder locations that have distinct URLs.
    {
      "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
          # - PROTOCOL_ADX
          # - PROTOCOL_OPENRTB_2_2
          # - PROTOCOL_OPENRTB_2_3
          # - PROTOCOL_OPENRTB_2_4
          # - PROTOCOL_OPENRTB_2_5
          # - PROTOCOL_OPENRTB_PROTOBUF_2_3
          # - PROTOCOL_OPENRTB_PROTOBUF_2_4
          # - PROTOCOL_OPENRTB_PROTOBUF_2_5
      "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
      "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
          # - ASIA
          # - EUROPE
          # - US_EAST
          # - US_WEST
      "url": "A String", # The URL to which the Ad Exchange will send bid requests.
    },
  ],
  "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
  "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  "id": 42, # Account id.
  "kind": "adexchangebuyer#account", # Resource type.
  "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
  "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
  "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
}
list()
Retrieves the authenticated user's list of accounts.

Args:

Returns:
  An object of the form:

    { # An account feed lists Ad Exchange buyer accounts that the user has access to. Each entry in the feed corresponds to a single buyer account.
  "items": [ # A list of accounts.
    { # Configuration data for an Ad Exchange buyer account.
      "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
      "bidderLocation": [ # Your bidder locations that have distinct URLs.
        {
          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
              # - PROTOCOL_ADX
              # - PROTOCOL_OPENRTB_2_2
              # - PROTOCOL_OPENRTB_2_3
              # - PROTOCOL_OPENRTB_2_4
              # - PROTOCOL_OPENRTB_2_5
              # - PROTOCOL_OPENRTB_PROTOBUF_2_3
              # - PROTOCOL_OPENRTB_PROTOBUF_2_4
              # - PROTOCOL_OPENRTB_PROTOBUF_2_5
          "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
          "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
              # - ASIA
              # - EUROPE
              # - US_EAST
              # - US_WEST
          "url": "A String", # The URL to which the Ad Exchange will send bid requests.
        },
      ],
      "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
      "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
      "id": 42, # Account id.
      "kind": "adexchangebuyer#account", # Resource type.
      "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
      "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
      "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
    },
  ],
  "kind": "adexchangebuyer#accountsList", # Resource type.
}
patch(id, body=None, confirmUnsafeAccountChange=None)
Updates an existing account. This method supports patch semantics.

Args:
  id: integer, The account id (required)
  body: object, The request body.
    The object takes the form of:

{ # Configuration data for an Ad Exchange buyer account.
  "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
  "bidderLocation": [ # Your bidder locations that have distinct URLs.
    {
      "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
          # - PROTOCOL_ADX
          # - PROTOCOL_OPENRTB_2_2
          # - PROTOCOL_OPENRTB_2_3
          # - PROTOCOL_OPENRTB_2_4
          # - PROTOCOL_OPENRTB_2_5
          # - PROTOCOL_OPENRTB_PROTOBUF_2_3
          # - PROTOCOL_OPENRTB_PROTOBUF_2_4
          # - PROTOCOL_OPENRTB_PROTOBUF_2_5
      "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
      "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
          # - ASIA
          # - EUROPE
          # - US_EAST
          # - US_WEST
      "url": "A String", # The URL to which the Ad Exchange will send bid requests.
    },
  ],
  "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
  "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  "id": 42, # Account id.
  "kind": "adexchangebuyer#account", # Resource type.
  "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
  "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
  "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
}

  confirmUnsafeAccountChange: boolean, Confirmation for erasing bidder and cookie matching urls.

Returns:
  An object of the form:

    { # Configuration data for an Ad Exchange buyer account.
  "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
  "bidderLocation": [ # Your bidder locations that have distinct URLs.
    {
      "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
          # - PROTOCOL_ADX
          # - PROTOCOL_OPENRTB_2_2
          # - PROTOCOL_OPENRTB_2_3
          # - PROTOCOL_OPENRTB_2_4
          # - PROTOCOL_OPENRTB_2_5
          # - PROTOCOL_OPENRTB_PROTOBUF_2_3
          # - PROTOCOL_OPENRTB_PROTOBUF_2_4
          # - PROTOCOL_OPENRTB_PROTOBUF_2_5
      "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
      "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
          # - ASIA
          # - EUROPE
          # - US_EAST
          # - US_WEST
      "url": "A String", # The URL to which the Ad Exchange will send bid requests.
    },
  ],
  "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
  "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  "id": 42, # Account id.
  "kind": "adexchangebuyer#account", # Resource type.
  "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
  "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
  "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
}
update(id, body=None, confirmUnsafeAccountChange=None)
Updates an existing account.

Args:
  id: integer, The account id (required)
  body: object, The request body.
    The object takes the form of:

{ # Configuration data for an Ad Exchange buyer account.
  "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
  "bidderLocation": [ # Your bidder locations that have distinct URLs.
    {
      "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
          # - PROTOCOL_ADX
          # - PROTOCOL_OPENRTB_2_2
          # - PROTOCOL_OPENRTB_2_3
          # - PROTOCOL_OPENRTB_2_4
          # - PROTOCOL_OPENRTB_2_5
          # - PROTOCOL_OPENRTB_PROTOBUF_2_3
          # - PROTOCOL_OPENRTB_PROTOBUF_2_4
          # - PROTOCOL_OPENRTB_PROTOBUF_2_5
      "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
      "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
          # - ASIA
          # - EUROPE
          # - US_EAST
          # - US_WEST
      "url": "A String", # The URL to which the Ad Exchange will send bid requests.
    },
  ],
  "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
  "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  "id": 42, # Account id.
  "kind": "adexchangebuyer#account", # Resource type.
  "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
  "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
  "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
}

  confirmUnsafeAccountChange: boolean, Confirmation for erasing bidder and cookie matching urls.

Returns:
  An object of the form:

    { # Configuration data for an Ad Exchange buyer account.
  "applyPretargetingToNonGuaranteedDeals": True or False, # When this is false, bid requests that include a deal ID for a private auction or preferred deal are always sent to your bidder. When true, all active pretargeting configs will be applied to private auctions and preferred deals. Programmatic Guaranteed deals (when enabled) are always sent to your bidder.
  "bidderLocation": [ # Your bidder locations that have distinct URLs.
    {
      "bidProtocol": "A String", # The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON.  Allowed values:
          # - PROTOCOL_ADX
          # - PROTOCOL_OPENRTB_2_2
          # - PROTOCOL_OPENRTB_2_3
          # - PROTOCOL_OPENRTB_2_4
          # - PROTOCOL_OPENRTB_2_5
          # - PROTOCOL_OPENRTB_PROTOBUF_2_3
          # - PROTOCOL_OPENRTB_PROTOBUF_2_4
          # - PROTOCOL_OPENRTB_PROTOBUF_2_5
      "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
      "region": "A String", # The geographical region the Ad Exchange should send requests from. Only used by some quota systems, but always setting the value is recommended. Allowed values:
          # - ASIA
          # - EUROPE
          # - US_EAST
          # - US_WEST
      "url": "A String", # The URL to which the Ad Exchange will send bid requests.
    },
  ],
  "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. Please contact your technical account manager if you need to change this.
  "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  "id": 42, # Account id.
  "kind": "adexchangebuyer#account", # Resource type.
  "maximumActiveCreatives": 42, # The maximum number of active creatives that an account can have, where a creative is active if it was inserted or bid with in the last 30 days. Please contact your technical account manager if you need to change this.
  "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
  "numberActiveCreatives": 42, # The number of creatives that this account inserted or bid with in the last 30 days.
}