google-api-client 0.36.0 → 0.37.0

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

@@ -305,7 +305,7 @@ module Google
         attr_accessor :name
       
         # The resource name for the contact group, assigned by the server. An ASCII
-        # string, in the form of `contactGroups/`<var>contact_group_id</var>.
+        # string, in the form of `contactGroups/`contact_group_id``.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
@@ -337,7 +337,7 @@ module Google
         attr_accessor :contact_group_id
       
         # The resource name for the contact group, assigned by the server. An ASCII
-        # string, in the form of `contactGroups/`<var>contact_group_id</var>.
+        # string, in the form of `contactGroups/`contact_group_id``.
         # Only contact_group_resource_name can be used for modifying memberships.
         # Any contact group membership can be removed, but only user group or
         # "myContacts" or "starred" system groups memberships can be added. A
@@ -749,7 +749,7 @@ module Google
         end
       end
       
-      # 
+      # The response to a get request for a list of people by resource name.
       class GetPeopleResponse
         include Google::Apis::Core::Hashable
       
@@ -858,7 +858,7 @@ module Google
         end
       end
       
-      # 
+      # The response to a request for the authenticated user's connections.
       class ListConnectionsResponse
         include Google::Apis::Core::Hashable
       
@@ -1004,14 +1004,14 @@ module Google
       class ModifyContactGroupMembersRequest
         include Google::Apis::Core::Hashable
       
-        # The resource names of the contact people to add in the form of
-        # `people/`<var>person_id</var>.
+        # Optional. The resource names of the contact people to add in the form of
+        # `people/`person_id``.
         # Corresponds to the JSON property `resourceNamesToAdd`
         # @return [Array<String>]
         attr_accessor :resource_names_to_add
       
-        # The resource names of the contact people to remove in the form of
-        # `people/`<var>person_id</var>.
+        # Optional. The resource names of the contact people to remove in the form of
+        # `people/`person_id``.
         # Corresponds to the JSON property `resourceNamesToRemove`
         # @return [Array<String>]
         attr_accessor :resource_names_to_remove
@@ -1342,7 +1342,7 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Address>]
         attr_accessor :addresses
       
-        # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)**
+        # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
         # The person's age range.
         # Corresponds to the JSON property `ageRange`
         # @return [String]
@@ -1471,7 +1471,7 @@ module Google
       
         # The resource name for the person, assigned by the server. An ASCII string
         # with a max length of 27 characters, in the form of
-        # `people/`<var>person_id</var>.
+        # `people/`person_id``.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
@@ -1724,9 +1724,10 @@ module Google
         attr_accessor :metadata
       
         # The URL of the photo. You can change the desired size by appending a query
-        # parameter `sz=`<var>size</var> at the end of the url. Example:
-        # `https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/
-        # 00gzXvDBYqw/s100/photo.jpg?sz=50`
+        # parameter `sz=`size`` at the end of the url, where `size` is the size in
+        # pixels. Example:
+        # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/
+        # 00gzXvDBYqw/s100/photo.jpg?sz=50
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url

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

@@ -190,11 +190,11 @@ module Google
         #   1 and
         #   1000, inclusive. Defaults to 30 if not set or set to 0.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous call to
+        #   Optional. The next_page_token value returned from a previous call to
         #   [ListContactGroups](/people/api/rest/v1/contactgroups/list).
         #   Requests the next page of resources.
         # @param [String] sync_token
-        #   A sync token, returned by a previous call to `contactgroups.list`.
+        #   Optional. A sync token, returned by a previous call to `contactgroups.list`.
         #   Only resources changed since the sync token was created will be returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -229,7 +229,7 @@ module Google
         # user.
         # @param [String] resource_name
         #   The resource name for the contact group, assigned by the server. An ASCII
-        #   string, in the form of `contactGroups/`<var>contact_group_id</var>.
+        #   string, in the form of `contactGroups/`contact_group_id``.
         # @param [Google::Apis::PeopleV1::UpdateContactGroupRequest] update_contact_group_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -261,7 +261,6 @@ module Google
         end
         
         # Modify the members of a contact group owned by the authenticated user.
-        # <br>
         # The only system contact groups that can have members added are
         # `contactGroups/myContacts` and `contactGroups/starred`. Other system
         # contact groups are deprecated and can only have contacts removed.
@@ -424,13 +423,12 @@ module Google
         
         # Provides information about a person by specifying a resource name. Use
         # `people/me` to indicate the authenticated user.
-        # <br>
         # The request throws a 400 error if 'personFields' is not specified.
         # @param [String] resource_name
         #   Required. The resource name of the person to provide information about.
         #   - To get information about the authenticated user, specify `people/me`.
         #   - To get information about a google account, specify
-        #   `people/`<var>account_id</var>.
+        #   `people/`account_id``.
         #   - To get information about a contact, specify the resource name that
         #   identifies the contact as returned by
         #   [`people.connections.list`](/people/api/rest/v1/people.connections/list).
@@ -504,7 +502,6 @@ module Google
         # Provides information about a list of specific people by specifying a list
         # of requested resource names. Use `people/me` to indicate the authenticated
         # user.
-        # <br>
         # The request throws a 400 error if 'personFields' is not specified.
         # @param [String] person_fields
         #   Required. A field mask to restrict which fields on each person are returned.
@@ -548,7 +545,7 @@ module Google
         #   Required. The resource names of the people to provide information about.
         #   - To get information about the authenticated user, specify `people/me`.
         #   - To get information about a google account, specify
-        #   `people/`<var>account_id</var>.
+        #   `people/`account_id``.
         #   - To get information about a contact, specify the resource name that
         #   identifies the contact as returned by
         #   [`people.connections.list`](/people/api/rest/v1/people.connections/list).
@@ -585,10 +582,8 @@ module Google
         # Update contact data for an existing contact person. Any non-contact data
         # will not be modified.
         # The request throws a 400 error if `updatePersonFields` is not specified.
-        # <br>
         # The request throws a 400 error if `person.metadata.sources` is not
         # specified for the contact to be updated.
-        # <br>
         # The request throws a 400 error with an error with reason
         # `"failedPrecondition"` if `person.metadata.sources.etag` is different than
         # the contact's etag, which indicates the contact has changed since its data
@@ -597,7 +592,7 @@ module Google
         # @param [String] resource_name
         #   The resource name for the person, assigned by the server. An ASCII string
         #   with a max length of 27 characters, in the form of
-        #   `people/`<var>person_id</var>.
+        #   `people/`person_id``.
         # @param [Google::Apis::PeopleV1::Person] person_object
         # @param [String] update_person_fields
         #   Required. A field mask to restrict which fields on the person are updated.
@@ -689,7 +684,6 @@ module Google
         
         # Provides a list of the authenticated user's contacts merged with any
         # connected profiles.
-        # <br>
         # The request throws a 400 error if 'personFields' is not specified.
         # @param [String] resource_name
         #   Required. The resource name to return connections for. Only `people/me` is
@@ -699,7 +693,7 @@ module Google
         #   are
         #   between 1 and 2000, inclusive. Defaults to 100 if not set or set to 0.
         # @param [String] page_token
-        #   The token of the page to be returned.
+        #   Optional. The token of the page to be returned.
         # @param [String] person_fields
         #   Required. A field mask to restrict which fields on each person are returned.
         #   Multiple
@@ -739,15 +733,17 @@ module Google
         #   path should start with `person.`: for example, `person.names` or
         #   `person.photos`.
         # @param [Boolean] request_sync_token
-        #   Whether the response should include a sync token, which can be used to get
+        #   Optional. Whether the response should include a 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] sort_order
-        #   The order in which the connections should be sorted. Defaults to
+        #   Optional. The order in which the connections should be sorted. Defaults to
         #   `LAST_MODIFIED_ASCENDING`.
         # @param [String] sync_token
-        #   A sync token returned by a previous call to `people.connections.list`.
+        #   Optional. A sync token returned by a previous call to `people.connections.list`
+        #   .
         #   Only resources changed since the sync token was created will be returned.
         #   Sync requests that specify `sync_token` have an additional rate limit.
         # @param [String] fields

data/generated/google/apis/people_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/people/
     module PeopleV1
       VERSION = 'V1'
-      REVISION = '20191030'
+      REVISION = '20200212'
 
       # See, edit, download, and permanently delete your contacts
       AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts'
@@ -42,6 +42,9 @@ module Google
       # View your email addresses
       AUTH_USER_EMAILS_READ = 'https://www.googleapis.com/auth/user.emails.read'
 
+      # See your education, work history and org info
+      AUTH_USER_ORGANIZATION_READ = 'https://www.googleapis.com/auth/user.organization.read'
+
       # View your phone numbers
       AUTH_USER_PHONENUMBERS_READ = 'https://www.googleapis.com/auth/user.phonenumbers.read'