Method: sellers.products.list

  • The sellers.products.list method lists products associated with a specific seller.

  • The request uses an HTTP GET method with the parent seller specified in the path.

  • Query parameters can be used to control the number of results, pagination, filtering, ordering, and whether to show deleted products.

  • A successful response returns a list of products and a token for retrieving the next page of results.

  • Errors like PERMISSION_DENIED or INVALID_ARGUMENT may be returned based on user access or invalid input parameters.

Lists products.

  • For example GET /v1/sellers/111/products
  • Returns a list of products and a token to retrieve the next page if successful.
  • Returns error code PERMISSION_DENIED if the user does not have access to the seller or seller id does not exist.
  • Returns error code INVALID_ARGUMENT if sellers provide an invalid page size or page token.

HTTP request

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/products

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The seller, which owns this collection of products. Format: sellers/{seller}

Query parameters

Parameters
pageSize

integer

The maximum number of items to return. The service may return fewer than this value. Max allowed number of products is 1000; values above 1000 will be changed to 1000. If unspecified, at most 1000 products will be returned.
pageToken

string

The nextPageToken value returned from a previous List request, if any.
filter

string

The list filter. Currently supports external ID, with the syntax: "externalId = [EXTERNAL_ID]". The logical operators AND and OR can be used to chain filters.
orderBy

string

The order by string used to specify the sort order of the results. Currently supports ordering by updateTime, provide "updateTime" to get results sorted by updateTime in ascending order, or "updateTime desc" for descending order.
showDeleted

boolean

Whether to return soft-deleted products.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for InventoryService.ListProducts.

JSON representation 
{
  "products": [
    {
      object (Product)
    }
  ],
  "nextPageToken": string
}
Fields
products[]

object (Product)

The list of products.
nextPageToken

string

A token to retrieve the next page of results. Pass this value in the pageToken field in the subsequent call to products.list method to retrieve the next page of results.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/doubleclickbidmanager

For more information, see the OAuth 2.0 Overview.