Real-time Bidding API . bidders . publisherConnections

Instance Methods

batchApprove(parent, body=None, x__xgafv=None)

Batch approves multiple publisher connections.

batchReject(parent, body=None, x__xgafv=None)

Batch rejects multiple publisher connections.

close()

Close httplib2 connections.

get(name, x__xgafv=None)

Gets a publisher connection.

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists publisher connections for a given bidder.

list_next()

Retrieves the next page of results.

Method Details

batchApprove(parent, body=None, x__xgafv=None)
Batch approves multiple publisher connections.

Args:
  parent: string, Required. The bidder for whom publisher connections will be approved. Format: `bidders/{bidder}` where `{bidder}` is the account ID of the bidder. (required)
  body: object, The request body.
    The object takes the form of:

{ # A request to approve a batch of publisher connections.
  "names": [ # Required. The names of the publishers with which connections will be approved. In the pattern `bidders/{bidder}/publisherConnections/{publisher}` where `{bidder}` is the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
    "A String",
  ],
}

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

Returns:
  An object of the form:

    { # A response for the request to approve a batch of publisher connections.
  "publisherConnections": [ # The publisher connections that have been approved.
    { # An Open Bidding exchange's connection to a publisher. This is initiated by the publisher for the bidder to review. If approved by the bidder, this means that the bidder agrees to receive bid requests from the publisher.
      "biddingState": "A String", # Whether the publisher has been approved by the bidder.
      "createTime": "A String", # Output only. The time at which the publisher initiated a connection with the bidder (irrespective of if or when the bidder approves it). This is subsequently updated if the publisher revokes and re-initiates the connection.
      "displayName": "A String", # Output only. Publisher display name.
      "name": "A String", # Output only. Name of the publisher connection. This follows the pattern `bidders/{bidder}/publisherConnections/{publisher}`, where `{bidder}` represents the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
      "publisherPlatform": "A String", # Output only. Whether the publisher is an Ad Manager or AdMob publisher.
    },
  ],
}
batchReject(parent, body=None, x__xgafv=None)
Batch rejects multiple publisher connections.

Args:
  parent: string, Required. The bidder for whom publisher connections will be rejected. Format: `bidders/{bidder}` where `{bidder}` is the account ID of the bidder. (required)
  body: object, The request body.
    The object takes the form of:

{ # A request to reject a batch of publisher connections.
  "names": [ # Required. The names of the publishers with whom connection will be rejected. In the pattern `bidders/{bidder}/publisherConnections/{publisher}` where `{bidder}` is the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
    "A String",
  ],
}

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

Returns:
  An object of the form:

    { # A response for the request to reject a batch of publisher connections.
  "publisherConnections": [ # The publisher connections that have been rejected.
    { # An Open Bidding exchange's connection to a publisher. This is initiated by the publisher for the bidder to review. If approved by the bidder, this means that the bidder agrees to receive bid requests from the publisher.
      "biddingState": "A String", # Whether the publisher has been approved by the bidder.
      "createTime": "A String", # Output only. The time at which the publisher initiated a connection with the bidder (irrespective of if or when the bidder approves it). This is subsequently updated if the publisher revokes and re-initiates the connection.
      "displayName": "A String", # Output only. Publisher display name.
      "name": "A String", # Output only. Name of the publisher connection. This follows the pattern `bidders/{bidder}/publisherConnections/{publisher}`, where `{bidder}` represents the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
      "publisherPlatform": "A String", # Output only. Whether the publisher is an Ad Manager or AdMob publisher.
    },
  ],
}
close()
Close httplib2 connections.
get(name, x__xgafv=None)
Gets a publisher connection.

Args:
  name: string, Required. Name of the publisher whose connection information is to be retrieved. In the pattern `bidders/{bidder}/publisherConnections/{publisher}` where `{bidder}` is the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID. See publisherConnection.name. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Open Bidding exchange's connection to a publisher. This is initiated by the publisher for the bidder to review. If approved by the bidder, this means that the bidder agrees to receive bid requests from the publisher.
  "biddingState": "A String", # Whether the publisher has been approved by the bidder.
  "createTime": "A String", # Output only. The time at which the publisher initiated a connection with the bidder (irrespective of if or when the bidder approves it). This is subsequently updated if the publisher revokes and re-initiates the connection.
  "displayName": "A String", # Output only. Publisher display name.
  "name": "A String", # Output only. Name of the publisher connection. This follows the pattern `bidders/{bidder}/publisherConnections/{publisher}`, where `{bidder}` represents the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
  "publisherPlatform": "A String", # Output only. Whether the publisher is an Ad Manager or AdMob publisher.
}
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists publisher connections for a given bidder.

Args:
  parent: string, Required. Name of the bidder for which publishers have initiated connections. The pattern for this resource is `bidders/{bidder}` where `{bidder}` represents the account ID of the bidder. (required)
  filter: string, Query string to filter publisher connections. Connections can be filtered by `displayName`, `publisherPlatform`, and `biddingState`. If no filter is specified, all publisher connections will be returned. Example: 'displayName="Great Publisher*" AND publisherPlatform=ADMOB AND biddingState != PENDING' See https://google.aip.dev/160 for more information about filtering syntax.
  orderBy: string, Order specification by which results should be sorted. If no sort order is specified, the results will be returned in alphabetic order based on the publisher's publisher code. Results can be sorted by `createTime`. Example: 'createTime DESC'.
  pageSize: integer, Requested page size. The server may return fewer results than requested (due to timeout constraint) even if more are available through another call. If unspecified, the server will pick an appropriate default. Acceptable values are 1 to 5000, inclusive.
  pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListPublisherConnectionsResponse.nextPageToken returned from the previous call to the 'ListPublisherConnections' method.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A response to a request for listing publisher connections.
  "nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the ListPublisherConnectionsRequest.pageToken field in the subsequent call to the `ListPublisherConnections` method to retrieve the next page of results.
  "publisherConnections": [ # The list of publisher connections.
    { # An Open Bidding exchange's connection to a publisher. This is initiated by the publisher for the bidder to review. If approved by the bidder, this means that the bidder agrees to receive bid requests from the publisher.
      "biddingState": "A String", # Whether the publisher has been approved by the bidder.
      "createTime": "A String", # Output only. The time at which the publisher initiated a connection with the bidder (irrespective of if or when the bidder approves it). This is subsequently updated if the publisher revokes and re-initiates the connection.
      "displayName": "A String", # Output only. Publisher display name.
      "name": "A String", # Output only. Name of the publisher connection. This follows the pattern `bidders/{bidder}/publisherConnections/{publisher}`, where `{bidder}` represents the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID.
      "publisherPlatform": "A String", # Output only. Whether the publisher is an Ad Manager or AdMob publisher.
    },
  ],
}
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.