Resource: Product
A product is a segment of inventory that a seller wants to sell. It is associated with certain terms and targeting information which helps the buyer know more about the inventory.
JSON representation | |
---|---|
{ "productId" : string , "createTime" : string , "updateTime" : string , "seller" : { object ( |
Fields | |
---|---|
productId
|
The unique ID for the product. |
createTime
|
Creation time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime
|
Time of last update. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
seller
|
Information about the seller that created this product. |
publisherProfileId
|
An ID which can be used by the Publisher Profile API to get more information about the seller that created this product. |
displayName
|
The display name for this product as set by the seller. |
terms
|
The negotiable terms of the deal. |
creatorContacts[]
|
Optional contact information for the creator of this product. |
availableStartTime
|
Inventory availability dates. The start time will be truncated to seconds during serving. Thus, a field specified as 3:23:34.456 (HH:mm:ss.SSS) will be truncated to 3:23:34 when serving. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
availableEndTime
|
The proposed end time for the deal. The field will be truncated to the order of seconds during serving. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
hasCreatorSignedOff
|
If the creator has already signed off on the product, then the buyer can finalize the deal by accepting the product as is. When copying to a proposal, if any of the terms are changed, then auto_finalize is automatically set to false. |
targetingCriterion[]
|
Targeting that is shared between the buyer and the seller. Each targeting criterion has a specified key and for each key there is a list of inclusion value or exclusion values. |
webPropertyCode
|
The web-property code for the seller. This needs to be copied as is when adding a new deal to a proposal. |
productRevision
|
The revision number of the product (auto-assigned by Marketplace). |
syndicationProduct
|
The syndication product associated with the deal. |
Methods |
|
---|---|
|
Gets the requested product by ID. |
|
List all products visible to the buyer (optionally filtered by the specified PQL query). |