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). |