chore(samples): add and fix comments (#312)

Co-authored-by: Anthonios Partheniou <partheniou@google.com>

generated_samples/interactive-tutorials/events/purge_user_event.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_purge_user_event]
-# Import user events into a catalog from inline source using Retail API
+# Deleting user event using Retail API.
 #
 import google.auth
 from google.cloud.retail import PurgeUserEventsRequest, UserEventServiceClient

generated_samples/interactive-tutorials/events/rejoin_user_event.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_rejoin_user_event]
-# Import user events into a catalog from inline source using Retail API
+# Starts a user event rejoin operation using Retail API.
 #
 import google.auth
 from google.cloud.retail import RejoinUserEventsRequest, UserEventServiceClient

generated_samples/interactive-tutorials/events/write_user_event.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_write_user_event]
-# Import user events into a catalog from inline source using Retail API
+# Write user event using Retail API.
 #
 import datetime
 

generated_samples/interactive-tutorials/product/add_fulfillment_places.py

@@ -13,6 +13,8 @@
 # limitations under the License.
 
 # [START retail_add_fulfillment_places]
+# Adding place IDs using Retail API.
+#
 import datetime
 import random
 import string

generated_samples/interactive-tutorials/product/crud_product.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_crud_product]
-# Create product in a catalog using Retail API
+# Create, update, get and delete product in a catalog using Retail API.
 #
 import random
 import string

generated_samples/interactive-tutorials/product/delete_product.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_delete_product]
-# Delete product from a catalog using Retail API
+# Delete product from a catalog using Retail API.
 #
 import random
 import string

generated_samples/interactive-tutorials/product/get_product.py

@@ -14,7 +14,7 @@
 
 
 # [START retail_get_product]
-# Get product from a catalog using Retail API
+# Get product from a catalog using Retail API.
 #
 import random
 import string

generated_samples/interactive-tutorials/product/import_products_gcs.py

@@ -18,7 +18,8 @@
 
 def main(bucket_name):
     # [START retail_import_products_from_gcs]
-
+    # Import products from using Retail API.
+    #
     import time
 
     import google.auth

generated_samples/interactive-tutorials/product/remove_fulfillment_places.py

@@ -13,6 +13,8 @@
 # limitations under the License.
 
 # [START retail_remove_fulfillment_places]
+# Remove place IDs using Retail API.
+#
 import datetime
 import random
 import string

generated_samples/interactive-tutorials/product/set_inventory.py

@@ -13,6 +13,8 @@
 # limitations under the License.
 
 # [START retail_set_inventory]
+# Updating inventory information using Retail API.
+#
 import datetime
 import random
 import string

generated_samples/interactive-tutorials/search/search_with_facet_spec.py

@@ -13,8 +13,8 @@
 # limitations under the License.
 
 # [START retail_search_product_with_facet_spec]
+# Call Retail API to search for a products in a catalog with facets.
 #
-
 import google.auth
 from google.cloud.retail import SearchRequest, SearchServiceClient