google-api-client 0.28.7 → 0.29.0

data/generated/google/apis/cloudasset_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/quickstart-cloud-asset-inventory
     module CloudassetV1
       VERSION = 'V1'
-      REVISION = '20190327'
+      REVISION = '20190412'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1/classes.rb

@@ -290,8 +290,7 @@ module Google
       
         # A list of asset types of which to take a snapshot for. For example:
         # "compute.googleapis.com/Disk". If specified, only matching assets will be
-        # returned.
-        # See [Introduction to Cloud Asset
+        # returned. See [Introduction to Cloud Asset
         # Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-
         # inventory/overview)
         # for all supported asset types.
@@ -392,6 +391,19 @@ module Google
         # @return [String]
         attr_accessor :uri
       
+        # The uri prefix of all generated Cloud Storage objects. For example:
+        # "gs://bucket_name/object_name_prefix". Each object uri is in format:
+        # "gs://bucket_name/object_name_prefix/<asset type>/<shard number> and only
+        # contains assets for that type. <shard number> starts from 0. For example:
+        # "gs://bucket_name/object_name_prefix/compute.googleapis.com/Disk/0" is
+        # the first shard of output objects containing all
+        # compute.googleapis.com/Disk assets. An INVALID_ARGUMENT error will be
+        # returned if file with the same name "gs://bucket_name/object_name_prefix"
+        # already exists.
+        # Corresponds to the JSON property `uriPrefix`
+        # @return [String]
+        attr_accessor :uri_prefix
+      
         def initialize(**args)
            update!(**args)
         end
@@ -399,6 +411,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @uri = args[:uri] if args.key?(:uri)
+          @uri_prefix = args[:uri_prefix] if args.key?(:uri_prefix)
         end
       end
       

data/generated/google/apis/cloudasset_v1/representations.rb

@@ -184,6 +184,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :uri, as: 'uri'
+          property :uri_prefix, as: 'uriPrefix'
         end
       end
       

data/generated/google/apis/cloudasset_v1/service.rb

@@ -96,8 +96,9 @@ module Google
         #   instance1`.
         #   See [Resource
         #   Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        #   and [Resource Name Format](https://cloud.google.com/resource-manager/docs/
-        #   cloud-asset-inventory/resource-name-format)
+        #   and [Resource Name
+        #   Format](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/
+        #   resource-name-format)
         #   for more info.
         #   The request becomes a no-op if the asset name list is empty, and the max
         #   size of the asset name list is 100 in one request.

data/generated/google/apis/cloudasset_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/quickstart-cloud-asset-inventory
     module CloudassetV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190327'
+      REVISION = '20190412'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1beta1/classes.rb

@@ -391,6 +391,18 @@ module Google
         # @return [String]
         attr_accessor :uri
       
+        # The uri prefix of all generated Cloud Storage objects. For example:
+        # "gs://bucket_name/object_name_prefix". Each object uri is in format:
+        # "gs://bucket_name/object_name_prefix/<asset type>/<shard number> and only
+        # contains assets for that type. <shard number> starts from 0. For example:
+        # "gs://bucket_name/object_name_prefix/google.compute.disk/0" is the first
+        # shard of output objects containing all google.compute.disk assets.
+        # An INVALID_ARGUMENT error will be returned if file with the same name
+        # "gs://bucket_name/object_name_prefix" already exists.
+        # Corresponds to the JSON property `uriPrefix`
+        # @return [String]
+        attr_accessor :uri_prefix
+      
         def initialize(**args)
            update!(**args)
         end
@@ -398,6 +410,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @uri = args[:uri] if args.key?(:uri)
+          @uri_prefix = args[:uri_prefix] if args.key?(:uri_prefix)
         end
       end
       

data/generated/google/apis/cloudasset_v1beta1/representations.rb

@@ -184,6 +184,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :uri, as: 'uri'
+          property :uri_prefix, as: 'uriPrefix'
         end
       end
       

data/generated/google/apis/cloudbilling_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/billing/
     module CloudbillingV1
       VERSION = 'V1'
-      REVISION = '20190310'
+      REVISION = '20190413'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudbilling_v1/service.rb

@@ -155,8 +155,8 @@ module Google
         end
         
         # Lists the billing accounts that the current authenticated user has
-        # permission to [view](https://cloud.google.com/billing/docs/how-to/billing-
-        # access).
+        # permission to
+        # [view](https://cloud.google.com/billing/docs/how-to/billing-access).
         # @param [String] filter
         #   Options for how to filter the returned billing accounts.
         #   Currently this only supports filtering for

data/generated/google/apis/cloudbuild_v1alpha1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/cloud-build/docs/
     module CloudbuildV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20190312'
+      REVISION = '20190422'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudbuild_v1alpha1/classes.rb

@@ -1098,7 +1098,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The project ID of the GCP project in which the `WorkerPool` is created.
+        # The project ID of the GCP project for which the `WorkerPool` is created.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id

data/generated/google/apis/clouderrorreporting_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/error-reporting/
     module ClouderrorreportingV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20180706'
+      REVISION = '20190411'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb

@@ -420,23 +420,26 @@ module Google
         # languages and formats.
         # Supported languages are Java, Python, JavaScript, Ruby, C#, PHP, and Go.
         # Supported stack trace formats are:
-        # * **Java**: Must be the return value of [`Throwable.printStackTrace()`](https:/
-        # /docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html#printStackTrace%28%
-        # 29).
-        # * **Python**: Must be the return value of [`traceback.format_exc()`](https://
-        # docs.python.org/2/library/traceback.html#traceback.format_exc).
-        # * **JavaScript**: Must be the value of [`error.stack`](https://github.com/v8/
-        # v8/wiki/Stack-Trace-API)
-        # as returned by V8.
-        # * **Ruby**: Must contain frames returned by [`Exception.backtrace`](https://
-        # ruby-doc.org/core-2.2.0/Exception.html#method-i-backtrace).
-        # * **C#**: Must be the return value of [`Exception.ToString()`](https://msdn.
-        # microsoft.com/en-us/library/system.exception.tostring.aspx).
+        # * **Java**: Must be the return value of
+        # [`Throwable.printStackTrace()`](https://docs.oracle.com/javase/7/docs/api/java/
+        # lang/Throwable.html#printStackTrace%28%29).
+        # * **Python**: Must be the return value of
+        # [`traceback.format_exc()`](https://docs.python.org/2/library/traceback.html#
+        # traceback.format_exc).
+        # * **JavaScript**: Must be the value of
+        # [`error.stack`](https://github.com/v8/v8/wiki/Stack-Trace-API) as returned
+        # by V8.
+        # * **Ruby**: Must contain frames returned by
+        # [`Exception.backtrace`](https://ruby-doc.org/core-2.2.0/Exception.html#method-
+        # i-backtrace).
+        # * **C#**: Must be the return value of
+        # [`Exception.ToString()`](https://msdn.microsoft.com/en-us/library/system.
+        # exception.tostring.aspx).
         # * **PHP**: Must start with `PHP (Notice|Parse error|Fatal error|Warning)`
-        # and contain the result of [`(string)$exception`](http://php.net/manual/en/
-        # exception.tostring.php).
-        # * **Go**: Must be the return value of [`runtime.Stack()`](https://golang.org/
-        # pkg/runtime/debug/#Stack).
+        # and contain the result of
+        # [`(string)$exception`](http://php.net/manual/en/exception.tostring.php).
+        # * **Go**: Must be the return value of
+        # [`runtime.Stack()`](https://golang.org/pkg/runtime/debug/#Stack).
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

data/generated/google/apis/clouderrorreporting_v1beta1/service.rb

@@ -148,14 +148,15 @@ module Google
         # **or** an [API key](https://support.google.com/cloud/answer/6158862)
         # for authentication. To use an API key, append it to the URL as the value of
         # a `key` parameter. For example:
-        # `POST https://clouderrorreporting.googleapis.com/v1beta1/projects/example-
-        # project/events:report?key=123ABC456`
+        # `POST
+        # https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/
+        # events:report?key=123ABC456`
         # @param [String] project_name
         #   [Required] The resource name of the Google Cloud Platform project. Written
         #   as `projects/` plus the
-        #   [Google Cloud Platform project ID](https://support.google.com/cloud/answer/
-        #   6158840).
-        #   Example: `projects/my-project-123`.
+        #   [Google Cloud Platform project
+        #   ID](https://support.google.com/cloud/answer/6158840). Example:
+        #   `projects/my-project-123`.
         # @param [Google::Apis::ClouderrorreportingV1beta1::ReportedErrorEvent] reported_error_event_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/cloudfunctions_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/functions
     module CloudfunctionsV1
       VERSION = 'V1'
-      REVISION = '20190318'
+      REVISION = '20190406'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudfunctions_v1/classes.rb

@@ -287,8 +287,7 @@ module Google
         attr_accessor :labels
       
         # The limit on the maximum number of function instances that may coexist at a
-        # given time. This feature is currently in alpha, available only for
-        # whitelisted users.
+        # given time.
         # Corresponds to the JSON property `maxInstances`
         # @return [Fixnum]
         attr_accessor :max_instances
@@ -316,14 +315,12 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # The runtime in which the function is going to run. Example values include:
-        # `go111`: for Go 1.11
-        # `nodejs6`: for Node.js 6
-        # `nodejs8`: for Node.js 8
-        # `nodejs10`: for Node.js 10
-        # `python37`: for Python 3.7
-        # `ruby25`: for Ruby 2.5
-        # If empty, defaults to `nodejs6`.
+        # Required. The runtime in which the function is going to run. Choices:
+        # * `nodejs6`: Node.js 6
+        # * `nodejs8`: Node.js 8
+        # * `nodejs10`: Node.js 10
+        # * `python37`: Python 3.7
+        # * `go111`: Go 1.11
         # Corresponds to the JSON property `runtime`
         # @return [String]
         attr_accessor :runtime

data/generated/google/apis/cloudfunctions_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/functions
     module CloudfunctionsV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20190318'
+      REVISION = '20190406'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudfunctions_v1beta2/classes.rb

@@ -124,8 +124,7 @@ module Google
         attr_accessor :latest_operation
       
         # The limit on the maximum number of function instances that may coexist at a
-        # given time. This feature is currently in alpha, available only for
-        # whitelisted users.
+        # given time.
         # Corresponds to the JSON property `maxInstances`
         # @return [Fixnum]
         attr_accessor :max_instances
@@ -153,8 +152,12 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # The runtime in which the function is going to run. If empty, defaults to
-        # Node.js 6.
+        # Required. The runtime in which the function is going to run. Choices:
+        # * `nodejs6`: Node.js 6
+        # * `nodejs8`: Node.js 8
+        # * `nodejs10`: Node.js 10
+        # * `python37`: Python 3.7
+        # * `go111`: Go 1.11
         # Corresponds to the JSON property `runtime`
         # @return [String]
         attr_accessor :runtime

data/generated/google/apis/cloudiot_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/iot
     module CloudiotV1
       VERSION = 'V1'
-      REVISION = '20190321'
+      REVISION = '20190409'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudkms_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/kms/
     module CloudkmsV1
       VERSION = 'V1'
-      REVISION = '20190321'
+      REVISION = '20190426'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudprivatecatalogproducer_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://sites.google.com/corp/google.com/cloudprivatecatalog
     module CloudprivatecatalogproducerV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190316'
+      REVISION = '20190413'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudresourcemanager_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV1
       VERSION = 'V1'
-      REVISION = '20190318'
+      REVISION = '20190424'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudresourcemanager_v1/classes.rb

@@ -1560,11 +1560,12 @@ module Google
         # the response. Filter rules are case-insensitive.
         # Organizations may be filtered by `owner.directoryCustomerId` or by
         # `domain`, where the domain is a G Suite domain, for example:
-        # |Filter|Description|
-        # |------|-----------|
-        # |owner.directorycustomerid:123456789|Organizations with
-        # `owner.directory_customer_id` equal to `123456789`.|
-        # |domain:google.com|Organizations corresponding to the domain `google.com`.|
+        # | Filter                              | Description                      |
+        # |-------------------------------------|----------------------------------|
+        # | owner.directorycustomerid:123456789 | Organizations with `owner.
+        # directory_customer_id` equal to `123456789`.|
+        # | domain:google.com                   | Organizations corresponding to the
+        # domain `google.com`.|
         # This field is optional.
         # Corresponds to the JSON property `filter`
         # @return [String]

data/generated/google/apis/cloudresourcemanager_v1/service.rb

@@ -1125,38 +1125,47 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists Projects that are visible to the user and satisfy the
-        # specified filter. This method returns Projects in an unspecified order.
+        # Lists Projects that the caller has the `resourcemanager.projects.get`
+        # permission on and satisfy the specified filter.
+        # This method returns Projects in an unspecified order.
         # This method is eventually consistent with project mutations; this means
         # that a newly created project may not appear in the results or recent
         # updates to an existing project may not be reflected in the results. To
         # retrieve the latest state of a project, use the
         # GetProject method.
+        # NOTE: If the request filter contains a `parent.type` and `parent.id` and
+        # the caller has the `resourcemanager.projects.list` permission on the
+        # parent, the results will be drawn from an alternate index which provides
+        # more consistent results. In future versions of this API, this List method
+        # will be split into List and Search to properly capture the behavorial
+        # difference.
         # @param [String] filter
         #   An expression for filtering the results of the request.  Filter rules are
         #   case insensitive. The fields eligible for filtering are:
         #   + `name`
         #   + `id`
-        #   + <code>labels.<em>key</em></code> where *key* is the name of a label
+        #   + `labels.<key>` (where *key* is the name of a label)
+        #   + `parent.type`
+        #   + `parent.id`
         #   Some examples of using labels as filters:
-        #   |Filter|Description|
-        #   |------|-----------|
-        #   |name:how*|The project's name starts with "how".|
-        #   |name:Howl|The project's name is `Howl` or `howl`.|
-        #   |name:HOWL|Equivalent to above.|
-        #   |NAME:howl|Equivalent to above.|
-        #   |labels.color:*|The project has the label `color`.|
-        #   |labels.color:red|The project's label `color` has the value `red`.|
-        #   |labels.color:red&nbsp;labels.size:big|The project's label `color` has the
-        #   value `red` and its label `size` has the value `big`.
-        #   If you specify a filter that has both `parent.type` and `parent.id`, then
-        #   the `resourcemanager.projects.list` permission is checked on the parent.
-        #   If the user has this permission, all projects under the parent will be
-        #   returned after remaining filters have been applied. If the user lacks this
-        #   permission, then all projects for which the user has the
-        #   `resourcemanager.projects.get` permission will be returned after remaining
-        #   filters have been applied. If no filter is specified, the call will return
-        #   projects for which the user has `resourcemanager.projects.get` permissions.
+        #   | Filter           | Description                                         |
+        #   |------------------|-----------------------------------------------------|
+        #   | name:how*        | The project's name starts with "how".               |
+        #   | name:Howl        | The project's name is `Howl` or `howl`.             |
+        #   | name:HOWL        | Equivalent to above.                                |
+        #   | NAME:howl        | Equivalent to above.                                |
+        #   | labels.color:*   | The project has the label `color`.                  |
+        #   | labels.color:red | The project's label `color` has the value `red`.    |
+        #   | labels.color:red&nbsp;labels.size:big |The project's label `color` has
+        #   the value `red` and its label `size` has the value `big`.              |
+        #   If no filter is specified, the call will return projects for which the user
+        #   has the `resourcemanager.projects.get` permission.
+        #   NOTE: To perform a by-parent query (eg., what projects are directly in a
+        #   Folder), the caller must have the `resourcemanager.projects.list`
+        #   permission on the parent and the filter must contain both a `parent.type`
+        #   and a `parent.id` restriction
+        #   (example: "parent.type:folder parent.id:123"). In this case an alternate
+        #   search index is used which provides more consistent results.
         #   Optional.
         # @param [Fixnum] page_size
         #   The maximum number of Projects to return in the response.

data/generated/google/apis/cloudresourcemanager_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190318'
+      REVISION = '20190424'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb

@@ -130,8 +130,8 @@ module Google
         #   `domain`, where the domain is a G Suite domain, for example:
         #   |Filter|Description|
         #   |------|-----------|
-        #   |owner.directorycustomerid:123456789|Organizations with `owner.
-        #   directory_customer_id` equal to `123456789`.|
+        #   |owner.directorycustomerid:123456789|Organizations with
+        #   `owner.directory_customer_id` equal to `123456789`.|
         #   |domain:google.com|Organizations corresponding to the domain `google.com`.|
         #   This field is optional.
         # @param [Fixnum] page_size
@@ -335,8 +335,9 @@ module Google
         # and the Project remains visible to ListProjects.
         # However, you cannot update the project.
         # After the deletion completes, the Project is not retrievable by
-        # the  GetProject and
-        # ListProjects methods.
+        # the  GetProject
+        # and ListProjects
+        # methods.
         # The caller must have modify permissions for this Project.
         # @param [String] project_id
         #   The Project ID (for example, `foo-bar-123`).
@@ -474,37 +475,47 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists Projects that are visible to the user and satisfy the
-        # specified filter. This method returns Projects in an unspecified order.
+        # Lists Projects that the caller has the `resourcemanager.projects.get`
+        # permission on and satisfy the specified filter.
+        # This method returns Projects in an unspecified order.
         # This method is eventually consistent with project mutations; this means
         # that a newly created project may not appear in the results or recent
         # updates to an existing project may not be reflected in the results. To
-        # retrieve the latest state of a project, use the GetProjectmethod.
+        # retrieve the latest state of a project, use the
+        # GetProject method.
+        # NOTE: If the request filter contains a `parent.type` and `parent.id` and
+        # the caller has the `resourcemanager.projects.list` permission on the
+        # parent, the results will be drawn from an alternate index which provides
+        # more consistent results. In future versions of this API, this List method
+        # will be split into List and Search to properly capture the behavorial
+        # difference.
         # @param [String] filter
         #   An expression for filtering the results of the request.  Filter rules are
         #   case insensitive. The fields eligible for filtering are:
         #   + `name`
         #   + `id`
-        #   + <code>labels.<em>key</em></code> where *key* is the name of a label
+        #   + `labels.<key>` (where *key* is the name of a label)
+        #   + `parent.type`
+        #   + `parent.id`
         #   Some examples of using labels as filters:
-        #   |Filter|Description|
-        #   |------|-----------|
-        #   |name:how*|The project's name starts with "how".|
-        #   |name:Howl|The project's name is `Howl` or `howl`.|
-        #   |name:HOWL|Equivalent to above.|
-        #   |NAME:howl|Equivalent to above.|
-        #   |labels.color:*|The project has the label `color`.|
-        #   |labels.color:red|The project's label `color` has the value `red`.|
-        #   |labels.color:red&nbsp;labels.size:big|The project's label `color` has the
-        #   value `red` and its label `size` has the value `big`.
-        #   If you specify a filter that has both `parent.type` and `parent.id`, then
-        #   the `resourcemanager.projects.list` permission is checked on the parent.
-        #   If the user has this permission, all projects under the parent will be
-        #   returned after remaining filters have been applied. If the user lacks this
-        #   permission, then all projects for which the user has the
-        #   `resourcemanager.projects.get` permission will be returned after remaining
-        #   filters have been applied. If no filter is specified, the call will return
-        #   projects for which the user has `resourcemanager.projects.get` permissions.
+        #   | Filter           | Description                                         |
+        #   |------------------|-----------------------------------------------------|
+        #   | name:how*        | The project's name starts with "how".               |
+        #   | name:Howl        | The project's name is `Howl` or `howl`.             |
+        #   | name:HOWL        | Equivalent to above.                                |
+        #   | NAME:howl        | Equivalent to above.                                |
+        #   | labels.color:*   | The project has the label `color`.                  |
+        #   | labels.color:red | The project's label `color` has the value `red`.    |
+        #   | labels.color:red&nbsp;labels.size:big |The project's label `color` has
+        #   the value `red` and its label `size` has the value `big`.              |
+        #   If no filter is specified, the call will return projects for which the user
+        #   has the `resourcemanager.projects.get` permission.
+        #   NOTE: To perform a by-parent query (eg., what projects are directly in a
+        #   Folder), the caller must have the `resourcemanager.projects.list`
+        #   permission on the parent and the filter must contain both a `parent.type`
+        #   and a `parent.id` restriction
+        #   (example: "parent.type:folder parent.id:123"). In this case an alternate
+        #   search index is used which provides more consistent results.
         #   Optional.
         # @param [Fixnum] page_size
         #   The maximum number of Projects to return in the response.