# Ad Exchange Buyer API II . accounts . clients

## Instance Methods

Returns the invitations Resource.

Returns the users Resource.

Creates a new client buyer.

Gets a client buyer with a given client account ID.

Lists all the clients for the current sponsor buyer.

Retrieves the next page of results.

Updates an existing client buyer.

### Method Details

`create(accountId, body=None, x__xgafv=None)`

    Creates a new client buyer.

    Args:
      accountId: string, Unique numerical account ID for the buyer of which the client buyer
    is a customer; the sponsor buyer to create a client for. (required) (required)
      body: object, The request body.
        The object takes the form of:

    { # A client resource represents a client buyer&mdash;an agency, a brand, or an
        # advertiser customer of the sponsor buyer. Users associated with the client
        # buyer have restricted access to the Marketplace and certain other sections of
        # the Authorized Buyers UI based on the role granted to the client buyer. All
        # fields are required unless otherwise specified.
      "entityId": "A String", # Numerical identifier of the client entity.
          # The entity can be an advertiser, a brand, or an agency.
          # This identifier is unique among all the entities with the same type.
          # The value of this field is ignored if the entity type is not provided.
          #
          # A list of all known advertisers with their identifiers is available in the
          # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
          # file.
          #
          # A list of all known brands with their identifiers is available in the
          # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
          # file.
          #
          # A list of all known agencies with their identifiers is available in the
          # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
          # file.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
      "clientName": "A String", # Name used to represent this client to publishers.
          # You may have multiple clients that map to the same entity,
          # but for each client the combination of `clientName` and entity
          # must be unique.
          # You can specify this field as empty.
      "entityName": "A String", # The name of the entity. This field is automatically fetched based on
          # the type and ID.
          # The value of this field is ignored in create and update operations.
      "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
          # standpoint of its Ad Exchange sponsor buyer.
          #
          # This field can be used to associate a client buyer with the identifier
          # in the namespace of its sponsor buyer, lookup client buyers by that
          # identifier and verify whether an Ad Exchange counterpart of a given client
          # buyer already exists.
          #
          # If present, must be unique among all the client buyers for its
          # Ad Exchange sponsor buyer.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client.
          # The value of this field is ignored in create and update operations.
      "entityType": "A String", # An optional field for specifying the type of the client entity:
          # `ADVERTISER`, `BRAND`, or `AGENCY`.
      "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
          # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
          # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A client resource represents a client buyer&mdash;an agency, a brand, or an
          # advertiser customer of the sponsor buyer. Users associated with the client
          # buyer have restricted access to the Marketplace and certain other sections of
          # the Authorized Buyers UI based on the role granted to the client buyer. All
          # fields are required unless otherwise specified.
        "entityId": "A String", # Numerical identifier of the client entity.
            # The entity can be an advertiser, a brand, or an agency.
            # This identifier is unique among all the entities with the same type.
            # The value of this field is ignored if the entity type is not provided.
            #
            # A list of all known advertisers with their identifiers is available in the
            # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
            # file.
            #
            # A list of all known brands with their identifiers is available in the
            # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
            # file.
            #
            # A list of all known agencies with their identifiers is available in the
            # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
            # file.
        "status": "A String", # The status of the client buyer.
        "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
        "clientName": "A String", # Name used to represent this client to publishers.
            # You may have multiple clients that map to the same entity,
            # but for each client the combination of `clientName` and entity
            # must be unique.
            # You can specify this field as empty.
        "entityName": "A String", # The name of the entity. This field is automatically fetched based on
            # the type and ID.
            # The value of this field is ignored in create and update operations.
        "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
            # standpoint of its Ad Exchange sponsor buyer.
            #
            # This field can be used to associate a client buyer with the identifier
            # in the namespace of its sponsor buyer, lookup client buyers by that
            # identifier and verify whether an Ad Exchange counterpart of a given client
            # buyer already exists.
            #
            # If present, must be unique among all the client buyers for its
            # Ad Exchange sponsor buyer.
        "clientAccountId": "A String", # The globally-unique numerical ID of the client.
            # The value of this field is ignored in create and update operations.
        "entityType": "A String", # An optional field for specifying the type of the client entity:
            # `ADVERTISER`, `BRAND`, or `AGENCY`.
        "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
            # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
            # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
      }

`get(accountId, clientAccountId, x__xgafv=None)`

    Gets a client buyer with a given client account ID.

    Args:
      accountId: string, Numerical account ID of the client's sponsor buyer. (required) (required)
      clientAccountId: string, Numerical account ID of the client buyer to retrieve. (required) (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A client resource represents a client buyer&mdash;an agency, a brand, or an
          # advertiser customer of the sponsor buyer. Users associated with the client
          # buyer have restricted access to the Marketplace and certain other sections of
          # the Authorized Buyers UI based on the role granted to the client buyer. All
          # fields are required unless otherwise specified.
        "entityId": "A String", # Numerical identifier of the client entity.
            # The entity can be an advertiser, a brand, or an agency.
            # This identifier is unique among all the entities with the same type.
            # The value of this field is ignored if the entity type is not provided.
            #
            # A list of all known advertisers with their identifiers is available in the
            # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
            # file.
            #
            # A list of all known brands with their identifiers is available in the
            # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
            # file.
            #
            # A list of all known agencies with their identifiers is available in the
            # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
            # file.
        "status": "A String", # The status of the client buyer.
        "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
        "clientName": "A String", # Name used to represent this client to publishers.
            # You may have multiple clients that map to the same entity,
            # but for each client the combination of `clientName` and entity
            # must be unique.
            # You can specify this field as empty.
        "entityName": "A String", # The name of the entity. This field is automatically fetched based on
            # the type and ID.
            # The value of this field is ignored in create and update operations.
        "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
            # standpoint of its Ad Exchange sponsor buyer.
            #
            # This field can be used to associate a client buyer with the identifier
            # in the namespace of its sponsor buyer, lookup client buyers by that
            # identifier and verify whether an Ad Exchange counterpart of a given client
            # buyer already exists.
            #
            # If present, must be unique among all the client buyers for its
            # Ad Exchange sponsor buyer.
        "clientAccountId": "A String", # The globally-unique numerical ID of the client.
            # The value of this field is ignored in create and update operations.
        "entityType": "A String", # An optional field for specifying the type of the client entity:
            # `ADVERTISER`, `BRAND`, or `AGENCY`.
        "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
            # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
            # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
      }

`list(accountId, pageToken=None, partnerClientId=None, pageSize=None, x__xgafv=None)`

    Lists all the clients for the current sponsor buyer.

    Args:
      accountId: string, Unique numerical account ID of the sponsor buyer to list the clients for. (required)
      pageToken: string, A token identifying a page of results the server should return.
    Typically, this is the value of
    ListClientsResponse.nextPageToken
    returned from the previous call to the
    accounts.clients.list
    method.
      partnerClientId: string, Optional unique identifier (from the standpoint of an Ad Exchange sponsor
    buyer partner) of the client to return.
    If specified, at most one client will be returned in the response.
      pageSize: integer, Requested page size. The server may return fewer clients than requested.
    If unspecified, the server will pick an appropriate default.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        {
        "clients": [ # The returned list of clients.
          { # A client resource represents a client buyer&mdash;an agency, a brand, or an
              # advertiser customer of the sponsor buyer. Users associated with the client
              # buyer have restricted access to the Marketplace and certain other sections of
              # the Authorized Buyers UI based on the role granted to the client buyer. All
              # fields are required unless otherwise specified.
            "entityId": "A String", # Numerical identifier of the client entity.
                # The entity can be an advertiser, a brand, or an agency.
                # This identifier is unique among all the entities with the same type.
                # The value of this field is ignored if the entity type is not provided.
                #
                # A list of all known advertisers with their identifiers is available in the
                # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
                # file.
                #
                # A list of all known brands with their identifiers is available in the
                # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
                # file.
                #
                # A list of all known agencies with their identifiers is available in the
                # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
                # file.
            "status": "A String", # The status of the client buyer.
            "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
            "clientName": "A String", # Name used to represent this client to publishers.
                # You may have multiple clients that map to the same entity,
                # but for each client the combination of `clientName` and entity
                # must be unique.
                # You can specify this field as empty.
            "entityName": "A String", # The name of the entity. This field is automatically fetched based on
                # the type and ID.
                # The value of this field is ignored in create and update operations.
            "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
                # standpoint of its Ad Exchange sponsor buyer.
                #
                # This field can be used to associate a client buyer with the identifier
                # in the namespace of its sponsor buyer, lookup client buyers by that
                # identifier and verify whether an Ad Exchange counterpart of a given client
                # buyer already exists.
                #
                # If present, must be unique among all the client buyers for its
                # Ad Exchange sponsor buyer.
            "clientAccountId": "A String", # The globally-unique numerical ID of the client.
                # The value of this field is ignored in create and update operations.
            "entityType": "A String", # An optional field for specifying the type of the client entity:
                # `ADVERTISER`, `BRAND`, or `AGENCY`.
            "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
                # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
                # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
          },
        ],
        "nextPageToken": "A String", # A token to retrieve the next page of results.
            # Pass this value in the
            # ListClientsRequest.pageToken
            # field in the subsequent call to the
            # accounts.clients.list
            # method to retrieve the next page of results.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`update(accountId, clientAccountId, body=None, x__xgafv=None)`

    Updates an existing client buyer.

    Args:
      accountId: string, Unique numerical account ID for the buyer of which the client buyer
    is a customer; the sponsor buyer to update a client for. (required) (required)
      clientAccountId: string, Unique numerical account ID of the client to update. (required) (required)
      body: object, The request body.
        The object takes the form of:

    { # A client resource represents a client buyer&mdash;an agency, a brand, or an
        # advertiser customer of the sponsor buyer. Users associated with the client
        # buyer have restricted access to the Marketplace and certain other sections of
        # the Authorized Buyers UI based on the role granted to the client buyer. All
        # fields are required unless otherwise specified.
      "entityId": "A String", # Numerical identifier of the client entity.
          # The entity can be an advertiser, a brand, or an agency.
          # This identifier is unique among all the entities with the same type.
          # The value of this field is ignored if the entity type is not provided.
          #
          # A list of all known advertisers with their identifiers is available in the
          # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
          # file.
          #
          # A list of all known brands with their identifiers is available in the
          # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
          # file.
          #
          # A list of all known agencies with their identifiers is available in the
          # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
          # file.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
      "clientName": "A String", # Name used to represent this client to publishers.
          # You may have multiple clients that map to the same entity,
          # but for each client the combination of `clientName` and entity
          # must be unique.
          # You can specify this field as empty.
      "entityName": "A String", # The name of the entity. This field is automatically fetched based on
          # the type and ID.
          # The value of this field is ignored in create and update operations.
      "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
          # standpoint of its Ad Exchange sponsor buyer.
          #
          # This field can be used to associate a client buyer with the identifier
          # in the namespace of its sponsor buyer, lookup client buyers by that
          # identifier and verify whether an Ad Exchange counterpart of a given client
          # buyer already exists.
          #
          # If present, must be unique among all the client buyers for its
          # Ad Exchange sponsor buyer.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client.
          # The value of this field is ignored in create and update operations.
      "entityType": "A String", # An optional field for specifying the type of the client entity:
          # `ADVERTISER`, `BRAND`, or `AGENCY`.
      "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
          # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
          # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A client resource represents a client buyer&mdash;an agency, a brand, or an
          # advertiser customer of the sponsor buyer. Users associated with the client
          # buyer have restricted access to the Marketplace and certain other sections of
          # the Authorized Buyers UI based on the role granted to the client buyer. All
          # fields are required unless otherwise specified.
        "entityId": "A String", # Numerical identifier of the client entity.
            # The entity can be an advertiser, a brand, or an agency.
            # This identifier is unique among all the entities with the same type.
            # The value of this field is ignored if the entity type is not provided.
            #
            # A list of all known advertisers with their identifiers is available in the
            # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)
            # file.
            #
            # A list of all known brands with their identifiers is available in the
            # [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)
            # file.
            #
            # A list of all known agencies with their identifiers is available in the
            # [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)
            # file.
        "status": "A String", # The status of the client buyer.
        "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
        "clientName": "A String", # Name used to represent this client to publishers.
            # You may have multiple clients that map to the same entity,
            # but for each client the combination of `clientName` and entity
            # must be unique.
            # You can specify this field as empty.
        "entityName": "A String", # The name of the entity. This field is automatically fetched based on
            # the type and ID.
            # The value of this field is ignored in create and update operations.
        "partnerClientId": "A String", # Optional arbitrary unique identifier of this client buyer from the
            # standpoint of its Ad Exchange sponsor buyer.
            #
            # This field can be used to associate a client buyer with the identifier
            # in the namespace of its sponsor buyer, lookup client buyers by that
            # identifier and verify whether an Ad Exchange counterpart of a given client
            # buyer already exists.
            #
            # If present, must be unique among all the client buyers for its
            # Ad Exchange sponsor buyer.
        "clientAccountId": "A String", # The globally-unique numerical ID of the client.
            # The value of this field is ignored in create and update operations.
        "entityType": "A String", # An optional field for specifying the type of the client entity:
            # `ADVERTISER`, `BRAND`, or `AGENCY`.
        "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
            # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
            # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
      }