addProduct(name, body, x__xgafv=None)

Adds a Product to the specified ProductSet. If the Product is already
present, no change is made.

One Product can be added to at most 100 ProductSets.

Possible errors:

* Returns NOT_FOUND if the Product or the ProductSet doesn't exist.

Args:
  name: string, The resource name for the ProductSet to modify.

Format is:
`projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID` (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # Request message for the `AddProductToProductSet` method.
    "product": "A String", # The resource name for the Product to be added to this ProductSet.
        # 
        # Format is:
        # `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated
      # empty messages in your APIs. A typical example is to use it as the request
      # or the response type of an API method. For instance:
      #
      #     service Foo {
      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
      #     }
      #
      # The JSON representation for `Empty` is empty JSON object `{}`.
  }

create(parent, body, productSetId=None, x__xgafv=None)

Creates and returns a new ProductSet resource.

Possible errors:

* Returns INVALID_ARGUMENT if display_name is missing, or is longer than
  4096 characters.

Args:
  parent: string, The project in which the ProductSet should be created.

Format is `projects/PROJECT_ID/locations/LOC_ID`. (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # A ProductSet contains Products. A ProductSet can contain a maximum of 1
    # million reference images. If the limit is exceeded, periodic indexing will
    # fail.
  "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
      # is populated.
      # 
      # This field is ignored when creating a ProductSet.
      # different programming environments, including REST APIs and RPC APIs. It is
      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
      # three pieces of data: error code, error message, and error details.
      #
      # You can find out more about this error model and how to work with it in the
      # [API Design Guide](https://cloud.google.com/apis/design/errors).
    "message": "A String", # A developer-facing error message, which should be in English. Any
        # user-facing error message should be localized and sent in the
        # google.rpc.Status.details field, or localized by the client.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details.  There is a common set of
        # message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
  },
  "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
      # most 4096 characters long.
  "name": "A String", # The resource name of the ProductSet.
      # 
      # Format is:
      # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
      # 
      # This field is ignored when creating a ProductSet.
  "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
      # results will reflect all updates before this time. If this ProductSet has
      # never been indexed, this timestamp is the default value
      # "1970-01-01T00:00:00Z".
      # 
      # This field is ignored when creating a ProductSet.
}

  productSetId: string, A user-supplied resource id for this ProductSet. If set, the server will
attempt to use this value as the resource id. If it is already in use, an
error is returned with code ALREADY_EXISTS. Must be at most 128 characters
long. It cannot contain the character `/`.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A ProductSet contains Products. A ProductSet can contain a maximum of 1
      # million reference images. If the limit is exceeded, periodic indexing will
      # fail.
    "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
        # is populated.
        #
        # This field is ignored when creating a ProductSet.
        # different programming environments, including REST APIs and RPC APIs. It is
        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
        # three pieces of data: error code, error message, and error details.
        #
        # You can find out more about this error model and how to work with it in the
        # [API Design Guide](https://cloud.google.com/apis/design/errors).
      "message": "A String", # A developer-facing error message, which should be in English. Any
          # user-facing error message should be localized and sent in the
          # google.rpc.Status.details field, or localized by the client.
      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
      "details": [ # A list of messages that carry the error details.  There is a common set of
          # message types for APIs to use.
        {
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      ],
    },
    "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
        # most 4096 characters long.
    "name": "A String", # The resource name of the ProductSet.
        #
        # Format is:
        # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
        #
        # This field is ignored when creating a ProductSet.
    "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
        # results will reflect all updates before this time. If this ProductSet has
        # never been indexed, this timestamp is the default value
        # "1970-01-01T00:00:00Z".
        #
        # This field is ignored when creating a ProductSet.
  }

delete(name, x__xgafv=None)

Permanently deletes a ProductSet. Products and ReferenceImages in the
ProductSet are not deleted.

The actual image files are not deleted from Google Cloud Storage.

Args:
  name: string, Resource name of the ProductSet to delete.

Format is:
`projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated
      # empty messages in your APIs. A typical example is to use it as the request
      # or the response type of an API method. For instance:
      #
      #     service Foo {
      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
      #     }
      #
      # The JSON representation for `Empty` is empty JSON object `{}`.
  }

get(name, x__xgafv=None)

Gets information associated with a ProductSet.

Possible errors:

* Returns NOT_FOUND if the ProductSet does not exist.

Args:
  name: string, Resource name of the ProductSet to get.

Format is:
`projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A ProductSet contains Products. A ProductSet can contain a maximum of 1
      # million reference images. If the limit is exceeded, periodic indexing will
      # fail.
    "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
        # is populated.
        #
        # This field is ignored when creating a ProductSet.
        # different programming environments, including REST APIs and RPC APIs. It is
        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
        # three pieces of data: error code, error message, and error details.
        #
        # You can find out more about this error model and how to work with it in the
        # [API Design Guide](https://cloud.google.com/apis/design/errors).
      "message": "A String", # A developer-facing error message, which should be in English. Any
          # user-facing error message should be localized and sent in the
          # google.rpc.Status.details field, or localized by the client.
      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
      "details": [ # A list of messages that carry the error details.  There is a common set of
          # message types for APIs to use.
        {
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      ],
    },
    "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
        # most 4096 characters long.
    "name": "A String", # The resource name of the ProductSet.
        #
        # Format is:
        # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
        #
        # This field is ignored when creating a ProductSet.
    "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
        # results will reflect all updates before this time. If this ProductSet has
        # never been indexed, this timestamp is the default value
        # "1970-01-01T00:00:00Z".
        #
        # This field is ignored when creating a ProductSet.
  }

import_(parent, body, x__xgafv=None)

Asynchronous API that imports a list of reference images to specified
product sets based on a list of image information.

The google.longrunning.Operation API can be used to keep track of the
progress and results of the request.
`Operation.metadata` contains `BatchOperationMetadata`. (progress)
`Operation.response` contains `ImportProductSetsResponse`. (results)

The input source of this method is a csv file on Google Cloud Storage.
For the format of the csv file please see
ImportProductSetsGcsSource.csv_file_uri.

Args:
parent: string, The project in which the ProductSets should be imported.

Format is `projects/PROJECT_ID/locations/LOC_ID`. (required)
body: object, The request body. (required)
The object takes the form of:

{ # Request message for the `ImportProductSets` method.
"inputConfig": { # The input content for the `ImportProductSets` method. # The input content for the list of requests.
"gcsSource": { # The Google Cloud Storage location for a csv file which preserves a list of # The Google Cloud Storage location for a csv file which preserves a list
# of ImportProductSetRequests in each line.
# ImportProductSetRequests in each line.
"csvFileUri": "A String", # The Google Cloud Storage URI of the input csv file.
#
# The URI must start with `gs://`.
#
# The format of the input csv file should be one image per line.
# In each line, there are 8 columns.
#
# 1. image-uri
# 2. image-id
# 3. product-set-id
# 4. product-id
# 5. product-category
# 6. product-display-name
# 7. labels
# 8. bounding-poly
#
# The `image-uri`, `product-set-id`, `product-id`, and `product-category`
# columns are required. All other columns are optional.
#
# If the `ProductSet` or `Product` specified by the `product-set-id` and
# `product-id` values does not exist, then the system will create a new
# `ProductSet` or `Product` for the image. In this case, the
# `product-display-name` column refers to
# display_name, the
# `product-category` column refers to
# product_category, and the
# `labels` column refers to product_labels.
#
# The `image-id` column is optional but must be unique if provided. If it is
# empty, the system will automatically assign a unique id to the image.
#
# The `product-display-name` column is optional. If it is empty, the system
# sets the display_name field for the product to a
# space (" "). You can update the `display_name` later by using the API.
#
# If a `Product` with the specified `product-id` already exists, then the
# system ignores the `product-display-name`, `product-category`, and `labels`
# columns.
#
# The `labels` column (optional) is a line containing a list of
# comma-separated key-value pairs, in the following format:
#
# "key_1=value_1,key_2=value_2,...,key_n=value_n"
#
# The `bounding-poly` column (optional) identifies one region of
# interest from the image in the same manner as `CreateReferenceImage`. If
# you do not specify the `bounding-poly` column, then the system will try to
# detect regions of interest automatically.
#
# At most one `bounding-poly` column is allowed per line. If the image
# contains multiple regions of interest, add a line to the CSV file that
# includes the same product information, and the `bounding-poly` values for
# each region of interest.
#
# The `bounding-poly` column must contain an even number of comma-separated
# numbers, in the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Use
# non-negative integers for absolute bounding polygons, and float values
# in [0, 1] for normalized bounding polygons.
#
# The system will resize the image if the image resolution is too
# large to process (larger than 20MP).
},
},
}

x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # This resource represents a long-running operation that is the result of a
# network API call.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
# `Get`/`Create`/`Update`, the response should be the resource. For other
# methods, the response should have the type `XxxResponse`, where `Xxx`
# is the original method name. For example, if the original method name
# is `TakeSnapshot()`, the inferred response type is
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"metadata": { # Service-specific metadata associated with the operation. It typically
# contains progress information and common metadata such as create time.
# Some services might not provide such metadata. Any method that returns a
# long-running operation should document the metadata type, if any.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"done": True or False, # If the value is `false`, it means the operation is still in progress.
# If `true`, the operation is completed, and either `error` or `response` is
# available.
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
# three pieces of data: error code, error message, and error details.
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
"message": "A String", # A developer-facing error message, which should be in English. Any
# user-facing error message should be localized and sent in the
# google.rpc.Status.details field, or localized by the client.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
}

list(parent, pageToken=None, x__xgafv=None, pageSize=None)

Lists ProductSets in an unspecified order.

Possible errors:

* Returns INVALID_ARGUMENT if page_size is greater than 100, or less
  than 1.

Args:
  parent: string, The project from which ProductSets should be listed.

Format is `projects/PROJECT_ID/locations/LOC_ID`. (required)
  pageToken: string, The next_page_token returned from a previous List request, if any.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
  pageSize: integer, The maximum number of items to return. Default 10, maximum 100.

Returns:
  An object of the form:

    { # Response message for the `ListProductSets` method.
    "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more
        # results in the list.
    "productSets": [ # List of ProductSets.
      { # A ProductSet contains Products. A ProductSet can contain a maximum of 1
          # million reference images. If the limit is exceeded, periodic indexing will
          # fail.
        "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
            # is populated.
            #
            # This field is ignored when creating a ProductSet.
            # different programming environments, including REST APIs and RPC APIs. It is
            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
            # three pieces of data: error code, error message, and error details.
            #
            # You can find out more about this error model and how to work with it in the
            # [API Design Guide](https://cloud.google.com/apis/design/errors).
          "message": "A String", # A developer-facing error message, which should be in English. Any
              # user-facing error message should be localized and sent in the
              # google.rpc.Status.details field, or localized by the client.
          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
          "details": [ # A list of messages that carry the error details.  There is a common set of
              # message types for APIs to use.
            {
              "a_key": "", # Properties of the object. Contains field @type with type URL.
            },
          ],
        },
        "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
            # most 4096 characters long.
        "name": "A String", # The resource name of the ProductSet.
            #
            # Format is:
            # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
            #
            # This field is ignored when creating a ProductSet.
        "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
            # results will reflect all updates before this time. If this ProductSet has
            # never been indexed, this timestamp is the default value
            # "1970-01-01T00:00:00Z".
            #
            # This field is ignored when creating a ProductSet.
      },
    ],
  }

list_next(previous_request, previous_response)

Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.

patch(name, body, updateMask=None, x__xgafv=None)

Makes changes to a ProductSet resource.
Only display_name can be updated currently.

Possible errors:

* Returns NOT_FOUND if the ProductSet does not exist.
* Returns INVALID_ARGUMENT if display_name is present in update_mask but
  missing from the request or longer than 4096 characters.

Args:
  name: string, The resource name of the ProductSet.

Format is:
`projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.

This field is ignored when creating a ProductSet. (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # A ProductSet contains Products. A ProductSet can contain a maximum of 1
    # million reference images. If the limit is exceeded, periodic indexing will
    # fail.
  "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
      # is populated.
      # 
      # This field is ignored when creating a ProductSet.
      # different programming environments, including REST APIs and RPC APIs. It is
      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
      # three pieces of data: error code, error message, and error details.
      #
      # You can find out more about this error model and how to work with it in the
      # [API Design Guide](https://cloud.google.com/apis/design/errors).
    "message": "A String", # A developer-facing error message, which should be in English. Any
        # user-facing error message should be localized and sent in the
        # google.rpc.Status.details field, or localized by the client.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details.  There is a common set of
        # message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
  },
  "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
      # most 4096 characters long.
  "name": "A String", # The resource name of the ProductSet.
      # 
      # Format is:
      # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
      # 
      # This field is ignored when creating a ProductSet.
  "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
      # results will reflect all updates before this time. If this ProductSet has
      # never been indexed, this timestamp is the default value
      # "1970-01-01T00:00:00Z".
      # 
      # This field is ignored when creating a ProductSet.
}

  updateMask: string, The FieldMask that specifies which fields to
update.
If update_mask isn't specified, all mutable fields are to be updated.
Valid mask path is `display_name`.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A ProductSet contains Products. A ProductSet can contain a maximum of 1
      # million reference images. If the limit is exceeded, periodic indexing will
      # fail.
    "indexError": { # The `Status` type defines a logical error model that is suitable for # Output only. If there was an error with indexing the product set, the field
        # is populated.
        #
        # This field is ignored when creating a ProductSet.
        # different programming environments, including REST APIs and RPC APIs. It is
        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
        # three pieces of data: error code, error message, and error details.
        #
        # You can find out more about this error model and how to work with it in the
        # [API Design Guide](https://cloud.google.com/apis/design/errors).
      "message": "A String", # A developer-facing error message, which should be in English. Any
          # user-facing error message should be localized and sent in the
          # google.rpc.Status.details field, or localized by the client.
      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
      "details": [ # A list of messages that carry the error details.  There is a common set of
          # message types for APIs to use.
        {
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      ],
    },
    "displayName": "A String", # The user-provided name for this ProductSet. Must not be empty. Must be at
        # most 4096 characters long.
    "name": "A String", # The resource name of the ProductSet.
        #
        # Format is:
        # `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
        #
        # This field is ignored when creating a ProductSet.
    "indexTime": "A String", # Output only. The time at which this ProductSet was last indexed. Query
        # results will reflect all updates before this time. If this ProductSet has
        # never been indexed, this timestamp is the default value
        # "1970-01-01T00:00:00Z".
        #
        # This field is ignored when creating a ProductSet.
  }

Cloud Vision API . projects . locations . productSets

Instance Methods

Method Details