| // Copyright 2018 Google Inc. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| // Code generated file. DO NOT EDIT. |
| |
| // Package people provides access to the People API. |
| // |
| // See https://developers.google.com/people/ |
| // |
| // Usage example: |
| // |
| // import "google.golang.org/api/people/v1" |
| // ... |
| // peopleService, err := people.New(oauthHttpClient) |
| package people // import "google.golang.org/api/people/v1" |
| |
| import ( |
| "bytes" |
| "context" |
| "encoding/json" |
| "errors" |
| "fmt" |
| "io" |
| "net/http" |
| "net/url" |
| "strconv" |
| "strings" |
| |
| gensupport "google.golang.org/api/gensupport" |
| googleapi "google.golang.org/api/googleapi" |
| ) |
| |
| // Always reference these packages, just in case the auto-generated code |
| // below doesn't. |
| var _ = bytes.NewBuffer |
| var _ = strconv.Itoa |
| var _ = fmt.Sprintf |
| var _ = json.NewDecoder |
| var _ = io.Copy |
| var _ = url.Parse |
| var _ = gensupport.MarshalJSON |
| var _ = googleapi.Version |
| var _ = errors.New |
| var _ = strings.Replace |
| var _ = context.Canceled |
| |
| const apiId = "people:v1" |
| const apiName = "people" |
| const apiVersion = "v1" |
| const basePath = "https://people.googleapis.com/" |
| |
| // OAuth2 scopes used by this API. |
| const ( |
| // See, edit, download, and permanently delete your contacts |
| ContactsScope = "https://www.googleapis.com/auth/contacts" |
| |
| // See and download your contacts |
| ContactsReadonlyScope = "https://www.googleapis.com/auth/contacts.readonly" |
| |
| // Know the list of people in your circles, your age range, and language |
| PlusLoginScope = "https://www.googleapis.com/auth/plus.login" |
| |
| // View your street addresses |
| UserAddressesReadScope = "https://www.googleapis.com/auth/user.addresses.read" |
| |
| // View your complete date of birth |
| UserBirthdayReadScope = "https://www.googleapis.com/auth/user.birthday.read" |
| |
| // View your email addresses |
| UserEmailsReadScope = "https://www.googleapis.com/auth/user.emails.read" |
| |
| // View your phone numbers |
| UserPhonenumbersReadScope = "https://www.googleapis.com/auth/user.phonenumbers.read" |
| |
| // View your email address |
| UserinfoEmailScope = "https://www.googleapis.com/auth/userinfo.email" |
| |
| // View your basic profile info |
| UserinfoProfileScope = "https://www.googleapis.com/auth/userinfo.profile" |
| ) |
| |
| func New(client *http.Client) (*Service, error) { |
| if client == nil { |
| return nil, errors.New("client is nil") |
| } |
| s := &Service{client: client, BasePath: basePath} |
| s.ContactGroups = NewContactGroupsService(s) |
| s.People = NewPeopleService(s) |
| return s, nil |
| } |
| |
| type Service struct { |
| client *http.Client |
| BasePath string // API endpoint base URL |
| UserAgent string // optional additional User-Agent fragment |
| |
| ContactGroups *ContactGroupsService |
| |
| People *PeopleService |
| } |
| |
| func (s *Service) userAgent() string { |
| if s.UserAgent == "" { |
| return googleapi.UserAgent |
| } |
| return googleapi.UserAgent + " " + s.UserAgent |
| } |
| |
| func NewContactGroupsService(s *Service) *ContactGroupsService { |
| rs := &ContactGroupsService{s: s} |
| rs.Members = NewContactGroupsMembersService(s) |
| return rs |
| } |
| |
| type ContactGroupsService struct { |
| s *Service |
| |
| Members *ContactGroupsMembersService |
| } |
| |
| func NewContactGroupsMembersService(s *Service) *ContactGroupsMembersService { |
| rs := &ContactGroupsMembersService{s: s} |
| return rs |
| } |
| |
| type ContactGroupsMembersService struct { |
| s *Service |
| } |
| |
| func NewPeopleService(s *Service) *PeopleService { |
| rs := &PeopleService{s: s} |
| rs.Connections = NewPeopleConnectionsService(s) |
| return rs |
| } |
| |
| type PeopleService struct { |
| s *Service |
| |
| Connections *PeopleConnectionsService |
| } |
| |
| func NewPeopleConnectionsService(s *Service) *PeopleConnectionsService { |
| rs := &PeopleConnectionsService{s: s} |
| return rs |
| } |
| |
| type PeopleConnectionsService struct { |
| s *Service |
| } |
| |
| // Address: A person's physical address. May be a P.O. box or street |
| // address. All fields |
| // are optional. |
| type Address struct { |
| // City: The city of the address. |
| City string `json:"city,omitempty"` |
| |
| // Country: The country of the address. |
| Country string `json:"country,omitempty"` |
| |
| // CountryCode: The [ISO 3166-1 |
| // alpha-2](http://www.iso.org/iso/country_codes.htm) country |
| // code of the address. |
| CountryCode string `json:"countryCode,omitempty"` |
| |
| // ExtendedAddress: The extended address of the address; for example, |
| // the apartment number. |
| ExtendedAddress string `json:"extendedAddress,omitempty"` |
| |
| // FormattedType: The read-only type of the address translated and |
| // formatted in the viewer's |
| // account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // FormattedValue: The unstructured value of the address. If this is not |
| // set by the user it |
| // will be automatically constructed from structured values. |
| FormattedValue string `json:"formattedValue,omitempty"` |
| |
| // Metadata: Metadata about the address. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // PoBox: The P.O. box of the address. |
| PoBox string `json:"poBox,omitempty"` |
| |
| // PostalCode: The postal code of the address. |
| PostalCode string `json:"postalCode,omitempty"` |
| |
| // Region: The region of the address; for example, the state or |
| // province. |
| Region string `json:"region,omitempty"` |
| |
| // StreetAddress: The street address. |
| StreetAddress string `json:"streetAddress,omitempty"` |
| |
| // Type: The type of the address. The type can be custom or one of these |
| // predefined |
| // values: |
| // |
| // * `home` |
| // * `work` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "City") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "City") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Address) MarshalJSON() ([]byte, error) { |
| type NoMethod Address |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // AgeRangeType: A person's age range. |
| type AgeRangeType struct { |
| // AgeRange: The age range. |
| // |
| // Possible values: |
| // "AGE_RANGE_UNSPECIFIED" - Unspecified. |
| // "LESS_THAN_EIGHTEEN" - Younger than eighteen. |
| // "EIGHTEEN_TO_TWENTY" - Between eighteen and twenty. |
| // "TWENTY_ONE_OR_OLDER" - Twenty-one and older. |
| AgeRange string `json:"ageRange,omitempty"` |
| |
| // Metadata: Metadata about the age range. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "AgeRange") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "AgeRange") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *AgeRangeType) MarshalJSON() ([]byte, error) { |
| type NoMethod AgeRangeType |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // BatchGetContactGroupsResponse: The response to a batch get contact |
| // groups request. |
| type BatchGetContactGroupsResponse struct { |
| // Responses: The list of responses for each requested contact group |
| // resource. |
| Responses []*ContactGroupResponse `json:"responses,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "Responses") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Responses") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *BatchGetContactGroupsResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod BatchGetContactGroupsResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Biography: A person's short biography. |
| type Biography struct { |
| // ContentType: The content type of the biography. |
| // |
| // Possible values: |
| // "CONTENT_TYPE_UNSPECIFIED" - Unspecified. |
| // "TEXT_PLAIN" - Plain text. |
| // "TEXT_HTML" - HTML text. |
| ContentType string `json:"contentType,omitempty"` |
| |
| // Metadata: Metadata about the biography. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The short biography. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContentType") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContentType") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Biography) MarshalJSON() ([]byte, error) { |
| type NoMethod Biography |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Birthday: A person's birthday. At least one of the `date` and `text` |
| // fields are |
| // specified. The `date` and `text` fields typically represent the |
| // same |
| // date, but are not guaranteed to. |
| type Birthday struct { |
| // Date: The date of the birthday. |
| Date *Date `json:"date,omitempty"` |
| |
| // Metadata: Metadata about the birthday. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Text: A free-form string representing the user's birthday. |
| Text string `json:"text,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Date") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Date") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Birthday) MarshalJSON() ([]byte, error) { |
| type NoMethod Birthday |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // BraggingRights: A person's bragging rights. |
| type BraggingRights struct { |
| // Metadata: Metadata about the bragging rights. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The bragging rights; for example, `climbed mount everest`. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *BraggingRights) MarshalJSON() ([]byte, error) { |
| type NoMethod BraggingRights |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ContactGroup: A contact group. |
| type ContactGroup struct { |
| // Etag: The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) |
| // of the |
| // resource. Used for web cache validation. |
| Etag string `json:"etag,omitempty"` |
| |
| // FormattedName: The read-only 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 `json:"formattedName,omitempty"` |
| |
| // GroupType: The read-only contact group type. |
| // |
| // Possible values: |
| // "GROUP_TYPE_UNSPECIFIED" - Unspecified. |
| // "USER_CONTACT_GROUP" - User defined contact group. |
| // "SYSTEM_CONTACT_GROUP" - System defined contact group. |
| GroupType string `json:"groupType,omitempty"` |
| |
| // MemberCount: The total number of contacts in the group irrespective |
| // of max members in |
| // specified in the request. |
| MemberCount int64 `json:"memberCount,omitempty"` |
| |
| // MemberResourceNames: 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/memb |
| // ers/modify). |
| MemberResourceNames []string `json:"memberResourceNames,omitempty"` |
| |
| // Metadata: Metadata about the contact group. |
| Metadata *ContactGroupMetadata `json:"metadata,omitempty"` |
| |
| // Name: The contact group name set by the group owner or a system |
| // provided name |
| // for system groups. |
| Name string `json:"name,omitempty"` |
| |
| // ResourceName: The resource name for the contact group, assigned by |
| // the server. An ASCII |
| // string, in the form of `contactGroups/`<var>contact_group_id</var>. |
| ResourceName string `json:"resourceName,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "Etag") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Etag") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ContactGroup) MarshalJSON() ([]byte, error) { |
| type NoMethod ContactGroup |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ContactGroupMembership: A Google contact group membership. |
| type ContactGroupMembership struct { |
| // ContactGroupId: The contact group ID for the contact group |
| // membership. The contact group |
| // ID can be custom or one of these predefined values: |
| // |
| // * `myContacts` |
| // * `starred` |
| // * A numerical ID for user-created groups. |
| ContactGroupId string `json:"contactGroupId,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContactGroupId") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroupId") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ContactGroupMembership) MarshalJSON() ([]byte, error) { |
| type NoMethod ContactGroupMembership |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ContactGroupMetadata: The read-only metadata about a contact group. |
| type ContactGroupMetadata struct { |
| // Deleted: 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 bool `json:"deleted,omitempty"` |
| |
| // UpdateTime: The time the group was last updated. |
| UpdateTime string `json:"updateTime,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Deleted") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Deleted") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ContactGroupMetadata) MarshalJSON() ([]byte, error) { |
| type NoMethod ContactGroupMetadata |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ContactGroupResponse: The response for a specific contact group. |
| type ContactGroupResponse struct { |
| // ContactGroup: The contact group. |
| ContactGroup *ContactGroup `json:"contactGroup,omitempty"` |
| |
| // RequestedResourceName: The original requested resource name. |
| RequestedResourceName string `json:"requestedResourceName,omitempty"` |
| |
| // Status: The status of the response. |
| Status *Status `json:"status,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContactGroup") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroup") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ContactGroupResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod ContactGroupResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // CoverPhoto: A person's read-only cover photo. A large image shown on |
| // the person's |
| // profile page that represents who they are or what they care about. |
| type CoverPhoto struct { |
| // Default: True if the cover photo is the default cover photo; |
| // false if the cover photo is a user-provided cover photo. |
| Default bool `json:"default,omitempty"` |
| |
| // Metadata: Metadata about the cover photo. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Url: The URL of the cover photo. |
| Url string `json:"url,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Default") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Default") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *CoverPhoto) MarshalJSON() ([]byte, error) { |
| type NoMethod CoverPhoto |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // CreateContactGroupRequest: A request to create a new contact group. |
| type CreateContactGroupRequest struct { |
| // ContactGroup: The contact group to create. |
| ContactGroup *ContactGroup `json:"contactGroup,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContactGroup") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroup") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *CreateContactGroupRequest) MarshalJSON() ([]byte, error) { |
| type NoMethod CreateContactGroupRequest |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Date: Represents a whole calendar date, for example a date of birth. |
| // The time |
| // of day and time zone are either specified elsewhere or are |
| // not |
| // significant. The date is relative to the |
| // [Proleptic Gregorian |
| // Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). |
| // |
| // The day may be 0 to represent a year and month where the day is |
| // not |
| // significant. The year may be 0 to represent a month and day |
| // independent |
| // of year; for example, anniversary date. |
| type Date struct { |
| // Day: 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 int64 `json:"day,omitempty"` |
| |
| // Month: Month of year. Must be from 1 to 12, or 0 if specifying a year |
| // without a |
| // month and day. |
| Month int64 `json:"month,omitempty"` |
| |
| // Year: Year of date. Must be from 1 to 9999, or 0 if specifying a date |
| // without |
| // a year. |
| Year int64 `json:"year,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Day") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Day") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Date) MarshalJSON() ([]byte, error) { |
| type NoMethod Date |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // DomainMembership: A Google Apps Domain membership. |
| type DomainMembership struct { |
| // InViewerDomain: True if the person is in the viewer's Google Apps |
| // domain. |
| InViewerDomain bool `json:"inViewerDomain,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "InViewerDomain") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "InViewerDomain") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *DomainMembership) MarshalJSON() ([]byte, error) { |
| type NoMethod DomainMembership |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // EmailAddress: A person's email address. |
| type EmailAddress struct { |
| // DisplayName: The display name of the email. |
| DisplayName string `json:"displayName,omitempty"` |
| |
| // FormattedType: The read-only type of the email address translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the email address. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the email address. The type can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `home` |
| // * `work` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // Value: The email address. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "DisplayName") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "DisplayName") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *EmailAddress) MarshalJSON() ([]byte, error) { |
| type NoMethod EmailAddress |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Empty: A generic empty message that you can re-use to avoid defining |
| // duplicated |
| // empty messages in your APIs. A typical example is to use it as the |
| // request |
| // or the response type of an API method. For instance: |
| // |
| // service Foo { |
| // rpc Bar(google.protobuf.Empty) returns |
| // (google.protobuf.Empty); |
| // } |
| // |
| // The JSON representation for `Empty` is empty JSON object `{}`. |
| type Empty struct { |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| } |
| |
| // Event: An event related to the person. |
| type Event struct { |
| // Date: The date of the event. |
| Date *Date `json:"date,omitempty"` |
| |
| // FormattedType: The read-only type of the event translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the event. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the event. The type can be custom or one of these |
| // predefined |
| // values: |
| // |
| // * `anniversary` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Date") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Date") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Event) MarshalJSON() ([]byte, error) { |
| type NoMethod Event |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // FieldMetadata: Metadata about a field. |
| type FieldMetadata struct { |
| // Primary: True if the field is the primary field; false if the field |
| // is a secondary |
| // field. |
| Primary bool `json:"primary,omitempty"` |
| |
| // Source: The source of the field. |
| Source *Source `json:"source,omitempty"` |
| |
| // Verified: 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 bool `json:"verified,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Primary") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Primary") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *FieldMetadata) MarshalJSON() ([]byte, error) { |
| type NoMethod FieldMetadata |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Gender: A person's gender. |
| type Gender struct { |
| // FormattedValue: The read-only value of the gender translated and |
| // formatted in the viewer's |
| // account locale or the `Accept-Language` HTTP header locale. |
| FormattedValue string `json:"formattedValue,omitempty"` |
| |
| // Metadata: Metadata about the gender. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The gender for the person. The gender can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `male` |
| // * `female` |
| // * `other` |
| // * `unknown` |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedValue") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedValue") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Gender) MarshalJSON() ([]byte, error) { |
| type NoMethod Gender |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| type GetPeopleResponse struct { |
| // Responses: The response for each requested resource name. |
| Responses []*PersonResponse `json:"responses,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "Responses") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Responses") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *GetPeopleResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod GetPeopleResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ImClient: A person's instant messaging client. |
| type ImClient struct { |
| // FormattedProtocol: The read-only protocol of the IM client formatted |
| // in the viewer's account |
| // locale or the `Accept-Language` HTTP header locale. |
| FormattedProtocol string `json:"formattedProtocol,omitempty"` |
| |
| // FormattedType: The read-only type of the IM client translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the IM client. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Protocol: The protocol of the IM client. The protocol can be custom |
| // or one of these |
| // predefined values: |
| // |
| // * `aim` |
| // * `msn` |
| // * `yahoo` |
| // * `skype` |
| // * `qq` |
| // * `googleTalk` |
| // * `icq` |
| // * `jabber` |
| // * `netMeeting` |
| Protocol string `json:"protocol,omitempty"` |
| |
| // Type: The type of the IM client. The type can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `home` |
| // * `work` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // Username: The user name used in the IM client. |
| Username string `json:"username,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedProtocol") |
| // to unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedProtocol") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ImClient) MarshalJSON() ([]byte, error) { |
| type NoMethod ImClient |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Interest: One of the person's interests. |
| type Interest struct { |
| // Metadata: Metadata about the interest. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The interest; for example, `stargazing`. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Interest) MarshalJSON() ([]byte, error) { |
| type NoMethod Interest |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| type ListConnectionsResponse struct { |
| // Connections: The list of people that the requestor is connected to. |
| Connections []*Person `json:"connections,omitempty"` |
| |
| // NextPageToken: The token that can be used to retrieve the next page |
| // of results. |
| NextPageToken string `json:"nextPageToken,omitempty"` |
| |
| // NextSyncToken: The token that can be used to retrieve changes since |
| // the last request. |
| NextSyncToken string `json:"nextSyncToken,omitempty"` |
| |
| // TotalItems: The total number of items in the list without pagination. |
| TotalItems int64 `json:"totalItems,omitempty"` |
| |
| // TotalPeople: **DEPRECATED** (Please use totalItems) |
| // The total number of people in the list without pagination. |
| TotalPeople int64 `json:"totalPeople,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "Connections") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Connections") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod ListConnectionsResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ListContactGroupsResponse: The response to a list contact groups |
| // request. |
| type ListContactGroupsResponse struct { |
| // ContactGroups: The list of contact groups. Members of the contact |
| // groups are not |
| // populated. |
| ContactGroups []*ContactGroup `json:"contactGroups,omitempty"` |
| |
| // NextPageToken: The token that can be used to retrieve the next page |
| // of results. |
| NextPageToken string `json:"nextPageToken,omitempty"` |
| |
| // NextSyncToken: The token that can be used to retrieve changes since |
| // the last request. |
| NextSyncToken string `json:"nextSyncToken,omitempty"` |
| |
| // TotalItems: The total number of items in the list without pagination. |
| TotalItems int64 `json:"totalItems,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContactGroups") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroups") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ListContactGroupsResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod ListContactGroupsResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Locale: A person's locale preference. |
| type Locale struct { |
| // Metadata: Metadata about the locale. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The well-formed [IETF BCP |
| // 47](https://tools.ietf.org/html/bcp47) |
| // language tag representing the locale. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Locale) MarshalJSON() ([]byte, error) { |
| type NoMethod Locale |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Membership: A person's read-only membership in a group. |
| type Membership struct { |
| // ContactGroupMembership: The contact group membership. |
| ContactGroupMembership *ContactGroupMembership `json:"contactGroupMembership,omitempty"` |
| |
| // DomainMembership: The domain membership. |
| DomainMembership *DomainMembership `json:"domainMembership,omitempty"` |
| |
| // Metadata: Metadata about the membership. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. |
| // "ContactGroupMembership") to unconditionally include in API requests. |
| // By default, fields with empty values are omitted from API requests. |
| // However, any non-pointer, non-interface field appearing in |
| // ForceSendFields will be sent to the server regardless of whether the |
| // field is empty or not. This may be used to include empty fields in |
| // Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroupMembership") |
| // to include in API requests with the JSON null value. By default, |
| // fields with empty values are omitted from API requests. However, any |
| // field with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Membership) MarshalJSON() ([]byte, error) { |
| type NoMethod Membership |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ModifyContactGroupMembersRequest: A request to modify an existing |
| // contact group's members. Contacts can be |
| // removed from any group but they can only be added to a user group |
| // or |
| // myContacts or starred system groups. |
| type ModifyContactGroupMembersRequest struct { |
| // ResourceNamesToAdd: The resource names of the contact people to add |
| // in the form of in the form |
| // `people/`<var>person_id</var>. |
| ResourceNamesToAdd []string `json:"resourceNamesToAdd,omitempty"` |
| |
| // ResourceNamesToRemove: The resource names of the contact people to |
| // remove in the form of in the |
| // form of `people/`<var>person_id</var>. |
| ResourceNamesToRemove []string `json:"resourceNamesToRemove,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ResourceNamesToAdd") |
| // to unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ResourceNamesToAdd") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ModifyContactGroupMembersRequest) MarshalJSON() ([]byte, error) { |
| type NoMethod ModifyContactGroupMembersRequest |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ModifyContactGroupMembersResponse: The response to a modify contact |
| // group members request. |
| type ModifyContactGroupMembersResponse struct { |
| // NotFoundResourceNames: The contact people resource names that were |
| // not found. |
| NotFoundResourceNames []string `json:"notFoundResourceNames,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. |
| // "NotFoundResourceNames") to unconditionally include in API requests. |
| // By default, fields with empty values are omitted from API requests. |
| // However, any non-pointer, non-interface field appearing in |
| // ForceSendFields will be sent to the server regardless of whether the |
| // field is empty or not. This may be used to include empty fields in |
| // Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "NotFoundResourceNames") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ModifyContactGroupMembersResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod ModifyContactGroupMembersResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Name: A person's name. If the name is a mononym, the family name is |
| // empty. |
| type Name struct { |
| // DisplayName: The read-only display name formatted according to the |
| // locale specified by |
| // the viewer's account or the `Accept-Language` HTTP header. |
| DisplayName string `json:"displayName,omitempty"` |
| |
| // DisplayNameLastFirst: The read-only 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 `json:"displayNameLastFirst,omitempty"` |
| |
| // FamilyName: The family name. |
| FamilyName string `json:"familyName,omitempty"` |
| |
| // GivenName: The given name. |
| GivenName string `json:"givenName,omitempty"` |
| |
| // HonorificPrefix: The honorific prefixes, such as `Mrs.` or `Dr.` |
| HonorificPrefix string `json:"honorificPrefix,omitempty"` |
| |
| // HonorificSuffix: The honorific suffixes, such as `Jr.` |
| HonorificSuffix string `json:"honorificSuffix,omitempty"` |
| |
| // Metadata: Metadata about the name. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // MiddleName: The middle name(s). |
| MiddleName string `json:"middleName,omitempty"` |
| |
| // PhoneticFamilyName: The family name spelled as it sounds. |
| PhoneticFamilyName string `json:"phoneticFamilyName,omitempty"` |
| |
| // PhoneticFullName: The full name spelled as it sounds. |
| PhoneticFullName string `json:"phoneticFullName,omitempty"` |
| |
| // PhoneticGivenName: The given name spelled as it sounds. |
| PhoneticGivenName string `json:"phoneticGivenName,omitempty"` |
| |
| // PhoneticHonorificPrefix: The honorific prefixes spelled as they |
| // sound. |
| PhoneticHonorificPrefix string `json:"phoneticHonorificPrefix,omitempty"` |
| |
| // PhoneticHonorificSuffix: The honorific suffixes spelled as they |
| // sound. |
| PhoneticHonorificSuffix string `json:"phoneticHonorificSuffix,omitempty"` |
| |
| // PhoneticMiddleName: The middle name(s) spelled as they sound. |
| PhoneticMiddleName string `json:"phoneticMiddleName,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "DisplayName") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "DisplayName") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Name) MarshalJSON() ([]byte, error) { |
| type NoMethod Name |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Nickname: A person's nickname. |
| type Nickname struct { |
| // Metadata: Metadata about the nickname. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the nickname. |
| // |
| // Possible values: |
| // "DEFAULT" - Generic nickname. |
| // "MAIDEN_NAME" - Maiden name or birth family name. Used when the |
| // person's family name has |
| // changed as a result of marriage. |
| // "INITIALS" - Initials. |
| // "GPLUS" - Google+ profile nickname. |
| // "OTHER_NAME" - A professional affiliation or other name; for |
| // example, `Dr. Smith.` |
| Type string `json:"type,omitempty"` |
| |
| // Value: The nickname. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Nickname) MarshalJSON() ([]byte, error) { |
| type NoMethod Nickname |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Occupation: A person's occupation. |
| type Occupation struct { |
| // Metadata: Metadata about the occupation. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The occupation; for example, `carpenter`. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Occupation) MarshalJSON() ([]byte, error) { |
| type NoMethod Occupation |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Organization: A person's past or current organization. Overlapping |
| // date ranges are |
| // permitted. |
| type Organization struct { |
| // Current: True if the organization is the person's current |
| // organization; |
| // false if the organization is a past organization. |
| Current bool `json:"current,omitempty"` |
| |
| // Department: The person's department at the organization. |
| Department string `json:"department,omitempty"` |
| |
| // Domain: The domain name associated with the organization; for |
| // example, `google.com`. |
| Domain string `json:"domain,omitempty"` |
| |
| // EndDate: The end date when the person left the organization. |
| EndDate *Date `json:"endDate,omitempty"` |
| |
| // FormattedType: The read-only type of the organization translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // JobDescription: The person's job description at the organization. |
| JobDescription string `json:"jobDescription,omitempty"` |
| |
| // Location: The location of the organization office the person works |
| // at. |
| Location string `json:"location,omitempty"` |
| |
| // Metadata: Metadata about the organization. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Name: The name of the organization. |
| Name string `json:"name,omitempty"` |
| |
| // PhoneticName: The phonetic name of the organization. |
| PhoneticName string `json:"phoneticName,omitempty"` |
| |
| // StartDate: The start date when the person joined the organization. |
| StartDate *Date `json:"startDate,omitempty"` |
| |
| // Symbol: The symbol associated with the organization; for example, a |
| // stock ticker |
| // symbol, abbreviation, or acronym. |
| Symbol string `json:"symbol,omitempty"` |
| |
| // Title: The person's job title at the organization. |
| Title string `json:"title,omitempty"` |
| |
| // Type: The type of the organization. The type can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `work` |
| // * `school` |
| Type string `json:"type,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Current") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Current") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Organization) MarshalJSON() ([]byte, error) { |
| type NoMethod Organization |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Person: Information about a person merged from various data sources |
| // such as the |
| // authenticated user's contacts and profile data. |
| // |
| // Most fields can have multiple items. The items in a field have no |
| // guaranteed |
| // order, but each non-empty field is guaranteed to have exactly one |
| // field with |
| // `metadata.primary` set to true. |
| type Person struct { |
| // Addresses: The person's street addresses. |
| Addresses []*Address `json:"addresses,omitempty"` |
| |
| // AgeRange: **DEPRECATED** (Please use `person.ageRanges` |
| // instead)** |
| // |
| // The person's read-only age range. |
| // |
| // Possible values: |
| // "AGE_RANGE_UNSPECIFIED" - Unspecified. |
| // "LESS_THAN_EIGHTEEN" - Younger than eighteen. |
| // "EIGHTEEN_TO_TWENTY" - Between eighteen and twenty. |
| // "TWENTY_ONE_OR_OLDER" - Twenty-one and older. |
| AgeRange string `json:"ageRange,omitempty"` |
| |
| // AgeRanges: The person's read-only age ranges. |
| AgeRanges []*AgeRangeType `json:"ageRanges,omitempty"` |
| |
| // Biographies: The person's biographies. |
| Biographies []*Biography `json:"biographies,omitempty"` |
| |
| // Birthdays: The person's birthdays. |
| Birthdays []*Birthday `json:"birthdays,omitempty"` |
| |
| // BraggingRights: The person's bragging rights. |
| BraggingRights []*BraggingRights `json:"braggingRights,omitempty"` |
| |
| // CoverPhotos: The person's read-only cover photos. |
| CoverPhotos []*CoverPhoto `json:"coverPhotos,omitempty"` |
| |
| // EmailAddresses: The person's email addresses. |
| EmailAddresses []*EmailAddress `json:"emailAddresses,omitempty"` |
| |
| // Etag: The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) |
| // of the |
| // resource. Used for web cache validation. |
| Etag string `json:"etag,omitempty"` |
| |
| // Events: The person's events. |
| Events []*Event `json:"events,omitempty"` |
| |
| // Genders: The person's genders. |
| Genders []*Gender `json:"genders,omitempty"` |
| |
| // ImClients: The person's instant messaging clients. |
| ImClients []*ImClient `json:"imClients,omitempty"` |
| |
| // Interests: The person's interests. |
| Interests []*Interest `json:"interests,omitempty"` |
| |
| // Locales: The person's locale preferences. |
| Locales []*Locale `json:"locales,omitempty"` |
| |
| // Memberships: The person's read-only group memberships. |
| Memberships []*Membership `json:"memberships,omitempty"` |
| |
| // Metadata: Read-only metadata about the person. |
| Metadata *PersonMetadata `json:"metadata,omitempty"` |
| |
| // Names: The person's names. |
| Names []*Name `json:"names,omitempty"` |
| |
| // Nicknames: The person's nicknames. |
| Nicknames []*Nickname `json:"nicknames,omitempty"` |
| |
| // Occupations: The person's occupations. |
| Occupations []*Occupation `json:"occupations,omitempty"` |
| |
| // Organizations: The person's past or current organizations. |
| Organizations []*Organization `json:"organizations,omitempty"` |
| |
| // PhoneNumbers: The person's phone numbers. |
| PhoneNumbers []*PhoneNumber `json:"phoneNumbers,omitempty"` |
| |
| // Photos: The person's read-only photos. |
| Photos []*Photo `json:"photos,omitempty"` |
| |
| // Relations: The person's relations. |
| Relations []*Relation `json:"relations,omitempty"` |
| |
| // RelationshipInterests: The person's read-only relationship interests. |
| RelationshipInterests []*RelationshipInterest `json:"relationshipInterests,omitempty"` |
| |
| // RelationshipStatuses: The person's read-only relationship statuses. |
| RelationshipStatuses []*RelationshipStatus `json:"relationshipStatuses,omitempty"` |
| |
| // Residences: The person's residences. |
| Residences []*Residence `json:"residences,omitempty"` |
| |
| // 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>. |
| ResourceName string `json:"resourceName,omitempty"` |
| |
| // SipAddresses: The person's SIP addresses. |
| SipAddresses []*SipAddress `json:"sipAddresses,omitempty"` |
| |
| // Skills: The person's skills. |
| Skills []*Skill `json:"skills,omitempty"` |
| |
| // Taglines: The person's read-only taglines. |
| Taglines []*Tagline `json:"taglines,omitempty"` |
| |
| // Urls: The person's associated URLs. |
| Urls []*Url `json:"urls,omitempty"` |
| |
| // UserDefined: The person's user defined data. |
| UserDefined []*UserDefined `json:"userDefined,omitempty"` |
| |
| // ServerResponse contains the HTTP response code and headers from the |
| // server. |
| googleapi.ServerResponse `json:"-"` |
| |
| // ForceSendFields is a list of field names (e.g. "Addresses") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Addresses") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Person) MarshalJSON() ([]byte, error) { |
| type NoMethod Person |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // PersonMetadata: The read-only metadata about a person. |
| type PersonMetadata struct { |
| // Deleted: 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 bool `json:"deleted,omitempty"` |
| |
| // LinkedPeopleResourceNames: Resource names of people linked to this |
| // resource. |
| LinkedPeopleResourceNames []string `json:"linkedPeopleResourceNames,omitempty"` |
| |
| // ObjectType: **DEPRECATED** (Please |
| // use |
| // `person.metadata.sources.profileMetadata.objectType` instead) |
| // |
| // The type of the person object. |
| // |
| // Possible values: |
| // "OBJECT_TYPE_UNSPECIFIED" - Unspecified. |
| // "PERSON" - Person. |
| // "PAGE" - [Google+ Page.](http://www.google.com/+/brands/) |
| ObjectType string `json:"objectType,omitempty"` |
| |
| // PreviousResourceNames: 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 `json:"previousResourceNames,omitempty"` |
| |
| // Sources: The sources of data for the person. |
| Sources []*Source `json:"sources,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Deleted") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Deleted") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *PersonMetadata) MarshalJSON() ([]byte, error) { |
| type NoMethod PersonMetadata |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // PersonResponse: The response for a single person |
| type PersonResponse struct { |
| // HttpStatusCode: **DEPRECATED** (Please use status instead) |
| // |
| // [HTTP 1.1 status |
| // code] |
| // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html). |
| HttpStatusCode int64 `json:"httpStatusCode,omitempty"` |
| |
| // Person: The person. |
| Person *Person `json:"person,omitempty"` |
| |
| // RequestedResourceName: 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 `json:"requestedResourceName,omitempty"` |
| |
| // Status: The status of the response. |
| Status *Status `json:"status,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "HttpStatusCode") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "HttpStatusCode") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *PersonResponse) MarshalJSON() ([]byte, error) { |
| type NoMethod PersonResponse |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // PhoneNumber: A person's phone number. |
| type PhoneNumber struct { |
| // CanonicalForm: The read-only 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 `json:"canonicalForm,omitempty"` |
| |
| // FormattedType: The read-only type of the phone number translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the phone number. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the phone number. The type can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `home` |
| // * `work` |
| // * `mobile` |
| // * `homeFax` |
| // * `workFax` |
| // * `otherFax` |
| // * `pager` |
| // * `workMobile` |
| // * `workPager` |
| // * `main` |
| // * `googleVoice` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // Value: The phone number. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "CanonicalForm") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "CanonicalForm") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *PhoneNumber) MarshalJSON() ([]byte, error) { |
| type NoMethod PhoneNumber |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Photo: A person's read-only photo. A picture shown next to the |
| // person's name to |
| // help others recognize the person. |
| type Photo struct { |
| // Default: True if the photo is a default photo; |
| // false if the photo is a user-provided photo. |
| Default bool `json:"default,omitempty"` |
| |
| // Metadata: Metadata about the photo. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Url: The URL of the photo. You can change the desired size by |
| // appending a query |
| // parameter `sz=`<var>size</var> at the end of the url. |
| // Example: |
| // `https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/A |
| // AAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50` |
| Url string `json:"url,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Default") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Default") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Photo) MarshalJSON() ([]byte, error) { |
| type NoMethod Photo |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // ProfileMetadata: The read-only metadata about a profile. |
| type ProfileMetadata struct { |
| // ObjectType: The profile object type. |
| // |
| // Possible values: |
| // "OBJECT_TYPE_UNSPECIFIED" - Unspecified. |
| // "PERSON" - Person. |
| // "PAGE" - [Google+ Page.](http://www.google.com/+/brands/) |
| ObjectType string `json:"objectType,omitempty"` |
| |
| // UserTypes: The user types. |
| // |
| // Possible values: |
| // "USER_TYPE_UNKNOWN" - The user type is not known. |
| // "GOOGLE_USER" - The user is a Google user. |
| // "GPLUS_USER" - The user is a Google+ user. |
| // "GOOGLE_APPS_USER" - The user is a Google Apps for Work user. |
| UserTypes []string `json:"userTypes,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ObjectType") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ObjectType") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *ProfileMetadata) MarshalJSON() ([]byte, error) { |
| type NoMethod ProfileMetadata |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Relation: A person's relation to another person. |
| type Relation struct { |
| // FormattedType: 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 `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the relation. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Person: The name of the other person this relation refers to. |
| Person string `json:"person,omitempty"` |
| |
| // Type: The person's relation to the other person. The type can be |
| // custom or one of |
| // these predefined values: |
| // |
| // * `spouse` |
| // * `child` |
| // * `mother` |
| // * `father` |
| // * `parent` |
| // * `brother` |
| // * `sister` |
| // * `friend` |
| // * `relative` |
| // * `domesticPartner` |
| // * `manager` |
| // * `assistant` |
| // * `referredBy` |
| // * `partner` |
| Type string `json:"type,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedType") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedType") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Relation) MarshalJSON() ([]byte, error) { |
| type NoMethod Relation |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // RelationshipInterest: A person's read-only relationship interest . |
| type RelationshipInterest struct { |
| // FormattedValue: 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 `json:"formattedValue,omitempty"` |
| |
| // Metadata: Metadata about the relationship interest. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The kind of relationship the person is looking for. The value |
| // can be custom |
| // or one of these predefined values: |
| // |
| // * `friend` |
| // * `date` |
| // * `relationship` |
| // * `networking` |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedValue") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedValue") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *RelationshipInterest) MarshalJSON() ([]byte, error) { |
| type NoMethod RelationshipInterest |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // RelationshipStatus: A person's read-only relationship status. |
| type RelationshipStatus struct { |
| // FormattedValue: The read-only value of the relationship status |
| // translated and formatted in |
| // the viewer's account locale or the `Accept-Language` HTTP header |
| // locale. |
| FormattedValue string `json:"formattedValue,omitempty"` |
| |
| // Metadata: Metadata about the relationship status. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The relationship status. The value can be custom or one of |
| // these |
| // predefined values: |
| // |
| // * `single` |
| // * `inARelationship` |
| // * `engaged` |
| // * `married` |
| // * `itsComplicated` |
| // * `openRelationship` |
| // * `widowed` |
| // * `inDomesticPartnership` |
| // * `inCivilUnion` |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedValue") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedValue") to |
| // include in API requests with the JSON null value. By default, fields |
| // with empty values are omitted from API requests. However, any field |
| // with an empty value appearing in NullFields will be sent to the |
| // server as null. It is an error if a field in this list has a |
| // non-empty value. This may be used to include null fields in Patch |
| // requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *RelationshipStatus) MarshalJSON() ([]byte, error) { |
| type NoMethod RelationshipStatus |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Residence: A person's past or current residence. |
| type Residence struct { |
| // Current: True if the residence is the person's current |
| // residence; |
| // false if the residence is a past residence. |
| Current bool `json:"current,omitempty"` |
| |
| // Metadata: Metadata about the residence. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The address of the residence. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Current") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Current") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Residence) MarshalJSON() ([]byte, error) { |
| type NoMethod Residence |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // SipAddress: A person's SIP address. Session Initial Protocol |
| // addresses are used for VoIP |
| // communications to make voice or video calls over the internet. |
| type SipAddress struct { |
| // FormattedType: The read-only type of the SIP address translated and |
| // formatted in the |
| // viewer's account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the SIP address. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the SIP address. The type can be custom or or one |
| // of these |
| // predefined values: |
| // |
| // * `home` |
| // * `work` |
| // * `mobile` |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // Value: The SIP address in the |
| // [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP |
| // URI |
| // format. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedType") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedType") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *SipAddress) MarshalJSON() ([]byte, error) { |
| type NoMethod SipAddress |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Skill: A skill that the person has. |
| type Skill struct { |
| // Metadata: Metadata about the skill. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The skill; for example, `underwater basket weaving`. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Skill) MarshalJSON() ([]byte, error) { |
| type NoMethod Skill |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Source: The source of a field. |
| type Source struct { |
| // Etag: **Only populated in `person.metadata.sources`.** |
| // |
| // The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of |
| // the |
| // source. Used for web cache validation. |
| Etag string `json:"etag,omitempty"` |
| |
| // Id: The unique identifier within the source type generated by the |
| // server. |
| Id string `json:"id,omitempty"` |
| |
| // ProfileMetadata: **Only populated in |
| // `person.metadata.sources`.** |
| // |
| // Metadata about a source of type PROFILE. |
| ProfileMetadata *ProfileMetadata `json:"profileMetadata,omitempty"` |
| |
| // Type: The source type. |
| // |
| // Possible values: |
| // "SOURCE_TYPE_UNSPECIFIED" - Unspecified. |
| // "ACCOUNT" - [Google Account](https://accounts.google.com). |
| // "PROFILE" - [Google profile](https://profiles.google.com). You can |
| // view the |
| // profile at https://profiles.google.com/<var>id</var> |
| // where |
| // <var>id</var> is the source id. |
| // "DOMAIN_PROFILE" - [Google Apps domain |
| // profile](https://admin.google.com). |
| // "CONTACT" - [Google contact](https://contacts.google.com). You can |
| // view the |
| // contact at https://contact.google.com/<var>id</var> where |
| // <var>id</var> |
| // is the source id. |
| Type string `json:"type,omitempty"` |
| |
| // UpdateTime: **Only populated in `person.metadata.sources`.** |
| // |
| // Last update timestamp of this source. |
| UpdateTime string `json:"updateTime,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Etag") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Etag") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Source) MarshalJSON() ([]byte, error) { |
| type NoMethod Source |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Status: The `Status` type defines a logical error model that is |
| // suitable for different |
| // programming environments, including REST APIs and RPC APIs. It is |
| // used by |
| // [gRPC](https://github.com/grpc). The error model is designed to |
| // be: |
| // |
| // - Simple to use and understand for most users |
| // - Flexible enough to meet unexpected needs |
| // |
| // # Overview |
| // |
| // The `Status` message contains three pieces of data: error code, error |
| // message, |
| // and error details. The error code should be an enum value |
| // of |
| // google.rpc.Code, but it may accept additional error codes if needed. |
| // The |
| // error message should be a developer-facing English message that |
| // helps |
| // developers *understand* and *resolve* the error. If a localized |
| // user-facing |
| // error message is needed, put the localized message in the error |
| // details or |
| // localize it in the client. The optional error details may contain |
| // arbitrary |
| // information about the error. There is a predefined set of error |
| // detail types |
| // in the package `google.rpc` that can be used for common error |
| // conditions. |
| // |
| // # Language mapping |
| // |
| // The `Status` message is the logical representation of the error |
| // model, but it |
| // is not necessarily the actual wire format. When the `Status` message |
| // is |
| // exposed in different client libraries and different wire protocols, |
| // it can be |
| // mapped differently. For example, it will likely be mapped to some |
| // exceptions |
| // in Java, but more likely mapped to some error codes in C. |
| // |
| // # Other uses |
| // |
| // The error model and the `Status` message can be used in a variety |
| // of |
| // environments, either with or without APIs, to provide a |
| // consistent developer experience across different |
| // environments. |
| // |
| // Example uses of this error model include: |
| // |
| // - Partial errors. If a service needs to return partial errors to the |
| // client, |
| // it may embed the `Status` in the normal response to indicate the |
| // partial |
| // errors. |
| // |
| // - Workflow errors. A typical workflow has multiple steps. Each step |
| // may |
| // have a `Status` message for error reporting. |
| // |
| // - Batch operations. If a client uses batch request and batch |
| // response, the |
| // `Status` message should be used directly inside batch response, |
| // one for |
| // each error sub-response. |
| // |
| // - Asynchronous operations. If an API call embeds asynchronous |
| // operation |
| // results in its response, the status of those operations should |
| // be |
| // represented directly using the `Status` message. |
| // |
| // - Logging. If some API errors are stored in logs, the message |
| // `Status` could |
| // be used directly after any stripping needed for security/privacy |
| // reasons. |
| type Status struct { |
| // Code: The status code, which should be an enum value of |
| // google.rpc.Code. |
| Code int64 `json:"code,omitempty"` |
| |
| // Details: A list of messages that carry the error details. There is a |
| // common set of |
| // message types for APIs to use. |
| Details []googleapi.RawMessage `json:"details,omitempty"` |
| |
| // Message: 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 `json:"message,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Code") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Code") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Status) MarshalJSON() ([]byte, error) { |
| type NoMethod Status |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Tagline: A read-only brief one-line description of the person. |
| type Tagline struct { |
| // Metadata: Metadata about the tagline. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The tagline. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Metadata") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Metadata") to include in |
| // API requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Tagline) MarshalJSON() ([]byte, error) { |
| type NoMethod Tagline |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // UpdateContactGroupRequest: A request to update an existing user |
| // contact group. All updated fields will |
| // be replaced. |
| type UpdateContactGroupRequest struct { |
| // ContactGroup: The contact group to update. |
| ContactGroup *ContactGroup `json:"contactGroup,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "ContactGroup") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "ContactGroup") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *UpdateContactGroupRequest) MarshalJSON() ([]byte, error) { |
| type NoMethod UpdateContactGroupRequest |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // Url: A person's associated URLs. |
| type Url struct { |
| // FormattedType: The read-only type of the URL translated and formatted |
| // in the viewer's |
| // account locale or the `Accept-Language` HTTP header locale. |
| FormattedType string `json:"formattedType,omitempty"` |
| |
| // Metadata: Metadata about the URL. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Type: The type of the URL. The type can be custom or one of these |
| // predefined |
| // values: |
| // |
| // * `home` |
| // * `work` |
| // * `blog` |
| // * `profile` |
| // * `homePage` |
| // * `ftp` |
| // * `reservations` |
| // * `appInstallPage`: website for a Google+ application. |
| // * `other` |
| Type string `json:"type,omitempty"` |
| |
| // Value: The URL. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "FormattedType") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "FormattedType") to include |
| // in API requests with the JSON null value. By default, fields with |
| // empty values are omitted from API requests. However, any field with |
| // an empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *Url) MarshalJSON() ([]byte, error) { |
| type NoMethod Url |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // UserDefined: Arbitrary user data that is populated by the end users. |
| type UserDefined struct { |
| // Key: The end user specified key of the user defined data. |
| Key string `json:"key,omitempty"` |
| |
| // Metadata: Metadata about the user defined data. |
| Metadata *FieldMetadata `json:"metadata,omitempty"` |
| |
| // Value: The end user specified value of the user defined data. |
| Value string `json:"value,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "Key") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| |
| // NullFields is a list of field names (e.g. "Key") to include in API |
| // requests with the JSON null value. By default, fields with empty |
| // values are omitted from API requests. However, any field with an |
| // empty value appearing in NullFields will be sent to the server as |
| // null. It is an error if a field in this list has a non-empty value. |
| // This may be used to include null fields in Patch requests. |
| NullFields []string `json:"-"` |
| } |
| |
| func (s *UserDefined) MarshalJSON() ([]byte, error) { |
| type NoMethod UserDefined |
| raw := NoMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) |
| } |
| |
| // method id "people.contactGroups.batchGet": |
| |
| type ContactGroupsBatchGetCall struct { |
| s *Service |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // BatchGet: Get a list of contact groups owned by the authenticated |
| // user by specifying |
| // a list of contact group resource names. |
| func (r *ContactGroupsService) BatchGet() *ContactGroupsBatchGetCall { |
| c := &ContactGroupsBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| return c |
| } |
| |
| // MaxMembers sets the optional parameter "maxMembers": Specifies the |
| // maximum number of members to return for each group. |
| func (c *ContactGroupsBatchGetCall) MaxMembers(maxMembers int64) *ContactGroupsBatchGetCall { |
| c.urlParams_.Set("maxMembers", fmt.Sprint(maxMembers)) |
| return c |
| } |
| |
| // ResourceNames sets the optional parameter "resourceNames": The |
| // resource names of the contact groups to get. |
| func (c *ContactGroupsBatchGetCall) ResourceNames(resourceNames ...string) *ContactGroupsBatchGetCall { |
| c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsBatchGetCall) Fields(s ...googleapi.Field) *ContactGroupsBatchGetCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *ContactGroupsBatchGetCall) IfNoneMatch(entityTag string) *ContactGroupsBatchGetCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsBatchGetCall) Context(ctx context.Context) *ContactGroupsBatchGetCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsBatchGetCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsBatchGetCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/contactGroups:batchGet") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.batchGet" call. |
| // Exactly one of *BatchGetContactGroupsResponse or error will be |
| // non-nil. Any non-2xx status code is an error. Response headers are in |
| // either *BatchGetContactGroupsResponse.ServerResponse.Header or (if a |
| // response was returned at all) in error.(*googleapi.Error).Header. Use |
| // googleapi.IsNotModified to check whether the returned error was |
| // because http.StatusNotModified was returned. |
| func (c *ContactGroupsBatchGetCall) Do(opts ...googleapi.CallOption) (*BatchGetContactGroupsResponse, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &BatchGetContactGroupsResponse{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Get a list of contact groups owned by the authenticated user by specifying\na list of contact group resource names.", |
| // "flatPath": "v1/contactGroups:batchGet", |
| // "httpMethod": "GET", |
| // "id": "people.contactGroups.batchGet", |
| // "parameterOrder": [], |
| // "parameters": { |
| // "maxMembers": { |
| // "description": "Specifies the maximum number of members to return for each group.", |
| // "format": "int32", |
| // "location": "query", |
| // "type": "integer" |
| // }, |
| // "resourceNames": { |
| // "description": "The resource names of the contact groups to get.", |
| // "location": "query", |
| // "repeated": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/contactGroups:batchGet", |
| // "response": { |
| // "$ref": "BatchGetContactGroupsResponse" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.contactGroups.create": |
| |
| type ContactGroupsCreateCall struct { |
| s *Service |
| createcontactgrouprequest *CreateContactGroupRequest |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Create: Create a new contact group owned by the authenticated user. |
| func (r *ContactGroupsService) Create(createcontactgrouprequest *CreateContactGroupRequest) *ContactGroupsCreateCall { |
| c := &ContactGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.createcontactgrouprequest = createcontactgrouprequest |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsCreateCall) Fields(s ...googleapi.Field) *ContactGroupsCreateCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsCreateCall) Context(ctx context.Context) *ContactGroupsCreateCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsCreateCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsCreateCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.createcontactgrouprequest) |
| if err != nil { |
| return nil, err |
| } |
| reqHeaders.Set("Content-Type", "application/json") |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/contactGroups") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("POST", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.create" call. |
| // Exactly one of *ContactGroup or error will be non-nil. Any non-2xx |
| // status code is an error. Response headers are in either |
| // *ContactGroup.ServerResponse.Header or (if a response was returned at |
| // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified |
| // to check whether the returned error was because |
| // http.StatusNotModified was returned. |
| func (c *ContactGroupsCreateCall) Do(opts ...googleapi.CallOption) (*ContactGroup, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ContactGroup{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Create a new contact group owned by the authenticated user.", |
| // "flatPath": "v1/contactGroups", |
| // "httpMethod": "POST", |
| // "id": "people.contactGroups.create", |
| // "parameterOrder": [], |
| // "parameters": {}, |
| // "path": "v1/contactGroups", |
| // "request": { |
| // "$ref": "CreateContactGroupRequest" |
| // }, |
| // "response": { |
| // "$ref": "ContactGroup" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.contactGroups.delete": |
| |
| type ContactGroupsDeleteCall struct { |
| s *Service |
| resourceName string |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Delete: Delete an existing contact group owned by the authenticated |
| // user by |
| // specifying a contact group resource name. |
| func (r *ContactGroupsService) Delete(resourceName string) *ContactGroupsDeleteCall { |
| c := &ContactGroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| return c |
| } |
| |
| // DeleteContacts sets the optional parameter "deleteContacts": Set to |
| // true to also delete the contacts in the specified group. |
| func (c *ContactGroupsDeleteCall) DeleteContacts(deleteContacts bool) *ContactGroupsDeleteCall { |
| c.urlParams_.Set("deleteContacts", fmt.Sprint(deleteContacts)) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsDeleteCall) Fields(s ...googleapi.Field) *ContactGroupsDeleteCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsDeleteCall) Context(ctx context.Context) *ContactGroupsDeleteCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsDeleteCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsDeleteCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("DELETE", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.delete" call. |
| // Exactly one of *Empty or error will be non-nil. Any non-2xx status |
| // code is an error. Response headers are in either |
| // *Empty.ServerResponse.Header or (if a response was returned at all) |
| // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to |
| // check whether the returned error was because http.StatusNotModified |
| // was returned. |
| func (c *ContactGroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &Empty{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Delete an existing contact group owned by the authenticated user by\nspecifying a contact group resource name.", |
| // "flatPath": "v1/contactGroups/{contactGroupsId}", |
| // "httpMethod": "DELETE", |
| // "id": "people.contactGroups.delete", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "deleteContacts": { |
| // "description": "Set to true to also delete the contacts in the specified group.", |
| // "location": "query", |
| // "type": "boolean" |
| // }, |
| // "resourceName": { |
| // "description": "The resource name of the contact group to delete.", |
| // "location": "path", |
| // "pattern": "^contactGroups/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}", |
| // "response": { |
| // "$ref": "Empty" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.contactGroups.get": |
| |
| type ContactGroupsGetCall struct { |
| s *Service |
| resourceName string |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Get: Get a specific contact group owned by the authenticated user by |
| // specifying |
| // a contact group resource name. |
| func (r *ContactGroupsService) Get(resourceName string) *ContactGroupsGetCall { |
| c := &ContactGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| return c |
| } |
| |
| // MaxMembers sets the optional parameter "maxMembers": Specifies the |
| // maximum number of members to return. |
| func (c *ContactGroupsGetCall) MaxMembers(maxMembers int64) *ContactGroupsGetCall { |
| c.urlParams_.Set("maxMembers", fmt.Sprint(maxMembers)) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsGetCall) Fields(s ...googleapi.Field) *ContactGroupsGetCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *ContactGroupsGetCall) IfNoneMatch(entityTag string) *ContactGroupsGetCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsGetCall) Context(ctx context.Context) *ContactGroupsGetCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsGetCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsGetCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.get" call. |
| // Exactly one of *ContactGroup or error will be non-nil. Any non-2xx |
| // status code is an error. Response headers are in either |
| // *ContactGroup.ServerResponse.Header or (if a response was returned at |
| // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified |
| // to check whether the returned error was because |
| // http.StatusNotModified was returned. |
| func (c *ContactGroupsGetCall) Do(opts ...googleapi.CallOption) (*ContactGroup, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ContactGroup{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Get a specific contact group owned by the authenticated user by specifying\na contact group resource name.", |
| // "flatPath": "v1/contactGroups/{contactGroupsId}", |
| // "httpMethod": "GET", |
| // "id": "people.contactGroups.get", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "maxMembers": { |
| // "description": "Specifies the maximum number of members to return.", |
| // "format": "int32", |
| // "location": "query", |
| // "type": "integer" |
| // }, |
| // "resourceName": { |
| // "description": "The resource name of the contact group to get.", |
| // "location": "path", |
| // "pattern": "^contactGroups/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}", |
| // "response": { |
| // "$ref": "ContactGroup" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.contactGroups.list": |
| |
| type ContactGroupsListCall struct { |
| s *Service |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // List: List all contact groups owned by the authenticated user. |
| // Members of the |
| // contact groups are not populated. |
| func (r *ContactGroupsService) List() *ContactGroupsListCall { |
| c := &ContactGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| return c |
| } |
| |
| // PageSize sets the optional parameter "pageSize": The maximum number |
| // of resources to return. |
| func (c *ContactGroupsListCall) PageSize(pageSize int64) *ContactGroupsListCall { |
| c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) |
| return c |
| } |
| |
| // PageToken sets the optional parameter "pageToken": The |
| // next_page_token value returned from a previous call |
| // to |
| // [ListContactGroups](/people/api/rest/v1/contactgroups/list). |
| // Reques |
| // ts the next page of resources. |
| func (c *ContactGroupsListCall) PageToken(pageToken string) *ContactGroupsListCall { |
| c.urlParams_.Set("pageToken", pageToken) |
| return c |
| } |
| |
| // SyncToken sets the optional parameter "syncToken": A sync token, |
| // returned by a previous call to `contactgroups.list`. |
| // Only resources changed since the sync token was created will be |
| // returned. |
| func (c *ContactGroupsListCall) SyncToken(syncToken string) *ContactGroupsListCall { |
| c.urlParams_.Set("syncToken", syncToken) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsListCall) Fields(s ...googleapi.Field) *ContactGroupsListCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *ContactGroupsListCall) IfNoneMatch(entityTag string) *ContactGroupsListCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsListCall) Context(ctx context.Context) *ContactGroupsListCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsListCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsListCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/contactGroups") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.list" call. |
| // Exactly one of *ListContactGroupsResponse or error will be non-nil. |
| // Any non-2xx status code is an error. Response headers are in either |
| // *ListContactGroupsResponse.ServerResponse.Header or (if a response |
| // was returned at all) in error.(*googleapi.Error).Header. Use |
| // googleapi.IsNotModified to check whether the returned error was |
| // because http.StatusNotModified was returned. |
| func (c *ContactGroupsListCall) Do(opts ...googleapi.CallOption) (*ListContactGroupsResponse, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ListContactGroupsResponse{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "List all contact groups owned by the authenticated user. Members of the\ncontact groups are not populated.", |
| // "flatPath": "v1/contactGroups", |
| // "httpMethod": "GET", |
| // "id": "people.contactGroups.list", |
| // "parameterOrder": [], |
| // "parameters": { |
| // "pageSize": { |
| // "description": "The maximum number of resources to return.", |
| // "format": "int32", |
| // "location": "query", |
| // "type": "integer" |
| // }, |
| // "pageToken": { |
| // "description": "The next_page_token value returned from a previous call to\n[ListContactGroups](/people/api/rest/v1/contactgroups/list).\nRequests the next page of resources.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "syncToken": { |
| // "description": "A sync token, returned by a previous call to `contactgroups.list`.\nOnly resources changed since the sync token was created will be returned.", |
| // "location": "query", |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/contactGroups", |
| // "response": { |
| // "$ref": "ListContactGroupsResponse" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly" |
| // ] |
| // } |
| |
| } |
| |
| // Pages invokes f for each page of results. |
| // A non-nil error returned from f will halt the iteration. |
| // The provided context supersedes any context provided to the Context method. |
| func (c *ContactGroupsListCall) Pages(ctx context.Context, f func(*ListContactGroupsResponse) error) error { |
| c.ctx_ = ctx |
| defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point |
| for { |
| x, err := c.Do() |
| if err != nil { |
| return err |
| } |
| if err := f(x); err != nil { |
| return err |
| } |
| if x.NextPageToken == "" { |
| return nil |
| } |
| c.PageToken(x.NextPageToken) |
| } |
| } |
| |
| // method id "people.contactGroups.update": |
| |
| type ContactGroupsUpdateCall struct { |
| s *Service |
| resourceName string |
| updatecontactgrouprequest *UpdateContactGroupRequest |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Update: Update the name of an existing contact group owned by the |
| // authenticated |
| // user. |
| func (r *ContactGroupsService) Update(resourceName string, updatecontactgrouprequest *UpdateContactGroupRequest) *ContactGroupsUpdateCall { |
| c := &ContactGroupsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| c.updatecontactgrouprequest = updatecontactgrouprequest |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsUpdateCall) Fields(s ...googleapi.Field) *ContactGroupsUpdateCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsUpdateCall) Context(ctx context.Context) *ContactGroupsUpdateCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsUpdateCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsUpdateCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.updatecontactgrouprequest) |
| if err != nil { |
| return nil, err |
| } |
| reqHeaders.Set("Content-Type", "application/json") |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("PUT", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.update" call. |
| // Exactly one of *ContactGroup or error will be non-nil. Any non-2xx |
| // status code is an error. Response headers are in either |
| // *ContactGroup.ServerResponse.Header or (if a response was returned at |
| // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified |
| // to check whether the returned error was because |
| // http.StatusNotModified was returned. |
| func (c *ContactGroupsUpdateCall) Do(opts ...googleapi.CallOption) (*ContactGroup, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ContactGroup{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Update the name of an existing contact group owned by the authenticated\nuser.", |
| // "flatPath": "v1/contactGroups/{contactGroupsId}", |
| // "httpMethod": "PUT", |
| // "id": "people.contactGroups.update", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "resourceName": { |
| // "description": "The resource name for the contact group, assigned by the server. An ASCII\nstring, in the form of `contactGroups/`\u003cvar\u003econtact_group_id\u003c/var\u003e.", |
| // "location": "path", |
| // "pattern": "^contactGroups/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}", |
| // "request": { |
| // "$ref": "UpdateContactGroupRequest" |
| // }, |
| // "response": { |
| // "$ref": "ContactGroup" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.contactGroups.members.modify": |
| |
| type ContactGroupsMembersModifyCall struct { |
| s *Service |
| resourceName string |
| modifycontactgroupmembersrequest *ModifyContactGroupMembersRequest |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Modify: Modify the members of a contact group owned by the |
| // authenticated user. |
| func (r *ContactGroupsMembersService) Modify(resourceName string, modifycontactgroupmembersrequest *ModifyContactGroupMembersRequest) *ContactGroupsMembersModifyCall { |
| c := &ContactGroupsMembersModifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| c.modifycontactgroupmembersrequest = modifycontactgroupmembersrequest |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *ContactGroupsMembersModifyCall) Fields(s ...googleapi.Field) *ContactGroupsMembersModifyCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *ContactGroupsMembersModifyCall) Context(ctx context.Context) *ContactGroupsMembersModifyCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *ContactGroupsMembersModifyCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *ContactGroupsMembersModifyCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.modifycontactgroupmembersrequest) |
| if err != nil { |
| return nil, err |
| } |
| reqHeaders.Set("Content-Type", "application/json") |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}/members:modify") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("POST", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.contactGroups.members.modify" call. |
| // Exactly one of *ModifyContactGroupMembersResponse or error will be |
| // non-nil. Any non-2xx status code is an error. Response headers are in |
| // either *ModifyContactGroupMembersResponse.ServerResponse.Header or |
| // (if a response was returned at all) in |
| // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check |
| // whether the returned error was because http.StatusNotModified was |
| // returned. |
| func (c *ContactGroupsMembersModifyCall) Do(opts ...googleapi.CallOption) (*ModifyContactGroupMembersResponse, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ModifyContactGroupMembersResponse{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Modify the members of a contact group owned by the authenticated user.", |
| // "flatPath": "v1/contactGroups/{contactGroupsId}/members:modify", |
| // "httpMethod": "POST", |
| // "id": "people.contactGroups.members.modify", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "resourceName": { |
| // "description": "The resource name of the contact group to modify.", |
| // "location": "path", |
| // "pattern": "^contactGroups/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}/members:modify", |
| // "request": { |
| // "$ref": "ModifyContactGroupMembersRequest" |
| // }, |
| // "response": { |
| // "$ref": "ModifyContactGroupMembersResponse" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.createContact": |
| |
| type PeopleCreateContactCall struct { |
| s *Service |
| person *Person |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // CreateContact: Create a new contact and return the person resource |
| // for that contact. |
| func (r *PeopleService) CreateContact(person *Person) *PeopleCreateContactCall { |
| c := &PeopleCreateContactCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.person = person |
| return c |
| } |
| |
| // Parent sets the optional parameter "parent": The resource name of the |
| // owning person resource. |
| func (c *PeopleCreateContactCall) Parent(parent string) *PeopleCreateContactCall { |
| c.urlParams_.Set("parent", parent) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleCreateContactCall) Fields(s ...googleapi.Field) *PeopleCreateContactCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleCreateContactCall) Context(ctx context.Context) *PeopleCreateContactCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleCreateContactCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleCreateContactCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.person) |
| if err != nil { |
| return nil, err |
| } |
| reqHeaders.Set("Content-Type", "application/json") |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/people:createContact") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("POST", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.createContact" call. |
| // Exactly one of *Person or error will be non-nil. Any non-2xx status |
| // code is an error. Response headers are in either |
| // *Person.ServerResponse.Header or (if a response was returned at all) |
| // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to |
| // check whether the returned error was because http.StatusNotModified |
| // was returned. |
| func (c *PeopleCreateContactCall) Do(opts ...googleapi.CallOption) (*Person, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &Person{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Create a new contact and return the person resource for that contact.", |
| // "flatPath": "v1/people:createContact", |
| // "httpMethod": "POST", |
| // "id": "people.people.createContact", |
| // "parameterOrder": [], |
| // "parameters": { |
| // "parent": { |
| // "description": "The resource name of the owning person resource.", |
| // "location": "query", |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/people:createContact", |
| // "request": { |
| // "$ref": "Person" |
| // }, |
| // "response": { |
| // "$ref": "Person" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.deleteContact": |
| |
| type PeopleDeleteContactCall struct { |
| s *Service |
| resourceName string |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // DeleteContact: Delete a contact person. Any non-contact data will not |
| // be deleted. |
| func (r *PeopleService) DeleteContact(resourceName string) *PeopleDeleteContactCall { |
| c := &PeopleDeleteContactCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleDeleteContactCall) Fields(s ...googleapi.Field) *PeopleDeleteContactCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleDeleteContactCall) Context(ctx context.Context) *PeopleDeleteContactCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleDeleteContactCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleDeleteContactCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}:deleteContact") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("DELETE", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.deleteContact" call. |
| // Exactly one of *Empty or error will be non-nil. Any non-2xx status |
| // code is an error. Response headers are in either |
| // *Empty.ServerResponse.Header or (if a response was returned at all) |
| // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to |
| // check whether the returned error was because http.StatusNotModified |
| // was returned. |
| func (c *PeopleDeleteContactCall) Do(opts ...googleapi.CallOption) (*Empty, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &Empty{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Delete a contact person. Any non-contact data will not be deleted.", |
| // "flatPath": "v1/people/{peopleId}:deleteContact", |
| // "httpMethod": "DELETE", |
| // "id": "people.people.deleteContact", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "resourceName": { |
| // "description": "The resource name of the contact to delete.", |
| // "location": "path", |
| // "pattern": "^people/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}:deleteContact", |
| // "response": { |
| // "$ref": "Empty" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.get": |
| |
| type PeopleGetCall struct { |
| s *Service |
| resourceName string |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // Get: 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. |
| func (r *PeopleService) Get(resourceName string) *PeopleGetCall { |
| c := &PeopleGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| return c |
| } |
| |
| // PersonFields sets the optional parameter "personFields": |
| // **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: |
| // |
| // * addresses |
| // * ageRanges |
| // * biographies |
| // * birthdays |
| // * braggingRights |
| // * coverPhotos |
| // * emailAddresses |
| // * events |
| // * genders |
| // * imClients |
| // * interests |
| // * locales |
| // * memberships |
| // * metadata |
| // * names |
| // * nicknames |
| // * occupations |
| // * organizations |
| // * phoneNumbers |
| // * photos |
| // * relations |
| // * relationshipInterests |
| // * relationshipStatuses |
| // * residences |
| // * sipAddresses |
| // * skills |
| // * taglines |
| // * urls |
| // * userDefined |
| func (c *PeopleGetCall) PersonFields(personFields string) *PeopleGetCall { |
| c.urlParams_.Set("personFields", personFields) |
| return c |
| } |
| |
| // RequestMaskIncludeField sets the optional parameter |
| // "requestMask.includeField": **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`. |
| func (c *PeopleGetCall) RequestMaskIncludeField(requestMaskIncludeField string) *PeopleGetCall { |
| c.urlParams_.Set("requestMask.includeField", requestMaskIncludeField) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleGetCall) Fields(s ...googleapi.Field) *PeopleGetCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *PeopleGetCall) IfNoneMatch(entityTag string) *PeopleGetCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleGetCall) Context(ctx context.Context) *PeopleGetCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleGetCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleGetCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.get" call. |
| // Exactly one of *Person or error will be non-nil. Any non-2xx status |
| // code is an error. Response headers are in either |
| // *Person.ServerResponse.Header or (if a response was returned at all) |
| // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to |
| // check whether the returned error was because http.StatusNotModified |
| // was returned. |
| func (c *PeopleGetCall) Do(opts ...googleapi.CallOption) (*Person, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &Person{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Provides information about a person by specifying a resource name. Use\n`people/me` to indicate the authenticated user.\n\u003cbr\u003e\nThe request throws a 400 error if 'personFields' is not specified.", |
| // "flatPath": "v1/people/{peopleId}", |
| // "httpMethod": "GET", |
| // "id": "people.people.get", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "personFields": { |
| // "description": "**Required.** A field mask to restrict which fields on the person are\nreturned. Multiple fields can be specified by separating them with commas.\nValid values are:\n\n* addresses\n* ageRanges\n* biographies\n* birthdays\n* braggingRights\n* coverPhotos\n* emailAddresses\n* events\n* genders\n* imClients\n* interests\n* locales\n* memberships\n* metadata\n* names\n* nicknames\n* occupations\n* organizations\n* phoneNumbers\n* photos\n* relations\n* relationshipInterests\n* relationshipStatuses\n* residences\n* sipAddresses\n* skills\n* taglines\n* urls\n* userDefined", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "requestMask.includeField": { |
| // "description": "**Required.** Comma-separated list of person fields to be included in the\nresponse. Each path should start with `person.`: for example,\n`person.names` or `person.photos`.", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "resourceName": { |
| // "description": "The resource name of the person to provide information about.\n\n- To get information about the authenticated user, specify `people/me`.\n- To get information about a google account, specify\n `people/`\u003cvar\u003eaccount_id\u003c/var\u003e.\n- To get information about a contact, specify the resource name that\n identifies the contact as returned by\n[`people.connections.list`](/people/api/rest/v1/people.connections/list).", |
| // "location": "path", |
| // "pattern": "^people/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}", |
| // "response": { |
| // "$ref": "Person" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly", |
| // "https://www.googleapis.com/auth/plus.login", |
| // "https://www.googleapis.com/auth/user.addresses.read", |
| // "https://www.googleapis.com/auth/user.birthday.read", |
| // "https://www.googleapis.com/auth/user.emails.read", |
| // "https://www.googleapis.com/auth/user.phonenumbers.read", |
| // "https://www.googleapis.com/auth/userinfo.email", |
| // "https://www.googleapis.com/auth/userinfo.profile" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.getBatchGet": |
| |
| type PeopleGetBatchGetCall struct { |
| s *Service |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // GetBatchGet: 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. |
| func (r *PeopleService) GetBatchGet() *PeopleGetBatchGetCall { |
| c := &PeopleGetBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| return c |
| } |
| |
| // PersonFields sets the optional parameter "personFields": |
| // **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: |
| // |
| // * addresses |
| // * ageRanges |
| // * biographies |
| // * birthdays |
| // * braggingRights |
| // * coverPhotos |
| // * emailAddresses |
| // * events |
| // * genders |
| // * imClients |
| // * interests |
| // * locales |
| // * memberships |
| // * metadata |
| // * names |
| // * nicknames |
| // * occupations |
| // * organizations |
| // * phoneNumbers |
| // * photos |
| // * relations |
| // * relationshipInterests |
| // * relationshipStatuses |
| // * residences |
| // * sipAddresses |
| // * skills |
| // * taglines |
| // * urls |
| // * userDefined |
| func (c *PeopleGetBatchGetCall) PersonFields(personFields string) *PeopleGetBatchGetCall { |
| c.urlParams_.Set("personFields", personFields) |
| return c |
| } |
| |
| // RequestMaskIncludeField sets the optional parameter |
| // "requestMask.includeField": **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`. |
| func (c *PeopleGetBatchGetCall) RequestMaskIncludeField(requestMaskIncludeField string) *PeopleGetBatchGetCall { |
| c.urlParams_.Set("requestMask.includeField", requestMaskIncludeField) |
| return c |
| } |
| |
| // ResourceNames sets the optional parameter "resourceNames": 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`](/people/api/rest/v1/people.connections/ |
| // list). |
| // |
| // You can include up to 50 resource names in one request. |
| func (c *PeopleGetBatchGetCall) ResourceNames(resourceNames ...string) *PeopleGetBatchGetCall { |
| c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleGetBatchGetCall) Fields(s ...googleapi.Field) *PeopleGetBatchGetCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *PeopleGetBatchGetCall) IfNoneMatch(entityTag string) *PeopleGetBatchGetCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleGetBatchGetCall) Context(ctx context.Context) *PeopleGetBatchGetCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleGetBatchGetCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleGetBatchGetCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/people:batchGet") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.getBatchGet" call. |
| // Exactly one of *GetPeopleResponse or error will be non-nil. Any |
| // non-2xx status code is an error. Response headers are in either |
| // *GetPeopleResponse.ServerResponse.Header or (if a response was |
| // returned at all) in error.(*googleapi.Error).Header. Use |
| // googleapi.IsNotModified to check whether the returned error was |
| // because http.StatusNotModified was returned. |
| func (c *PeopleGetBatchGetCall) Do(opts ...googleapi.CallOption) (*GetPeopleResponse, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &GetPeopleResponse{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Provides information about a list of specific people by specifying a list\nof requested resource names. Use `people/me` to indicate the authenticated\nuser.\n\u003cbr\u003e\nThe request throws a 400 error if 'personFields' is not specified.", |
| // "flatPath": "v1/people:batchGet", |
| // "httpMethod": "GET", |
| // "id": "people.people.getBatchGet", |
| // "parameterOrder": [], |
| // "parameters": { |
| // "personFields": { |
| // "description": "**Required.** A field mask to restrict which fields on each person are\nreturned. Multiple fields can be specified by separating them with commas.\nValid values are:\n\n* addresses\n* ageRanges\n* biographies\n* birthdays\n* braggingRights\n* coverPhotos\n* emailAddresses\n* events\n* genders\n* imClients\n* interests\n* locales\n* memberships\n* metadata\n* names\n* nicknames\n* occupations\n* organizations\n* phoneNumbers\n* photos\n* relations\n* relationshipInterests\n* relationshipStatuses\n* residences\n* sipAddresses\n* skills\n* taglines\n* urls\n* userDefined", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "requestMask.includeField": { |
| // "description": "**Required.** Comma-separated list of person fields to be included in the\nresponse. Each path should start with `person.`: for example,\n`person.names` or `person.photos`.", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "resourceNames": { |
| // "description": "The resource names of the people to provide information about.\n\n- To get information about the authenticated user, specify `people/me`.\n- To get information about a google account, specify\n `people/`\u003cvar\u003eaccount_id\u003c/var\u003e.\n- To get information about a contact, specify the resource name that\n identifies the contact as returned by\n[`people.connections.list`](/people/api/rest/v1/people.connections/list).\n\nYou can include up to 50 resource names in one request.", |
| // "location": "query", |
| // "repeated": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/people:batchGet", |
| // "response": { |
| // "$ref": "GetPeopleResponse" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly", |
| // "https://www.googleapis.com/auth/plus.login", |
| // "https://www.googleapis.com/auth/user.addresses.read", |
| // "https://www.googleapis.com/auth/user.birthday.read", |
| // "https://www.googleapis.com/auth/user.emails.read", |
| // "https://www.googleapis.com/auth/user.phonenumbers.read", |
| // "https://www.googleapis.com/auth/userinfo.email", |
| // "https://www.googleapis.com/auth/userinfo.profile" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.updateContact": |
| |
| type PeopleUpdateContactCall struct { |
| s *Service |
| resourceName string |
| person *Person |
| urlParams_ gensupport.URLParams |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // UpdateContact: 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. |
| func (r *PeopleService) UpdateContact(resourceName string, person *Person) *PeopleUpdateContactCall { |
| c := &PeopleUpdateContactCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| c.person = person |
| return c |
| } |
| |
| // UpdatePersonFields sets the optional parameter "updatePersonFields": |
| // **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: |
| // |
| // * addresses |
| // * biographies |
| // * birthdays |
| // * emailAddresses |
| // * events |
| // * genders |
| // * imClients |
| // * interests |
| // * locales |
| // * names |
| // * nicknames |
| // * occupations |
| // * organizations |
| // * phoneNumbers |
| // * relations |
| // * residences |
| // * sipAddresses |
| // * urls |
| // * userDefined |
| func (c *PeopleUpdateContactCall) UpdatePersonFields(updatePersonFields string) *PeopleUpdateContactCall { |
| c.urlParams_.Set("updatePersonFields", updatePersonFields) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleUpdateContactCall) Fields(s ...googleapi.Field) *PeopleUpdateContactCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleUpdateContactCall) Context(ctx context.Context) *PeopleUpdateContactCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleUpdateContactCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleUpdateContactCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.person) |
| if err != nil { |
| return nil, err |
| } |
| reqHeaders.Set("Content-Type", "application/json") |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}:updateContact") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("PATCH", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.updateContact" call. |
| // Exactly one of *Person or error will be non-nil. Any non-2xx status |
| // code is an error. Response headers are in either |
| // *Person.ServerResponse.Header or (if a response was returned at all) |
| // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to |
| // check whether the returned error was because http.StatusNotModified |
| // was returned. |
| func (c *PeopleUpdateContactCall) Do(opts ...googleapi.CallOption) (*Person, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &Person{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Update contact data for an existing contact person. Any non-contact data\nwill not be modified.\n\nThe request throws a 400 error if `updatePersonFields` is not specified.\n\u003cbr\u003e\nThe request throws a 400 error if `person.metadata.sources` is not\nspecified for the contact to be updated.\n\u003cbr\u003e\nThe request throws a 412 error if `person.metadata.sources.etag` is\ndifferent than the contact's etag, which indicates the contact has changed\nsince its data was read. Clients should get the latest person and re-apply\ntheir updates to the latest person.", |
| // "flatPath": "v1/people/{peopleId}:updateContact", |
| // "httpMethod": "PATCH", |
| // "id": "people.people.updateContact", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "resourceName": { |
| // "description": "The resource name for the person, assigned by the server. An ASCII string\nwith a max length of 27 characters, in the form of\n`people/`\u003cvar\u003eperson_id\u003c/var\u003e.", |
| // "location": "path", |
| // "pattern": "^people/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // }, |
| // "updatePersonFields": { |
| // "description": "**Required.** A field mask to restrict which fields on the person are\nupdated. Multiple fields can be specified by separating them with commas.\nAll updated fields will be replaced. Valid values are:\n\n* addresses\n* biographies\n* birthdays\n* emailAddresses\n* events\n* genders\n* imClients\n* interests\n* locales\n* names\n* nicknames\n* occupations\n* organizations\n* phoneNumbers\n* relations\n* residences\n* sipAddresses\n* urls\n* userDefined", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}:updateContact", |
| // "request": { |
| // "$ref": "Person" |
| // }, |
| // "response": { |
| // "$ref": "Person" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts" |
| // ] |
| // } |
| |
| } |
| |
| // method id "people.people.connections.list": |
| |
| type PeopleConnectionsListCall struct { |
| s *Service |
| resourceName string |
| urlParams_ gensupport.URLParams |
| ifNoneMatch_ string |
| ctx_ context.Context |
| header_ http.Header |
| } |
| |
| // List: 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. |
| func (r *PeopleConnectionsService) List(resourceName string) *PeopleConnectionsListCall { |
| c := &PeopleConnectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.resourceName = resourceName |
| return c |
| } |
| |
| // PageSize sets the optional parameter "pageSize": The number of |
| // connections to include in the response. Valid values are |
| // between 1 and 2000, inclusive. Defaults to 100. |
| func (c *PeopleConnectionsListCall) PageSize(pageSize int64) *PeopleConnectionsListCall { |
| c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) |
| return c |
| } |
| |
| // PageToken sets the optional parameter "pageToken": The token of the |
| // page to be returned. |
| func (c *PeopleConnectionsListCall) PageToken(pageToken string) *PeopleConnectionsListCall { |
| c.urlParams_.Set("pageToken", pageToken) |
| return c |
| } |
| |
| // PersonFields sets the optional parameter "personFields": |
| // **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: |
| // |
| // * addresses |
| // * ageRanges |
| // * biographies |
| // * birthdays |
| // * braggingRights |
| // * coverPhotos |
| // * emailAddresses |
| // * events |
| // * genders |
| // * imClients |
| // * interests |
| // * locales |
| // * memberships |
| // * metadata |
| // * names |
| // * nicknames |
| // * occupations |
| // * organizations |
| // * phoneNumbers |
| // * photos |
| // * relations |
| // * relationshipInterests |
| // * relationshipStatuses |
| // * residences |
| // * sipAddresses |
| // * skills |
| // * taglines |
| // * urls |
| // * userDefined |
| func (c *PeopleConnectionsListCall) PersonFields(personFields string) *PeopleConnectionsListCall { |
| c.urlParams_.Set("personFields", personFields) |
| return c |
| } |
| |
| // RequestMaskIncludeField sets the optional parameter |
| // "requestMask.includeField": **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`. |
| func (c *PeopleConnectionsListCall) RequestMaskIncludeField(requestMaskIncludeField string) *PeopleConnectionsListCall { |
| c.urlParams_.Set("requestMask.includeField", requestMaskIncludeField) |
| return c |
| } |
| |
| // RequestSyncToken sets the optional parameter "requestSyncToken": |
| // Whether the response should include a sync token, which can be used |
| // to get |
| // all changes since the last request. For subsequent sync requests use |
| // the |
| // `sync_token` param instead. Initial sync requests that |
| // specify |
| // `request_sync_token` have an additional rate limit. |
| func (c *PeopleConnectionsListCall) RequestSyncToken(requestSyncToken bool) *PeopleConnectionsListCall { |
| c.urlParams_.Set("requestSyncToken", fmt.Sprint(requestSyncToken)) |
| return c |
| } |
| |
| // SortOrder sets the optional parameter "sortOrder": The order in which |
| // the connections should be sorted. Defaults |
| // to |
| // `LAST_MODIFIED_ASCENDING`. |
| // |
| // Possible values: |
| // "LAST_MODIFIED_ASCENDING" |
| // "FIRST_NAME_ASCENDING" |
| // "LAST_NAME_ASCENDING" |
| func (c *PeopleConnectionsListCall) SortOrder(sortOrder string) *PeopleConnectionsListCall { |
| c.urlParams_.Set("sortOrder", sortOrder) |
| return c |
| } |
| |
| // SyncToken sets the optional parameter "syncToken": A sync token |
| // returned by a previous call to `people.connections.list`. |
| // Only resources changed since the sync token was created will be |
| // returned. |
| // Sync requests that specify `sync_token` have an additional rate |
| // limit. |
| func (c *PeopleConnectionsListCall) SyncToken(syncToken string) *PeopleConnectionsListCall { |
| c.urlParams_.Set("syncToken", syncToken) |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *PeopleConnectionsListCall) Fields(s ...googleapi.Field) *PeopleConnectionsListCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // IfNoneMatch sets the optional parameter which makes the operation |
| // fail if the object's ETag matches the given value. This is useful for |
| // getting updates only after the object has changed since the last |
| // request. Use googleapi.IsNotModified to check whether the response |
| // error from Do is the result of In-None-Match. |
| func (c *PeopleConnectionsListCall) IfNoneMatch(entityTag string) *PeopleConnectionsListCall { |
| c.ifNoneMatch_ = entityTag |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| func (c *PeopleConnectionsListCall) Context(ctx context.Context) *PeopleConnectionsListCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| // Header returns an http.Header that can be modified by the caller to |
| // add HTTP headers to the request. |
| func (c *PeopleConnectionsListCall) Header() http.Header { |
| if c.header_ == nil { |
| c.header_ = make(http.Header) |
| } |
| return c.header_ |
| } |
| |
| func (c *PeopleConnectionsListCall) doRequest(alt string) (*http.Response, error) { |
| reqHeaders := make(http.Header) |
| for k, v := range c.header_ { |
| reqHeaders[k] = v |
| } |
| reqHeaders.Set("User-Agent", c.s.userAgent()) |
| if c.ifNoneMatch_ != "" { |
| reqHeaders.Set("If-None-Match", c.ifNoneMatch_) |
| } |
| var body io.Reader = nil |
| c.urlParams_.Set("alt", alt) |
| c.urlParams_.Set("prettyPrint", "false") |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resourceName}/connections") |
| urls += "?" + c.urlParams_.Encode() |
| req, err := http.NewRequest("GET", urls, body) |
| if err != nil { |
| return nil, err |
| } |
| req.Header = reqHeaders |
| googleapi.Expand(req.URL, map[string]string{ |
| "resourceName": c.resourceName, |
| }) |
| return gensupport.SendRequest(c.ctx_, c.s.client, req) |
| } |
| |
| // Do executes the "people.people.connections.list" call. |
| // Exactly one of *ListConnectionsResponse or error will be non-nil. Any |
| // non-2xx status code is an error. Response headers are in either |
| // *ListConnectionsResponse.ServerResponse.Header or (if a response was |
| // returned at all) in error.(*googleapi.Error).Header. Use |
| // googleapi.IsNotModified to check whether the returned error was |
| // because http.StatusNotModified was returned. |
| func (c *PeopleConnectionsListCall) Do(opts ...googleapi.CallOption) (*ListConnectionsResponse, error) { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := c.doRequest("json") |
| if res != nil && res.StatusCode == http.StatusNotModified { |
| if res.Body != nil { |
| res.Body.Close() |
| } |
| return nil, &googleapi.Error{ |
| Code: res.StatusCode, |
| Header: res.Header, |
| } |
| } |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| ret := &ListConnectionsResponse{ |
| ServerResponse: googleapi.ServerResponse{ |
| Header: res.Header, |
| HTTPStatusCode: res.StatusCode, |
| }, |
| } |
| target := &ret |
| if err := gensupport.DecodeResponse(target, res); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Provides a list of the authenticated user's contacts merged with any\nconnected profiles.\n\u003cbr\u003e\nThe request throws a 400 error if 'personFields' is not specified.", |
| // "flatPath": "v1/people/{peopleId}/connections", |
| // "httpMethod": "GET", |
| // "id": "people.people.connections.list", |
| // "parameterOrder": [ |
| // "resourceName" |
| // ], |
| // "parameters": { |
| // "pageSize": { |
| // "description": "The number of connections to include in the response. Valid values are\nbetween 1 and 2000, inclusive. Defaults to 100.", |
| // "format": "int32", |
| // "location": "query", |
| // "type": "integer" |
| // }, |
| // "pageToken": { |
| // "description": "The token of the page to be returned.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "personFields": { |
| // "description": "**Required.** A field mask to restrict which fields on each person are\nreturned. Multiple fields can be specified by separating them with commas.\nValid values are:\n\n* addresses\n* ageRanges\n* biographies\n* birthdays\n* braggingRights\n* coverPhotos\n* emailAddresses\n* events\n* genders\n* imClients\n* interests\n* locales\n* memberships\n* metadata\n* names\n* nicknames\n* occupations\n* organizations\n* phoneNumbers\n* photos\n* relations\n* relationshipInterests\n* relationshipStatuses\n* residences\n* sipAddresses\n* skills\n* taglines\n* urls\n* userDefined", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "requestMask.includeField": { |
| // "description": "**Required.** Comma-separated list of person fields to be included in the\nresponse. Each path should start with `person.`: for example,\n`person.names` or `person.photos`.", |
| // "format": "google-fieldmask", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "requestSyncToken": { |
| // "description": "Whether the response should include a sync token, which can be used to get\nall changes since the last request. For subsequent sync requests use the\n`sync_token` param instead. Initial sync requests that specify\n`request_sync_token` have an additional rate limit.", |
| // "location": "query", |
| // "type": "boolean" |
| // }, |
| // "resourceName": { |
| // "description": "The resource name to return connections for. Only `people/me` is valid.", |
| // "location": "path", |
| // "pattern": "^people/[^/]+$", |
| // "required": true, |
| // "type": "string" |
| // }, |
| // "sortOrder": { |
| // "description": "The order in which the connections should be sorted. Defaults to\n`LAST_MODIFIED_ASCENDING`.", |
| // "enum": [ |
| // "LAST_MODIFIED_ASCENDING", |
| // "FIRST_NAME_ASCENDING", |
| // "LAST_NAME_ASCENDING" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "syncToken": { |
| // "description": "A sync token returned by a previous call to `people.connections.list`.\nOnly resources changed since the sync token was created will be returned.\nSync requests that specify `sync_token` have an additional rate limit.", |
| // "location": "query", |
| // "type": "string" |
| // } |
| // }, |
| // "path": "v1/{+resourceName}/connections", |
| // "response": { |
| // "$ref": "ListConnectionsResponse" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/contacts", |
| // "https://www.googleapis.com/auth/contacts.readonly" |
| // ] |
| // } |
| |
| } |
| |
| // Pages invokes f for each page of results. |
| // A non-nil error returned from f will halt the iteration. |
| // The provided context supersedes any context provided to the Context method. |
| func (c *PeopleConnectionsListCall) Pages(ctx context.Context, f func(*ListConnectionsResponse) error) error { |
| c.ctx_ = ctx |
| defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point |
| for { |
| x, err := c.Do() |
| if err != nil { |
| return err |
| } |
| if err := f(x); err != nil { |
| return err |
| } |
| if x.NextPageToken == "" { |
| return nil |
| } |
| c.PageToken(x.NextPageToken) |
| } |
| } |