Add more clarifying comments about resource names versus identifiers (AutoML Video OT)

Rebecca Taylor · Rebecca Taylor · commit d1b3f77e307a · 2019-06-28T19:18:47.000-07:00
diff --git a/video/cloud-client/automl/v1beta1/automl_video_object_tracking_create_dataset.py b/video/cloud-client/automl/v1beta1/automl_video_object_tracking_create_dataset.py
@@ -68,6 +68,9 @@ def sample_create_dataset(display_name, project):
     # This will have the format:
     #   projects/[Google Cloud Project Number]/locations/us-central1/datasets/VOT1234567890123456789
     #
+    # The Dataset ID is the generated identifer in this path, e.g. VOT1234567890123456789
+    # You will need this ID to perform operations on the dataset as well as to create a model.
+    #
     print(u"Name: {}".format(dataset.name))
     # Print out the Display Name (the text you provided during creation)
     print(u"Display Name: {}".format(dataset.display_name))
diff --git a/video/cloud-client/automl/v1beta1/automl_video_object_tracking_get_dataset.py b/video/cloud-client/automl/v1beta1/automl_video_object_tracking_get_dataset.py
@@ -52,6 +52,9 @@ def sample_get_dataset(dataset_id, project):
     # This will have the format:
     #   projects/[Google Cloud Project Number]/locations/us-central1/datasets/VOT1234567890123456789
     #
+    # The Dataset ID is the generated identifer in this path, e.g. VOT1234567890123456789
+    # You will need this ID to perform operations on the dataset as well as to create a model.
+    #
     print(u"Name: {}".format(dataset.name))
     # Print out the Display Name (the text you provided during creation)
     print(u"Display Name: {}".format(dataset.display_name))
diff --git a/video/cloud-client/automl/v1beta1/automl_video_object_tracking_get_model.py b/video/cloud-client/automl/v1beta1/automl_video_object_tracking_get_model.py
@@ -52,6 +52,9 @@ def sample_get_model(model_id, project):
     # This will have the format:
     #   projects/[Google Cloud Project Number]/locations/us-central1/models/VOT1234567890123456789
     #
+    # The Model ID is the generated identifer in this path, e.g. VOT1234567890123456789
+    # You will need this ID to perform operations on the model including predictions.
+    #
     print(u"Model name: {}".format(model.name))
     # Print out the Display Name (the text you provided during creation)
     print(u"Display name: {}".format(model.display_name))
diff --git a/video/cloud-client/automl/v1beta1/automl_video_object_tracking_list_datasets.py b/video/cloud-client/automl/v1beta1/automl_video_object_tracking_list_datasets.py
@@ -55,6 +55,9 @@ def sample_list_datasets(project):
         # This will have the format:
         #   projects/[Google Cloud Project Number]/locations/us-central1/datasets/VOT1234567890123456789
         #
+        # The Dataset ID is the generated identifer in this path, e.g. VOT1234567890123456789
+        # You will need this ID to perform operations on the dataset as well as to create a model.
+        #
         print(u"Name: {}".format(dataset.name))
         # Print out the Display Name (the text you provided during creation)
         print(u"Display Name: {}".format(dataset.display_name))
diff --git a/video/cloud-client/automl/v1beta1/automl_video_object_tracking_list_models.py b/video/cloud-client/automl/v1beta1/automl_video_object_tracking_list_models.py
@@ -54,6 +54,9 @@ def sample_list_models(filter_, project):
         # This will have the format:
         #   projects/[Google Cloud Project Number]/locations/us-central1/models/VOT1234567890123456789
         #
+        # The Model ID is the generated identifer in this path, e.g. VOT1234567890123456789
+        # You will need this ID to perform operations on the model including predictions.
+        #
         print(u"Model name: {}".format(model.name))
         # Print out the Display Name (the text you provided during creation)
         print(u"Display name: {}".format(model.display_name))
