diff --git a/generated/google/apis/cloudasset_v1.rb b/generated/google/apis/cloudasset_v1.rb index 8b0919ff4..7ce294afd 100644 --- a/generated/google/apis/cloudasset_v1.rb +++ b/generated/google/apis/cloudasset_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/asset-inventory/docs/quickstart module CloudassetV1 VERSION = 'V1' - REVISION = '20200515' + REVISION = '20200605' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1/classes.rb b/generated/google/apis/cloudasset_v1/classes.rb index eb722ec5a..7761581ac 100644 --- a/generated/google/apis/cloudasset_v1/classes.rb +++ b/generated/google/apis/cloudasset_v1/classes.rb @@ -59,7 +59,7 @@ module Google # @return [Array] attr_accessor :ancestors - # The type of the asset. Example: "compute.googleapis.com/Disk" + # The type of the asset. Example: `compute.googleapis.com/Disk` # See [Supported asset # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types) # for more information. @@ -133,8 +133,8 @@ module Google attr_accessor :iam_policy # The full name of the asset. Example: - # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/ - # instance1" + # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/ + # instance1` # See [Resource # names](https://cloud.google.com/apis/design/resource_names#full_resource_name) # for more information. @@ -170,6 +170,12 @@ module Google # @return [Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter] attr_accessor :service_perimeter + # The last update timestamp of an asset. update_time is updated when + # create/update/delete operation is performed. + # Corresponds to the JSON property `updateTime` + # @return [String] + attr_accessor :update_time + def initialize(**args) update!(**args) end @@ -185,6 +191,7 @@ module Google @org_policy = args[:org_policy] if args.key?(:org_policy) @resource = args[:resource] if args.key?(:resource) @service_perimeter = args[:service_perimeter] if args.key?(:service_perimeter) + @update_time = args[:update_time] if args.key?(:update_time) end end @@ -200,7 +207,7 @@ module Google # ` # "audit_configs": [ # ` - # "service": "allServices" + # "service": "allServices", # "audit_log_configs": [ # ` # "log_type": "DATA_READ", @@ -209,18 +216,18 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # `, # ` - # "log_type": "ADMIN_READ", + # "log_type": "ADMIN_READ" # ` # ] # `, # ` - # "service": "sampleservice.googleapis.com" + # "service": "sampleservice.googleapis.com", # "audit_log_configs": [ # ` - # "log_type": "DATA_READ", + # "log_type": "DATA_READ" # `, # ` # "log_type": "DATA_WRITE", @@ -272,7 +279,7 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # ` # ] # ` @@ -323,7 +330,7 @@ module Google end end - # A BigQuery destination. + # A BigQuery destination for exporting assets to. class BigQueryDestination include Google::Apis::Core::Hashable @@ -495,31 +502,6 @@ module Google end end - # Explanation about the IAM policy search result. - class Explanation - include Google::Apis::Core::Hashable - - # The map from roles to their included permissions that match the - # permission query (i.e., a query containing `policy.role.permissions:`). - # Example: if query `policy.role.permissions : "compute.disk.get"` - # matches a policy binding that contains owner role, the - # matched_permissions will be `"roles/owner": ["compute.disk.get"]`. The - # roles can also be found in the returned `policy` bindings. Note that the - # map is populated only for requests with permission queries. - # Corresponds to the JSON property `matchedPermissions` - # @return [Hash] - attr_accessor :matched_permissions - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @matched_permissions = args[:matched_permissions] if args.key?(:matched_permissions) - end - end - # Export asset request. class ExportAssetsRequest include Google::Apis::Core::Hashable @@ -1600,117 +1582,6 @@ module Google end end - # A result of IAM Policy search, containing information of an IAM policy. - class IamPolicySearchResult - include Google::Apis::Core::Hashable - - # Explanation about the IAM policy search result. - # Corresponds to the JSON property `explanation` - # @return [Google::Apis::CloudassetV1::Explanation] - attr_accessor :explanation - - # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). - # Corresponds to the JSON property `policy` - # @return [Google::Apis::CloudassetV1::Policy] - attr_accessor :policy - - # The project that the associated GCP resource belongs to, in the form of - # projects/`PROJECT_NUMBER`. If an IAM policy is set on a resource (like VM - # instance, Cloud Storage bucket), the project field will indicate the - # project that contains the resource. If an IAM policy is set on a folder or - # orgnization, the project field will be empty. - # To search against the `project`: - # * specify the `scope` field as this project in your search request. - # Corresponds to the JSON property `project` - # @return [String] - attr_accessor :project - - # The full resource name of the resource associated with this IAM policy. - # Example: - # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/ - # instance1". - # See [Cloud Asset Inventory Resource Name - # Format](https://cloud.google.com/asset-inventory/docs/resource-name-format) - # for more information. - # To search against the `resource`: - # * use a field query. Example: `resource : "organizations/123"` - # Corresponds to the JSON property `resource` - # @return [String] - attr_accessor :resource - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @explanation = args[:explanation] if args.key?(:explanation) - @policy = args[:policy] if args.key?(:policy) - @project = args[:project] if args.key?(:project) - @resource = args[:resource] if args.key?(:resource) - end - end - # class ListFeedsResponse include Google::Apis::Core::Hashable @@ -1798,7 +1669,7 @@ module Google class OutputConfig include Google::Apis::Core::Hashable - # A BigQuery destination. + # A BigQuery destination for exporting assets to. # Corresponds to the JSON property `bigqueryDestination` # @return [Google::Apis::CloudassetV1::BigQueryDestination] attr_accessor :bigquery_destination @@ -1819,25 +1690,6 @@ module Google end end - # IAM permissions - class Permissions - include Google::Apis::Core::Hashable - - # A list of permissions. A sample permission string: "compute.disk.get". - # Corresponds to the JSON property `permissions` - # @return [Array] - attr_accessor :permissions - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @permissions = args[:permissions] if args.key?(:permissions) - end - end - # An Identity and Access Management (IAM) policy, which specifies access # controls for Google Cloud resources. # A `Policy` is a collection of `bindings`. A `binding` binds one or more @@ -1998,7 +1850,7 @@ module Google # The URL of the discovery document containing the resource's JSON schema. # Example: - # "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest" + # `https://www.googleapis.com/discovery/v1/apis/compute/v1/rest` # This value is unspecified for resources that do not have an API based on a # discovery document, such as Cloud Bigtable. # Corresponds to the JSON property `discoveryDocumentUri` @@ -2006,7 +1858,7 @@ module Google attr_accessor :discovery_document_uri # The JSON schema name listed in the discovery document. Example: - # "Project" + # `Project` # This value is unspecified for resources that do not have an API based on a # discovery document, such as Cloud Bigtable. # Corresponds to the JSON property `discoveryName` @@ -2027,7 +1879,7 @@ module Google # [Cloud IAM policy # hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy). # Example: - # "//cloudresourcemanager.googleapis.com/projects/my_project_123" + # `//cloudresourcemanager.googleapis.com/projects/my_project_123` # For third-party assets, this field may be set differently. # Corresponds to the JSON property `parent` # @return [String] @@ -2035,13 +1887,13 @@ module Google # The REST URL for accessing the resource. An HTTP `GET` request using this # URL returns the resource itself. Example: - # "https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123" + # `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123` # This value is unspecified for resources without a REST API. # Corresponds to the JSON property `resourceUrl` # @return [String] attr_accessor :resource_url - # The API version. Example: "v1" + # The API version. Example: `v1` # Corresponds to the JSON property `version` # @return [String] attr_accessor :version @@ -2062,175 +1914,6 @@ module Google end end - # A result of Resource Search, containing information of a cloud resoure. - class ResourceSearchResult - include Google::Apis::Core::Hashable - - # The additional attributes of this resource. The attributes may vary from - # one resource type to another. Examples: "projectId" for Project, - # "dnsName" for DNS ManagedZone. - # To search against the `additional_attributes`: - # * use a free text query to match the attributes values. Example: to search - # additional_attributes = ` dnsName: "foobar" `, you can issue a query - # `"foobar"`. - # Corresponds to the JSON property `additionalAttributes` - # @return [Hash] - attr_accessor :additional_attributes - - # The type of this resource. Example: "compute.googleapis.com/Disk". - # To search against the `asset_type`: - # * specify the `asset_type` field in your search request. - # Corresponds to the JSON property `assetType` - # @return [String] - attr_accessor :asset_type - - # One or more paragraphs of text description of this resource. Maximum length - # could be up to 1M bytes. - # To search against the `description`: - # * use a field query. Example: `description : "*important instance*"` - # * use a free text query. Example: `"*important instance*"` - # Corresponds to the JSON property `description` - # @return [String] - attr_accessor :description - - # The display name of this resource. - # To search against the `display_name`: - # * use a field query. Example: `displayName : "My Instance"` - # * use a free text query. Example: `"My Instance"` - # Corresponds to the JSON property `displayName` - # @return [String] - attr_accessor :display_name - - # Labels associated with this resource. See [Labelling and grouping GCP - # resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping- - # your-google-cloud-platform-resources) - # for more information. - # To search against the `labels`: - # * use a field query, as following: - # - query on any label's key or value. Example: `labels : "prod"` - # - query by a given label. Example: `labels.env : "prod"` - # - query by a given label'sexistence. Example: `labels.env : *` - # * use a free text query. Example: `"prod"` - # Corresponds to the JSON property `labels` - # @return [Hash] - attr_accessor :labels - - # Location can be "global", regional like "us-east1", or zonal like - # "us-west1-b". - # To search against the `location`: - # * use a field query. Example: `location : "us-west*"` - # * use a free text query. Example: `"us-west*"` - # Corresponds to the JSON property `location` - # @return [String] - attr_accessor :location - - # The full resource name of this resource. Example: - # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/ - # instance1". - # See [Cloud Asset Inventory Resource Name - # Format](https://cloud.google.com/asset-inventory/docs/resource-name-format) - # for more information. - # To search against the `name`: - # * use a field query. Example: `name : "instance1"` - # * use a free text query. Example: `"instance1"` - # Corresponds to the JSON property `name` - # @return [String] - attr_accessor :name - - # Network tags associated with this resource. Like labels, network tags are a - # type of annotations used to group GCP resources. See [Labelling GCP - # resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping- - # your-google-cloud-platform-resources) - # for more information. - # To search against the `network_tags`: - # * use a field query. Example: `networkTags : "internal"` - # * use a free text query. Example: `"internal"` - # Corresponds to the JSON property `networkTags` - # @return [Array] - attr_accessor :network_tags - - # The project that this resource belongs to, in the form of - # projects/`PROJECT_NUMBER`. - # To search against the `project`: - # * specify the `scope` field as this project in your search request. - # Corresponds to the JSON property `project` - # @return [String] - attr_accessor :project - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @additional_attributes = args[:additional_attributes] if args.key?(:additional_attributes) - @asset_type = args[:asset_type] if args.key?(:asset_type) - @description = args[:description] if args.key?(:description) - @display_name = args[:display_name] if args.key?(:display_name) - @labels = args[:labels] if args.key?(:labels) - @location = args[:location] if args.key?(:location) - @name = args[:name] if args.key?(:name) - @network_tags = args[:network_tags] if args.key?(:network_tags) - @project = args[:project] if args.key?(:project) - end - end - - # Search all IAM policies response. - class SearchAllIamPoliciesResponse - include Google::Apis::Core::Hashable - - # Set if there are more results than those appearing in this response; to get - # the next set of results, call this method again, using this value as the - # `page_token`. - # Corresponds to the JSON property `nextPageToken` - # @return [String] - attr_accessor :next_page_token - - # A list of IamPolicy that match the search query. Related information such - # as the associated resource is returned along with the policy. - # Corresponds to the JSON property `results` - # @return [Array] - attr_accessor :results - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @next_page_token = args[:next_page_token] if args.key?(:next_page_token) - @results = args[:results] if args.key?(:results) - end - end - - # Search all resources response. - class SearchAllResourcesResponse - include Google::Apis::Core::Hashable - - # If there are more results than those appearing in this response, then - # `next_page_token` is included. To get the next set of results, call this - # method again using the value of `next_page_token` as `page_token`. - # Corresponds to the JSON property `nextPageToken` - # @return [String] - attr_accessor :next_page_token - - # A list of Resources that match the search query. It contains the resource - # standard metadata information. - # Corresponds to the JSON property `results` - # @return [Array] - attr_accessor :results - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @next_page_token = args[:next_page_token] if args.key?(:next_page_token) - @results = args[:results] if args.key?(:results) - end - end - # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is # used by [gRPC](https://github.com/grpc). Each `Status` message contains @@ -2291,7 +1974,7 @@ module Google attr_accessor :deleted alias_method :deleted?, :deleted - # A time window specified by its "start_time" and "end_time". + # A time window specified by its `start_time` and `end_time`. # Corresponds to the JSON property `window` # @return [Google::Apis::CloudassetV1::TimeWindow] attr_accessor :window @@ -2308,7 +1991,7 @@ module Google end end - # A time window specified by its "start_time" and "end_time". + # A time window specified by its `start_time` and `end_time`. class TimeWindow include Google::Apis::Core::Hashable diff --git a/generated/google/apis/cloudasset_v1/representations.rb b/generated/google/apis/cloudasset_v1/representations.rb index 35dc9cbbc..459469337 100644 --- a/generated/google/apis/cloudasset_v1/representations.rb +++ b/generated/google/apis/cloudasset_v1/representations.rb @@ -70,12 +70,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class Explanation - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class ExportAssetsRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -190,12 +184,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class IamPolicySearchResult - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class ListFeedsResponse class Representation < Google::Apis::Core::JsonRepresentation; end @@ -214,12 +202,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class Permissions - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class Policy class Representation < Google::Apis::Core::JsonRepresentation; end @@ -238,24 +220,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class ResourceSearchResult - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class SearchAllIamPoliciesResponse - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class SearchAllResourcesResponse - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class Status class Representation < Google::Apis::Core::JsonRepresentation; end @@ -298,6 +262,7 @@ module Google property :service_perimeter, as: 'servicePerimeter', class: Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter, decorator: Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter::Representation + property :update_time, as: 'updateTime' end end @@ -360,14 +325,6 @@ module Google end end - class Explanation - # @private - class Representation < Google::Apis::Core::JsonRepresentation - hash :matched_permissions, as: 'matchedPermissions', class: Google::Apis::CloudassetV1::Permissions, decorator: Google::Apis::CloudassetV1::Permissions::Representation - - end - end - class ExportAssetsRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -566,18 +523,6 @@ module Google end end - class IamPolicySearchResult - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :explanation, as: 'explanation', class: Google::Apis::CloudassetV1::Explanation, decorator: Google::Apis::CloudassetV1::Explanation::Representation - - property :policy, as: 'policy', class: Google::Apis::CloudassetV1::Policy, decorator: Google::Apis::CloudassetV1::Policy::Representation - - property :project, as: 'project' - property :resource, as: 'resource' - end - end - class ListFeedsResponse # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -608,13 +553,6 @@ module Google end end - class Permissions - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :permissions, as: 'permissions' - end - end - class Policy # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -647,39 +585,6 @@ module Google end end - class ResourceSearchResult - # @private - class Representation < Google::Apis::Core::JsonRepresentation - hash :additional_attributes, as: 'additionalAttributes' - property :asset_type, as: 'assetType' - property :description, as: 'description' - property :display_name, as: 'displayName' - hash :labels, as: 'labels' - property :location, as: 'location' - property :name, as: 'name' - collection :network_tags, as: 'networkTags' - property :project, as: 'project' - end - end - - class SearchAllIamPoliciesResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :next_page_token, as: 'nextPageToken' - collection :results, as: 'results', class: Google::Apis::CloudassetV1::IamPolicySearchResult, decorator: Google::Apis::CloudassetV1::IamPolicySearchResult::Representation - - end - end - - class SearchAllResourcesResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :next_page_token, as: 'nextPageToken' - collection :results, as: 'results', class: Google::Apis::CloudassetV1::ResourceSearchResult, decorator: Google::Apis::CloudassetV1::ResourceSearchResult::Representation - - end - end - class Status # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/cloudasset_v1/service.rb b/generated/google/apis/cloudasset_v1/service.rb index ca2f2a6ac..8681a3012 100644 --- a/generated/google/apis/cloudasset_v1/service.rb +++ b/generated/google/apis/cloudasset_v1/service.rb @@ -254,10 +254,10 @@ module Google end # Batch gets the update history of assets that overlap a time window. - # For RESOURCE content, this API outputs history with asset in both - # non-delete or deleted status. # For IAM_POLICY content, this API outputs history when the asset and its # attached IAM POLICY both exist. This can create gaps in the output history. + # Otherwise, this API outputs history with asset in both non-delete or + # deleted status. # If a specified asset does not exist, this API returns an INVALID_ARGUMENT # error. # @param [String] parent @@ -311,13 +311,15 @@ module Google end # Exports assets with time and resource types to a given Cloud Storage - # location. The output format is newline-delimited JSON. Each line represents - # a google.cloud.asset.v1.Asset in the JSON format. - # This API implements the google.longrunning.Operation API allowing you - # to keep track of the export. We recommend intervals of at least 2 seconds - # with exponential retry to poll the export operation result. For - # regular-size resource parent, the export operation usually finishes within - # 5 minutes. + # location/BigQuery table. For Cloud Storage location destinations, the + # output format is newline-delimited JSON. Each line represents a + # google.cloud.asset.v1.Asset in the JSON format; for BigQuery table + # destinations, the output table stores the fields in asset proto as columns. + # This API implements the google.longrunning.Operation API + # , which allows you to keep track of the export. We recommend intervals of + # at least 2 seconds with exponential retry to poll the export operation + # result. For regular-size resource parent, the export operation usually + # finishes within 5 minutes. # @param [String] parent # Required. The relative name of the root asset. This can only be an # organization number (such as "organizations/123"), a project ID (such as @@ -352,183 +354,6 @@ module Google command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - - # Searches all the IAM policies within the given accessible scope (e.g., a - # project, a folder or an organization). Callers should have - # cloud.assets.SearchAllIamPolicies permission upon the requested scope, - # otherwise the request will be rejected. - # @param [String] scope - # Required. A scope can be a project, a folder or an organization. The search is - # limited to the IAM policies within the `scope`. - # The allowed values are: - # * projects/`PROJECT_ID` - # * projects/`PROJECT_NUMBER` - # * folders/`FOLDER_NUMBER` - # * organizations/`ORGANIZATION_NUMBER` - # @param [Fixnum] page_size - # Optional. The page size for search result pagination. Page size is capped at - # 500 even - # if a larger value is given. If set to zero, server will pick an appropriate - # default. Returned results may be fewer than requested. When this happens, - # there could be more results as long as `next_page_token` is returned. - # @param [String] page_token - # Optional. If present, retrieve the next batch of results from the preceding - # call to - # this method. `page_token` must be the value of `next_page_token` from the - # previous response. The values of all other method parameters must be - # identical to those in the previous call. - # @param [String] query - # Optional. The query statement. An empty query can be specified to search all - # the IAM - # policies within the given `scope`. - # Examples: - # * `policy : "amy@gmail.com"` to find Cloud IAM policy bindings that - # specify user "amy@gmail.com". - # * `policy : "roles/compute.admin"` to find Cloud IAM policy bindings that - # specify the Compute Admin role. - # * `policy.role.permissions : "storage.buckets.update"` to find Cloud IAM - # policy bindings that specify a role containing "storage.buckets.update" - # permission. - # * `resource : "organizations/123"` to find Cloud IAM policy bindings that - # are set on "organizations/123". - # * `(resource : ("organizations/123" OR "folders/1234") AND policy : "amy")` - # to find Cloud IAM policy bindings that are set on "organizations/123" or - # "folders/1234", and also specify user "amy". - # See [how to construct a - # query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies# - # how_to_construct_a_query) - # for more details. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # Available to use for quota purposes for server-side applications. Can be any - # arbitrary string assigned to a user, but should not exceed 40 characters. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::CloudassetV1::SearchAllIamPoliciesResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::CloudassetV1::SearchAllIamPoliciesResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def search_all_iam_policies(scope, page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+scope}:searchAllIamPolicies', options) - command.response_representation = Google::Apis::CloudassetV1::SearchAllIamPoliciesResponse::Representation - command.response_class = Google::Apis::CloudassetV1::SearchAllIamPoliciesResponse - command.params['scope'] = scope unless scope.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['query'] = query unless query.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Searches all the resources within the given accessible scope (e.g., a - # project, a folder or an organization). Callers should have - # cloud.assets.SearchAllResources permission upon the requested scope, - # otherwise the request will be rejected. - # @param [String] scope - # Required. A scope can be a project, a folder or an organization. The search is - # limited to the resources within the `scope`. - # The allowed values are: - # * projects/`PROJECT_ID` - # * projects/`PROJECT_NUMBER` - # * folders/`FOLDER_NUMBER` - # * organizations/`ORGANIZATION_NUMBER` - # @param [Array, String] asset_types - # Optional. A list of asset types that this request searches for. If empty, it - # will - # search all the [searchable asset - # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types# - # searchable_asset_types). - # @param [String] order_by - # Optional. A comma separated list of fields specifying the sorting order of the - # results. The default order is ascending. Add " DESC" after the field name - # to indicate descending order. Redundant space characters are ignored. - # Example: "location DESC, name". See [supported resource metadata - # fields](https://cloud.google.com/asset-inventory/docs/searching-resources# - # query_on_resource_metadata_fields) - # for more details. - # @param [Fixnum] page_size - # Optional. The page size for search result pagination. Page size is capped at - # 500 even - # if a larger value is given. If set to zero, server will pick an appropriate - # default. Returned results may be fewer than requested. When this happens, - # there could be more results as long as `next_page_token` is returned. - # @param [String] page_token - # Optional. If present, then retrieve the next batch of results from the - # preceding call - # to this method. `page_token` must be the value of `next_page_token` from - # the previous response. The values of all other method parameters, must be - # identical to those in the previous call. - # @param [String] query - # Optional. The query statement. An empty query can be specified to search all - # the - # resources of certain `asset_types` within the given `scope`. - # Examples: - # * `name : "Important"` to find Cloud resources whose name contains - # "Important" as a word. - # * `displayName : "Impor*"` to find Cloud resources whose display name - # contains "Impor" as a word prefix. - # * `description : "*por*"` to find Cloud resources whose description - # contains "por" as a substring. - # * `location : "us-west*"` to find Cloud resources whose location is - # prefixed with "us-west". - # * `labels : "prod"` to find Cloud resources whose labels contain "prod" as - # a key or value. - # * `labels.env : "prod"` to find Cloud resources which have a label "env" - # and its value is "prod". - # * `labels.env : *` to find Cloud resources which have a label "env". - # * `"Important"` to find Cloud resources which contain "Important" as a word - # in any of the searchable fields. - # * `"Impor*"` to find Cloud resources which contain "Impor" as a word prefix - # in any of the searchable fields. - # * `"*por*"` to find Cloud resources which contain "por" as a substring in - # any of the searchable fields. - # * `("Important" AND location : ("us-west1" OR "global"))` to find Cloud - # resources which contain "Important" as a word in any of the searchable - # fields and are also located in the "us-west1" region or the "global" - # location. - # See [how to construct a - # query](https://cloud.google.com/asset-inventory/docs/searching-resources# - # how_to_construct_a_query) - # for more details. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # Available to use for quota purposes for server-side applications. Can be any - # arbitrary string assigned to a user, but should not exceed 40 characters. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::CloudassetV1::SearchAllResourcesResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::CloudassetV1::SearchAllResourcesResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def search_all_resources(scope, asset_types: nil, order_by: nil, page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+scope}:searchAllResources', options) - command.response_representation = Google::Apis::CloudassetV1::SearchAllResourcesResponse::Representation - command.response_class = Google::Apis::CloudassetV1::SearchAllResourcesResponse - command.params['scope'] = scope unless scope.nil? - command.query['assetTypes'] = asset_types unless asset_types.nil? - command.query['orderBy'] = order_by unless order_by.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['query'] = query unless query.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end protected diff --git a/generated/google/apis/cloudasset_v1beta1.rb b/generated/google/apis/cloudasset_v1beta1.rb index ab56ba6f0..f9b7b8823 100644 --- a/generated/google/apis/cloudasset_v1beta1.rb +++ b/generated/google/apis/cloudasset_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/asset-inventory/docs/quickstart module CloudassetV1beta1 VERSION = 'V1beta1' - REVISION = '20200515' + REVISION = '20200605' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1beta1/classes.rb b/generated/google/apis/cloudasset_v1beta1/classes.rb index 9c6fa9ea6..0798f88b3 100644 --- a/generated/google/apis/cloudasset_v1beta1/classes.rb +++ b/generated/google/apis/cloudasset_v1beta1/classes.rb @@ -137,7 +137,7 @@ module Google # ` # "audit_configs": [ # ` - # "service": "allServices" + # "service": "allServices", # "audit_log_configs": [ # ` # "log_type": "DATA_READ", @@ -146,18 +146,18 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # `, # ` - # "log_type": "ADMIN_READ", + # "log_type": "ADMIN_READ" # ` # ] # `, # ` - # "service": "sampleservice.googleapis.com" + # "service": "sampleservice.googleapis.com", # "audit_log_configs": [ # ` - # "log_type": "DATA_READ", + # "log_type": "DATA_READ" # `, # ` # "log_type": "DATA_WRITE", @@ -209,7 +209,7 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # ` # ] # ` diff --git a/generated/google/apis/cloudasset_v1beta1/service.rb b/generated/google/apis/cloudasset_v1beta1/service.rb index cac1fba1c..651fe2481 100644 --- a/generated/google/apis/cloudasset_v1beta1/service.rb +++ b/generated/google/apis/cloudasset_v1beta1/service.rb @@ -122,10 +122,10 @@ module Google end # Batch gets the update history of assets that overlap a time window. - # For RESOURCE content, this API outputs history with asset in both - # non-delete or deleted status. # For IAM_POLICY content, this API outputs history when the asset and its # attached IAM POLICY both exist. This can create gaps in the output history. + # Otherwise, this API outputs history with asset in both non-delete or + # deleted status. # If a specified asset does not exist, this API returns an INVALID_ARGUMENT # error. # @param [String] parent @@ -254,10 +254,10 @@ module Google end # Batch gets the update history of assets that overlap a time window. - # For RESOURCE content, this API outputs history with asset in both - # non-delete or deleted status. # For IAM_POLICY content, this API outputs history when the asset and its # attached IAM POLICY both exist. This can create gaps in the output history. + # Otherwise, this API outputs history with asset in both non-delete or + # deleted status. # If a specified asset does not exist, this API returns an INVALID_ARGUMENT # error. # @param [String] parent diff --git a/generated/google/apis/cloudasset_v1p1beta1.rb b/generated/google/apis/cloudasset_v1p1beta1.rb index 5146f4054..21b30d987 100644 --- a/generated/google/apis/cloudasset_v1p1beta1.rb +++ b/generated/google/apis/cloudasset_v1p1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/asset-inventory/docs/quickstart module CloudassetV1p1beta1 VERSION = 'V1p1beta1' - REVISION = '20200515' + REVISION = '20200605' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1p1beta1/classes.rb b/generated/google/apis/cloudasset_v1p1beta1/classes.rb index 27fc64af3..773c3c2ac 100644 --- a/generated/google/apis/cloudasset_v1p1beta1/classes.rb +++ b/generated/google/apis/cloudasset_v1p1beta1/classes.rb @@ -34,7 +34,7 @@ module Google # ` # "audit_configs": [ # ` - # "service": "allServices" + # "service": "allServices", # "audit_log_configs": [ # ` # "log_type": "DATA_READ", @@ -43,18 +43,18 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # `, # ` - # "log_type": "ADMIN_READ", + # "log_type": "ADMIN_READ" # ` # ] # `, # ` - # "service": "sampleservice.googleapis.com" + # "service": "sampleservice.googleapis.com", # "audit_log_configs": [ # ` - # "log_type": "DATA_READ", + # "log_type": "DATA_READ" # `, # ` # "log_type": "DATA_WRITE", @@ -106,7 +106,7 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # ` # ] # ` diff --git a/generated/google/apis/cloudasset_v1p1beta1/service.rb b/generated/google/apis/cloudasset_v1p1beta1/service.rb index 608cecd0b..0f304c1df 100644 --- a/generated/google/apis/cloudasset_v1p1beta1/service.rb +++ b/generated/google/apis/cloudasset_v1p1beta1/service.rb @@ -47,12 +47,12 @@ module Google @batch_path = 'batch' end - # Searches all the IAM policies under a given accessible CRM scope - # (project/folder/organization). This RPC gives callers - # especially admins the ability to search all the IAM policies under a scope, - # even if they don't have .getIamPolicy permission of all the IAM policies. - # Callers should have cloud.assets.SearchAllIamPolicies permission on the - # requested scope, otherwise it will be rejected. + # Searches all the IAM policies within a given accessible CRM scope + # (project/folder/organization). This RPC gives callers especially + # administrators the ability to search all the IAM policies within a scope, + # even if they don't have `.getIamPolicy` permission of all the IAM policies. + # Callers should have `cloud.assets.SearchAllIamPolicies` permission on the + # requested scope, otherwise the request will be rejected. # @param [String] scope # Required. The relative name of an asset. The search is limited to the # resources @@ -74,8 +74,7 @@ module Google # previous response. The values of all other method parameters must be # identical to those in the previous call. # @param [String] query - # Optional. The query statement. - # Examples: + # Optional. The query statement. Examples: # * "policy:myuser@mydomain.com" # * "policy:(myuser@mydomain.com viewer)" # @param [String] fields @@ -108,12 +107,12 @@ module Google execute_or_queue_command(command, &block) end - # Searches all the resources under a given accessible CRM scope - # (project/folder/organization). This RPC gives callers - # especially admins the ability to search all the resources under a scope, - # even if they don't have .get permission of all the resources. Callers - # should have cloud.assets.SearchAllResources permission on the requested - # scope, otherwise it will be rejected. + # Searches all the resources within a given accessible CRM scope + # (project/folder/organization). This RPC gives callers especially + # administrators the ability to search all the resources within a scope, even + # if they don't have `.get` permission of all the resources. Callers should + # have `cloud.assets.SearchAllResources` permission on the requested scope, + # otherwise the request will be rejected. # @param [String] scope # Required. The relative name of an asset. The search is limited to the # resources @@ -128,9 +127,9 @@ module Google # search all the supported asset types. # @param [String] order_by # Optional. A comma separated list of fields specifying the sorting order of the - # results. The default order is ascending. Add " desc" after the field name + # results. The default order is ascending. Add ` DESC` after the field name # to indicate descending order. Redundant space characters are ignored. For - # example, " foo , bar desc ". + # example, ` location DESC , name `. # @param [Fixnum] page_size # Optional. The page size for search result pagination. Page size is capped at # 500 even diff --git a/generated/google/apis/cloudasset_v1p4beta1.rb b/generated/google/apis/cloudasset_v1p4beta1.rb index cef7c840b..d80de7ef1 100644 --- a/generated/google/apis/cloudasset_v1p4beta1.rb +++ b/generated/google/apis/cloudasset_v1p4beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/asset-inventory/docs/quickstart module CloudassetV1p4beta1 VERSION = 'V1p4beta1' - REVISION = '20200515' + REVISION = '20200605' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1p4beta1/classes.rb b/generated/google/apis/cloudasset_v1p4beta1/classes.rb index 33c8ef544..38d3d379b 100644 --- a/generated/google/apis/cloudasset_v1p4beta1/classes.rb +++ b/generated/google/apis/cloudasset_v1p4beta1/classes.rb @@ -511,7 +511,8 @@ module Google # @return [Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AnalysisState] attr_accessor :analysis_state - # The [full resource name](https://aip.dev/122#full-resource-names). + # The [full resource + # name](https://cloud.google.com/asset-inventory/docs/resource-name-format) # Corresponds to the JSON property `fullResourceName` # @return [String] attr_accessor :full_resource_name @@ -603,14 +604,20 @@ module Google # within # the parent will be analyzed. This can only be an organization number (such # as "organizations/123") or a folder number (such as "folders/123"). + # To know how to get organization id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing- + # organization#retrieving_your_organization_id). + # To know how to get folder id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing-folders# + # viewing_or_listing_folders_and_projects). # Corresponds to the JSON property `parent` # @return [String] attr_accessor :parent # Specifies the resource to analyze for access policies, which may be set # directly on the resource, or on ancestors such as organizations, folders or - # projects. At least one of ResourceSelector, IdentitySelector or - # AccessSelector must be specified in a request. + # projects. Either ResourceSelector or IdentitySelector must be + # specified in a request. # Corresponds to the JSON property `resourceSelector` # @return [Google::Apis::CloudassetV1p4beta1::ResourceSelector] attr_accessor :resource_selector @@ -639,7 +646,9 @@ module Google # @return [Array] attr_accessor :access_control_lists - # The full name of the resource to which the iam_binding policy attaches. + # The [full resource + # name](https://cloud.google.com/asset-inventory/docs/resource-name-format) + # of the resource to which the iam_binding policy attaches. # Corresponds to the JSON property `attachedResourceFullName` # @return [String] attr_accessor :attached_resource_full_name @@ -685,6 +694,13 @@ module Google # Required. The identity appear in the form of members in # [IAM policy # binding](https://cloud.google.com/iam/reference/rest/v1/Binding). + # The examples of supported forms are: + # "user:mike@example.com", + # "group:admins@example.com", + # "domain:google.com", + # "serviceAccount:my-project-id@appspot.gserviceaccount.com". + # Notice that wildcard characters (such as * and ?) are not supported. + # You must give a specific identity. # Corresponds to the JSON property `identity` # @return [String] attr_accessor :identity @@ -859,14 +875,16 @@ module Google # Specifies the resource to analyze for access policies, which may be set # directly on the resource, or on ancestors such as organizations, folders or - # projects. At least one of ResourceSelector, IdentitySelector or - # AccessSelector must be specified in a request. + # projects. Either ResourceSelector or IdentitySelector must be + # specified in a request. class ResourceSelector include Google::Apis::Core::Hashable # Required. The [full resource - # name](https://cloud.google.com/apis/design/resource_names#full_resource_name) - # . + # name](https://cloud.google.com/asset-inventory/docs/resource-name-format) + # of a resource of [supported resource + # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types# + # analyzable_asset_types). # Corresponds to the JSON property `fullResourceName` # @return [String] attr_accessor :full_resource_name diff --git a/generated/google/apis/cloudasset_v1p4beta1/service.rb b/generated/google/apis/cloudasset_v1p4beta1/service.rb index c3d1a1a50..0360aba29 100644 --- a/generated/google/apis/cloudasset_v1p4beta1/service.rb +++ b/generated/google/apis/cloudasset_v1p4beta1/service.rb @@ -54,6 +54,12 @@ module Google # within # the parent will be analyzed. This can only be an organization number (such # as "organizations/123") or a folder number (such as "folders/123"). + # To know how to get organization id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing- + # organization#retrieving_your_organization_id). + # To know how to get folder id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing-folders# + # viewing_or_listing_folders_and_projects). # @param [Array, String] analysis_query_access_selector_permissions # Optional. The permissions to appear in result. # @param [Array, String] analysis_query_access_selector_roles @@ -62,16 +68,25 @@ module Google # Required. The identity appear in the form of members in # [IAM policy # binding](https://cloud.google.com/iam/reference/rest/v1/Binding). + # The examples of supported forms are: + # "user:mike@example.com", + # "group:admins@example.com", + # "domain:google.com", + # "serviceAccount:my-project-id@appspot.gserviceaccount.com". + # Notice that wildcard characters (such as * and ?) are not supported. + # You must give a specific identity. # @param [String] analysis_query_resource_selector_full_resource_name # Required. The [full resource - # name](https://cloud.google.com/apis/design/resource_names#full_resource_name) - # . + # name](https://cloud.google.com/asset-inventory/docs/resource-name-format) + # of a resource of [supported resource + # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types# + # analyzable_asset_types). # @param [Boolean] options_analyze_service_account_impersonation # Optional. If true, the response will include access analysis from identities # to # resources via service account impersonation. This is a very expensive # operation, because many derived queries will be executed. We highly - # recommend you use ExportIamPolicyAnalysis rpc instead. + # recommend you use AssetService.ExportIamPolicyAnalysis rpc instead. # For example, if the request analyzes for which resources user A has # permission P, and there's an IAM policy states user A has # iam.serviceAccounts.getAccessToken permission to a service account SA, @@ -175,6 +190,12 @@ module Google # within # the parent will be analyzed. This can only be an organization number (such # as "organizations/123") or a folder number (such as "folders/123"). + # To know how to get organization id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing- + # organization#retrieving_your_organization_id). + # To know how to get folder id, visit [here + # ](https://cloud.google.com/resource-manager/docs/creating-managing-folders# + # viewing_or_listing_folders_and_projects). # @param [Google::Apis::CloudassetV1p4beta1::ExportIamPolicyAnalysisRequest] export_iam_policy_analysis_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. diff --git a/generated/google/apis/cloudbuild_v1.rb b/generated/google/apis/cloudbuild_v1.rb index c3fe189f3..db75f9eb5 100644 --- a/generated/google/apis/cloudbuild_v1.rb +++ b/generated/google/apis/cloudbuild_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/cloud-build/docs/ module CloudbuildV1 VERSION = 'V1' - REVISION = '20200601' + REVISION = '20200606' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudbuild_v1/classes.rb b/generated/google/apis/cloudbuild_v1/classes.rb index 22c871678..4fe193539 100644 --- a/generated/google/apis/cloudbuild_v1/classes.rb +++ b/generated/google/apis/cloudbuild_v1/classes.rb @@ -381,8 +381,8 @@ module Google # @return [String] attr_accessor :log_streaming_option - # Option to specify the logging mode, which determines where the logs are - # stored. + # Option to specify the logging mode, which determines if and where build + # logs are stored. # Corresponds to the JSON property `logging` # @return [String] attr_accessor :logging diff --git a/generated/google/apis/cloudbuild_v1alpha1.rb b/generated/google/apis/cloudbuild_v1alpha1.rb index a3510eafa..78ea37ca0 100644 --- a/generated/google/apis/cloudbuild_v1alpha1.rb +++ b/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 = '20200601' + REVISION = '20200606' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudbuild_v1alpha1/classes.rb b/generated/google/apis/cloudbuild_v1alpha1/classes.rb index aefcb0b32..348b18c44 100644 --- a/generated/google/apis/cloudbuild_v1alpha1/classes.rb +++ b/generated/google/apis/cloudbuild_v1alpha1/classes.rb @@ -381,8 +381,8 @@ module Google # @return [String] attr_accessor :log_streaming_option - # Option to specify the logging mode, which determines where the logs are - # stored. + # Option to specify the logging mode, which determines if and where build + # logs are stored. # Corresponds to the JSON property `logging` # @return [String] attr_accessor :logging diff --git a/generated/google/apis/cloudbuild_v1alpha2.rb b/generated/google/apis/cloudbuild_v1alpha2.rb index 07bd35a5f..98a402c3d 100644 --- a/generated/google/apis/cloudbuild_v1alpha2.rb +++ b/generated/google/apis/cloudbuild_v1alpha2.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/cloud-build/docs/ module CloudbuildV1alpha2 VERSION = 'V1alpha2' - REVISION = '20200601' + REVISION = '20200606' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudbuild_v1alpha2/classes.rb b/generated/google/apis/cloudbuild_v1alpha2/classes.rb index 0da3f2d37..5021a91ff 100644 --- a/generated/google/apis/cloudbuild_v1alpha2/classes.rb +++ b/generated/google/apis/cloudbuild_v1alpha2/classes.rb @@ -381,8 +381,8 @@ module Google # @return [String] attr_accessor :log_streaming_option - # Option to specify the logging mode, which determines where the logs are - # stored. + # Option to specify the logging mode, which determines if and where build + # logs are stored. # Corresponds to the JSON property `logging` # @return [String] attr_accessor :logging diff --git a/generated/google/apis/dlp_v2.rb b/generated/google/apis/dlp_v2.rb index cfff75c29..d3be78cfb 100644 --- a/generated/google/apis/dlp_v2.rb +++ b/generated/google/apis/dlp_v2.rb @@ -27,7 +27,7 @@ module Google # @see https://cloud.google.com/dlp/docs/ module DlpV2 VERSION = 'V2' - REVISION = '20200516' + REVISION = '20200606' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/dlp_v2/classes.rb b/generated/google/apis/dlp_v2/classes.rb index 33ba3427a..8a5eab0d7 100644 --- a/generated/google/apis/dlp_v2/classes.rb +++ b/generated/google/apis/dlp_v2/classes.rb @@ -36,7 +36,8 @@ module Google # Publish a message into given Pub/Sub topic when DlpJob has completed. The # message contains a single field, `DlpJobName`, which is equal to the # finished job's - # [`DlpJob.name`](/dlp/docs/reference/rest/v2/projects.dlpJobs#DlpJob). + # [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/projects. + # dlpJobs#DlpJob). # Compatible with: Inspect, Risk # Corresponds to the JSON property `pubSub` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PublishToPubSub] @@ -1576,8 +1577,8 @@ module Google # Message for detecting output from deidentification transformations # such as - # [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2/organizations. - # deidentifyTemplates#cryptoreplaceffxfpeconfig). + # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ + # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). # These types of transformations are # those that perform pseudonymization, thereby producing a "surrogate" as # output. This should be used in conjunction with a field on the @@ -4895,7 +4896,8 @@ module Google # Publish a message into given Pub/Sub topic when DlpJob has completed. The # message contains a single field, `DlpJobName`, which is equal to the # finished job's - # [`DlpJob.name`](/dlp/docs/reference/rest/v2/projects.dlpJobs#DlpJob). + # [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/projects. + # dlpJobs#DlpJob). # Compatible with: Inspect, Risk class GooglePrivacyDlpV2PublishToPubSub include Google::Apis::Core::Hashable @@ -5975,8 +5977,8 @@ module Google # Message for detecting output from deidentification transformations # such as - # [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2/organizations. - # deidentifyTemplates#cryptoreplaceffxfpeconfig). + # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ + # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). # These types of transformations are # those that perform pseudonymization, thereby producing a "surrogate" as # output. This should be used in conjunction with a field on the diff --git a/generated/google/apis/dlp_v2/service.rb b/generated/google/apis/dlp_v2/service.rb index 247ea405c..1020d029c 100644 --- a/generated/google/apis/dlp_v2/service.rb +++ b/generated/google/apis/dlp_v2/service.rb @@ -62,7 +62,8 @@ module Google # @param [String] location_id # Deprecated. This field has no effect. # @param [String] parent - # The parent resource name, for example locations/`location_id`. + # The parent resource name. + # - Format:locations/[LOCATION-ID] # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -97,7 +98,8 @@ module Google # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to # learn more. # @param [String] parent - # The parent resource name, for example locations/`location_id`. + # The parent resource name. + # - Format:locations/[LOCATION-ID] # @param [String] filter # filter to only return infoTypes supported by certain parts of the # API. Defaults to supported_by=INSPECT. @@ -142,8 +144,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -248,8 +253,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -342,8 +350,11 @@ module Google # for inspecting content, images, and storage. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -445,8 +456,11 @@ module Google # Lists InspectTemplates. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -538,8 +552,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -644,8 +661,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -738,8 +758,11 @@ module Google # for inspecting content, images, and storage. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -841,8 +864,11 @@ module Google # Lists InspectTemplates. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -933,8 +959,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1038,8 +1067,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -1133,8 +1165,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1238,8 +1273,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -1337,7 +1375,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest] google_privacy_dlp_v2_deidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1376,7 +1416,9 @@ module Google # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images # and https://cloud.google.com/dlp/docs/inspecting-text, # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest] google_privacy_dlp_v2_inspect_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1414,6 +1456,8 @@ module Google # to learn more. # @param [String] parent # Required. The parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest] google_privacy_dlp_v2_reidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1449,8 +1493,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1555,8 +1602,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -1689,7 +1739,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest] google_privacy_dlp_v2_create_dlp_job_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1790,7 +1842,9 @@ module Google # See https://cloud.google.com/dlp/docs/inspecting-storage and # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter # Allows filtering. # Supported syntax: @@ -1875,7 +1929,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # The parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest] google_privacy_dlp_v2_redact_image_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1910,8 +1966,11 @@ module Google # for inspecting content, images, and storage. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2013,8 +2072,11 @@ module Google # Lists InspectTemplates. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -2140,7 +2202,9 @@ module Google # sensitive information on a set schedule. # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest] google_privacy_dlp_v2_create_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2238,7 +2302,9 @@ module Google # Lists job triggers. # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. # @param [String] parent - # Required. The parent resource name, for example `projects/my-project-id`. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter # Allows filtering. # Supported syntax: @@ -2355,7 +2421,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest] google_privacy_dlp_v2_deidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2394,7 +2462,9 @@ module Google # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images # and https://cloud.google.com/dlp/docs/inspecting-text, # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest] google_privacy_dlp_v2_inspect_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2432,6 +2502,8 @@ module Google # to learn more. # @param [String] parent # Required. The parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest] google_privacy_dlp_v2_reidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2467,8 +2539,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2573,8 +2648,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn # more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -2707,7 +2785,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest] google_privacy_dlp_v2_create_dlp_job_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2884,7 +2964,9 @@ module Google # See https://cloud.google.com/dlp/docs/inspecting-storage and # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter # Allows filtering. # Supported syntax: @@ -2969,7 +3051,9 @@ module Google # system will automatically choose what detectors to run. By default this may # be all types, but may change over time as detectors are updated. # @param [String] parent - # The parent resource name, for example projects/my-project-id. + # The parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest] google_privacy_dlp_v2_redact_image_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3004,8 +3088,11 @@ module Google # for inspecting content, images, and storage. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3107,8 +3194,11 @@ module Google # Lists InspectTemplates. # See https://cloud.google.com/dlp/docs/creating-templates to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -3234,7 +3324,9 @@ module Google # sensitive information on a set schedule. # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest] google_privacy_dlp_v2_create_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3372,7 +3464,9 @@ module Google # Lists job triggers. # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. # @param [String] parent - # Required. The parent resource name, for example `projects/my-project-id`. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter # Allows filtering. # Supported syntax: @@ -3485,8 +3579,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3590,8 +3687,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by @@ -3685,8 +3785,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3790,8 +3893,11 @@ module Google # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to # learn more. # @param [String] parent - # Required. The parent resource name, for example projects/my-project-id or - # organizations/my-org-id. + # Required. Parent resource name. + # - Format:projects/[PROJECT-ID] + # - Format:organizations/[ORGANIZATION-ID] + # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by diff --git a/generated/google/apis/file_v1.rb b/generated/google/apis/file_v1.rb index d4a3136e0..3aa22c823 100644 --- a/generated/google/apis/file_v1.rb +++ b/generated/google/apis/file_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/filestore/ module FileV1 VERSION = 'V1' - REVISION = '20200602' + REVISION = '20200608' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/file_v1beta1.rb b/generated/google/apis/file_v1beta1.rb index d8790cb2f..88bbc6beb 100644 --- a/generated/google/apis/file_v1beta1.rb +++ b/generated/google/apis/file_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/filestore/ module FileV1beta1 VERSION = 'V1beta1' - REVISION = '20200602' + REVISION = '20200608' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/gmail_v1.rb b/generated/google/apis/gmail_v1.rb index cb77c244c..9ce5b907c 100644 --- a/generated/google/apis/gmail_v1.rb +++ b/generated/google/apis/gmail_v1.rb @@ -20,12 +20,13 @@ module Google module Apis # Gmail API # - # Access Gmail mailboxes including sending user email. + # The Gmail API lets you view and manage Gmail mailbox data like + # threads, messages, and labels. # # @see https://developers.google.com/gmail/api/ module GmailV1 VERSION = 'V1' - REVISION = '20200504' + REVISION = '20200601' # Read, compose, send, and permanently delete all your email from Gmail AUTH_SCOPE = 'https://mail.google.com/' diff --git a/generated/google/apis/gmail_v1/classes.rb b/generated/google/apis/gmail_v1/classes.rb index 82fbda4ae..ad753bddb 100644 --- a/generated/google/apis/gmail_v1/classes.rb +++ b/generated/google/apis/gmail_v1/classes.rb @@ -31,8 +31,8 @@ module Google # @return [String] attr_accessor :disposition - # Email address to which all incoming messages are forwarded. This email address - # must be a verified member of the forwarding addresses. + # Email address to which all incoming messages are forwarded. This email + # address must be a verified member of the forwarding addresses. # Corresponds to the JSON property `emailAddress` # @return [String] attr_accessor :email_address @@ -83,7 +83,8 @@ module Google # @return [Array] attr_accessor :add_label_ids - # The IDs of the messages to modify. There is a limit of 1000 ids per request. + # The IDs of the messages to modify. There is a limit of 1000 ids per + # request. # Corresponds to the JSON property `ids` # @return [Array] attr_accessor :ids @@ -106,8 +107,9 @@ module Google end # Settings for a delegate. Delegates can read, send, and delete messages, as - # well as view and add contacts, for the delegator's account. See "Set up mail - # delegation" for more information about delegates. + # well as view and add contacts, for the delegator's account. See + # "Set up + # mail delegation" for more information about delegates. class Delegate include Google::Apis::Core::Hashable @@ -116,8 +118,8 @@ module Google # @return [String] attr_accessor :delegate_email - # Indicates whether this address has been verified and can act as a delegate for - # the account. Read-only. + # Indicates whether this address has been verified and can act as a delegate + # for the account. Read-only. # Corresponds to the JSON property `verificationStatus` # @return [String] attr_accessor :verification_status @@ -242,16 +244,18 @@ module Google attr_accessor :has_attachment alias_method :has_attachment?, :has_attachment - # Only return messages not matching the specified query. Supports the same query - # format as the Gmail search box. For example, "from:someuser@example.com - # rfc822msgid: is:unread". + # Only return messages not matching the specified query. Supports the same + # query format as the Gmail search box. For example, + # "from:someuser@example.com rfc822msgid: + # is:unread". # Corresponds to the JSON property `negatedQuery` # @return [String] attr_accessor :negated_query - # Only return messages matching the specified query. Supports the same query - # format as the Gmail search box. For example, "from:someuser@example.com - # rfc822msgid: is:unread". + # Only return messages matching the specified query. Supports the same + # query format as the Gmail search box. For example, + # "from:someuser@example.com rfc822msgid: + # is:unread". # Corresponds to the JSON property `query` # @return [String] attr_accessor :query @@ -267,16 +271,16 @@ module Google # @return [String] attr_accessor :size_comparison - # Case-insensitive phrase found in the message's subject. Trailing and leading - # whitespace are be trimmed and adjacent spaces are collapsed. + # Case-insensitive phrase found in the message's subject. Trailing and + # leading whitespace are be trimmed and adjacent spaces are collapsed. # Corresponds to the JSON property `subject` # @return [String] attr_accessor :subject - # The recipient's display name or email address. Includes recipients in the "to", - # "cc", and "bcc" header fields. You can use simply the local part of the email - # address. For example, "example" and "example@" both match "example@gmail.com". - # This field is case-insensitive. + # The recipient's display name or email address. Includes recipients in the + # "to", "cc", and "bcc" header fields. You can use simply the local part of + # the email address. For example, "example" and "example@" both match + # "example@gmail.com". This field is case-insensitive. # Corresponds to the JSON property `to` # @return [String] attr_accessor :to @@ -308,8 +312,8 @@ module Google # @return [String] attr_accessor :forwarding_email - # Indicates whether this address has been verified and is usable for forwarding. - # Read-only. + # Indicates whether this address has been verified and is usable for + # forwarding. Read-only. # Corresponds to the JSON property `verificationStatus` # @return [String] attr_accessor :verification_status @@ -345,9 +349,10 @@ module Google # @return [Array] attr_accessor :labels_removed - # List of messages changed in this history record. The fields for specific - # change types, such as messagesAdded may duplicate messages in this field. We - # recommend using the specific change-type fields instead of this. + # List of messages changed in this history record. The fields for specific + # change types, such as messagesAdded may duplicate messages in + # this field. We recommend using the specific change-type fields instead + # of this. # Corresponds to the JSON property `messages` # @return [Array] attr_accessor :messages @@ -470,8 +475,8 @@ module Google include Google::Apis::Core::Hashable # If this value is true, Gmail will immediately expunge a message when it is - # marked as deleted in IMAP. Otherwise, Gmail will wait for an update from the - # client before expunging messages marked as deleted. + # marked as deleted in IMAP. Otherwise, Gmail will wait for an update from + # the client before expunging messages marked as deleted. # Corresponds to the JSON property `autoExpunge` # @return [Boolean] attr_accessor :auto_expunge @@ -483,15 +488,15 @@ module Google attr_accessor :enabled alias_method :enabled?, :enabled - # The action that will be executed on a message when it is marked as deleted and - # expunged from the last visible IMAP folder. + # The action that will be executed on a message when it is marked as deleted + # and expunged from the last visible IMAP folder. # Corresponds to the JSON property `expungeBehavior` # @return [String] attr_accessor :expunge_behavior - # An optional limit on the number of messages that an IMAP folder may contain. - # Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero is interpreted - # to mean that there is no limit. + # An optional limit on the number of messages that an IMAP folder may + # contain. Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero + # is interpreted to mean that there is no limit. # Corresponds to the JSON property `maxFolderSize` # @return [Fixnum] attr_accessor :max_folder_size @@ -509,12 +514,14 @@ module Google end end - # Labels are used to categorize messages and threads within the user's mailbox. + # Labels are used to categorize messages and threads within the + # user's mailbox. class Label include Google::Apis::Core::Hashable - # The color to assign to the label. Color is only available for labels that have - # their type set to user. + # The color to assign to the label. Color is only available for labels that + # have their type set to user. + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `color` # @return [Google::Apis::GmailV1::LabelColor] attr_accessor :color @@ -525,11 +532,14 @@ module Google attr_accessor :id # The visibility of the label in the label list in the Gmail web interface. + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `labelListVisibility` # @return [String] attr_accessor :label_list_visibility - # The visibility of the label in the message list in the Gmail web interface. + # The visibility of the label in the message list in the + # Gmail web interface. + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `messageListVisibility` # @return [String] attr_accessor :message_list_visibility @@ -545,6 +555,7 @@ module Google attr_accessor :messages_unread # The display name of the label. + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -559,14 +570,15 @@ module Google # @return [Fixnum] attr_accessor :threads_unread - # The owner type for the label. User labels are created by the user and can be - # modified and deleted by the user and can be applied to any message or thread. - # System labels are internally created and cannot be added, modified, or deleted. - # System labels may be able to be applied to or removed from messages and - # threads under some circumstances but this is not guaranteed. For example, - # users can apply and remove the INBOX and UNREAD labels from messages and - # threads, but cannot apply or remove the DRAFTS or SENT labels from messages or - # threads. + # The owner type for the label. User labels are created by the user and + # can be modified and deleted by the user and can be applied to any + # message or thread. System labels are internally created and cannot be + # added, modified, or deleted. System labels may be able to be applied to or + # removed from messages and threads under some circumstances but this is + # not guaranteed. For example, users can apply and remove the + # INBOX and UNREAD labels from messages and + # threads, but cannot apply or remove the DRAFTS or + # SENT labels from messages or threads. # Corresponds to the JSON property `type` # @return [String] attr_accessor :type @@ -594,40 +606,46 @@ module Google class LabelColor include Google::Apis::Core::Hashable - # The background color represented as hex string #RRGGBB (ex #000000). This - # field is required in order to set the color of a label. Only the following - # predefined set of color values are allowed: - # #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, # - # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, - # #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, # - # ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, - # #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, # - # f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, - # #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, # - # 076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7e7, #0d3472, #b6cff5, - # #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, # - # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, - # #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, # - # f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 + # The background color represented as hex string #RRGGBB (ex #000000). + # This field is required in order to set the color of a label. + # Only the following predefined set of color values are allowed: + #
+ # # 000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, + # # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, + # # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, + # # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, + # # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, + # # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, + # # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, + # # 822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c + # # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, + # # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, + # # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, + # # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, + # # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `backgroundColor` # @return [String] attr_accessor :background_color - # The text color of the label, represented as hex string. This field is required - # in order to set the color of a label. Only the following predefined set of - # color values are allowed: - # #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, # - # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, - # #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, # - # ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, - # #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, # - # f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, - # #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, # - # 076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7e7, #0d3472, #b6cff5, - # #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, # - # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, - # #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, # - # f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 + # The text color of the label, represented as hex string. + # This field is required in order to set the color of a label. + # Only the following predefined set of color values are allowed: + #
+ # # 000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, + # # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, + # # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, + # # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, + # # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, + # # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, + # # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, + # # 822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c + # # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, + # # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, + # # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, + # # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, + # # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 + # @mutable gmail.users.labels.create gmail.users.labels.update # Corresponds to the JSON property `textColor` # @return [String] attr_accessor :text_color @@ -643,21 +661,28 @@ module Google end end - # Language settings for an account. These settings correspond to the "Language - # settings" feature in the web interface. + # Language settings for an account. These settings correspond to + # the "Language + # settings" feature in the web interface. class LanguageSettings include Google::Apis::Core::Hashable - # The language to display Gmail in, formatted as an RFC 3066 Language Tag (for - # example en-GB, fr or ja for British English, French, or Japanese respectively). - # The set of languages supported by Gmail evolves over time, so please refer to - # the "Language" dropdown in the Gmail settings for all available options, as - # described in the language settings help article. A table of sample values is - # also provided in the Managing Language Settings guide - # Not all Gmail clients can display the same set of languages. In the case that - # a user's display language is not available for use on a particular client, - # said client automatically chooses to display in the closest supported variant ( - # or a reasonable default). + # The language to display Gmail in, formatted as an + # RFC 3066 + # Language Tag (for example en-GB, fr or + # ja for British English, French, or Japanese respectively). + # The set of languages supported by Gmail evolves over time, so please refer + # to the "Language" dropdown in the + # Gmail settings + # for all available options, as described in the + # language settings + # help article. A table of sample values is also provided in the + # Managing + # Language Settings guide + # Not all Gmail clients can display the same set of languages. In the case + # that a user's display language is not available for use on a particular + # client, said client automatically chooses to display in the closest + # supported variant (or a reasonable default). # Corresponds to the JSON property `displayLanguage` # @return [String] attr_accessor :display_language @@ -695,9 +720,11 @@ module Google class ListDraftsResponse include Google::Apis::Core::Hashable - # List of drafts. Note that the Message property in each Draft resource only - # contains an id and a threadId. The messages.get method can fetch additional - # message details. + # List of drafts. Note that the Message property in each + # Draft resource only contains an id and a + # threadId. The + # messages.get + # method can fetch additional message details. # Corresponds to the JSON property `drafts` # @return [Array] attr_accessor :drafts @@ -766,8 +793,9 @@ module Google class ListHistoryResponse include Google::Apis::Core::Hashable - # List of history records. Any messages contained in the response will typically - # only have id and threadId fields populated. + # List of history records. Any messages contained in the + # response will typically only have id and + # threadId fields populated. # Corresponds to the JSON property `history` # @return [Array] attr_accessor :history @@ -798,8 +826,10 @@ module Google class ListLabelsResponse include Google::Apis::Core::Hashable - # List of labels. Note that each label resource only contains an id, name, - # messageListVisibility, labelListVisibility, and type. The labels.get method + # List of labels. Note that each label resource only contains an + # id, name, messageListVisibility, + # labelListVisibility, and type. The + # labels.get method # can fetch additional label details. # Corresponds to the JSON property `labels` # @return [Array] @@ -819,8 +849,10 @@ module Google class ListMessagesResponse include Google::Apis::Core::Hashable - # List of messages. Note that each message resource contains only an id and a - # threadId. Additional message details can be fetched using the messages.get + # List of messages. Note that each message resource contains only an + # id and a threadId. Additional message details can + # be fetched using the + # messages.get # method. # Corresponds to the JSON property `messages` # @return [Array] @@ -901,8 +933,9 @@ module Google attr_accessor :result_size_estimate # List of threads. Note that each thread resource does not contain a list of - # messages. The list of messages for a given thread can be fetched using the - # threads.get method. + # messages. The list of messages for a given thread + # can be fetched using the + # threads.get method. # Corresponds to the JSON property `threads` # @return [Array] attr_accessor :threads @@ -933,16 +966,17 @@ module Google # @return [String] attr_accessor :id - # The internal message creation timestamp (epoch ms), which determines ordering - # in the inbox. For normal SMTP-received email, this represents the time the - # message was originally accepted by Google, which is more reliable than the - # Date header. However, for API-migrated mail, it can be configured by client to - # be based on the Date header. + # The internal message creation timestamp (epoch ms), which determines + # ordering in the inbox. For normal SMTP-received email, this represents the + # time the message was originally accepted by Google, which is more reliable + # than the Date header. However, for API-migrated mail, it can + # be configured by client to be based on the Date header. # Corresponds to the JSON property `internalDate` # @return [Fixnum] attr_accessor :internal_date # List of IDs of labels applied to this message. + # @mutable gmail.users.messages.insert gmail.users.messages.modify # Corresponds to the JSON property `labelIds` # @return [Array] attr_accessor :label_ids @@ -952,9 +986,12 @@ module Google # @return [Google::Apis::GmailV1::MessagePart] attr_accessor :payload - # The entire email message in an RFC 2822 formatted and base64url encoded string. - # Returned in messages.get and drafts.get responses when the format=RAW + # The entire email message in an RFC 2822 formatted and base64url + # encoded string. Returned in messages.get and + # drafts.get responses when the format=RAW # parameter is supplied. + # @mutable gmail.users.messages.insert gmail.users.messages.send + # @mutable gmail.users.drafts.create gmail.users.drafts.update # Corresponds to the JSON property `raw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -970,13 +1007,17 @@ module Google # @return [String] attr_accessor :snippet - # The ID of the thread the message belongs to. To add a message or draft to a - # thread, the following criteria must be met: - # - The requested threadId must be specified on the Message or Draft.Message you - # supply with your request. - # - The References and In-Reply-To headers must be set in compliance with the - # RFC 2822 standard. - # - The Subject headers must match. + # The ID of the thread the message belongs to. To add a message or draft to + # a thread, the following criteria must be met: + #
  1. The requested threadId must be specified on the + # Message or Draft.Message you supply with your + # request.
    2. + #
  2. The References and In-Reply-To headers must + # be set in compliance with the + # RFC 2822 standard.
    3. + #
  3. The Subject headers must match. + # @mutable gmail.users.messages.insert gmail.users.messages.send + # @mutable gmail.users.drafts.create gmail.users.drafts.update # Corresponds to the JSON property `threadId` # @return [String] attr_accessor :thread_id @@ -1008,15 +1049,16 @@ module Google # @return [Google::Apis::GmailV1::MessagePartBody] attr_accessor :body - # The filename of the attachment. Only present if this message part represents - # an attachment. + # The filename of the attachment. Only present if this message part + # represents an attachment. # Corresponds to the JSON property `filename` # @return [String] attr_accessor :filename # List of headers on this message part. For the top-level message part, - # representing the entire message payload, it will contain the standard RFC 2822 - # email headers such as To, From, and Subject. + # representing the entire message payload, it will contain the standard + # RFC 2822 email headers such as To, From, and + # Subject. # Corresponds to the JSON property `headers` # @return [Array] attr_accessor :headers @@ -1031,10 +1073,11 @@ module Google # @return [String] attr_accessor :part_id - # The child MIME message parts of this part. This only applies to container MIME - # message parts, for example multipart/*. For non- container MIME message part - # types, such as text/plain, this field is empty. For more information, see RFC - # 1521. + # The child MIME message parts of this part. This only applies to container + # MIME message parts, for example multipart/*. For non- + # container MIME message part types, such as text/plain, this + # field is empty. For more information, see + # RFC 1521. # Corresponds to the JSON property `parts` # @return [Array] attr_accessor :parts @@ -1058,17 +1101,19 @@ module Google class MessagePartBody include Google::Apis::Core::Hashable - # When present, contains the ID of an external attachment that can be retrieved - # in a separate messages.attachments.get request. When not present, the entire - # content of the message part body is contained in the data field. + # When present, contains the ID of an external attachment that can be + # retrieved in a separate messages.attachments.get request. + # When not present, the entire content of the message part body is + # contained in the data field. # Corresponds to the JSON property `attachmentId` # @return [String] attr_accessor :attachment_id - # The body data of a MIME message part as a base64url encoded string. May be - # empty for MIME container types that have no message body or when the body data - # is sent as a separate attachment. An attachment ID is present if the body data - # is contained in a separate attachment. + # The body data of a MIME message part as a base64url encoded string. + # May be empty for MIME container + # types that have no message body or when the body data is sent as a + # separate attachment. An attachment ID is present if the body data is + # contained in a separate attachment. # Corresponds to the JSON property `data` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -1095,13 +1140,14 @@ module Google class MessagePartHeader include Google::Apis::Core::Hashable - # The name of the header before the : separator. For example, To. + # The name of the header before the : separator. For + # example, To. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The value of the header after the : separator. For example, someuser@example. - # com. + # The value of the header after the : separator. For example, + # someuser@example.com. # Corresponds to the JSON property `value` # @return [String] attr_accessor :value @@ -1231,48 +1277,53 @@ module Google end # Settings associated with a send-as alias, which can be either the primary - # login address associated with the account or a custom "from" address. Send-as - # aliases correspond to the "Send Mail As" feature in the web interface. + # login address associated with the account or a custom "from" address. + # Send-as aliases correspond to the + # "Send Mail As" + # feature in the web interface. class SendAs include Google::Apis::Core::Hashable - # A name that appears in the "From:" header for mail sent using this alias. For - # custom "from" addresses, when this is empty, Gmail will populate the "From:" - # header with the name that is used for the primary address associated with the - # account. If the admin has disabled the ability for users to update their name - # format, requests to update this field for the primary login will silently fail. + # A name that appears in the "From:" header for mail sent using this alias. + # For custom "from" addresses, when this is empty, Gmail will populate the + # "From:" header with the name that is used for the primary address + # associated with the account. + # If the admin has disabled the ability for users to update their name + # format, requests to update this field for the primary login will silently + # fail. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # Whether this address is selected as the default "From:" address in situations - # such as composing a new message or sending a vacation auto-reply. Every Gmail - # account has exactly one default send-as address, so the only legal value that - # clients may write to this field is true. Changing this from false to true for - # an address will result in this field becoming false for the other previous - # default address. + # Whether this address is selected as the default "From:" address in + # situations such as composing a new message or sending a vacation + # auto-reply. Every Gmail account has exactly one default send-as address, + # so the only legal value that clients may write to this field is + # true. Changing this from false to + # true for an address will result in this field becoming + # false for the other previous default address. # Corresponds to the JSON property `isDefault` # @return [Boolean] attr_accessor :is_default alias_method :is_default?, :is_default # Whether this address is the primary address used to login to the account. - # Every Gmail account has exactly one primary address, and it cannot be deleted - # from the collection of send-as aliases. This field is read-only. + # Every Gmail account has exactly one primary address, and it cannot be + # deleted from the collection of send-as aliases. This field is read-only. # Corresponds to the JSON property `isPrimary` # @return [Boolean] attr_accessor :is_primary alias_method :is_primary?, :is_primary # An optional email address that is included in a "Reply-To:" header for mail - # sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" - # header. + # sent using this alias. If this is empty, Gmail will not generate a + # "Reply-To:" header. # Corresponds to the JSON property `replyToAddress` # @return [String] attr_accessor :reply_to_address - # The email address that appears in the "From:" header for mail sent using this - # alias. This is read-only for all operations except create. + # The email address that appears in the "From:" header for mail sent using + # this alias. This is read-only for all operations except create. # Corresponds to the JSON property `sendAsEmail` # @return [String] attr_accessor :send_as_email @@ -1288,15 +1339,16 @@ module Google # @return [Google::Apis::GmailV1::SmtpMsa] attr_accessor :smtp_msa - # Whether Gmail should treat this address as an alias for the user's primary - # email address. This setting only applies to custom "from" aliases. + # Whether Gmail should + # treat this address as an alias for the user's primary email address. + # This setting only applies to custom "from" aliases. # Corresponds to the JSON property `treatAsAlias` # @return [Boolean] attr_accessor :treat_as_alias alias_method :treat_as_alias?, :treat_as_alias - # Indicates whether this address has been verified for use as a send-as alias. - # Read-only. This setting only applies to custom "from" aliases. + # Indicates whether this address has been verified for use as a send-as + # alias. Read-only. This setting only applies to custom "from" aliases. # Corresponds to the JSON property `verificationStatus` # @return [String] attr_accessor :verification_status @@ -1349,18 +1401,18 @@ module Google # @return [String] attr_accessor :issuer_cn - # PEM formatted X509 concatenated certificate string (standard base64 encoding). - # Format used for returning key, which includes public key as well as - # certificate chain (not private key). + # PEM formatted X509 concatenated certificate string (standard base64 + # encoding). Format used for returning key, which includes public key + # as well as certificate chain (not private key). # Corresponds to the JSON property `pem` # @return [String] attr_accessor :pem - # PKCS#12 format containing a single private/public key pair and certificate - # chain. This format is only accepted from client for creating a new SmimeInfo - # and is never returned, because the private key is not intended to be exported. - # PKCS#12 may be encrypted, in which case encryptedKeyPassword should be set - # appropriately. + # PKCS#12 format containing a single private/public key pair and + # certificate chain. This format is only accepted from client + # for creating a new SmimeInfo and is never returned, because the + # private key is not intended to be exported. PKCS#12 may be encrypted, + # in which case encryptedKeyPassword should be set appropriately. # Corresponds to the JSON property `pkcs12` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -1386,32 +1438,32 @@ module Google class SmtpMsa include Google::Apis::Core::Hashable - # The hostname of the SMTP service. Required. + # The hostname of the SMTP service. Required. # Corresponds to the JSON property `host` # @return [String] attr_accessor :host - # The password that will be used for authentication with the SMTP service. This - # is a write-only field that can be specified in requests to create or update - # SendAs settings; it is never populated in responses. + # The password that will be used for authentication with the SMTP service. + # This is a write-only field that can be specified in requests to create or + # update SendAs settings; it is never populated in responses. # Corresponds to the JSON property `password` # @return [String] attr_accessor :password - # The port of the SMTP service. Required. + # The port of the SMTP service. Required. # Corresponds to the JSON property `port` # @return [Fixnum] attr_accessor :port - # The protocol that will be used to secure communication with the SMTP service. - # Required. + # The protocol that will be used to secure communication with the SMTP + # service. Required. # Corresponds to the JSON property `securityMode` # @return [String] attr_accessor :security_mode - # The username that will be used for authentication with the SMTP service. This - # is a write-only field that can be specified in requests to create or update - # SendAs settings; it is never populated in responses. + # The username that will be used for authentication with the SMTP service. + # This is a write-only field that can be specified in requests to create or + # update SendAs settings; it is never populated in responses. # Corresponds to the JSON property `username` # @return [String] attr_accessor :username @@ -1467,8 +1519,9 @@ module Google end end - # Vacation auto-reply settings for an account. These settings correspond to the " - # Vacation responder" feature in the web interface. + # Vacation auto-reply settings for an account. These settings correspond to + # the "Vacation + # responder" feature in the web interface. class VacationSettings include Google::Apis::Core::Hashable @@ -1478,49 +1531,57 @@ module Google attr_accessor :enable_auto_reply alias_method :enable_auto_reply?, :enable_auto_reply - # An optional end time for sending auto-replies (epoch ms). When this is - # specified, Gmail will automatically reply only to messages that it receives - # before the end time. If both startTime and endTime are specified, startTime - # must precede endTime. + # An optional end time for sending auto-replies (epoch ms). + # When this is specified, Gmail will automatically reply only to messages + # that it receives before the end time. If both startTime and + # endTime are specified, startTime must precede + # endTime. # Corresponds to the JSON property `endTime` # @return [Fixnum] attr_accessor :end_time - # Response body in HTML format. Gmail will sanitize the HTML before storing it. + # Response body in HTML format. Gmail will sanitize the HTML before + # storing it. If both response_body_plain_text and + # response_body_html are specified, + # response_body_html will be used. # Corresponds to the JSON property `responseBodyHtml` # @return [String] attr_accessor :response_body_html - # Response body in plain text format. + # Response body in plain text format. If both + # response_body_plain_text and response_body_html + # are specified, response_body_html will be used. # Corresponds to the JSON property `responseBodyPlainText` # @return [String] attr_accessor :response_body_plain_text - # Optional text to prepend to the subject line in vacation responses. In order - # to enable auto-replies, either the response subject or the response body must - # be nonempty. + # Optional text to prepend to the subject line in vacation responses. In + # order to enable auto-replies, either the response subject or the response + # body must be nonempty. # Corresponds to the JSON property `responseSubject` # @return [String] attr_accessor :response_subject - # Flag that determines whether responses are sent to recipients who are not in - # the user's list of contacts. + # Flag that determines whether responses are sent to recipients who are not + # in the user's list of contacts. # Corresponds to the JSON property `restrictToContacts` # @return [Boolean] attr_accessor :restrict_to_contacts alias_method :restrict_to_contacts?, :restrict_to_contacts - # Flag that determines whether responses are sent to recipients who are outside - # of the user's domain. This feature is only available for G Suite users. + # Flag that determines whether responses are sent to recipients who are + # outside of the user's domain. This feature is only available for G Suite + # users. # Corresponds to the JSON property `restrictToDomain` # @return [Boolean] attr_accessor :restrict_to_domain alias_method :restrict_to_domain?, :restrict_to_domain - # An optional start time for sending auto-replies (epoch ms). When this is - # specified, Gmail will automatically reply only to messages that it receives - # after the start time. If both startTime and endTime are specified, startTime - # must precede endTime. + # An optional start time for sending auto-replies (epoch ms). + # When this is specified, Gmail will automatically reply only to messages + # that it receives after the start time. If both startTime and + # endTime are specified, startTime must precede + # endTime. # Corresponds to the JSON property `startTime` # @return [Fixnum] attr_accessor :start_time @@ -1551,20 +1612,21 @@ module Google # @return [String] attr_accessor :label_filter_action - # List of label_ids to restrict notifications about. By default, if unspecified, - # all changes are pushed out. If specified then dictates which labels are - # required for a push notification to be generated. + # List of label_ids to restrict notifications about. By default, + # if unspecified, all changes are pushed out. If specified then + # dictates which labels are required for a push notification to + # be generated. # Corresponds to the JSON property `labelIds` # @return [Array] attr_accessor :label_ids - # A fully qualified Google Cloud Pub/Sub API topic name to publish the events to. - # This topic name **must** already exist in Cloud Pub/Sub and you **must** have - # already granted gmail "publish" permission on it. For example, "projects/my- - # project-identifier/topics/my-topic-name" (using the Cloud Pub/Sub "v1" topic - # naming format). - # Note that the "my-project-identifier" portion must exactly match your Google - # developer project id (the one executing this watch request). + # A fully qualified Google Cloud Pub/Sub API topic name to publish the + # events to. This topic name **must** already exist in Cloud Pub/Sub and + # you **must** have already granted gmail "publish" permission on it. + # For example, "projects/my-project-identifier/topics/my-topic-name" + # (using the Cloud Pub/Sub "v1" topic naming format). + # Note that the "my-project-identifier" portion must exactly match your + # Google developer project id (the one executing this watch request). # Corresponds to the JSON property `topicName` # @return [String] attr_accessor :topic_name @@ -1585,8 +1647,9 @@ module Google class WatchResponse include Google::Apis::Core::Hashable - # When Gmail will stop sending notifications for mailbox updates (epoch millis). - # Call watch again before this time to renew the watch. + # When Gmail will stop sending notifications for mailbox updates + # (epoch millis). Call watch again before this time to renew + # the watch. # Corresponds to the JSON property `expiration` # @return [Fixnum] attr_accessor :expiration diff --git a/generated/google/apis/gmail_v1/service.rb b/generated/google/apis/gmail_v1/service.rb index 980b56899..ae49a4988 100644 --- a/generated/google/apis/gmail_v1/service.rb +++ b/generated/google/apis/gmail_v1/service.rb @@ -22,7 +22,8 @@ module Google module GmailV1 # Gmail API # - # Access Gmail mailboxes including sending user email. + # The Gmail API lets you view and manage Gmail mailbox data like + # threads, messages, and labels. # # @example # require 'google/apis/gmail_v1' @@ -38,30 +39,24 @@ module Google attr_accessor :key # @return [String] - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. attr_accessor :quota_user - # @return [String] - # Deprecated. Please use quotaUser instead. - attr_accessor :user_ip - def initialize - super('https://www.googleapis.com/', 'gmail/v1/users/') + super('https://www.googleapis.com/', '') @batch_path = 'batch/gmail/v1' end # Gets the current user's Gmail profile. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -74,28 +69,25 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_profile(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/profile', options) + def get_user_profile(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/profile', options) command.response_representation = Google::Apis::GmailV1::Profile::Representation command.response_class = Google::Apis::GmailV1::Profile command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Stop receiving push notifications for the given user mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -108,27 +100,24 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def stop_user(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/stop', options) + def stop_user(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/stop', options) command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Set up or update a push notification watch on the given user mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::WatchRequest] watch_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -141,8 +130,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def watch_user(user_id, watch_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/watch', options) + def watch_user(user_id, watch_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/watch', options) command.request_representation = Google::Apis::GmailV1::WatchRequest::Representation command.request_object = watch_request_object command.response_representation = Google::Apis::GmailV1::WatchResponse::Representation @@ -150,22 +139,19 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Creates a new draft with the DRAFT label. + # Creates a new draft with the DRAFT label. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Draft] draft_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -182,11 +168,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_draft(user_id, draft_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def create_user_draft(user_id, draft_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:post, '{userId}/drafts', options) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/drafts', options) else - command = make_upload_command(:post, '{userId}/drafts', options) + command = make_upload_command(:post, 'gmail/v1/users/{userId}/drafts', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -197,24 +183,21 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Immediately and permanently deletes the specified draft. Does not simply trash - # it. + # Immediately and permanently deletes the specified draft. + # Does not simply trash it. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the draft to delete. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -227,20 +210,19 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_draft(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/drafts/{id}', options) + def delete_user_draft(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/drafts/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified draft. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the draft to retrieve. # @param [String] format @@ -248,10 +230,8 @@ module Google # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -264,8 +244,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_draft(user_id, id, format: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/drafts/{id}', options) + def get_user_draft(user_id, id, format: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/drafts/{id}', options) command.response_representation = Google::Apis::GmailV1::Draft::Representation command.response_class = Google::Apis::GmailV1::Draft command.params['userId'] = user_id unless user_id.nil? @@ -273,31 +253,30 @@ module Google command.query['format'] = format unless format.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the drafts in the user's mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Boolean] include_spam_trash - # Include drafts from SPAM and TRASH in the results. + # Include drafts from SPAM and TRASH + # in the results. # @param [Fixnum] max_results # Maximum number of drafts to return. # @param [String] page_token # Page token to retrieve a specific page of results in the list. # @param [String] q # Only return draft messages matching the specified query. Supports the same - # query format as the Gmail search box. For example, "from:someuser@example.com - # rfc822msgid: is:unread". + # query format as the Gmail search box. For example, + # "from:someuser@example.com rfc822msgid: + # is:unread". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -310,8 +289,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_drafts(user_id, include_spam_trash: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/drafts', options) + def list_user_drafts(user_id, include_spam_trash: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/drafts', options) command.response_representation = Google::Apis::GmailV1::ListDraftsResponse::Representation command.response_class = Google::Apis::GmailV1::ListDraftsResponse command.params['userId'] = user_id unless user_id.nil? @@ -321,23 +300,20 @@ module Google command.query['q'] = q unless q.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Sends the specified, existing draft to the recipients in the To, Cc, and Bcc - # headers. + # Sends the specified, existing draft to the recipients in the + # To, Cc, and Bcc headers. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Draft] draft_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -354,11 +330,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def send_user_draft(user_id, draft_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def send_user_draft(user_id, draft_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:post, '{userId}/drafts/send', options) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/drafts/send', options) else - command = make_upload_command(:post, '{userId}/drafts/send', options) + command = make_upload_command(:post, 'gmail/v1/users/{userId}/drafts/send', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -369,24 +345,21 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Replaces a draft's content. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the draft to update. # @param [Google::Apis::GmailV1::Draft] draft_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -403,11 +376,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_draft(user_id, id, draft_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def update_user_draft(user_id, id, draft_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:put, '{userId}/drafts/{id}', options) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/drafts/{id}', options) else - command = make_upload_command(:put, '{userId}/drafts/{id}', options) + command = make_upload_command(:put, 'gmail/v1/users/{userId}/drafts/{id}', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -419,15 +392,14 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the history of all changes to the given mailbox. History results are - # returned in chronological order (increasing historyId). + # returned in chronological order (increasing historyId). # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Array, String] history_types # History types to be returned by the function # @param [String] label_id @@ -437,23 +409,24 @@ module Google # @param [String] page_token # Page token to retrieve a specific page of results in the list. # @param [Fixnum] start_history_id - # Required. Returns history records after the specified startHistoryId. The - # supplied startHistoryId should be obtained from the historyId of a message, - # thread, or previous list response. History IDs increase chronologically but - # are not contiguous with random gaps in between valid IDs. Supplying an invalid - # or out of date startHistoryId typically returns an HTTP 404 error code. A - # historyId is typically valid for at least a week, but in some rare - # circumstances may be valid for only a few hours. If you receive an HTTP 404 - # error response, your application should perform a full sync. If you receive no - # nextPageToken in the response, there are no updates to retrieve and you can - # store the returned historyId for a future request. + # Required. Returns history records after the specified + # startHistoryId. The supplied startHistoryId + # should be obtained from the historyId of a message, thread, or + # previous list response. History IDs increase + # chronologically but are not contiguous with random gaps in between valid + # IDs. Supplying an invalid or out of date startHistoryId + # typically returns an HTTP 404 error code. A + # historyId is typically valid for at least a week, but in some + # rare circumstances may be valid for only a few hours. If you receive an + # HTTP 404 error response, your application should perform a + # full sync. If you receive no nextPageToken in the response, + # there are no updates to retrieve and you can store the returned + # historyId for a future request. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -466,8 +439,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_histories(user_id, history_types: nil, label_id: nil, max_results: nil, page_token: nil, start_history_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/history', options) + def list_user_histories(user_id, history_types: nil, label_id: nil, max_results: nil, page_token: nil, start_history_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/history', options) command.response_representation = Google::Apis::GmailV1::ListHistoryResponse::Representation command.response_class = Google::Apis::GmailV1::ListHistoryResponse command.params['userId'] = user_id unless user_id.nil? @@ -478,22 +451,19 @@ module Google command.query['startHistoryId'] = start_history_id unless start_history_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Creates a new label. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Label] label_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -506,8 +476,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_label(user_id, label_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/labels', options) + def create_user_label(user_id, label_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/labels', options) command.request_representation = Google::Apis::GmailV1::Label::Representation command.request_object = label_object command.response_representation = Google::Apis::GmailV1::Label::Representation @@ -515,24 +485,21 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Immediately and permanently deletes the specified label and removes it from # any messages and threads that it is applied to. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the label to delete. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -545,29 +512,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_label(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/labels/{id}', options) + def delete_user_label(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/labels/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified label. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the label to retrieve. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -580,29 +544,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_label(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/labels/{id}', options) + def get_user_label(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/labels/{id}', options) command.response_representation = Google::Apis::GmailV1::Label::Representation command.response_class = Google::Apis::GmailV1::Label command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists all labels in the user's mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -615,31 +576,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_labels(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/labels', options) + def list_user_labels(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/labels', options) command.response_representation = Google::Apis::GmailV1::ListLabelsResponse::Representation command.response_class = Google::Apis::GmailV1::ListLabelsResponse command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Updates the specified label. This method supports patch semantics. + # Patch the specified label. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the label to update. # @param [Google::Apis::GmailV1::Label] label_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -652,8 +610,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def patch_user_label(user_id, id, label_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:patch, '{userId}/labels/{id}', options) + def patch_user_label(user_id, id, label_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'gmail/v1/users/{userId}/labels/{id}', options) command.request_representation = Google::Apis::GmailV1::Label::Representation command.request_object = label_object command.response_representation = Google::Apis::GmailV1::Label::Representation @@ -662,24 +620,21 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates the specified label. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the label to update. # @param [Google::Apis::GmailV1::Label] label_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -692,8 +647,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_label(user_id, id, label_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/labels/{id}', options) + def update_user_label(user_id, id, label_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/labels/{id}', options) command.request_representation = Google::Apis::GmailV1::Label::Representation command.request_object = label_object command.response_representation = Google::Apis::GmailV1::Label::Representation @@ -702,23 +657,20 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Deletes many messages by message ID. Provides no guarantees that messages were - # not already deleted or even existed at all. + # Deletes many messages by message ID. Provides no guarantees that messages + # were not already deleted or even existed at all. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::BatchDeleteMessagesRequest] batch_delete_messages_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -731,29 +683,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def batch_delete_messages(user_id, batch_delete_messages_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/messages/batchDelete', options) + def batch_delete_messages(user_id, batch_delete_messages_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/batchDelete', options) command.request_representation = Google::Apis::GmailV1::BatchDeleteMessagesRequest::Representation command.request_object = batch_delete_messages_request_object command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Modifies the labels on the specified messages. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::BatchModifyMessagesRequest] batch_modify_messages_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -766,31 +715,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def batch_modify_messages(user_id, batch_modify_messages_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/messages/batchModify', options) + def batch_modify_messages(user_id, batch_modify_messages_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/batchModify', options) command.request_representation = Google::Apis::GmailV1::BatchModifyMessagesRequest::Representation command.request_object = batch_modify_messages_request_object command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Immediately and permanently deletes the specified message. This operation - # cannot be undone. Prefer messages.trash instead. + # cannot be undone. Prefer messages.trash instead. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the message to delete. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -803,20 +749,19 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_message(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/messages/{id}', options) + def delete_user_message(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/messages/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified message. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the message to retrieve. # @param [String] format @@ -826,10 +771,8 @@ module Google # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -842,8 +785,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_message(user_id, id, format: nil, metadata_headers: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/messages/{id}', options) + def get_user_message(user_id, id, format: nil, metadata_headers: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/messages/{id}', options) command.response_representation = Google::Apis::GmailV1::Message::Representation command.response_class = Google::Apis::GmailV1::Message command.params['userId'] = user_id unless user_id.nil? @@ -852,35 +795,34 @@ module Google command.query['metadataHeaders'] = metadata_headers unless metadata_headers.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Imports a message into only this user's mailbox, with standard email delivery - # scanning and classification similar to receiving via SMTP. Does not send a - # message. + # Imports a message into only this user's mailbox, with standard + # email delivery scanning and classification similar to receiving via SMTP. + # Does not send a message. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Message] message_object # @param [Boolean] deleted - # Mark the email as permanently deleted (not TRASH) and only visible in Google - # Vault to a Vault administrator. Only used for G Suite accounts. + # Mark the email as permanently deleted (not TRASH) and + # only visible in + # Google Vault to + # a Vault administrator. Only used for G Suite accounts. # @param [String] internal_date_source # Source for Gmail's internal date of the message. # @param [Boolean] never_mark_spam - # Ignore the Gmail spam classifier decision and never mark this email as SPAM in - # the mailbox. + # Ignore the Gmail spam classifier decision and never mark + # this email as SPAM in the mailbox. # @param [Boolean] process_for_calendar - # Process calendar invites in the email and add any extracted meetings to the - # Google Calendar for this user. + # Process calendar invites in the email and add any extracted + # meetings to the Google Calendar for this user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -897,11 +839,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def import_user_message(user_id, message_object = nil, deleted: nil, internal_date_source: nil, never_mark_spam: nil, process_for_calendar: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def import_user_message(user_id, message_object = nil, deleted: nil, internal_date_source: nil, never_mark_spam: nil, process_for_calendar: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:post, '{userId}/messages/import', options) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/import', options) else - command = make_upload_command(:post, '{userId}/messages/import', options) + command = make_upload_command(:post, 'gmail/v1/users/{userId}/messages/import', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -916,28 +858,28 @@ module Google command.query['processForCalendar'] = process_for_calendar unless process_for_calendar.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Directly inserts a message into only this user's mailbox similar to IMAP - # APPEND, bypassing most scanning and classification. Does not send a message. + # Directly inserts a message into only this user's mailbox similar to + # IMAP APPEND, bypassing most scanning and classification. + # Does not send a message. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Message] message_object # @param [Boolean] deleted - # Mark the email as permanently deleted (not TRASH) and only visible in Google - # Vault to a Vault administrator. Only used for G Suite accounts. + # Mark the email as permanently deleted (not TRASH) and + # only visible in + # Google Vault to + # a Vault administrator. Only used for G Suite accounts. # @param [String] internal_date_source # Source for Gmail's internal date of the message. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -954,11 +896,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def insert_user_message(user_id, message_object = nil, deleted: nil, internal_date_source: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def insert_user_message(user_id, message_object = nil, deleted: nil, internal_date_source: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:post, '{userId}/messages', options) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages', options) else - command = make_upload_command(:post, '{userId}/messages', options) + command = make_upload_command(:post, 'gmail/v1/users/{userId}/messages', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -971,16 +913,16 @@ module Google command.query['internalDateSource'] = internal_date_source unless internal_date_source.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the messages in the user's mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Boolean] include_spam_trash - # Include messages from SPAM and TRASH in the results. + # Include messages from SPAM and TRASH + # in the results. # @param [Array, String] label_ids # Only return messages with labels that match all of the specified label IDs. # @param [Fixnum] max_results @@ -988,17 +930,16 @@ module Google # @param [String] page_token # Page token to retrieve a specific page of results in the list. # @param [String] q - # Only return messages matching the specified query. Supports the same query - # format as the Gmail search box. For example, "from:someuser@example.com - # rfc822msgid: is:unread". Parameter cannot be used when - # accessing the api using the gmail.metadata scope. + # Only return messages matching the specified query. Supports the same + # query format as the Gmail search box. For example, + # "from:someuser@example.com rfc822msgid:<somemsgid@example.com> + # is:unread". Parameter cannot be used when accessing the api + # using the gmail.metadata scope. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1011,8 +952,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_messages(user_id, include_spam_trash: nil, label_ids: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/messages', options) + def list_user_messages(user_id, include_spam_trash: nil, label_ids: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/messages', options) command.response_representation = Google::Apis::GmailV1::ListMessagesResponse::Representation command.response_class = Google::Apis::GmailV1::ListMessagesResponse command.params['userId'] = user_id unless user_id.nil? @@ -1023,24 +964,21 @@ module Google command.query['q'] = q unless q.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Modifies the labels on the specified message. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the message to modify. # @param [Google::Apis::GmailV1::ModifyMessageRequest] modify_message_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1053,8 +991,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def modify_message(user_id, id, modify_message_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/messages/{id}/modify', options) + def modify_message(user_id, id, modify_message_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/{id}/modify', options) command.request_representation = Google::Apis::GmailV1::ModifyMessageRequest::Representation command.request_object = modify_message_request_object command.response_representation = Google::Apis::GmailV1::Message::Representation @@ -1063,22 +1001,20 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Sends the specified message to the recipients in the To, Cc, and Bcc headers. + # Sends the specified message to the recipients in the + # To, Cc, and Bcc headers. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Message] message_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [IO, String] upload_source # IO stream or filename containing content to upload # @param [String] content_type @@ -1095,11 +1031,11 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def send_user_message(user_id, message_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block) + def send_user_message(user_id, message_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? - command = make_simple_command(:post, '{userId}/messages/send', options) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/send', options) else - command = make_upload_command(:post, '{userId}/messages/send', options) + command = make_upload_command(:post, 'gmail/v1/users/{userId}/messages/send', options) command.upload_source = upload_source command.upload_content_type = content_type end @@ -1110,23 +1046,20 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Moves the specified message to the trash. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the message to Trash. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1139,31 +1072,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def trash_user_message(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/messages/{id}/trash', options) + def trash_user_message(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/{id}/trash', options) command.response_representation = Google::Apis::GmailV1::Message::Representation command.response_class = Google::Apis::GmailV1::Message command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Removes the specified message from the trash. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the message to remove from Trash. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1176,22 +1106,21 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def untrash_user_message(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/messages/{id}/untrash', options) + def untrash_user_message(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/messages/{id}/untrash', options) command.response_representation = Google::Apis::GmailV1::Message::Representation command.response_class = Google::Apis::GmailV1::Message command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified message attachment. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] message_id # The ID of the message containing the attachment. # @param [String] id @@ -1199,10 +1128,8 @@ module Google # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1215,8 +1142,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_message_attachment(user_id, message_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/messages/{messageId}/attachments/{id}', options) + def get_user_message_attachment(user_id, message_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}', options) command.response_representation = Google::Apis::GmailV1::MessagePartBody::Representation command.response_class = Google::Apis::GmailV1::MessagePartBody command.params['userId'] = user_id unless user_id.nil? @@ -1224,21 +1151,18 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the auto-forwarding setting for the specified account. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1251,28 +1175,25 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_auto_forwarding(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/autoForwarding', options) + def get_user_setting_auto_forwarding(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/autoForwarding', options) command.response_representation = Google::Apis::GmailV1::AutoForwarding::Representation command.response_class = Google::Apis::GmailV1::AutoForwarding command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets IMAP settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1285,28 +1206,25 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_imap(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/imap', options) + def get_user_setting_imap(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/imap', options) command.response_representation = Google::Apis::GmailV1::ImapSettings::Representation command.response_class = Google::Apis::GmailV1::ImapSettings command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets language settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1319,28 +1237,25 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_language(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/language', options) + def get_user_setting_language(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/language', options) command.response_representation = Google::Apis::GmailV1::LanguageSettings::Representation command.response_class = Google::Apis::GmailV1::LanguageSettings command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets POP settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1353,28 +1268,25 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_pop(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/pop', options) + def get_user_setting_pop(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/pop', options) command.response_representation = Google::Apis::GmailV1::PopSettings::Representation command.response_class = Google::Apis::GmailV1::PopSettings command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets vacation responder settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1387,32 +1299,29 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_vacation(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/vacation', options) + def get_user_setting_vacation(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/vacation', options) command.response_representation = Google::Apis::GmailV1::VacationSettings::Representation command.response_class = Google::Apis::GmailV1::VacationSettings command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Updates the auto-forwarding setting for the specified account. A verified + # Updates the auto-forwarding setting for the specified account. A verified # forwarding address must be specified when auto-forwarding is enabled. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::AutoForwarding] auto_forwarding_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1425,8 +1334,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_auto_forwarding(user_id, auto_forwarding_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/autoForwarding', options) + def update_user_setting_auto_forwarding(user_id, auto_forwarding_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/autoForwarding', options) command.request_representation = Google::Apis::GmailV1::AutoForwarding::Representation command.request_object = auto_forwarding_object command.response_representation = Google::Apis::GmailV1::AutoForwarding::Representation @@ -1434,22 +1343,19 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates IMAP settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::ImapSettings] imap_settings_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1462,8 +1368,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_imap(user_id, imap_settings_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/imap', options) + def update_user_setting_imap(user_id, imap_settings_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/imap', options) command.request_representation = Google::Apis::GmailV1::ImapSettings::Representation command.request_object = imap_settings_object command.response_representation = Google::Apis::GmailV1::ImapSettings::Representation @@ -1471,27 +1377,24 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates language settings. - # If successful, the return object contains the displayLanguage that was saved - # for the user, which may differ from the value passed into the request. This is - # because the requested displayLanguage may not be directly supported by Gmail - # but have a close variant that is, and so the variant may be chosen and saved - # instead. + # If successful, the return object contains the displayLanguage + # that was saved for the user, which may differ from the value passed into + # the request. This is because the requested displayLanguage may + # not be directly supported by Gmail but have a close variant that is, and so + # the variant may be chosen and saved instead. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::LanguageSettings] language_settings_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1504,8 +1407,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_language(user_id, language_settings_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/language', options) + def update_user_setting_language(user_id, language_settings_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/language', options) command.request_representation = Google::Apis::GmailV1::LanguageSettings::Representation command.request_object = language_settings_object command.response_representation = Google::Apis::GmailV1::LanguageSettings::Representation @@ -1513,22 +1416,19 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates POP settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::PopSettings] pop_settings_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1541,8 +1441,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_pop(user_id, pop_settings_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/pop', options) + def update_user_setting_pop(user_id, pop_settings_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/pop', options) command.request_representation = Google::Apis::GmailV1::PopSettings::Representation command.request_object = pop_settings_object command.response_representation = Google::Apis::GmailV1::PopSettings::Representation @@ -1550,22 +1450,19 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates vacation responder settings. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::VacationSettings] vacation_settings_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1578,8 +1475,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_vacation(user_id, vacation_settings_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/vacation', options) + def update_user_setting_vacation(user_id, vacation_settings_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/vacation', options) command.request_representation = Google::Apis::GmailV1::VacationSettings::Representation command.request_object = vacation_settings_object command.response_representation = Google::Apis::GmailV1::VacationSettings::Representation @@ -1587,33 +1484,32 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Adds a delegate with its verification status set directly to accepted, without - # sending any verification email. The delegate user must be a member of the same - # G Suite organization as the delegator user. - # Gmail imposes limitations on the number of delegates and delegators each user - # in a G Suite organization can have. These limits depend on your organization, - # but in general each user can have up to 25 delegates and up to 10 delegators. - # Note that a delegate user must be referred to by their primary email address, - # and not an email alias. - # Also note that when a new delegate is created, there may be up to a one minute - # delay before the new delegate is available for use. + # Adds a delegate with its verification status set directly to + # accepted, without sending any verification email. The + # delegate user must be a member of the same G Suite organization as the + # delegator user. + # Gmail imposes limitations on the number of delegates and delegators each + # user in a G Suite organization can have. These limits depend on your + # organization, but in general each user can have up to 25 delegates and + # up to 10 delegators. + # Note that a delegate user must be referred to by their primary email + # address, and not an email alias. + # Also note that when a new delegate is created, there may be up to a one + # minute delay before the new delegate is available for use. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Delegate] delegate_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1626,8 +1522,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_setting_delegate(user_id, delegate_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/delegates', options) + def create_user_setting_delegate(user_id, delegate_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/delegates', options) command.request_representation = Google::Apis::GmailV1::Delegate::Representation command.request_object = delegate_object command.response_representation = Google::Apis::GmailV1::Delegate::Representation @@ -1635,28 +1531,25 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Removes the specified delegate (which can be of any verification status), and - # revokes any verification that may have been required for using it. - # Note that a delegate user must be referred to by their primary email address, - # and not an email alias. + # Removes the specified delegate (which can be of any verification status), + # and revokes any verification that may have been required for using it. + # Note that a delegate user must be referred to by their primary email + # address, and not an email alias. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] delegate_email # The email address of the user to be removed as a delegate. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1669,33 +1562,31 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_setting_delegate(user_id, delegate_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/settings/delegates/{delegateEmail}', options) + def delete_user_setting_delegate(user_id, delegate_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/delegates/{delegateEmail}', options) command.params['userId'] = user_id unless user_id.nil? command.params['delegateEmail'] = delegate_email unless delegate_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified delegate. - # Note that a delegate user must be referred to by their primary email address, - # and not an email alias. + # Note that a delegate user must be referred to by their primary email + # address, and not an email alias. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] delegate_email - # The email address of the user whose delegate relationship is to be retrieved. + # The email address of the user whose delegate relationship is to be + # retrieved. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1708,15 +1599,14 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_delegate(user_id, delegate_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/delegates/{delegateEmail}', options) + def get_user_setting_delegate(user_id, delegate_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/delegates/{delegateEmail}', options) command.response_representation = Google::Apis::GmailV1::Delegate::Representation command.response_class = Google::Apis::GmailV1::Delegate command.params['userId'] = user_id unless user_id.nil? command.params['delegateEmail'] = delegate_email unless delegate_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end @@ -1724,15 +1614,13 @@ module Google # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1745,29 +1633,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_setting_delegates(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/delegates', options) + def list_user_setting_delegates(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/delegates', options) command.response_representation = Google::Apis::GmailV1::ListDelegatesResponse::Representation command.response_class = Google::Apis::GmailV1::ListDelegatesResponse command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Creates a filter. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::Filter] filter_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1780,8 +1665,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_setting_filter(user_id, filter_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/filters', options) + def create_user_setting_filter(user_id, filter_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/filters', options) command.request_representation = Google::Apis::GmailV1::Filter::Representation command.request_object = filter_object command.response_representation = Google::Apis::GmailV1::Filter::Representation @@ -1789,23 +1674,20 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Deletes a filter. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] id # The ID of the filter to be deleted. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1818,29 +1700,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_setting_filter(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/settings/filters/{id}', options) + def delete_user_setting_filter(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/filters/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets a filter. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] id # The ID of the filter to be fetched. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1853,29 +1732,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_filter(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/filters/{id}', options) + def get_user_setting_filter(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/filters/{id}', options) command.response_representation = Google::Apis::GmailV1::Filter::Representation command.response_class = Google::Apis::GmailV1::Filter command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the message filters of a Gmail user. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1888,34 +1764,31 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_setting_filters(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/filters', options) + def list_user_setting_filters(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/filters', options) command.response_representation = Google::Apis::GmailV1::ListFiltersResponse::Representation command.response_class = Google::Apis::GmailV1::ListFiltersResponse command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Creates a forwarding address. If ownership verification is required, a message - # will be sent to the recipient and the resource's verification status will be - # set to pending; otherwise, the resource will be created with verification - # status set to accepted. + # Creates a forwarding address. If ownership verification is required, a + # message will be sent to the recipient and the resource's verification + # status will be set to pending; otherwise, the resource will be + # created with verification status set to accepted. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::ForwardingAddress] forwarding_address_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1928,8 +1801,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_setting_forwarding_address(user_id, forwarding_address_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/forwardingAddresses', options) + def create_user_setting_forwarding_address(user_id, forwarding_address_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/forwardingAddresses', options) command.request_representation = Google::Apis::GmailV1::ForwardingAddress::Representation command.request_object = forwarding_address_object command.response_representation = Google::Apis::GmailV1::ForwardingAddress::Representation @@ -1937,26 +1810,23 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Deletes the specified forwarding address and revokes any verification that may - # have been required. + # Deletes the specified forwarding address and revokes any verification that + # may have been required. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] forwarding_email # The forwarding address to be deleted. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -1969,29 +1839,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_setting_forwarding_address(user_id, forwarding_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/settings/forwardingAddresses/{forwardingEmail}', options) + def delete_user_setting_forwarding_address(user_id, forwarding_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}', options) command.params['userId'] = user_id unless user_id.nil? command.params['forwardingEmail'] = forwarding_email unless forwarding_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified forwarding address. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] forwarding_email # The forwarding address to be retrieved. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2004,29 +1871,26 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_forwarding_address(user_id, forwarding_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/forwardingAddresses/{forwardingEmail}', options) + def get_user_setting_forwarding_address(user_id, forwarding_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}', options) command.response_representation = Google::Apis::GmailV1::ForwardingAddress::Representation command.response_class = Google::Apis::GmailV1::ForwardingAddress command.params['userId'] = user_id unless user_id.nil? command.params['forwardingEmail'] = forwarding_email unless forwarding_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the forwarding addresses for the specified account. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2039,37 +1903,35 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_setting_forwarding_addresses(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/forwardingAddresses', options) + def list_user_setting_forwarding_addresses(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/forwardingAddresses', options) command.response_representation = Google::Apis::GmailV1::ListForwardingAddressesResponse::Representation command.response_class = Google::Apis::GmailV1::ListForwardingAddressesResponse command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Creates a custom "from" send-as alias. If an SMTP MSA is specified, Gmail will - # attempt to connect to the SMTP service to validate the configuration before - # creating the alias. If ownership verification is required for the alias, a - # message will be sent to the email address and the resource's verification - # status will be set to pending; otherwise, the resource will be created with - # verification status set to accepted. If a signature is provided, Gmail will - # sanitize the HTML before saving it with the alias. + # Creates a custom "from" send-as alias. If an SMTP MSA is specified, Gmail + # will attempt to connect to the SMTP service to validate the configuration + # before creating the alias. If ownership verification is required for the + # alias, a message will be sent to the email address and the resource's + # verification status will be set to pending; otherwise, the + # resource will be created with verification status set to + # accepted. If a signature is provided, Gmail will sanitize the + # HTML before saving it with the alias. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [Google::Apis::GmailV1::SendAs] send_as_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2082,8 +1944,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_user_setting_send_as(user_id, send_as_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/sendAs', options) + def create_user_setting_send_as(user_id, send_as_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/sendAs', options) command.request_representation = Google::Apis::GmailV1::SendAs::Representation command.request_object = send_as_object command.response_representation = Google::Apis::GmailV1::SendAs::Representation @@ -2091,26 +1953,23 @@ module Google command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Deletes the specified send-as alias. Revokes any verification that may have - # been required for using it. + # Deletes the specified send-as alias. Revokes any verification that may + # have been required for using it. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] send_as_email # The send-as alias to be deleted. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2123,30 +1982,27 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/settings/sendAs/{sendAsEmail}', options) + def delete_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}', options) command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Gets the specified send-as alias. Fails with an HTTP 404 error if the + # Gets the specified send-as alias. Fails with an HTTP 404 error if the # specified address is not a member of the collection. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] send_as_email # The send-as alias to be retrieved. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2159,31 +2015,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/sendAs/{sendAsEmail}', options) + def get_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}', options) command.response_representation = Google::Apis::GmailV1::SendAs::Representation command.response_class = Google::Apis::GmailV1::SendAs command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Lists the send-as aliases for the specified account. The result includes the - # primary send-as address associated with the account as well as any custom " - # from" aliases. + # Lists the send-as aliases for the specified account. The result includes + # the primary send-as address associated with the account as well as any + # custom "from" aliases. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2196,35 +2049,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_setting_send_as(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/sendAs', options) + def list_user_setting_send_as(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/sendAs', options) command.response_representation = Google::Apis::GmailV1::ListSendAsResponse::Representation command.response_class = Google::Apis::GmailV1::ListSendAsResponse command.params['userId'] = user_id unless user_id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Updates a send-as alias. If a signature is provided, Gmail will sanitize the - # HTML before saving it with the alias. - # Addresses other than the primary address for the account can only be updated - # by service account clients that have been delegated domain-wide authority. - # This method supports patch semantics. + # Patch the specified send-as alias. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] send_as_email # The send-as alias to be updated. # @param [Google::Apis::GmailV1::SendAs] send_as_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2237,8 +2083,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def patch_user_setting_send_as(user_id, send_as_email, send_as_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:patch, '{userId}/settings/sendAs/{sendAsEmail}', options) + def patch_user_setting_send_as(user_id, send_as_email, send_as_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}', options) command.request_representation = Google::Apis::GmailV1::SendAs::Representation command.request_object = send_as_object command.response_representation = Google::Apis::GmailV1::SendAs::Representation @@ -2247,27 +2093,25 @@ module Google command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Updates a send-as alias. If a signature is provided, Gmail will sanitize the - # HTML before saving it with the alias. - # Addresses other than the primary address for the account can only be updated - # by service account clients that have been delegated domain-wide authority. + # Updates a send-as alias. If a signature is provided, Gmail will sanitize + # the HTML before saving it with the alias. + # Addresses other than the primary address for the account can only be + # updated by service account clients that have been delegated domain-wide + # authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] send_as_email # The send-as alias to be updated. # @param [Google::Apis::GmailV1::SendAs] send_as_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2280,8 +2124,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_user_setting_send_as(user_id, send_as_email, send_as_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:put, '{userId}/settings/sendAs/{sendAsEmail}', options) + def update_user_setting_send_as(user_id, send_as_email, send_as_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:put, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}', options) command.request_representation = Google::Apis::GmailV1::SendAs::Representation command.request_object = send_as_object command.response_representation = Google::Apis::GmailV1::SendAs::Representation @@ -2290,26 +2134,23 @@ module Google command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Sends a verification email to the specified send-as alias address. The - # verification status must be pending. + # Sends a verification email to the specified send-as alias address. + # The verification status must be pending. # This method is only available to service account clients that have been # delegated domain-wide authority. # @param [String] user_id - # User's email address. The special value "me" can be used to indicate the - # authenticated user. + # User's email address. The special value "me" + # can be used to indicate the authenticated user. # @param [String] send_as_email # The send-as alias to be verified. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2322,32 +2163,29 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def verify_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/sendAs/{sendAsEmail}/verify', options) + def verify_user_setting_send_as(user_id, send_as_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify', options) command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Deletes the specified S/MIME config for the specified send-as alias. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] send_as_email - # The email address that appears in the "From:" header for mail sent using this - # alias. + # The email address that appears in the "From:" header for mail sent using + # this alias. # @param [String] id # The immutable ID for the SmimeInfo. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2360,33 +2198,30 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_setting_send_a_smime_info(user_id, send_as_email, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', options) + def delete_user_setting_send_a_smime_info(user_id, send_as_email, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified S/MIME config for the specified send-as alias. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] send_as_email - # The email address that appears in the "From:" header for mail sent using this - # alias. + # The email address that appears in the "From:" header for mail sent using + # this alias. # @param [String] id # The immutable ID for the SmimeInfo. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2399,8 +2234,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_setting_send_a_smime_info(user_id, send_as_email, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', options) + def get_user_setting_send_a_smime_info(user_id, send_as_email, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', options) command.response_representation = Google::Apis::GmailV1::SmimeInfo::Representation command.response_class = Google::Apis::GmailV1::SmimeInfo command.params['userId'] = user_id unless user_id.nil? @@ -2408,26 +2243,23 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Insert (upload) the given S/MIME config for the specified send-as alias. Note - # that pkcs12 format is required for the key. + # Insert (upload) the given S/MIME config for the specified send-as alias. + # Note that pkcs12 format is required for the key. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] send_as_email - # The email address that appears in the "From:" header for mail sent using this - # alias. + # The email address that appears in the "From:" header for mail sent using + # this alias. # @param [Google::Apis::GmailV1::SmimeInfo] smime_info_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2440,8 +2272,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def insert_user_setting_send_a_smime_info(user_id, send_as_email, smime_info_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', options) + def insert_user_setting_send_a_smime_info(user_id, send_as_email, smime_info_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', options) command.request_representation = Google::Apis::GmailV1::SmimeInfo::Representation command.request_object = smime_info_object command.response_representation = Google::Apis::GmailV1::SmimeInfo::Representation @@ -2450,24 +2282,21 @@ module Google command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists S/MIME configs for the specified send-as alias. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] send_as_email - # The email address that appears in the "From:" header for mail sent using this - # alias. + # The email address that appears in the "From:" header for mail sent using + # this alias. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2480,34 +2309,31 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_setting_send_a_smime_infos(user_id, send_as_email, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', options) + def list_user_setting_send_a_smime_infos(user_id, send_as_email, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', options) command.response_representation = Google::Apis::GmailV1::ListSmimeInfoResponse::Representation command.response_class = Google::Apis::GmailV1::ListSmimeInfoResponse command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Sets the default S/MIME config for the specified send-as alias. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] send_as_email - # The email address that appears in the "From:" header for mail sent using this - # alias. + # The email address that appears in the "From:" header for mail sent using + # this alias. # @param [String] id # The immutable ID for the SmimeInfo. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2520,31 +2346,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def set_user_setting_send_a_smime_info_default(user_id, send_as_email, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault', options) + def set_user_setting_send_a_smime_info_default(user_id, send_as_email, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault', options) command.params['userId'] = user_id unless user_id.nil? command.params['sendAsEmail'] = send_as_email unless send_as_email.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Immediately and permanently deletes the specified thread. This operation - # cannot be undone. Prefer threads.trash instead. + # cannot be undone. Prefer threads.trash instead. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # ID of the Thread to delete. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2557,20 +2380,19 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_user_thread(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:delete, '{userId}/threads/{id}', options) + def delete_user_thread(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'gmail/v1/users/{userId}/threads/{id}', options) command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Gets the specified thread. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the thread to retrieve. # @param [String] format @@ -2580,10 +2402,8 @@ module Google # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2596,8 +2416,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_user_thread(user_id, id, format: nil, metadata_headers: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/threads/{id}', options) + def get_user_thread(user_id, id, format: nil, metadata_headers: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/threads/{id}', options) command.response_representation = Google::Apis::GmailV1::Thread::Representation command.response_class = Google::Apis::GmailV1::Thread command.params['userId'] = user_id unless user_id.nil? @@ -2606,16 +2426,16 @@ module Google command.query['metadataHeaders'] = metadata_headers unless metadata_headers.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Lists the threads in the user's mailbox. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [Boolean] include_spam_trash - # Include threads from SPAM and TRASH in the results. + # Include threads from SPAM and TRASH + # in the results. # @param [Array, String] label_ids # Only return threads with labels that match all of the specified label IDs. # @param [Fixnum] max_results @@ -2623,17 +2443,16 @@ module Google # @param [String] page_token # Page token to retrieve a specific page of results in the list. # @param [String] q - # Only return threads matching the specified query. Supports the same query - # format as the Gmail search box. For example, "from:someuser@example.com - # rfc822msgid: is:unread". Parameter cannot be used when accessing the api using - # the gmail.metadata scope. + # Only return threads matching the specified query. Supports the same + # query format as the Gmail search box. For example, + # "from:someuser@example.com rfc822msgid: + # is:unread". Parameter cannot be used when accessing the api + # using the gmail.metadata scope. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2646,8 +2465,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_user_threads(user_id, include_spam_trash: nil, label_ids: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:get, '{userId}/threads', options) + def list_user_threads(user_id, include_spam_trash: nil, label_ids: nil, max_results: nil, page_token: nil, q: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'gmail/v1/users/{userId}/threads', options) command.response_representation = Google::Apis::GmailV1::ListThreadsResponse::Representation command.response_class = Google::Apis::GmailV1::ListThreadsResponse command.params['userId'] = user_id unless user_id.nil? @@ -2658,25 +2477,22 @@ module Google command.query['q'] = q unless q.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end - # Modifies the labels applied to the thread. This applies to all messages in the - # thread. + # Modifies the labels applied to the thread. This applies to all messages + # in the thread. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the thread to modify. # @param [Google::Apis::GmailV1::ModifyThreadRequest] modify_thread_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2689,8 +2505,8 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def modify_thread(user_id, id, modify_thread_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/threads/{id}/modify', options) + def modify_thread(user_id, id, modify_thread_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/threads/{id}/modify', options) command.request_representation = Google::Apis::GmailV1::ModifyThreadRequest::Representation command.request_object = modify_thread_request_object command.response_representation = Google::Apis::GmailV1::Thread::Representation @@ -2699,23 +2515,20 @@ module Google command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Moves the specified thread to the trash. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the thread to Trash. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2728,31 +2541,28 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def trash_user_thread(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/threads/{id}/trash', options) + def trash_user_thread(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/threads/{id}/trash', options) command.response_representation = Google::Apis::GmailV1::Thread::Representation command.response_class = Google::Apis::GmailV1::Thread command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Removes the specified thread from the trash. # @param [String] user_id - # The user's email address. The special value me can be used to indicate the - # authenticated user. + # The user's email address. The special value me + # can be used to indicate the authenticated user. # @param [String] id # The ID of the thread to remove from Trash. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user - # An opaque string that represents a user for quota purposes. Must not exceed 40 - # characters. - # @param [String] user_ip - # Deprecated. Please use quotaUser instead. + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # @@ -2765,15 +2575,14 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def untrash_user_thread(user_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) - command = make_simple_command(:post, '{userId}/threads/{id}/untrash', options) + def untrash_user_thread(user_id, id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'gmail/v1/users/{userId}/threads/{id}/untrash', options) command.response_representation = Google::Apis::GmailV1::Thread::Representation command.response_class = Google::Apis::GmailV1::Thread command.params['userId'] = user_id unless user_id.nil? command.params['id'] = id unless id.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end @@ -2782,7 +2591,6 @@ module Google def apply_command_defaults(command) command.query['key'] = key unless key.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? - command.query['userIp'] = user_ip unless user_ip.nil? end end end diff --git a/generated/google/apis/memcache_v1beta2.rb b/generated/google/apis/memcache_v1beta2.rb index 917fe5f4a..35fdf59cc 100644 --- a/generated/google/apis/memcache_v1beta2.rb +++ b/generated/google/apis/memcache_v1beta2.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/memorystore/ module MemcacheV1beta2 VERSION = 'V1beta2' - REVISION = '20200603' + REVISION = '20200608' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/memcache_v1beta2/classes.rb b/generated/google/apis/memcache_v1beta2/classes.rb index b0eaf89e0..affa642eb 100644 --- a/generated/google/apis/memcache_v1beta2/classes.rb +++ b/generated/google/apis/memcache_v1beta2/classes.rb @@ -62,7 +62,7 @@ module Google # ` # "audit_configs": [ # ` - # "service": "allServices" + # "service": "allServices", # "audit_log_configs": [ # ` # "log_type": "DATA_READ", @@ -71,18 +71,18 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # `, # ` - # "log_type": "ADMIN_READ", + # "log_type": "ADMIN_READ" # ` # ] # `, # ` - # "service": "sampleservice.googleapis.com" + # "service": "sampleservice.googleapis.com", # "audit_log_configs": [ # ` - # "log_type": "DATA_READ", + # "log_type": "DATA_READ" # `, # ` # "log_type": "DATA_WRITE", @@ -134,7 +134,7 @@ module Google # ] # `, # ` - # "log_type": "DATA_WRITE", + # "log_type": "DATA_WRITE" # ` # ] # ` diff --git a/generated/google/apis/osconfig_v1beta.rb b/generated/google/apis/osconfig_v1beta.rb index 40b201a35..16aabc2ba 100644 --- a/generated/google/apis/osconfig_v1beta.rb +++ b/generated/google/apis/osconfig_v1beta.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/ module OsconfigV1beta VERSION = 'V1beta' - REVISION = '20200504' + REVISION = '20200601' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/osconfig_v1beta/classes.rb b/generated/google/apis/osconfig_v1beta/classes.rb index d95326a8a..0fabd0e87 100644 --- a/generated/google/apis/osconfig_v1beta/classes.rb +++ b/generated/google/apis/osconfig_v1beta/classes.rb @@ -461,8 +461,7 @@ module Google end end - # A request message to initiate patching across Google Compute Engine - # instances. + # A request message to initiate patching across Compute Engine instances. class ExecutePatchJobRequest include Google::Apis::Core::Hashable @@ -1182,8 +1181,8 @@ module Google class PatchInstanceFilterGroupLabel include Google::Apis::Core::Hashable - # Google Compute Engine instance labels that must be present for a VM - # instance to be targeted by this filter. + # Compute Engine instance labels that must be present for a VM instance to + # be targeted by this filter. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels @@ -1200,8 +1199,8 @@ module Google # A high level representation of a patch job that is either in progress # or has completed. - # Instances details are not included in the job. To paginate through instance - # details, use ListPatchJobInstanceDetails. + # Instance details are not included in the job. To paginate through instance + # details, use `ListPatchJobInstanceDetails`. # For more information about patch jobs, see # [Creating patch # jobs](https://cloud.google.com/compute/docs/os-patch-management/create-patch- @@ -1283,7 +1282,7 @@ module Google # @return [Float] attr_accessor :percent_complete - # The current state of the PatchJob . + # The current state of the PatchJob. # Corresponds to the JSON property `state` # @return [String] attr_accessor :state diff --git a/generated/google/apis/pagespeedonline_v5.rb b/generated/google/apis/pagespeedonline_v5.rb index 54bc8b7ba..7a942abb3 100644 --- a/generated/google/apis/pagespeedonline_v5.rb +++ b/generated/google/apis/pagespeedonline_v5.rb @@ -28,7 +28,7 @@ module Google # @see https://developers.google.com/speed/docs/insights/v5/about module PagespeedonlineV5 VERSION = 'V5' - REVISION = '20200305' + REVISION = '20200608' # Associate you with your personal info on Google PENID = 'openid' diff --git a/generated/google/apis/pagespeedonline_v5/classes.rb b/generated/google/apis/pagespeedonline_v5/classes.rb index 3ca612cb9..387d09292 100644 --- a/generated/google/apis/pagespeedonline_v5/classes.rb +++ b/generated/google/apis/pagespeedonline_v5/classes.rb @@ -496,6 +496,12 @@ module Google # @return [Hash] attr_accessor :metrics + # True if the result is an origin fallback from a page, false otherwise. + # Corresponds to the JSON property `origin_fallback` + # @return [Boolean] + attr_accessor :origin_fallback + alias_method :origin_fallback?, :origin_fallback + # The human readable speed "category" of the id. # Corresponds to the JSON property `overall_category` # @return [String] @@ -510,6 +516,7 @@ module Google @id = args[:id] if args.key?(:id) @initial_url = args[:initial_url] if args.key?(:initial_url) @metrics = args[:metrics] if args.key?(:metrics) + @origin_fallback = args[:origin_fallback] if args.key?(:origin_fallback) @overall_category = args[:overall_category] if args.key?(:overall_category) end end diff --git a/generated/google/apis/pagespeedonline_v5/representations.rb b/generated/google/apis/pagespeedonline_v5/representations.rb index 77f950264..def2deed2 100644 --- a/generated/google/apis/pagespeedonline_v5/representations.rb +++ b/generated/google/apis/pagespeedonline_v5/representations.rb @@ -266,6 +266,7 @@ module Google property :initial_url, as: 'initial_url' hash :metrics, as: 'metrics', class: Google::Apis::PagespeedonlineV5::UserPageLoadMetricV5, decorator: Google::Apis::PagespeedonlineV5::UserPageLoadMetricV5::Representation + property :origin_fallback, as: 'origin_fallback' property :overall_category, as: 'overall_category' end end diff --git a/generated/google/apis/people_v1.rb b/generated/google/apis/people_v1.rb index 2fcff86f1..84bdcb540 100644 --- a/generated/google/apis/people_v1.rb +++ b/generated/google/apis/people_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://developers.google.com/people/ module PeopleV1 VERSION = 'V1' - REVISION = '20200604' + REVISION = '20200606' # See, edit, download, and permanently delete your contacts AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts' diff --git a/generated/google/apis/people_v1/classes.rb b/generated/google/apis/people_v1/classes.rb index 2b536f4cc..5aeb3e8c2 100644 --- a/generated/google/apis/people_v1/classes.rb +++ b/generated/google/apis/people_v1/classes.rb @@ -439,8 +439,8 @@ module Google # Optional. A field mask to restrict which fields on the person are returned. # Multiple - # fields can be specified by separating them with commas. Defaults to empty - # if not set, which will skip the post mutate get. Valid values are: + # fields can be specified by separating them with commas. Defaults to the + # copy mask with metadata and membership fields if not set. Valid values are: # * addresses # * ageRanges # * biographies @@ -470,6 +470,14 @@ module Google # @return [String] attr_accessor :read_mask + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT and + # ReadSourceType.PROFILE if not + # set. + # Corresponds to the JSON property `sources` + # @return [Array] + attr_accessor :sources + def initialize(**args) update!(**args) end @@ -478,6 +486,7 @@ module Google def update!(**args) @copy_mask = args[:copy_mask] if args.key?(:copy_mask) @read_mask = args[:read_mask] if args.key?(:read_mask) + @sources = args[:sources] if args.key?(:sources) end end @@ -2302,6 +2311,14 @@ module Google # @return [String] attr_accessor :photo_bytes + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT and + # ReadSourceType.PROFILE if not + # set. + # Corresponds to the JSON property `sources` + # @return [Array] + attr_accessor :sources + def initialize(**args) update!(**args) end @@ -2310,6 +2327,7 @@ module Google def update!(**args) @person_fields = args[:person_fields] if args.key?(:person_fields) @photo_bytes = args[:photo_bytes] if args.key?(:photo_bytes) + @sources = args[:sources] if args.key?(:sources) end end diff --git a/generated/google/apis/people_v1/representations.rb b/generated/google/apis/people_v1/representations.rb index e9f743d56..523a14934 100644 --- a/generated/google/apis/people_v1/representations.rb +++ b/generated/google/apis/people_v1/representations.rb @@ -465,6 +465,7 @@ module Google class Representation < Google::Apis::Core::JsonRepresentation property :copy_mask, as: 'copyMask' property :read_mask, as: 'readMask' + collection :sources, as: 'sources' end end @@ -950,6 +951,7 @@ module Google class Representation < Google::Apis::Core::JsonRepresentation property :person_fields, as: 'personFields' property :photo_bytes, :base64 => true, as: 'photoBytes' + collection :sources, as: 'sources' end end diff --git a/generated/google/apis/people_v1/service.rb b/generated/google/apis/people_v1/service.rb index 17665e1ee..e7df3b88a 100644 --- a/generated/google/apis/people_v1/service.rb +++ b/generated/google/apis/people_v1/service.rb @@ -329,8 +329,104 @@ module Google execute_or_queue_command(command, &block) end + # List all other contacts, that is contacts that are not in a contact group. + # Other contacts are typically auto created contacts from interactions. + # @param [Fixnum] page_size + # Optional. The number of other contacts to include in the response. Valid + # values are + # between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0. + # @param [String] page_token + # Optional. A page token, received from a previous `ListOtherContacts` call. + # Provide this to retrieve the subsequent page. + # When paginating, all other parameters provided to `ListOtherContacts` + # must match the call that provided the page token. + # @param [String] read_mask + # Required. A field mask to restrict which fields on each person are returned. + # Multiple + # fields can be specified by separating them with commas. Valid values are: + # * emailAddresses + # * names + # * phoneNumbers + # @param [Boolean] request_sync_token + # Optional. Whether the response should include `next_sync_token`, which can be + # used to + # get all changes since the last request. For subsequent sync requests use + # the `sync_token` param instead. Initial sync requests that specify + # `request_sync_token` have an additional rate limit. + # @param [String] sync_token + # Optional. A sync token, received from a previous `ListOtherContacts` call. + # Provide this to retrieve only the resources changed since the last request. + # Sync requests that specify `sync_token` have an additional rate limit. + # When syncing, all other parameters provided to `ListOtherContacts` + # must match the call that provided the sync token. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::PeopleV1::ListOtherContactsResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::PeopleV1::ListOtherContactsResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def list_other_contacts(page_size: nil, page_token: nil, read_mask: nil, request_sync_token: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/otherContacts', options) + command.response_representation = Google::Apis::PeopleV1::ListOtherContactsResponse::Representation + command.response_class = Google::Apis::PeopleV1::ListOtherContactsResponse + command.query['pageSize'] = page_size unless page_size.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['readMask'] = read_mask unless read_mask.nil? + command.query['requestSyncToken'] = request_sync_token unless request_sync_token.nil? + command.query['syncToken'] = sync_token unless sync_token.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Create a new contact and return the person resource for that contact. # @param [Google::Apis::PeopleV1::Person] person_object + # @param [String] person_fields + # Required. A field mask to restrict which fields on each person are returned. + # Multiple + # fields can be specified by separating them with commas. Defaults to all + # fields if not set. Valid values are: + # * addresses + # * ageRanges + # * biographies + # * birthdays + # * coverPhotos + # * emailAddresses + # * events + # * genders + # * imClients + # * interests + # * locales + # * memberships + # * metadata + # * names + # * nicknames + # * occupations + # * organizations + # * phoneNumbers + # * photos + # * relations + # * residences + # * sipAddresses + # * skills + # * urls + # * userDefined + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT and + # ReadSourceType.PROFILE if not + # set. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -348,12 +444,14 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_person_contact(person_object = nil, fields: nil, quota_user: nil, options: nil, &block) + def create_person_contact(person_object = nil, person_fields: nil, sources: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/people:createContact', options) command.request_representation = Google::Apis::PeopleV1::Person::Representation command.request_object = person_object command.response_representation = Google::Apis::PeopleV1::Person::Representation command.response_class = Google::Apis::PeopleV1::Person + command.query['personFields'] = person_fields unless person_fields.nil? + command.query['sources'] = sources unless sources.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -422,6 +520,11 @@ module Google # * skills # * urls # * userDefined + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT and + # ReadSourceType.PROFILE if not + # set. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -439,12 +542,13 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_person_contact_photo(resource_name, person_fields: nil, fields: nil, quota_user: nil, options: nil, &block) + def delete_person_contact_photo(resource_name, person_fields: nil, sources: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/{+resourceName}:deleteContactPhoto', options) command.response_representation = Google::Apis::PeopleV1::DeleteContactPhotoResponse::Representation command.response_class = Google::Apis::PeopleV1::DeleteContactPhotoResponse command.params['resourceName'] = resource_name unless resource_name.nil? command.query['personFields'] = person_fields unless person_fields.nil? + command.query['sources'] = sources unless sources.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -495,6 +599,12 @@ module Google # Each # path should start with `person.`: for example, `person.names` or # `person.photos`. + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.PROFILE + # and + # ReadSourceType.CONTACT + # if not set. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -512,13 +622,14 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_person(resource_name, person_fields: nil, request_mask_include_field: nil, fields: nil, quota_user: nil, options: nil, &block) + def get_person(resource_name, person_fields: nil, request_mask_include_field: nil, sources: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+resourceName}', options) command.response_representation = Google::Apis::PeopleV1::Person::Representation command.response_class = Google::Apis::PeopleV1::Person command.params['resourceName'] = resource_name unless resource_name.nil? command.query['personFields'] = person_fields unless person_fields.nil? command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil? + command.query['sources'] = sources unless sources.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -571,6 +682,12 @@ module Google # identifies the contact as returned by # [`people.connections.list`](/people/api/rest/v1/people.connections/list). # You can include up to 50 resource names in one request. + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT + # and + # ReadSourceType.PROFILE + # if not set. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -588,13 +705,14 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_people(person_fields: nil, request_mask_include_field: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block) + def get_people(person_fields: nil, request_mask_include_field: nil, resource_names: nil, sources: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/people:batchGet', options) command.response_representation = Google::Apis::PeopleV1::GetPeopleResponse::Representation command.response_class = Google::Apis::PeopleV1::GetPeopleResponse command.query['personFields'] = person_fields unless person_fields.nil? command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil? command.query['resourceNames'] = resource_names unless resource_names.nil? + command.query['sources'] = sources unless sources.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -615,6 +733,41 @@ module Google # with a max length of 27 characters, in the form of # `people/`person_id``. # @param [Google::Apis::PeopleV1::Person] person_object + # @param [String] person_fields + # Optional. A field mask to restrict which fields on each person are returned. + # Multiple + # fields can be specified by separating them with commas. Defaults to all + # fields if not set. Valid values are: + # * addresses + # * ageRanges + # * biographies + # * birthdays + # * coverPhotos + # * emailAddresses + # * events + # * genders + # * imClients + # * interests + # * locales + # * memberships + # * metadata + # * names + # * nicknames + # * occupations + # * organizations + # * phoneNumbers + # * photos + # * relations + # * residences + # * sipAddresses + # * skills + # * urls + # * userDefined + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT and + # ReadSourceType.PROFILE if not + # set. # @param [String] update_person_fields # Required. A field mask to restrict which fields on the person are updated. # Multiple @@ -657,13 +810,15 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def update_person_contact(resource_name, person_object = nil, update_person_fields: nil, fields: nil, quota_user: nil, options: nil, &block) + def update_person_contact(resource_name, person_object = nil, person_fields: nil, sources: nil, update_person_fields: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:patch, 'v1/{+resourceName}:updateContact', options) command.request_representation = Google::Apis::PeopleV1::Person::Representation command.request_object = person_object command.response_representation = Google::Apis::PeopleV1::Person::Representation command.response_class = Google::Apis::PeopleV1::Person command.params['resourceName'] = resource_name unless resource_name.nil? + command.query['personFields'] = person_fields unless person_fields.nil? + command.query['sources'] = sources unless sources.nil? command.query['updatePersonFields'] = update_person_fields unless update_person_fields.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? @@ -760,6 +915,12 @@ module Google # @param [String] sort_order # Optional. The order in which the connections should be sorted. Defaults to # `LAST_MODIFIED_ASCENDING`. + # @param [Array, String] sources + # Optional. A mask of what source types to return. Defaults to + # ReadSourceType.CONTACT + # and + # ReadSourceType.PROFILE if not + # set. # @param [String] sync_token # Optional. A sync token, received from a previous `ListConnections` call. # Provide this to retrieve only the resources changed since the last request. @@ -783,7 +944,7 @@ module Google # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_person_connections(resource_name, page_size: nil, page_token: nil, person_fields: nil, request_mask_include_field: nil, request_sync_token: nil, sort_order: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block) + def list_person_connections(resource_name, page_size: nil, page_token: nil, person_fields: nil, request_mask_include_field: nil, request_sync_token: nil, sort_order: nil, sources: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+resourceName}/connections', options) command.response_representation = Google::Apis::PeopleV1::ListConnectionsResponse::Representation command.response_class = Google::Apis::PeopleV1::ListConnectionsResponse @@ -794,67 +955,7 @@ module Google command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil? command.query['requestSyncToken'] = request_sync_token unless request_sync_token.nil? command.query['sortOrder'] = sort_order unless sort_order.nil? - command.query['syncToken'] = sync_token unless sync_token.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # List all other contacts, that is contacts that are not in a contact group. - # Other contacts are typically auto created contacts from interactions. - # @param [Fixnum] page_size - # Optional. The number of other contacts to include in the response. Valid - # values are - # between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0. - # @param [String] page_token - # Optional. A page token, received from a previous `ListOtherContacts` call. - # Provide this to retrieve the subsequent page. - # When paginating, all other parameters provided to `ListOtherContacts` - # must match the call that provided the page token. - # @param [String] read_mask - # Required. A field mask to restrict which fields on each person are returned. - # Multiple - # fields can be specified by separating them with commas. Valid values are: - # * emailAddresses - # * names - # * phoneNumbers - # @param [Boolean] request_sync_token - # Optional. Whether the response should include `next_sync_token`, which can be - # used to - # get all changes since the last request. For subsequent sync requests use - # the `sync_token` param instead. Initial sync requests that specify - # `request_sync_token` have an additional rate limit. - # @param [String] sync_token - # Optional. A sync token, received from a previous `ListOtherContacts` call. - # Provide this to retrieve only the resources changed since the last request. - # Sync requests that specify `sync_token` have an additional rate limit. - # When syncing, all other parameters provided to `ListOtherContacts` - # must match the call that provided the sync token. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # Available to use for quota purposes for server-side applications. Can be any - # arbitrary string assigned to a user, but should not exceed 40 characters. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::PeopleV1::ListOtherContactsResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::PeopleV1::ListOtherContactsResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def other_contacts(page_size: nil, page_token: nil, read_mask: nil, request_sync_token: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/otherContacts', options) - command.response_representation = Google::Apis::PeopleV1::ListOtherContactsResponse::Representation - command.response_class = Google::Apis::PeopleV1::ListOtherContactsResponse - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['readMask'] = read_mask unless read_mask.nil? - command.query['requestSyncToken'] = request_sync_token unless request_sync_token.nil? + command.query['sources'] = sources unless sources.nil? command.query['syncToken'] = sync_token unless sync_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil?