Struct google_api_proto::google::cloud::retail::v2alpha::SetInventoryRequest

pub struct SetInventoryRequest {
    pub inventory: Option<Product>,
    pub set_mask: Option<FieldMask>,
    pub set_time: Option<Timestamp>,
    pub allow_missing: bool,
}

Request message for [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory] method.

Fields

inventory: Option<Product>

Required. The inventory information to update. The allowable fields to update are:

• [Product.price_info][google.cloud.retail.v2alpha.Product.price_info]
• [Product.availability][google.cloud.retail.v2alpha.Product.availability]
• [Product.available_quantity][google.cloud.retail.v2alpha.Product.available_quantity]
• [Product.fulfillment_info][google.cloud.retail.v2alpha.Product.fulfillment_info] The updated inventory fields must be specified in [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask].

If [SetInventoryRequest.inventory.name][google.cloud.retail.v2alpha.Product.name] is empty or invalid, an INVALID_ARGUMENT error is returned.

If the caller does not have permission to update the [Product][google.cloud.retail.v2alpha.Product] named in [Product.name][google.cloud.retail.v2alpha.Product.name], regardless of whether or not it exists, a PERMISSION_DENIED error is returned.

If the [Product][google.cloud.retail.v2alpha.Product] to update does not have existing inventory information, the provided inventory information will be inserted.

If the [Product][google.cloud.retail.v2alpha.Product] to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for [SetInventoryRequest.set_time][google.cloud.retail.v2alpha.SetInventoryRequest.set_time].

The caller can replace place IDs for a subset of fulfillment types in the following ways:

• Adds “fulfillment_info” in [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask]
• Specifies only the desired fulfillment types and corresponding place IDs to update in [SetInventoryRequest.inventory.fulfillment_info][google.cloud.retail.v2alpha.Product.fulfillment_info]

The caller can clear all place IDs from a subset of fulfillment types in the following ways:

• Adds “fulfillment_info” in [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask]
• Specifies only the desired fulfillment types to clear in [SetInventoryRequest.inventory.fulfillment_info][google.cloud.retail.v2alpha.Product.fulfillment_info]
• Checks that only the desired fulfillment info types have empty [SetInventoryRequest.inventory.fulfillment_info.place_ids][google.cloud.retail.v2alpha.FulfillmentInfo.place_ids]

The last update time is recorded for the following inventory fields:

• [Product.price_info][google.cloud.retail.v2alpha.Product.price_info]
• [Product.availability][google.cloud.retail.v2alpha.Product.availability]
• [Product.available_quantity][google.cloud.retail.v2alpha.Product.available_quantity]
• [Product.fulfillment_info][google.cloud.retail.v2alpha.Product.fulfillment_info]

If a full overwrite of inventory information while ignoring timestamps is needed, [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] should be invoked instead.

set_mask: Option<FieldMask>

Indicates which inventory fields in the provided [Product][google.cloud.retail.v2alpha.Product] to update.

At least one field must be provided.

If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.

set_time: Option<Timestamp>

The time when the request is issued, used to prevent out-of-order updates on inventory fields with the last update time recorded. If not provided, the internal system time will be used.

allow_missing: bool

If set to true, and the [Product][google.cloud.retail.v2alpha.Product] with name [Product.name][google.cloud.retail.v2alpha.Product.name] is not found, the inventory update will still be processed and retained for at most 1 day until the [Product][google.cloud.retail.v2alpha.Product] is created. If set to false, a NOT_FOUND error is returned if the [Product][google.cloud.retail.v2alpha.Product] is not found.

Trait Implementations

impl Clone for SetInventoryRequest

fn clone(&self) -> SetInventoryRequest

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SetInventoryRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SetInventoryRequest

fn default() -> Self

Returns the “default value” for a type.

impl Message for SetInventoryRequest

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for SetInventoryRequest

fn eq(&self, other: &SetInventoryRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SetInventoryRequest