Ad Exchange Buyer API . accounts

Instance Methods

get(id)

Gets one account by ID.

list()

Retrieves the authenticated user's list of accounts.

patch(id, body, confirmUnsafeAccountChange=None)

Updates an existing account. This method supports patch semantics.

update(id, body, confirmUnsafeAccountChange=None)

Updates an existing account.

Method Details

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.
      "kind": "adexchangebuyer#account", # Resource type.
      "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
      "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.
      "bidderLocation": [ # Your bidder locations that have distinct URLs.
        {
          "url": "A String", # The URL to which the Ad Exchange will send bid requests.
          "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
          "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
          "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
        },
      ],
      "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
      "id": 42, # Account id.
      "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
    }
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.
          "kind": "adexchangebuyer#account", # Resource type.
          "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
          "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.
          "bidderLocation": [ # Your bidder locations that have distinct URLs.
            {
              "url": "A String", # The URL to which the Ad Exchange will send bid requests.
              "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
              "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
              "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
            },
          ],
          "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
          "id": 42, # Account id.
          "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
        },
    ],
    "kind": "adexchangebuyer#accountsList", # Resource type.
  }
patch(id, body, confirmUnsafeAccountChange=None)
Updates an existing account. This method supports patch semantics.

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

{ # Configuration data for an Ad Exchange buyer account.
    "kind": "adexchangebuyer#account", # Resource type.
    "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
    "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.
    "bidderLocation": [ # Your bidder locations that have distinct URLs.
      {
        "url": "A String", # The URL to which the Ad Exchange will send bid requests.
        "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
        "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
        "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
      },
    ],
    "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
    "id": 42, # Account id.
    "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  }

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

Returns:
  An object of the form:

    { # Configuration data for an Ad Exchange buyer account.
      "kind": "adexchangebuyer#account", # Resource type.
      "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
      "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.
      "bidderLocation": [ # Your bidder locations that have distinct URLs.
        {
          "url": "A String", # The URL to which the Ad Exchange will send bid requests.
          "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
          "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
          "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
        },
      ],
      "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
      "id": 42, # Account id.
      "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
    }
update(id, body, confirmUnsafeAccountChange=None)
Updates an existing account.

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

{ # Configuration data for an Ad Exchange buyer account.
    "kind": "adexchangebuyer#account", # Resource type.
    "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
    "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.
    "bidderLocation": [ # Your bidder locations that have distinct URLs.
      {
        "url": "A String", # The URL to which the Ad Exchange will send bid requests.
        "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
        "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
        "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
      },
    ],
    "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
    "id": 42, # Account id.
    "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
  }

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

Returns:
  An object of the form:

    { # Configuration data for an Ad Exchange buyer account.
      "kind": "adexchangebuyer#account", # Resource type.
      "maximumTotalQps": 42, # The sum of all bidderLocation.maximumQps values cannot exceed this. Please contact your technical account manager if you need to change this.
      "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.
      "bidderLocation": [ # Your bidder locations that have distinct URLs.
        {
          "url": "A String", # The URL to which the Ad Exchange will send bid requests.
          "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
          "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
          "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
        },
      ],
      "cookieMatchingNid": "A String", # The nid parameter value used in cookie match requests. 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.
      "id": 42, # Account id.
      "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
    }