DefinitelyTyped/types/gapi.client.people/index.d.ts

// Type definitions for non-npm package People API v1 1.0
// Project: https://developers.google.com/people/
// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
// TypeScript Version: 2.8

// IMPORTANT
// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
// Generated from: https://people.googleapis.com/$discovery/rest?version=v1
// Revision: 20200318

/// <reference types="gapi.client" />

declare namespace gapi.client {
    /** Load People API v1 */
    function load(name: "people", version: "v1"): PromiseLike<void>;
    function load(name: "people", version: "v1", callback: () => any): void;

    namespace people {
        interface Address {
            /** The city of the address. */
            city?: string;
            /** The country of the address. */
            country?: string;
            /**
             * The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
             * code of the address.
             */
            countryCode?: string;
            /** The extended address of the address; for example, the apartment number. */
            extendedAddress?: string;
            /**
             * Output only. The type of the address translated and formatted in the viewer's
             * account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /**
             * The unstructured value of the address. If this is not set by the user it
             * will be automatically constructed from structured values.
             */
            formattedValue?: string;
            /** Metadata about the address. */
            metadata?: FieldMetadata;
            /** The P.O. box of the address. */
            poBox?: string;
            /** The postal code of the address. */
            postalCode?: string;
            /** The region of the address; for example, the state or province. */
            region?: string;
            /** The street address. */
            streetAddress?: string;
            /**
             * The type of the address. The type can be custom or one of these predefined
             * values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `other`
             */
            type?: string;
        }
        interface AgeRangeType {
            /** The age range. */
            ageRange?: string;
            /** Metadata about the age range. */
            metadata?: FieldMetadata;
        }
        interface BatchGetContactGroupsResponse {
            /** The list of responses for each requested contact group resource. */
            responses?: ContactGroupResponse[];
        }
        interface Biography {
            /** The content type of the biography. */
            contentType?: string;
            /** Metadata about the biography. */
            metadata?: FieldMetadata;
            /** The short biography. */
            value?: string;
        }
        interface Birthday {
            /** The date of the birthday. */
            date?: Date;
            /** Metadata about the birthday. */
            metadata?: FieldMetadata;
            /** A free-form string representing the user's birthday. */
            text?: string;
        }
        interface BraggingRights {
            /** Metadata about the bragging rights. */
            metadata?: FieldMetadata;
            /** The bragging rights; for example, `climbed mount everest`. */
            value?: string;
        }
        interface ContactGroup {
            /**
             * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
             * resource. Used for web cache validation.
             */
            etag?: string;
            /**
             * Output only. The name translated and formatted in the viewer's account locale
             * or the `Accept-Language` HTTP header locale for system groups names.
             * Group names set by the owner are the same as name.
             */
            formattedName?: string;
            /** Output only. The contact group type. */
            groupType?: string;
            /**
             * Output only. The total number of contacts in the group irrespective of max members in
             * specified in the request.
             */
            memberCount?: number;
            /**
             * Output only. The list of contact person resource names that are members of the contact
             * group. The field is not populated for LIST requests and can only be updated
             * through the
             * [ModifyContactGroupMembers](/people/api/rest/v1/contactgroups/members/modify).
             */
            memberResourceNames?: string[];
            /** Output only. Metadata about the contact group. */
            metadata?: ContactGroupMetadata;
            /**
             * The contact group name set by the group owner or a system provided name
             * for system groups.
             */
            name?: string;
            /**
             * The resource name for the contact group, assigned by the server. An ASCII
             * string, in the form of `contactGroups/{contact_group_id}`.
             */
            resourceName?: string;
        }
        interface ContactGroupMembership {
            /** Output only. The contact group ID for the contact group membership. */
            contactGroupId?: string;
            /**
             * The resource name for the contact group, assigned by the server. An ASCII
             * 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
             * contact must always have at least one contact group membership.
             */
            contactGroupResourceName?: string;
        }
        interface ContactGroupMetadata {
            /**
             * Output only. True if the contact group resource has been deleted. Populated only for
             * [`ListContactGroups`](/people/api/rest/v1/contactgroups/list) requests
             * that include a sync token.
             */
            deleted?: boolean;
            /** Output only. The time the group was last updated. */
            updateTime?: string;
        }
        interface ContactGroupResponse {
            /** The contact group. */
            contactGroup?: ContactGroup;
            /** The original requested resource name. */
            requestedResourceName?: string;
            /** The status of the response. */
            status?: Status;
        }
        interface CoverPhoto {
            /**
             * True if the cover photo is the default cover photo;
             * false if the cover photo is a user-provided cover photo.
             */
            default?: boolean;
            /** Metadata about the cover photo. */
            metadata?: FieldMetadata;
            /** The URL of the cover photo. */
            url?: string;
        }
        interface CreateContactGroupRequest {
            /** Required. The contact group to create. */
            contactGroup?: ContactGroup;
        }
        interface Date {
            /**
             * Day of month. Must be from 1 to 31 and valid for the year and month, or 0
             * if specifying a year by itself or a year and month where the day is not
             * significant.
             */
            day?: number;
            /**
             * Month of year. Must be from 1 to 12, or 0 if specifying a year without a
             * month and day.
             */
            month?: number;
            /**
             * Year of date. Must be from 1 to 9999, or 0 if specifying a date without
             * a year.
             */
            year?: number;
        }
        interface DeleteContactPhotoResponse {
            /**
             * The updated person, if person_fields is set in the
             * DeleteContactPhotoRequest; otherwise this will be unset.
             */
            person?: Person;
        }
        interface DomainMembership {
            /** True if the person is in the viewer's G Suite domain. */
            inViewerDomain?: boolean;
        }
        interface EmailAddress {
            /** The display name of the email. */
            displayName?: string;
            /**
             * Output only. The type of the email address translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the email address. */
            metadata?: FieldMetadata;
            /**
             * The type of the email address. The type can be custom or one of these
             * predefined values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `other`
             */
            type?: string;
            /** The email address. */
            value?: string;
        }
        // tslint:disable-next-line:no-empty-interface
        interface Empty {
        }
        interface Event {
            /** The date of the event. */
            date?: Date;
            /**
             * Output only. The type of the event translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the event. */
            metadata?: FieldMetadata;
            /**
             * The type of the event. The type can be custom or one of these predefined
             * values:
             *
             * &#42; `anniversary`
             * &#42; `other`
             */
            type?: string;
        }
        interface FieldMetadata {
            /**
             * True if the field is the primary field; false if the field is a secondary
             * field.
             */
            primary?: boolean;
            /** The source of the field. */
            source?: Source;
            /**
             * Output only. True if the field is verified; false if the field is unverified. A
             * verified field is typically a name, email address, phone number, or
             * website that has been confirmed to be owned by the person.
             */
            verified?: boolean;
        }
        interface Gender {
            /**
             * Output only. The value of the gender translated and formatted in the viewer's
             * account locale or the `Accept-Language` HTTP header locale.
             */
            formattedValue?: string;
            /** Metadata about the gender. */
            metadata?: FieldMetadata;
            /**
             * The gender for the person. The gender can be custom or one of these
             * predefined values:
             *
             * &#42; `male`
             * &#42; `female`
             * &#42; `other`
             * &#42; `unknown`
             */
            value?: string;
        }
        interface GetPeopleResponse {
            /** The response for each requested resource name. */
            responses?: PersonResponse[];
        }
        interface ImClient {
            /**
             * Output only. The protocol of the IM client formatted in the viewer's account
             * locale or the `Accept-Language` HTTP header locale.
             */
            formattedProtocol?: string;
            /**
             * Output only. The type of the IM client translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the IM client. */
            metadata?: FieldMetadata;
            /**
             * The protocol of the IM client. The protocol can be custom or one of these
             * predefined values:
             *
             * &#42; `aim`
             * &#42; `msn`
             * &#42; `yahoo`
             * &#42; `skype`
             * &#42; `qq`
             * &#42; `googleTalk`
             * &#42; `icq`
             * &#42; `jabber`
             * &#42; `netMeeting`
             */
            protocol?: string;
            /**
             * The type of the IM client. The type can be custom or one of these
             * predefined values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `other`
             */
            type?: string;
            /** The user name used in the IM client. */
            username?: string;
        }
        interface Interest {
            /** Metadata about the interest. */
            metadata?: FieldMetadata;
            /** The interest; for example, `stargazing`. */
            value?: string;
        }
        interface ListConnectionsResponse {
            /** The list of people that the requestor is connected to. */
            connections?: Person[];
            /**
             * A token, which can be sent as `page_token` to retrieve the next page.
             * If this field is omitted, there are no subsequent pages.
             */
            nextPageToken?: string;
            /**
             * A token, which can be sent as `sync_token` to retrieve changes since the
             * last request. Request must set `request_sync_token` to return the sync
             * token.
             */
            nextSyncToken?: string;
            /** The total number of items in the list without pagination. */
            totalItems?: number;
            /**
             * &#42;&#42;DEPRECATED&#42;&#42; (Please use totalItems)
             * The total number of people in the list without pagination.
             */
            totalPeople?: number;
        }
        interface ListContactGroupsResponse {
            /**
             * The list of contact groups. Members of the contact groups are not
             * populated.
             */
            contactGroups?: ContactGroup[];
            /** The token that can be used to retrieve the next page of results. */
            nextPageToken?: string;
            /** The token that can be used to retrieve changes since the last request. */
            nextSyncToken?: string;
            /** The total number of items in the list without pagination. */
            totalItems?: number;
        }
        interface Locale {
            /** Metadata about the locale. */
            metadata?: FieldMetadata;
            /**
             * The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
             * language tag representing the locale.
             */
            value?: string;
        }
        interface Membership {
            /** The contact group membership. */
            contactGroupMembership?: ContactGroupMembership;
            /** Output only. The domain membership. */
            domainMembership?: DomainMembership;
            /** Metadata about the membership. */
            metadata?: FieldMetadata;
        }
        interface ModifyContactGroupMembersRequest {
            /**
             * Optional. The resource names of the contact people to add in the form of
             * `people/{person_id}`.
             */
            resourceNamesToAdd?: string[];
            /**
             * Optional. The resource names of the contact people to remove in the form of
             * `people/{person_id}`.
             */
            resourceNamesToRemove?: string[];
        }
        interface ModifyContactGroupMembersResponse {
            /**
             * The contact people resource names that cannot be removed from their
             * last contact group.
             */
            canNotRemoveLastContactGroupResourceNames?: string[];
            /** The contact people resource names that were not found. */
            notFoundResourceNames?: string[];
        }
        interface Name {
            /**
             * Output only. The display name formatted according to the locale specified by
             * the viewer's account or the `Accept-Language` HTTP header.
             */
            displayName?: string;
            /**
             * Output only. The display name with the last name first formatted according to
             * the locale specified by the viewer's account or the
             * `Accept-Language` HTTP header.
             */
            displayNameLastFirst?: string;
            /** The family name. */
            familyName?: string;
            /** The given name. */
            givenName?: string;
            /** The honorific prefixes, such as `Mrs.` or `Dr.` */
            honorificPrefix?: string;
            /** The honorific suffixes, such as `Jr.` */
            honorificSuffix?: string;
            /** Metadata about the name. */
            metadata?: FieldMetadata;
            /** The middle name(s). */
            middleName?: string;
            /** The family name spelled as it sounds. */
            phoneticFamilyName?: string;
            /** The full name spelled as it sounds. */
            phoneticFullName?: string;
            /** The given name spelled as it sounds. */
            phoneticGivenName?: string;
            /** The honorific prefixes spelled as they sound. */
            phoneticHonorificPrefix?: string;
            /** The honorific suffixes spelled as they sound. */
            phoneticHonorificSuffix?: string;
            /** The middle name(s) spelled as they sound. */
            phoneticMiddleName?: string;
        }
        interface Nickname {
            /** Metadata about the nickname. */
            metadata?: FieldMetadata;
            /** The type of the nickname. */
            type?: string;
            /** The nickname. */
            value?: string;
        }
        interface Occupation {
            /** Metadata about the occupation. */
            metadata?: FieldMetadata;
            /** The occupation; for example, `carpenter`. */
            value?: string;
        }
        interface Organization {
            /**
             * True if the organization is the person's current organization;
             * false if the organization is a past organization.
             */
            current?: boolean;
            /** The person's department at the organization. */
            department?: string;
            /**
             * The domain name associated with the organization; for example,
             * `google.com`.
             */
            domain?: string;
            /** The end date when the person left the organization. */
            endDate?: Date;
            /**
             * Output only. The type of the organization translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** The person's job description at the organization. */
            jobDescription?: string;
            /** The location of the organization office the person works at. */
            location?: string;
            /** Metadata about the organization. */
            metadata?: FieldMetadata;
            /** The name of the organization. */
            name?: string;
            /** The phonetic name of the organization. */
            phoneticName?: string;
            /** The start date when the person joined the organization. */
            startDate?: Date;
            /**
             * The symbol associated with the organization; for example, a stock ticker
             * symbol, abbreviation, or acronym.
             */
            symbol?: string;
            /** The person's job title at the organization. */
            title?: string;
            /**
             * The type of the organization. The type can be custom or  one of these
             * predefined values:
             *
             * &#42; `work`
             * &#42; `school`
             */
            type?: string;
        }
        interface Person {
            /** The person's street addresses. */
            addresses?: Address[];
            /**
             * Output only. &#42;&#42;DEPRECATED&#42;&#42; (Please use `person.ageRanges` instead)
             *
             * The person's age range.
             */
            ageRange?: string;
            /** Output only. The person's age ranges. */
            ageRanges?: AgeRangeType[];
            /** The person's biographies. */
            biographies?: Biography[];
            /** The person's birthdays. */
            birthdays?: Birthday[];
            /** The person's bragging rights. */
            braggingRights?: BraggingRights[];
            /** Output only. The person's cover photos. */
            coverPhotos?: CoverPhoto[];
            /** The person's email addresses. */
            emailAddresses?: EmailAddress[];
            /**
             * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
             * resource. Used for web cache validation.
             */
            etag?: string;
            /** The person's events. */
            events?: Event[];
            /** The person's genders. */
            genders?: Gender[];
            /** The person's instant messaging clients. */
            imClients?: ImClient[];
            /** The person's interests. */
            interests?: Interest[];
            /** The person's locale preferences. */
            locales?: Locale[];
            /** The person's group memberships. */
            memberships?: Membership[];
            /** Output only. Metadata about the person. */
            metadata?: PersonMetadata;
            /** The person's names. */
            names?: Name[];
            /** The person's nicknames. */
            nicknames?: Nickname[];
            /** The person's occupations. */
            occupations?: Occupation[];
            /** The person's past or current organizations. */
            organizations?: Organization[];
            /** The person's phone numbers. */
            phoneNumbers?: PhoneNumber[];
            /** Output only. The person's photos. */
            photos?: Photo[];
            /** The person's relations. */
            relations?: Relation[];
            /** Output only. The person's relationship interests. */
            relationshipInterests?: RelationshipInterest[];
            /** Output only. The person's relationship statuses. */
            relationshipStatuses?: RelationshipStatus[];
            /** The person's residences. */
            residences?: Residence[];
            /**
             * 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/{person_id}`.
             */
            resourceName?: string;
            /** The person's SIP addresses. */
            sipAddresses?: SipAddress[];
            /** The person's skills. */
            skills?: Skill[];
            /** Output only. The person's taglines. */
            taglines?: Tagline[];
            /** The person's associated URLs. */
            urls?: Url[];
            /** The person's user defined data. */
            userDefined?: UserDefined[];
        }
        interface PersonMetadata {
            /**
             * Output only. True if the person resource has been deleted. Populated only for
             * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
             * that include a sync token.
             */
            deleted?: boolean;
            /** Output only. Resource names of people linked to this resource. */
            linkedPeopleResourceNames?: string[];
            /**
             * Output only. &#42;&#42;DEPRECATED&#42;&#42; (Please use
             * `person.metadata.sources.profileMetadata.objectType` instead)
             *
             * The type of the person object.
             */
            objectType?: string;
            /**
             * Output only. Any former resource names this person has had. Populated only for
             * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
             * that include a sync token.
             *
             * The resource name may change when adding or removing fields that link a
             * contact and profile such as a verified email, verified phone number, or
             * profile URL.
             */
            previousResourceNames?: string[];
            /** The sources of data for the person. */
            sources?: Source[];
        }
        interface PersonResponse {
            /**
             * &#42;&#42;DEPRECATED&#42;&#42; (Please use status instead)
             *
             * [HTTP 1.1 status code]
             * (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
             */
            httpStatusCode?: number;
            /** The person. */
            person?: Person;
            /**
             * The original requested resource name. May be different than the resource
             * name on the returned person.
             *
             * The resource name can change when adding or removing fields that link a
             * contact and profile such as a verified email, verified phone number, or a
             * profile URL.
             */
            requestedResourceName?: string;
            /** The status of the response. */
            status?: Status;
        }
        interface PhoneNumber {
            /**
             * Output only. The canonicalized [ITU-T
             * E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
             * form of the phone number.
             */
            canonicalForm?: string;
            /**
             * Output only. The type of the phone number translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the phone number. */
            metadata?: FieldMetadata;
            /**
             * The type of the phone number. The type can be custom or one of these
             * predefined values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `mobile`
             * &#42; `homeFax`
             * &#42; `workFax`
             * &#42; `otherFax`
             * &#42; `pager`
             * &#42; `workMobile`
             * &#42; `workPager`
             * &#42; `main`
             * &#42; `googleVoice`
             * &#42; `other`
             */
            type?: string;
            /** The phone number. */
            value?: string;
        }
        interface Photo {
            /**
             * True if the photo is a default photo;
             * false if the photo is a user-provided photo.
             */
            default?: boolean;
            /** Metadata about the photo. */
            metadata?: FieldMetadata;
            /**
             * The URL of the photo. You can change the desired size by appending a query
             * 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
             */
            url?: string;
        }
        interface ProfileMetadata {
            /** Output only. The profile object type. */
            objectType?: string;
            /** Output only. The user types. */
            userTypes?: string[];
        }
        interface Relation {
            /**
             * Output only. The type of the relation translated and formatted in the viewer's
             * account locale or the locale specified in the Accept-Language HTTP header.
             */
            formattedType?: string;
            /** Metadata about the relation. */
            metadata?: FieldMetadata;
            /** The name of the other person this relation refers to. */
            person?: string;
            /**
             * The person's relation to the other person. The type can be custom or one of
             * these predefined values:
             *
             * &#42; `spouse`
             * &#42; `child`
             * &#42; `mother`
             * &#42; `father`
             * &#42; `parent`
             * &#42; `brother`
             * &#42; `sister`
             * &#42; `friend`
             * &#42; `relative`
             * &#42; `domesticPartner`
             * &#42; `manager`
             * &#42; `assistant`
             * &#42; `referredBy`
             * &#42; `partner`
             */
            type?: string;
        }
        interface RelationshipInterest {
            /**
             * Output only. The value of the relationship interest translated and formatted
             * in the viewer's account locale or the locale specified in the
             * Accept-Language HTTP header.
             */
            formattedValue?: string;
            /** Metadata about the relationship interest. */
            metadata?: FieldMetadata;
            /**
             * The kind of relationship the person is looking for. The value can be custom
             * or one of these predefined values:
             *
             * &#42; `friend`
             * &#42; `date`
             * &#42; `relationship`
             * &#42; `networking`
             */
            value?: string;
        }
        interface RelationshipStatus {
            /**
             * Output only. The value of the relationship status translated and formatted in
             * the viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedValue?: string;
            /** Metadata about the relationship status. */
            metadata?: FieldMetadata;
            /**
             * The relationship status. The value can be custom or one of these
             * predefined values:
             *
             * &#42; `single`
             * &#42; `inARelationship`
             * &#42; `engaged`
             * &#42; `married`
             * &#42; `itsComplicated`
             * &#42; `openRelationship`
             * &#42; `widowed`
             * &#42; `inDomesticPartnership`
             * &#42; `inCivilUnion`
             */
            value?: string;
        }
        interface Residence {
            /**
             * True if the residence is the person's current residence;
             * false if the residence is a past residence.
             */
            current?: boolean;
            /** Metadata about the residence. */
            metadata?: FieldMetadata;
            /** The address of the residence. */
            value?: string;
        }
        interface SipAddress {
            /**
             * Output only. The type of the SIP address translated and formatted in the
             * viewer's account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the SIP address. */
            metadata?: FieldMetadata;
            /**
             * The type of the SIP address. The type can be custom or or one of these
             * predefined values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `mobile`
             * &#42; `other`
             */
            type?: string;
            /**
             * The SIP address in the
             * [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
             * format.
             */
            value?: string;
        }
        interface Skill {
            /** Metadata about the skill. */
            metadata?: FieldMetadata;
            /** The skill; for example, `underwater basket weaving`. */
            value?: string;
        }
        interface Source {
            /**
             * &#42;&#42;Only populated in `person.metadata.sources`.&#42;&#42;
             *
             * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
             * source. Used for web cache validation.
             */
            etag?: string;
            /** The unique identifier within the source type generated by the server. */
            id?: string;
            /**
             * Output only. &#42;&#42;Only populated in `person.metadata.sources`.&#42;&#42;
             *
             * Metadata about a source of type PROFILE.
             */
            profileMetadata?: ProfileMetadata;
            /** The source type. */
            type?: string;
            /**
             * Output only. &#42;&#42;Only populated in `person.metadata.sources`.&#42;&#42;
             *
             * Last update timestamp of this source.
             */
            updateTime?: string;
        }
        interface Status {
            /** The status code, which should be an enum value of google.rpc.Code. */
            code?: number;
            /**
             * A list of messages that carry the error details.  There is a common set of
             * message types for APIs to use.
             */
            details?: Array<Record<string, any>>;
            /**
             * A developer-facing error message, which should be in English. Any
             * user-facing error message should be localized and sent in the
             * google.rpc.Status.details field, or localized by the client.
             */
            message?: string;
        }
        interface Tagline {
            /** Metadata about the tagline. */
            metadata?: FieldMetadata;
            /** The tagline. */
            value?: string;
        }
        interface UpdateContactGroupRequest {
            /** Required. The contact group to update. */
            contactGroup?: ContactGroup;
        }
        interface UpdateContactPhotoRequest {
            /**
             * Optional. A field mask to restrict which fields on the person are returned. Multiple
             * fields can be specified by separating them with commas. Defaults to empty
             * if not set, which will skip the post mutate get. Valid values are:
             *
             * &#42; addresses
             * &#42; ageRanges
             * &#42; biographies
             * &#42; birthdays
             * &#42; braggingRights
             * &#42; coverPhotos
             * &#42; emailAddresses
             * &#42; events
             * &#42; genders
             * &#42; imClients
             * &#42; interests
             * &#42; locales
             * &#42; memberships
             * &#42; metadata
             * &#42; names
             * &#42; nicknames
             * &#42; occupations
             * &#42; organizations
             * &#42; phoneNumbers
             * &#42; photos
             * &#42; relations
             * &#42; relationshipInterests
             * &#42; relationshipStatuses
             * &#42; residences
             * &#42; sipAddresses
             * &#42; skills
             * &#42; taglines
             * &#42; urls
             * &#42; userDefined
             */
            personFields?: string;
            /** Required. Raw photo bytes */
            photoBytes?: string;
        }
        interface UpdateContactPhotoResponse {
            /**
             * The updated person, if person_fields is set in the
             * UpdateContactPhotoRequest; otherwise this will be unset.
             */
            person?: Person;
        }
        interface Url {
            /**
             * Output only. The type of the URL translated and formatted in the viewer's
             * account locale or the `Accept-Language` HTTP header locale.
             */
            formattedType?: string;
            /** Metadata about the URL. */
            metadata?: FieldMetadata;
            /**
             * The type of the URL. The type can be custom or one of these predefined
             * values:
             *
             * &#42; `home`
             * &#42; `work`
             * &#42; `blog`
             * &#42; `profile`
             * &#42; `homePage`
             * &#42; `ftp`
             * &#42; `reservations`
             * &#42; `appInstallPage`: website for a Google+ application.
             * &#42; `other`
             */
            type?: string;
            /** The URL. */
            value?: string;
        }
        interface UserDefined {
            /** The end user specified key of the user defined data. */
            key?: string;
            /** Metadata about the user defined data. */
            metadata?: FieldMetadata;
            /** The end user specified value of the user defined data. */
            value?: string;
        }
        interface MembersResource {
            /**
             * Modify the members of a contact group owned by the authenticated user.
             *
             * 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.
             */
            modify(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact group to modify. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: ModifyContactGroupMembersRequest;
            }): Request<ModifyContactGroupMembersResponse>;
            modify(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact group to modify. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: ModifyContactGroupMembersRequest): Request<ModifyContactGroupMembersResponse>;
        }
        interface ContactGroupsResource {
            /**
             * Get a list of contact groups owned by the authenticated user by specifying
             * a list of contact group resource names.
             */
            batchGet(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /**
                 * Optional. Specifies the maximum number of members to return for each group. Defaults
                 * to 0 if not set, which will return zero members.
                 */
                maxMembers?: number;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource names of the contact groups to get. */
                resourceNames?: string | string[];
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<BatchGetContactGroupsResponse>;
            /** Create a new contact group owned by the authenticated user. */
            create(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: CreateContactGroupRequest;
            }): Request<ContactGroup>;
            create(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: CreateContactGroupRequest): Request<ContactGroup>;
            /**
             * Delete an existing contact group owned by the authenticated user by
             * specifying a contact group resource name.
             */
            delete(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Optional. Set to true to also delete the contacts in the specified group. */
                deleteContacts?: boolean;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact group to delete. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<{}>;
            /**
             * Get a specific contact group owned by the authenticated user by specifying
             * a contact group resource name.
             */
            get(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /**
                 * Optional. Specifies the maximum number of members to return. Defaults to 0 if not
                 * set, which will return zero members.
                 */
                maxMembers?: number;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact group to get. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<ContactGroup>;
            /**
             * List all contact groups owned by the authenticated user. Members of the
             * contact groups are not populated.
             */
            list(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /**
                 * Optional. The maximum number of resources to return. Valid values are between 1 and
                 * 1000, inclusive. Defaults to 30 if not set or set to 0.
                 */
                pageSize?: number;
                /**
                 * 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.
                 */
                pageToken?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /**
                 * Optional. A sync token, returned by a previous call to `contactgroups.list`.
                 * Only resources changed since the sync token was created will be returned.
                 */
                syncToken?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<ListContactGroupsResponse>;
            /**
             * Update the name of an existing contact group owned by the authenticated
             * user.
             */
            update(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /**
                 * The resource name for the contact group, assigned by the server. An ASCII
                 * string, in the form of `contactGroups/{contact_group_id}`.
                 */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: UpdateContactGroupRequest;
            }): Request<ContactGroup>;
            update(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /**
                 * The resource name for the contact group, assigned by the server. An ASCII
                 * string, in the form of `contactGroups/{contact_group_id}`.
                 */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: UpdateContactGroupRequest): Request<ContactGroup>;
            members: MembersResource;
        }
        interface ConnectionsResource {
            /**
             * Provides a list of the authenticated user's contacts merged with any
             * connected profiles.
             *
             * The request throws a 400 error if 'personFields' is not specified.
             */
            list(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /**
                 * Optional. The number of connections to include in the response. Valid values are
                 * between 1 and 2000, inclusive. Defaults to 100 if not set or set to 0.
                 */
                pageSize?: number;
                /**
                 * Optional. A page token, received from a previous `ListConnections` call.
                 * Provide this to retrieve the subsequent page.
                 *
                 * When paginating, all other parameters provided to `ListConnections`
                 * must match the call that provided the page token.
                 */
                pageToken?: string;
                /**
                 * Required. A field mask to restrict which fields on each person are returned. Multiple
                 * fields can be specified by separating them with commas. Valid values are:
                 *
                 * &#42; addresses
                 * &#42; ageRanges
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; braggingRights
                 * &#42; coverPhotos
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; metadata
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; photos
                 * &#42; relations
                 * &#42; relationshipInterests
                 * &#42; relationshipStatuses
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; skills
                 * &#42; taglines
                 * &#42; urls
                 * &#42; userDefined
                 */
                personFields?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: 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`.
                 */
                "requestMask.includeField"?: string;
                /**
                 * Optional. Whether the response should include `next_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.
                 */
                requestSyncToken?: boolean;
                /** Required. The resource name to return connections for. Only `people/me` is valid. */
                resourceName: string;
                /**
                 * Optional. The order in which the connections should be sorted. Defaults to
                 * `LAST_MODIFIED_ASCENDING`.
                 */
                sortOrder?: string;
                /**
                 * Optional. A sync token, received from a previous `ListConnections` call.
                 * Provide this to retrieve only the resources changed since the last request.
                 * Sync requests that specify `sync_token` have an additional rate limit.
                 *
                 * When syncing, all other parameters provided to `ListConnections`
                 * must match the call that provided the sync token.
                 */
                syncToken?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<ListConnectionsResponse>;
        }
        interface PeopleResource {
            /** Create a new contact and return the person resource for that contact. */
            createContact(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: Person;
            }): Request<Person>;
            createContact(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: Person): Request<Person>;
            /** Delete a contact person. Any non-contact data will not be deleted. */
            deleteContact(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact to delete. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<{}>;
            /** Delete a contact's photo. */
            deleteContactPhoto(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /**
                 * Optional. A field mask to restrict which fields on the person are returned. Multiple
                 * fields can be specified by separating them with commas. Defaults to empty
                 * if not set, which will skip the post mutate get. Valid values are:
                 *
                 * &#42; addresses
                 * &#42; ageRanges
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; braggingRights
                 * &#42; coverPhotos
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; metadata
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; photos
                 * &#42; relations
                 * &#42; relationshipInterests
                 * &#42; relationshipStatuses
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; skills
                 * &#42; taglines
                 * &#42; urls
                 * &#42; userDefined
                 */
                personFields?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. The resource name of the contact whose photo will be deleted. */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<DeleteContactPhotoResponse>;
            /**
             * Provides information about a person by specifying a resource name. Use
             * `people/me` to indicate the authenticated user.
             *
             * The request throws a 400 error if 'personFields' is not specified.
             */
            get(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /**
                 * Required. 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:
                 *
                 * &#42; addresses
                 * &#42; ageRanges
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; braggingRights
                 * &#42; coverPhotos
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; metadata
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; photos
                 * &#42; relations
                 * &#42; relationshipInterests
                 * &#42; relationshipStatuses
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; skills
                 * &#42; taglines
                 * &#42; urls
                 * &#42; userDefined
                 */
                personFields?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: 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`.
                 */
                "requestMask.includeField"?: string;
                /**
                 * 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/{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).
                 */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<Person>;
            /**
             * Provides information about a list of specific people by specifying a list
             * of requested resource names. Use `people/me` to indicate the authenticated
             * user.
             *
             * The request throws a 400 error if 'personFields' is not specified.
             */
            getBatchGet(request?: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /**
                 * Required. A field mask to restrict which fields on each person are returned. Multiple
                 * fields can be specified by separating them with commas. Valid values are:
                 *
                 * &#42; addresses
                 * &#42; ageRanges
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; braggingRights
                 * &#42; coverPhotos
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; metadata
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; photos
                 * &#42; relations
                 * &#42; relationshipInterests
                 * &#42; relationshipStatuses
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; skills
                 * &#42; taglines
                 * &#42; urls
                 * &#42; userDefined
                 */
                personFields?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: 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`.
                 */
                "requestMask.includeField"?: string;
                /**
                 * 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/{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).
                 *
                 * You can include up to 50 resource names in one request.
                 */
                resourceNames?: string | string[];
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            }): Request<GetPeopleResponse>;
            /**
             * 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.
             *
             * The request throws a 400 error if `person.metadata.sources` is not
             * specified for the contact to be updated.
             *
             * 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
             * was read. Clients should get the latest person and re-apply their updates
             * to the latest person.
             */
            updateContact(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /**
                 * 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/{person_id}`.
                 */
                resourceName: string;
                /**
                 * Required. A field mask to restrict which fields on the person are updated. Multiple
                 * fields can be specified by separating them with commas.
                 * All updated fields will be replaced. Valid values are:
                 *
                 * &#42; addresses
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; relations
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; urls
                 * &#42; userDefined
                 */
                updatePersonFields?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: Person;
            }): Request<Person>;
            updateContact(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /**
                 * 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/{person_id}`.
                 */
                resourceName: string;
                /**
                 * Required. A field mask to restrict which fields on the person are updated. Multiple
                 * fields can be specified by separating them with commas.
                 * All updated fields will be replaced. Valid values are:
                 *
                 * &#42; addresses
                 * &#42; biographies
                 * &#42; birthdays
                 * &#42; emailAddresses
                 * &#42; events
                 * &#42; genders
                 * &#42; imClients
                 * &#42; interests
                 * &#42; locales
                 * &#42; memberships
                 * &#42; names
                 * &#42; nicknames
                 * &#42; occupations
                 * &#42; organizations
                 * &#42; phoneNumbers
                 * &#42; relations
                 * &#42; residences
                 * &#42; sipAddresses
                 * &#42; urls
                 * &#42; userDefined
                 */
                updatePersonFields?: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: Person): Request<Person>;
            /** Update a contact's photo. */
            updateContactPhoto(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. Person resource name */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
                /** Request body */
                resource: UpdateContactPhotoRequest;
            }): Request<UpdateContactPhotoResponse>;
            updateContactPhoto(request: {
                /** V1 error format. */
                "$.xgafv"?: string;
                /** OAuth access token. */
                access_token?: string;
                /** Data format for response. */
                alt?: string;
                /** JSONP */
                callback?: string;
                /** Selector specifying which fields to include in a partial response. */
                fields?: 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. */
                key?: string;
                /** OAuth 2.0 token for the current user. */
                oauth_token?: string;
                /** Returns response with indentations and line breaks. */
                prettyPrint?: boolean;
                /** 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. */
                quotaUser?: string;
                /** Required. Person resource name */
                resourceName: string;
                /** Upload protocol for media (e.g. "raw", "multipart"). */
                upload_protocol?: string;
                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
                uploadType?: string;
            },
            body: UpdateContactPhotoRequest): Request<UpdateContactPhotoResponse>;
            connections: ConnectionsResource;
        }

        const contactGroups: ContactGroupsResource;

        const people: PeopleResource;
    }
}