google_api_people v0.0.1 GoogleApi.People.V1.Api.People View Source
API calls for all endpoints tagged People
.
Link to this section Summary
Functions
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
Create a new contact and return the person resource for that contact
Delete a contact person. Any non-contact data will not be deleted
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
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
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 412 error if `person.metadata.sources.etag` is different than the contact's etag, which indicates the contact has changed since its data was read. Clients should get the latest person and re-apply their updates to the latest person
Link to this section Functions
people_people_connections_list(Tesla.Env.client, String.t, keyword) :: {:ok, GoogleApi.People.V1.Model.ListConnectionsResponse.t} | {:error, Tesla.Env.t}
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.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
- people_id (String): Part of `resourceName`. The resource name to return connections for. Only `people/me` is valid.
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
- :request_sync_token (Boolean): Whether the response should include a sync token, which can be used to get all changes since the last request.
- :page_token (String): The token of the page to be returned.
- :request_mask/include_field (String): Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.photos`.
- :page_size (Integer): The number of connections to include in the response. Valid values are between 1 and 2000, inclusive. Defaults to 100.
- :sync_token (String): A sync token, returned by a previous call to `people.connections.list`. Only resources changed since the sync token was created will be returned.
- :person_fields (String): Required. A field mask to restrict which fields on each person are returned. 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 skills taglines * urls
- :sort_order (String): The order in which the connections should be sorted. Defaults to `LAST_MODIFIED_ASCENDING`.
Returns
{:ok, %GoogleApi.People.V1.Model.ListConnectionsResponse{}} on success {:error, info} on failure
people_people_create_contact(Tesla.Env.client, keyword) :: {:ok, GoogleApi.People.V1.Model.Person.t} | {:error, Tesla.Env.t}
Create a new contact and return the person resource for that contact.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
- :parent (String): The resource name of the owning person resource.
- :body (Person):
Returns
{:ok, %GoogleApi.People.V1.Model.Person{}} on success {:error, info} on failure
people_people_delete_contact(Tesla.Env.client, String.t, keyword) :: {:ok, GoogleApi.People.V1.Model.Empty.t} | {:error, Tesla.Env.t}
Delete a contact person. Any non-contact data will not be deleted.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
- people_id (String): Part of `resourceName`. The resource name of the contact to delete.
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
Returns
{:ok, %GoogleApi.People.V1.Model.Empty{}} on success {:error, info} on failure
people_people_get(Tesla.Env.client, String.t, keyword) :: {:ok, GoogleApi.People.V1.Model.Person.t} | {:error, Tesla.Env.t}
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.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
- people_id (String): Part of `resourceName`. 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>. - To get information about a contact, specify the resource name that identifies the contact as returned by `people.connections.list`.
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
- :person_fields (String): Required. A field mask to restrict which fields on the person are returned. 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 skills taglines * urls
- :request_mask/include_field (String): Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.photos`.
Returns
{:ok, %GoogleApi.People.V1.Model.Person{}} on success {:error, info} on failure
people_people_get_batch_get(Tesla.Env.client, keyword) :: {:ok, GoogleApi.People.V1.Model.GetPeopleResponse.t} | {:error, Tesla.Env.t}
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.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
- :request_mask/include_field (String): Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.photos`.
- :resource_names (List[String]): 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>. - To get information about a contact, specify the resource name that identifies the contact as returned by `people.connections.list`. You can include up to 50 resource names in one request.
- :person_fields (String): Required. A field mask to restrict which fields on each person are returned. 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 skills taglines * urls
Returns
{:ok, %GoogleApi.People.V1.Model.GetPeopleResponse{}} on success {:error, info} on failure
people_people_update_contact(Tesla.Env.client, String.t, keyword) :: {:ok, GoogleApi.People.V1.Model.Person.t} | {:error, Tesla.Env.t}
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 412 error if `person.metadata.sources.etag` is different than the contact's etag, which indicates the contact has changed since its data was read. Clients should get the latest person and re-apply their updates to the latest person.
Parameters
- connection (GoogleApi.People.V1.Connection): Connection to server
- people_id (String): Part of `person.resourceName`. 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>.
opts (KeywordList): [optional] Optional parameters
- :pp (Boolean): Pretty-print response.
- :oauth_token (String): OAuth 2.0 token for the current user.
- :bearer_token (String): OAuth bearer token.
- :upload_protocol (String): Upload protocol for media (e.g. "raw", "multipart").
- :pretty_print (Boolean): Returns response with indentations and line breaks.
- :upload_type (String): Legacy upload protocol for media (e.g. "media", "multipart").
- :fields (String): Selector specifying which fields to include in a partial response.
- :__/xgafv (String): V1 error format.
- :callback (String): JSONP
- :alt (String): Data format for response.
- :key (String): API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- :access_token (String): OAuth access token.
- :quota_user (String): 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.
- :update_person_fields (String): Required. A field mask to restrict which fields on the person are updated. Valid values are: addresses biographies birthdays braggingRights emailAddresses events genders imClients interests locales names nicknames occupations organizations phoneNumbers relations residences skills * urls
- :body (Person):
Returns
{:ok, %GoogleApi.People.V1.Model.Person{}} on success {:error, info} on failure