docs(samples): add resources for interactive tutorials (#145)

* feat: Retail Interactive Tutorials. Product service code samples

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* fail if GOOGLE_CLOUD_PROJECT_NUMBER is not set

* remove endpoint

* require GOOGLE_CLOUD_PROJECT environment variable

* adjust filepaths samples testing

* lint

* update and move the tests resources setup files

* Update create_test_resources.py

* Update create_test_resources.py

* fix typo

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <[email protected]>
Co-authored-by: t-karasova <[email protected]>

Author: 4 people

generated_samples/snippets/TEST_RESOURCES_SETUP_CLEANUP.md renamed to generated_samples/interactive-tutorials/TEST_RESOURCES_SETUP_CLEANUP.md

@@ -3,22 +3,31 @@
 ## Required environment variables
 
 To successfully import the catalog data for tests, the following environment variables should be set:
- - PROJECT_NUMBER
+ - GOOGLE_CLOUD_PROJECT_NUMBER
+ - GOOGLE_CLOUD_PROJECT_ID 
  - BUCKET_NAME
+ - EVENTS_BUCKET_NAME
 These values are stored in the Secret Manager and will be submitted as 
    docker environment variables before the test run.
 
 The Secret Manager name is set in .kokoro/presubmit/common.cfg file, SECRET_MANAGER_KEYS variable.
 
 ## Import catalog data
 
-There is a JSON file with valid products prepared in the `product` directory:
-`resources/products.json`.
+There are JSON files with valid products and user events prepared in `resources` directory:
+`samples/resources/products.json` and `samples/resources/user_events.json` respectively.
 
 Run the `create_test_resources.py` to perform the following actions:
    - create the GCS bucket <BUCKET_NAME>, 
-   - upload the product data from `resources/products.json` file,
-   - import products to the default branch of the Retail catalog.
+      - upload the product data from `resources/products.json` file to products bucket,
+   - import products to the default branch of the Retail catalog,
+   - create the GCS bucket <EVENTS_BUCKET_NAME>, 
+      - upload the product data from `resources/user_events.json` file to events bucket,
+   - create a BigQuery dataset and table `products`,
+      - insert products from resources/products.json to the created products table,
+   - create a BigQuery dataset and table `events`,
+      - insert user events from resources/user_events.json to the created events table
+  
 
 ```
 $ python create_test_resources.py
@@ -33,6 +42,10 @@ Run the `remove_test_resources.py` to perform the following actions:
    - remove all objects from the GCS bucket <BUCKET_NAME>, 
    - remove the <BUCKET_NAME> bucket,
    - delete all products from the Retail catalog.
+   - remove all objects from the GCS bucket <EVENTS_BUCKET_NAME>, 
+   - remove the <EVENTS_BUCKET_NAME> bucket,
+   - remove dataset `products` along with tables
+   - remove dataset `user_events` along with tables 
 
 ```
 $ python remove_test_resources.py

generated_samples/interactive-tutorials/resources/events_schema.json

@@ -0,0 +1,73 @@
+[
+    {
+      "fields":[
+        {
+          "mode": "NULLABLE",
+          "name": "currencyCode",
+          "type": "STRING"
+        },
+        {
+          "mode": "NULLABLE",
+          "name": "revenue",
+          "type": "FLOAT"
+        }
+      ],
+      "mode": "NULLABLE",
+      "name": "purchaseTransaction",
+      "type": "RECORD"
+    },
+    {
+      "fields":[
+        {
+          "mode": "NULLABLE",
+          "name": "quantity",
+          "type": "INTEGER"
+        },
+        {
+          "fields":[
+            {
+              "mode": "NULLABLE",
+              "name": "id",
+              "type": "STRING"
+            }
+          ],
+          "mode": "NULLABLE",
+          "name": "product",
+          "type": "RECORD"
+        }
+      ],
+      "mode": "REPEATED",
+      "name": "productDetails",
+      "type": "RECORD"
+    },
+    {
+      "mode": "REQUIRED",
+      "name": "eventTime",
+      "type": "STRING"
+    },
+    {
+      "mode": "REQUIRED",
+      "name": "visitorId",
+      "type": "STRING"
+    },
+    {
+      "mode": "REQUIRED",
+      "name": "eventType",
+      "type": "STRING"
+    },
+    {
+      "mode": "NULLABLE",
+      "name": "searchQuery",
+      "type": "STRING"
+    },
+    {
+      "mode": "NULLABLE",
+      "name": "cartId",
+      "type": "STRING"
+    },
+    {
+      "mode": "REPEATED",
+      "name": "pageCategories",
+      "type": "STRING"
+    }
+  ]