# Ad Exchange Buyer API . accounts

## Instance Methods

Gets one account by ID.

Retrieves the authenticated user's list of accounts.

Updates an existing account. This method supports patch semantics.

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.
        }