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)

Updates an existing account. This method supports patch semantics.

update(id, body)

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.
        },
      ],
      "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.
            },
          ],
          "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)
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.
      },
    ],
    "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.
  }


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.
        },
      ],
      "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)
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.
      },
    ],
    "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.
  }


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.
        },
      ],
      "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.
    }