Package com.google.cloud.retail.v2beta

Class ProductServiceGrpc.ProductServiceFutureStub

  • Enclosing class:
    ProductServiceGrpc
    public static final class ProductServiceGrpc.ProductServiceFutureStub
extends io.grpc.stub.AbstractFutureStub<ProductServiceGrpc.ProductServiceFutureStub>
    A stub to allow clients to do ListenableFuture-style rpc calls to service ProductService. 
     Service for ingesting [Product][google.cloud.retail.v2beta.Product]
 information of the customer's website.

    • Nested Class Summary

      • Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

        io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> addFulfillmentPlaces​(AddFulfillmentPlacesRequest request)
      It is recommended to use the [ProductService.AddLocalInventories][google.cloud.retail.v2beta.ProductService.AddLocalInventories] method instead of [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.AddFulfillmentPlaces].
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> addLocalInventories​(AddLocalInventoriesRequest request)
      Updates local inventory information for a [Product][google.cloud.retail.v2beta.Product] at a list of places, while respecting the last update timestamps of each inventory field.
      protected ProductServiceGrpc.ProductServiceFutureStub build​(io.grpc.Channel channel, io.grpc.CallOptions callOptions)  
      com.google.common.util.concurrent.ListenableFuture<Product> createProduct​(CreateProductRequest request)
      Creates a [Product][google.cloud.retail.v2beta.Product].
      com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Empty> deleteProduct​(DeleteProductRequest request)
      Deletes a [Product][google.cloud.retail.v2beta.Product].
      com.google.common.util.concurrent.ListenableFuture<Product> getProduct​(GetProductRequest request)
      Gets a [Product][google.cloud.retail.v2beta.Product].
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> importProducts​(ImportProductsRequest request)
      Bulk import of multiple [Product][google.cloud.retail.v2beta.Product]s.
      com.google.common.util.concurrent.ListenableFuture<ListProductsResponse> listProducts​(ListProductsRequest request)
      Gets a list of [Product][google.cloud.retail.v2beta.Product]s.
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> removeFulfillmentPlaces​(RemoveFulfillmentPlacesRequest request)
      It is recommended to use the [ProductService.RemoveLocalInventories][google.cloud.retail.v2beta.ProductService.RemoveLocalInventories] method instead of [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.RemoveFulfillmentPlaces].
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> removeLocalInventories​(RemoveLocalInventoriesRequest request)
      Remove local inventory information for a [Product][google.cloud.retail.v2beta.Product] at a list of places at a removal timestamp.
      com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> setInventory​(SetInventoryRequest request)
      Updates inventory information for a [Product][google.cloud.retail.v2beta.Product] while respecting the last update timestamps of each inventory field.
      com.google.common.util.concurrent.ListenableFuture<Product> updateProduct​(UpdateProductRequest request)
      Updates a [Product][google.cloud.retail.v2beta.Product].

      • Methods inherited from class io.grpc.stub.AbstractFutureStub

        newStub, newStub

      • Methods inherited from class io.grpc.stub.AbstractStub

        getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOption, withWaitForReady

    • Method Detail

      • createProduct

        public com.google.common.util.concurrent.ListenableFuture<Product> createProduct​(CreateProductRequest request)
         Creates a [Product][google.cloud.retail.v2beta.Product].

      • getProduct

        public com.google.common.util.concurrent.ListenableFuture<Product> getProduct​(GetProductRequest request)
         Gets a [Product][google.cloud.retail.v2beta.Product].

      • listProducts

        public com.google.common.util.concurrent.ListenableFuture<ListProductsResponse> listProducts​(ListProductsRequest request)
         Gets a list of [Product][google.cloud.retail.v2beta.Product]s.

      • updateProduct

        public com.google.common.util.concurrent.ListenableFuture<Product> updateProduct​(UpdateProductRequest request)
         Updates a [Product][google.cloud.retail.v2beta.Product].

      • deleteProduct

        public com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Empty> deleteProduct​(DeleteProductRequest request)
         Deletes a [Product][google.cloud.retail.v2beta.Product].

      • importProducts

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> importProducts​(ImportProductsRequest request)
         Bulk import of multiple [Product][google.cloud.retail.v2beta.Product]s.
 Request processing may be synchronous.
 Non-existing items are created.
 Note that it is possible for a subset of the
 [Product][google.cloud.retail.v2beta.Product]s to be successfully updated.

      • setInventory

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> setInventory​(SetInventoryRequest request)
         Updates inventory information for a
 [Product][google.cloud.retail.v2beta.Product] while respecting the last
 update timestamps of each inventory field.
 This process is asynchronous and does not require the
 [Product][google.cloud.retail.v2beta.Product] to exist before updating
 fulfillment information. If the request is valid, the update is enqueued
 and processed downstream. As a consequence, when a response is returned,
 updates are not immediately manifested in the
 [Product][google.cloud.retail.v2beta.Product] queried by
 [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct]
 or
 [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
 When inventory is updated with
 [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct]
 and
 [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct],
 the specified inventory field value(s) overwrite any existing value(s)
 while ignoring the last update time for this field. Furthermore, the last
 update times for the specified inventory fields are overwritten by the
 times of the
 [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct]
 or
 [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
 request.
 If no inventory fields are set in
 [CreateProductRequest.product][google.cloud.retail.v2beta.CreateProductRequest.product],
 then any pre-existing inventory information for this product is used.
 If no inventory fields are set in
 [SetInventoryRequest.set_mask][google.cloud.retail.v2beta.SetInventoryRequest.set_mask],
 then any existing inventory information is preserved.
 Pre-existing inventory information can only be updated with
 [ProductService.SetInventory][google.cloud.retail.v2beta.ProductService.SetInventory],
 [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.AddFulfillmentPlaces],
 and
 [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.RemoveFulfillmentPlaces].
 The returned [Operation][google.longrunning.Operation]s is obsolete after
 one day, and the [GetOperation][google.longrunning.Operations.GetOperation]
 API returns `NOT_FOUND` afterwards.
 If conflicting updates are issued, the
 [Operation][google.longrunning.Operation]s associated with the stale
 updates are not marked as [done][google.longrunning.Operation.done] until
 they are obsolete.

      • addFulfillmentPlaces

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> addFulfillmentPlaces​(AddFulfillmentPlacesRequest request)
         It is recommended to use the
 [ProductService.AddLocalInventories][google.cloud.retail.v2beta.ProductService.AddLocalInventories]
 method instead of
 [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.AddFulfillmentPlaces].
 [ProductService.AddLocalInventories][google.cloud.retail.v2beta.ProductService.AddLocalInventories]
 achieves the same results but provides more fine-grained control over
 ingesting local inventory data.
 Incrementally adds place IDs to
 [Product.fulfillment_info.place_ids][google.cloud.retail.v2beta.FulfillmentInfo.place_ids].
 This process is asynchronous and does not require the
 [Product][google.cloud.retail.v2beta.Product] to exist before updating
 fulfillment information. If the request is valid, the update will be
 enqueued and processed downstream. As a consequence, when a response is
 returned, the added place IDs are not immediately manifested in the
 [Product][google.cloud.retail.v2beta.Product] queried by
 [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct]
 or
 [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
 The returned [Operation][google.longrunning.Operation]s will be obsolete
 after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
 API will return NOT_FOUND afterwards.
 If conflicting updates are issued, the
 [Operation][google.longrunning.Operation]s associated with the stale
 updates will not be marked as [done][google.longrunning.Operation.done]
 until being obsolete.

      • removeFulfillmentPlaces

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> removeFulfillmentPlaces​(RemoveFulfillmentPlacesRequest request)
         It is recommended to use the
 [ProductService.RemoveLocalInventories][google.cloud.retail.v2beta.ProductService.RemoveLocalInventories]
 method instead of
 [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2beta.ProductService.RemoveFulfillmentPlaces].
 [ProductService.RemoveLocalInventories][google.cloud.retail.v2beta.ProductService.RemoveLocalInventories]
 achieves the same results but provides more fine-grained control over
 ingesting local inventory data.
 Incrementally removes place IDs from a
 [Product.fulfillment_info.place_ids][google.cloud.retail.v2beta.FulfillmentInfo.place_ids].
 This process is asynchronous and does not require the
 [Product][google.cloud.retail.v2beta.Product] to exist before updating
 fulfillment information. If the request is valid, the update will be
 enqueued and processed downstream. As a consequence, when a response is
 returned, the removed place IDs are not immediately manifested in the
 [Product][google.cloud.retail.v2beta.Product] queried by
 [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct]
 or
 [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
 The returned [Operation][google.longrunning.Operation]s will be obsolete
 after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
 API will return NOT_FOUND afterwards.
 If conflicting updates are issued, the
 [Operation][google.longrunning.Operation]s associated with the stale
 updates will not be marked as [done][google.longrunning.Operation.done]
 until being obsolete.

      • addLocalInventories

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> addLocalInventories​(AddLocalInventoriesRequest request)
         Updates local inventory information for a
 [Product][google.cloud.retail.v2beta.Product] at a list of places, while
 respecting the last update timestamps of each inventory field.
 This process is asynchronous and does not require the
 [Product][google.cloud.retail.v2beta.Product] to exist before updating
 inventory information. If the request is valid, the update will be enqueued
 and processed downstream. As a consequence, when a response is returned,
 updates are not immediately manifested in the
 [Product][google.cloud.retail.v2beta.Product] queried by
 [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct]
 or
 [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
 Local inventory information can only be modified using this method.
 [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct]
 and
 [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
 has no effect on local inventories.
 The returned [Operation][google.longrunning.Operation]s will be obsolete
 after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
 API will return NOT_FOUND afterwards.
 If conflicting updates are issued, the
 [Operation][google.longrunning.Operation]s associated with the stale
 updates will not be marked as [done][google.longrunning.Operation.done]
 until being obsolete.

      • removeLocalInventories

        public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation> removeLocalInventories​(RemoveLocalInventoriesRequest request)
         Remove local inventory information for a
 [Product][google.cloud.retail.v2beta.Product] at a list of places at a
 removal timestamp.
 This process is asynchronous. If the request is valid, the removal will be
 enqueued and processed downstream. As a consequence, when a response is
 returned, removals are not immediately manifested in the
 [Product][google.cloud.retail.v2beta.Product] queried by
 [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct]
 or
 [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
 Local inventory information can only be removed using this method.
 [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct]
 and
 [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
 has no effect on local inventories.
 The returned [Operation][google.longrunning.Operation]s will be obsolete
 after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
 API will return NOT_FOUND afterwards.
 If conflicting updates are issued, the
 [Operation][google.longrunning.Operation]s associated with the stale
 updates will not be marked as [done][google.longrunning.Operation.done]
 until being obsolete.