com.google.api.ads.dfp.axis.v201708

Interface ProductServiceInterface

All Superinterfaces:

Remote

All Known Implementing Classes:

ProductServiceSoapBindingStub

public interface ProductServiceInterface
extends Remote

Method Summary

Modifier and Type	Method and Description
Product[]	createProducts(Product[] products) Creates new Product objects.
ProductPage	getProductsByStatement(Statement statement) Gets a ProductPage of Product objects that satisfy the criteria specified by given Statement.query.
UpdateResult	performProductAction(ProductAction productAction, Statement filterStatement) Performs action on Product objects that satisfy the given Statement.
Product[]	updateProducts(Product[] products) Updates the specified Product objects.

Method Detail

createProducts

Product[] createProducts(Product[] products)
                  throws RemoteException,
                         ApiException

Creates new Product objects. This method is only available when creating programmatic guaranteed products when not using sales management.

Parameters:

products - the products to create

Returns:

the created products with their IDs filled in

Throws:

RemoteException

ApiException

getProductsByStatement

ProductPage getProductsByStatement(Statement statement)
                            throws RemoteException,
                                   ApiException

Gets a ProductPage of Product objects that satisfy the criteria specified by given Statement.query.

When using sales management, the following fields are supported for filtering and/or sorting.

PQL Property	Object Property	Filterable	Sortable
rateCardId	Rate card ID which the product is associated with	Yes	No
status	Product.status	Yes	Yes
lineItemType	Product.lineItemType	Yes	Yes
productType	Product.productType	Yes	Yes
rateType	Product.rateType	Yes	Yes
productTemplateId	Product.productTemplateId	Yes	No
name	Product.name	Yes	Yes
description	Product#description	Yes	No
id	Product.id	Yes	Yes
lastModifiedDateTime	Product.lastModifiedDateTime	Yes	Yes

When using programmatic guaranteed and not sales management, the following fields are supported for filtering and/or sorting.

PQL Property	Object Property	Filterable	Sortable
status	Product.status	Yes	Yes
rateType	Product.rateType	Yes	Yes
name	Product.name	Yes	Yes
id	Product.id	Yes	Yes
lastModifiedDateTime	Product.lastModifiedDateTime	Yes	Yes

Parameters:

statement - a Publisher Query Language statement which specifies the filtering criteria over products

Returns:

the products that match the given statement

Throws:

RemoteException

ApiException

performProductAction

UpdateResult performProductAction(ProductAction productAction,
                                  Statement filterStatement)
                           throws RemoteException,
                                  ApiException

Performs action on Product objects that satisfy the given Statement.

Parameters:

productAction - the action to perform

filterStatement - a Publisher Query Language statement used to filter a set of products.

Returns:

the result of the action performed

Throws:

RemoteException

ApiException

updateProducts

Product[] updateProducts(Product[] products)
                  throws RemoteException,
                         ApiException

Updates the specified Product objects. Note non-updatable fields will not be backfilled.

Parameters:

products - the products to update

Returns:

the updated products

Throws:

RemoteException

ApiException