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

Link to this function people_people_connections_list(connection, people_id, opts \\ []) View Source
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

Link to this function people_people_create_contact(connection, opts \\ []) View Source
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

Link to this function people_people_delete_contact(connection, people_id, opts \\ []) View Source
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

Link to this function people_people_get(connection, people_id, opts \\ []) View Source
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

Link to this function people_people_get_batch_get(connection, opts \\ []) View Source
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

Link to this function people_people_update_contact(connection, people_id, opts \\ []) View Source
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