# Ad Exchange Buyer API II . accounts . clients

## Instance Methods

Returns the invitations Resource.

Returns the users Resource.

Close httplib2 connections.

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

`close()`

    Close httplib2 connections.

`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—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.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
      "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. Maximum length of 255 characters is allowed.
      "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.
      "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.
      "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
      "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.
      "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`.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
    }

      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—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.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
      "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. Maximum length of 255 characters is allowed.
      "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.
      "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.
      "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
      "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.
      "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`.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
    }

`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—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.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
      "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. Maximum length of 255 characters is allowed.
      "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.
      "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.
      "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
      "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.
      "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`.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
    }

`list(accountId, pageSize=None, pageToken=None, partnerClientId=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)
      pageSize: integer, Requested page size. The server may return fewer clients than requested. If unspecified, the server will pick an appropriate default.
      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.
      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—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.
          "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
          "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. Maximum length of 255 characters is allowed.
          "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.
          "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.
          "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
          "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.
          "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`.
          "status": "A String", # The status of the client buyer.
          "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
        },
      ],
      "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()`

    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—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.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
      "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. Maximum length of 255 characters is allowed.
      "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.
      "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.
      "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
      "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.
      "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`.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
    }

      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—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.
      "clientAccountId": "A String", # The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
      "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. Maximum length of 255 characters is allowed.
      "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.
      "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.
      "entityType": "A String", # An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
      "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.
      "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`.
      "status": "A String", # The status of the client buyer.
      "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
    }