google-api-client 0.30.6 → 0.30.7

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

@@ -51,13 +51,11 @@ module Google
         # Completes the specified prefix with keyword suggestions.
         # Intended for use by a job search auto-complete search box.
         # @param [String] name
-        #   Required.
-        #   Resource name of project the completion is performed within.
+        #   Required. Resource name of project the completion is performed within.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [String] company_name
-        #   Optional.
-        #   If provided, restricts completion to specified company.
+        #   Optional. If provided, restricts completion to specified company.
         #   The format is "projects/`project_id`/companies/`company_id`", for example,
         #   "projects/api-test-project/companies/foo".
         # @param [String] language_code
@@ -77,8 +75,7 @@ module Google
         #   language_code are returned.
         #   The maximum number of allowed characters is 255.
         # @param [Array<String>, String] language_codes
-        #   Optional.
-        #   The list of languages of the query. This is
+        #   Optional. The list of languages of the query. This is
         #   the BCP-47 language code, such as "en-US" or "sr-Latn".
         #   For more information, see
         #   [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
@@ -92,19 +89,15 @@ module Google
         #   language_codes are returned.
         #   The maximum number of allowed characters is 255.
         # @param [Fixnum] page_size
-        #   Required.
-        #   Completion result count.
+        #   Required. Completion result count.
         #   The maximum allowed page size is 10.
         # @param [String] query
-        #   Required.
-        #   The query used to generate suggestions.
+        #   Required. The query used to generate suggestions.
         #   The maximum number of allowed characters is 255.
         # @param [String] scope
-        #   Optional.
-        #   The scope of the completion. The defaults is CompletionScope.PUBLIC.
+        #   Optional. The scope of the completion. The defaults is CompletionScope.PUBLIC.
         # @param [String] type
-        #   Optional.
-        #   The completion topic. The default is CompletionType.COMBINED.
+        #   Optional. The completion topic. The default is CompletionType.COMBINED.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -180,8 +173,7 @@ module Google
         
         # Creates a new company entity.
         # @param [String] parent
-        #   Required.
-        #   Resource name of the project under which the company is created.
+        #   Required. Resource name of the project under which the company is created.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Google::Apis::JobsV3p1beta1::CreateCompanyRequest] create_company_request_object
@@ -217,8 +209,7 @@ module Google
         # Deletes specified company.
         # Prerequisite: The company has no jobs associated with it.
         # @param [String] name
-        #   Required.
-        #   The resource name of the company to be deleted.
+        #   Required. The resource name of the company to be deleted.
         #   The format is "projects/`project_id`/companies/`company_id`", for example,
         #   "projects/api-test-project/companies/foo".
         # @param [String] fields
@@ -250,8 +241,7 @@ module Google
         
         # Retrieves specified company.
         # @param [String] name
-        #   Required.
-        #   The resource name of the company to be retrieved.
+        #   Required. The resource name of the company to be retrieved.
         #   The format is "projects/`project_id`/companies/`company_id`", for example,
         #   "projects/api-test-project/companies/foo".
         # @param [String] fields
@@ -283,20 +273,16 @@ module Google
         
         # Lists all companies associated with the service account.
         # @param [String] parent
-        #   Required.
-        #   Resource name of the project under which the company is created.
+        #   Required. Resource name of the project under which the company is created.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Fixnum] page_size
-        #   Optional.
-        #   The maximum number of companies to be returned, at most 100.
+        #   Optional. The maximum number of companies to be returned, at most 100.
         #   Default is 100 if a non-positive number is provided.
         # @param [String] page_token
-        #   Optional.
-        #   The starting indicator from which to return results.
+        #   Optional. The starting indicator from which to return results.
         # @param [Boolean] require_open_jobs
-        #   Optional.
-        #   Set to true if the companies requested must have open jobs.
+        #   Optional. Set to true if the companies requested must have open jobs.
         #   Defaults to false.
         #   If true, at most page_size of companies are fetched, among which
         #   only those with open jobs are returned.
@@ -371,8 +357,7 @@ module Google
         
         # Deletes a list of Jobs by filter.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project under which the job is created.
+        #   Required. The resource name of the project under which the job is created.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Google::Apis::JobsV3p1beta1::BatchDeleteJobsRequest] batch_delete_jobs_request_object
@@ -409,8 +394,7 @@ module Google
         # Typically, the job becomes searchable within 10 seconds, but it may take
         # up to 5 minutes.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project under which the job is created.
+        #   Required. The resource name of the project under which the job is created.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Google::Apis::JobsV3p1beta1::CreateJobRequest] create_job_request_object
@@ -447,8 +431,7 @@ module Google
         # Typically, the job becomes unsearchable within 10 seconds, but it may take
         # up to 5 minutes.
         # @param [String] name
-        #   Required.
-        #   The resource name of the job to be deleted.
+        #   Required. The resource name of the job to be deleted.
         #   The format is "projects/`project_id`/jobs/`job_id`",
         #   for example, "projects/api-test-project/jobs/1234".
         # @param [String] fields
@@ -481,8 +464,7 @@ module Google
         # Retrieves the specified job, whose status is OPEN or recently EXPIRED
         # within the last 90 days.
         # @param [String] name
-        #   Required.
-        #   The resource name of the job to retrieve.
+        #   Required. The resource name of the job to retrieve.
         #   The format is "projects/`project_id`/jobs/`job_id`",
         #   for example, "projects/api-test-project/jobs/1234".
         # @param [String] fields
@@ -514,13 +496,11 @@ module Google
         
         # Lists jobs by filter.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project under which the job is created.
+        #   Required. The resource name of the project under which the job is created.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [String] filter
-        #   Required.
-        #   The filter string specifies the jobs to be enumerated.
+        #   Required. The filter string specifies the jobs to be enumerated.
         #   Supported operator: =, AND
         #   The fields eligible for filtering are:
         #   * `companyName` (Required)
@@ -530,19 +510,16 @@ module Google
         #   * companyName = "projects/api-test-project/companies/123" AND requisitionId
         #   = "req-1"
         # @param [String] job_view
-        #   Optional.
-        #   The desired job attributes returned for jobs in the
+        #   Optional. The desired job attributes returned for jobs in the
         #   search response. Defaults to JobView.JOB_VIEW_FULL if no value is
         #   specified.
         # @param [Fixnum] page_size
-        #   Optional.
-        #   The maximum number of jobs to be returned per page of results.
+        #   Optional. The maximum number of jobs to be returned per page of results.
         #   If job_view is set to JobView.JOB_VIEW_ID_ONLY, the maximum allowed
         #   page size is 1000. Otherwise, the maximum allowed page size is 100.
         #   Default is 100 if empty or a number < 1 is specified.
         # @param [String] page_token
-        #   Optional.
-        #   The starting point of a query result.
+        #   Optional. The starting point of a query result.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -620,8 +597,7 @@ module Google
         # present in the database, and only returns jobs that the caller has
         # permission to search against.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project to search within.
+        #   Required. The resource name of the project to search within.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Google::Apis::JobsV3p1beta1::SearchJobsRequest] search_jobs_request_object
@@ -663,8 +639,7 @@ module Google
         # present in the database, and only returns jobs the caller has
         # permission to search against.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project to search within.
+        #   Required. The resource name of the project to search within.
         #   The format is "projects/`project_id`", for example,
         #   "projects/api-test-project".
         # @param [Google::Apis::JobsV3p1beta1::SearchJobsRequest] search_jobs_request_object

data/generated/google/apis/people_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/people/
     module PeopleV1
       VERSION = 'V1'
-      REVISION = '20190611'
+      REVISION = '20190718'
 
       # See, edit, download, and permanently delete your contacts
       AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts'

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

@@ -514,6 +514,29 @@ module Google
         end
       end
       
+      # The response for deleteing a contact's photo.
+      class DeleteContactPhotoResponse
+        include Google::Apis::Core::Hashable
+      
+        # Information about a person merged from various data sources such as the
+        # authenticated user's contacts and profile data.
+        # Most fields can have multiple items. The items in a field have no guaranteed
+        # order, but each non-empty field is guaranteed to have exactly one field with
+        # `metadata.primary` set to true.
+        # Corresponds to the JSON property `person`
+        # @return [Google::Apis::PeopleV1::Person]
+        attr_accessor :person
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @person = args[:person] if args.key?(:person)
+        end
+      end
+      
       # A read-only G Suite Domain membership.
       class DomainMembership
         include Google::Apis::Core::Hashable
@@ -2101,6 +2124,88 @@ module Google
         end
       end
       
+      # A request to update an existing contact's photo.
+      # All requests must have a valid photo format: JPEG or PNG.
+      class UpdateContactPhotoRequest
+        include Google::Apis::Core::Hashable
+      
+        # **Optional.** Not specifying any fields will skip the post mutate read.
+        # A field mask to restrict which fields on the person are
+        # returned. Multiple fields can be specified by separating them with commas.
+        # Valid values are:
+        # * addresses
+        # * ageRanges
+        # * biographies
+        # * birthdays
+        # * braggingRights
+        # * coverPhotos
+        # * emailAddresses
+        # * events
+        # * genders
+        # * imClients
+        # * interests
+        # * locales
+        # * memberships
+        # * metadata
+        # * names
+        # * nicknames
+        # * occupations
+        # * organizations
+        # * phoneNumbers
+        # * photos
+        # * relations
+        # * relationshipInterests
+        # * relationshipStatuses
+        # * residences
+        # * sipAddresses
+        # * skills
+        # * taglines
+        # * urls
+        # * userDefined
+        # Corresponds to the JSON property `personFields`
+        # @return [String]
+        attr_accessor :person_fields
+      
+        # Raw photo bytes
+        # Corresponds to the JSON property `photoBytes`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :photo_bytes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @person_fields = args[:person_fields] if args.key?(:person_fields)
+          @photo_bytes = args[:photo_bytes] if args.key?(:photo_bytes)
+        end
+      end
+      
+      # The response for updating a contact's photo.
+      class UpdateContactPhotoResponse
+        include Google::Apis::Core::Hashable
+      
+        # Information about a person merged from various data sources such as the
+        # authenticated user's contacts and profile data.
+        # Most fields can have multiple items. The items in a field have no guaranteed
+        # order, but each non-empty field is guaranteed to have exactly one field with
+        # `metadata.primary` set to true.
+        # Corresponds to the JSON property `person`
+        # @return [Google::Apis::PeopleV1::Person]
+        attr_accessor :person
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @person = args[:person] if args.key?(:person)
+        end
+      end
+      
       # A person's associated URLs.
       class Url
         include Google::Apis::Core::Hashable

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

@@ -100,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DeleteContactPhotoResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DomainMembership
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -310,6 +316,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpdateContactPhotoRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UpdateContactPhotoResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Url
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -457,6 +475,14 @@ module Google
         end
       end
       
+      class DeleteContactPhotoResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :person, as: 'person', class: Google::Apis::PeopleV1::Person, decorator: Google::Apis::PeopleV1::Person::Representation
+      
+        end
+      end
+      
       class DomainMembership
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -886,6 +912,22 @@ module Google
         end
       end
       
+      class UpdateContactPhotoRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :person_fields, as: 'personFields'
+          property :photo_bytes, :base64 => true, as: 'photoBytes'
+        end
+      end
+      
+      class UpdateContactPhotoResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :person, as: 'person', class: Google::Apis::PeopleV1::Person, decorator: Google::Apis::PeopleV1::Person::Representation
+      
+        end
+      end
+      
       class Url
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -354,6 +354,71 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Delete a contact's photo.
+        # @param [String] resource_name
+        #   The resource name of the contact whose photo will be deleted.
+        # @param [String] person_fields
+        #   **Optional.** Not specifying any fields will skip the post mutate read.
+        #   A field mask to restrict which fields on the person are
+        #   returned. Multiple fields can be specified by separating them with commas.
+        #   Valid values are:
+        #   * addresses
+        #   * ageRanges
+        #   * biographies
+        #   * birthdays
+        #   * braggingRights
+        #   * coverPhotos
+        #   * emailAddresses
+        #   * events
+        #   * genders
+        #   * imClients
+        #   * interests
+        #   * locales
+        #   * memberships
+        #   * metadata
+        #   * names
+        #   * nicknames
+        #   * occupations
+        #   * organizations
+        #   * phoneNumbers
+        #   * photos
+        #   * relations
+        #   * relationshipInterests
+        #   * relationshipStatuses
+        #   * residences
+        #   * sipAddresses
+        #   * skills
+        #   * taglines
+        #   * urls
+        #   * userDefined
+        # @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::DeleteContactPhotoResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PeopleV1::DeleteContactPhotoResponse]
+        #
+        # @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)
+          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['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Provides information about a person by specifying a resource name. Use
         # `people/me` to indicate the authenticated user.
         # <br>
@@ -582,6 +647,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Update a contact's photo.
+        # @param [String] resource_name
+        #   Person resource name
+        # @param [Google::Apis::PeopleV1::UpdateContactPhotoRequest] update_contact_photo_request_object
+        # @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::UpdateContactPhotoResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PeopleV1::UpdateContactPhotoResponse]
+        #
+        # @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_photo(resource_name, update_contact_photo_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+resourceName}:updateContactPhoto', options)
+          command.request_representation = Google::Apis::PeopleV1::UpdateContactPhotoRequest::Representation
+          command.request_object = update_contact_photo_request_object
+          command.response_representation = Google::Apis::PeopleV1::UpdateContactPhotoResponse::Representation
+          command.response_class = Google::Apis::PeopleV1::UpdateContactPhotoResponse
+          command.params['resourceName'] = resource_name unless resource_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Provides a list of the authenticated user's contacts merged with any
         # connected profiles.
         # <br>