Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132372111.9 KB
people

Create a new contact and return the person resource for that contact. The request returns a 400 error if more than one field is specified on a field that is a singleton for contact sources: * biographies * birthdays * genders * names Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.

post/v1/people:createContact

Query parameters

personFieldsstring

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 * calendarUrls * clientData * coverPhotos * emailAddresses * events * externalIds * genders * imClients * interests * locales * locations * memberships * metadata * miscKeywords * names * nicknames * occupations * organizations * phoneNumbers * photos * relations * sipAddresses * skills * urls * userDefined

sourcesstring[]

Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.

Request body

ageRange'AGE_RANGE_UNSPECIFIED' | 'LESS_THAN_EIGHTEEN' | 'EIGHTEEN_TO_TWENTY' | 'TWENTY_ONE_OR_OLDER'

Output only. DEPRECATED (Please use person.ageRanges instead) The person's age range.

etagstring

The HTTP entity tag of the resource. Used for web cache validation.

resourceNamestring

The resource name for the person, assigned by the server. An ASCII string in the form of people/{person_id}.

Response

Successful response