{"name":"people","version":"v1","revision":"20261021","title":"People API","rootUrl":"https://people.googleapis.com/","servicePath":"","basePath":"","batchPath":"batch","methods":[{"id":"contactGroups.batchGet","httpMethod":"GET","path":"v1/contactGroups:batchGet","flatPath":"v1/contactGroups:batchGet","description":"Get a list of contact groups owned by the authenticated user by specifying a list of contact group resource names.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.readonly"],"required":[],"parameters":[{"name":"groupFields","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A field mask to restrict which fields on the group are returned. Defaults to `metadata`, `groupType`, `memberCount`, and `name` if not set or set to e","enum":null},{"name":"maxMembers","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. Specifies the maximum number of members to return for each group. Defaults to 0 if not set, which will return zero members.","enum":null},{"name":"resourceNames","type":"string","required":false,"repeated":true,"location":"query","description":"Required. The resource names of the contact groups to get. There is a maximum of 200 resource names.","enum":null}]},{"id":"contactGroups.create","httpMethod":"POST","path":"v1/contactGroups","flatPath":"v1/contactGroups","description":"Create a new contact group owned by the authenticated user. Created contact group names must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error. Mutate requests for the same user should be sent sequentially to avoid increased latenc","scopes":["https://www.googleapis.com/auth/contacts"],"required":[],"parameters":[]},{"id":"contactGroups.delete","httpMethod":"DELETE","path":"v1/{+resourceName}","flatPath":"v1/contactGroups/{contactGroupsId}","description":"Delete an existing contact group owned by the authenticated user by specifying a contact group resource name. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"deleteContacts","type":"boolean","required":false,"repeated":false,"location":"query","description":"Optional. Set to true to also delete the contacts in the specified group.","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the contact group to delete.","enum":null}]},{"id":"contactGroups.get","httpMethod":"GET","path":"v1/{+resourceName}","flatPath":"v1/contactGroups/{contactGroupsId}","description":"Get a specific contact group owned by the authenticated user by specifying a contact group resource name.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.readonly"],"required":["resourceName"],"parameters":[{"name":"groupFields","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A field mask to restrict which fields on the group are returned. Defaults to `metadata`, `groupType`, `memberCount`, and `name` if not set or set to e","enum":null},{"name":"maxMembers","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. Specifies the maximum number of members to return. Defaults to 0 if not set, which will return zero members.","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the contact group to get.","enum":null}]},{"id":"contactGroups.list","httpMethod":"GET","path":"v1/contactGroups","flatPath":"v1/contactGroups","description":"List all contact groups owned by the authenticated user. Members of the contact groups are not populated.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.readonly"],"required":[],"parameters":[{"name":"groupFields","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A field mask to restrict which fields on the group are returned. Defaults to `metadata`, `groupType`, `memberCount`, and `name` if not set or set to e","enum":null},{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The maximum number of resources to return. Valid values are between 1 and 1000, inclusive. Defaults to 30 if not set or set to 0.","enum":null},{"name":"pageToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. The next_page_token value returned from a previous call to [ListContactGroups](/people/api/rest/v1/contactgroups/list). Requests the next page of reso","enum":null},{"name":"syncToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A sync token, returned by a previous call to `contactgroups.list`. Only resources changed since the sync token was created will be returned.","enum":null}]},{"id":"contactGroups.members.modify","httpMethod":"POST","path":"v1/{+resourceName}/members:modify","flatPath":"v1/contactGroups/{contactGroupsId}/members:modify","description":"Modify the members of a contact group owned by the authenticated user. The only system contact groups that can have members added are `contactGroups/myContacts` and `contactGroups/starred`. Other system contact groups are deprecated and can only have contacts removed.","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the contact group to modify.","enum":null}]},{"id":"contactGroups.update","httpMethod":"PUT","path":"v1/{+resourceName}","flatPath":"v1/contactGroups/{contactGroupsId}","description":"Update the name of an existing contact group owned by the authenticated user. Updated contact group names must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error. Mutate requests for the same user should be sent sequentially to avoi","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"The resource name for the contact group, assigned by the server. An ASCII string, in the form of `contactGroups/{contact_group_id}`.","enum":null}]},{"id":"otherContacts.copyOtherContactToMyContactsGroup","httpMethod":"POST","path":"v1/{+resourceName}:copyOtherContactToMyContactsGroup","flatPath":"v1/otherContacts/{otherContactsId}:copyOtherContactToMyContactsGroup","description":"Copies an \"Other contact\" to a new contact in the user's \"myContacts\" group Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.other.readonly"],"required":["resourceName"],"parameters":[{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the \"Other contact\" to copy.","enum":null}]},{"id":"otherContacts.list","httpMethod":"GET","path":"v1/otherContacts","flatPath":"v1/otherContacts","description":"List all \"Other contacts\", that is contacts that are not in a contact group. \"Other contacts\" are typically auto created contacts from interactions. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an [google.rpc.ErrorInfo](https://cloud.goog","scopes":["https://www.googleapis.com/auth/contacts.other.readonly"],"required":[],"parameters":[{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of \"Other contacts\" to include in the response. Valid values are between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.","enum":null},{"name":"pageToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A page token, received from a previous response `next_page_token`. Provide this to retrieve the subsequent page. When paginating, all other parameters","enum":null},{"name":"readMask","type":"string","required":false,"repeated":false,"location":"query","description":"Required. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. What values are va","enum":null},{"name":"requestSyncToken","type":"boolean","required":false,"repeated":false,"location":"query","description":"Optional. Whether the response should return `next_sync_token` on the last page of results. It can be used to get incremental changes since the last request by ","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT if not set. Possible values for this field are: * READ_SOURCE_TYPE_CONTACT","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]},{"name":"syncToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A sync token, received from a previous response `next_sync_token` Provide this to retrieve only the resources changed since the last request. When syn","enum":null}]},{"id":"otherContacts.search","httpMethod":"GET","path":"v1/otherContacts:search","flatPath":"v1/otherContacts:search","description":"Provides a list of contacts in the authenticated user's other contacts that matches the search query. The query matches on a contact's `names`, `emailAddresses`, and `phoneNumbers` fields that are from the OTHER_CONTACT source. **IMPORTANT**: Before searching, clients should send a warmup request wi","scopes":["https://www.googleapis.com/auth/contacts.other.readonly"],"required":[],"parameters":[{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of results to return. Defaults to 10 if field is not set, or set to 0. Values greater than 30 will be capped to 30.","enum":null},{"name":"query","type":"string","required":false,"repeated":false,"location":"query","description":"Required. The plain-text query for the request. The query is used to match prefix phrases of the fields on a person. For example, a person with name \"foo name\" ","enum":null},{"name":"readMask","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null}]},{"id":"people.batchCreateContacts","httpMethod":"POST","path":"v1/people:batchCreateContacts","flatPath":"v1/people:batchCreateContacts","description":"Create a batch of new contacts and return the PersonResponses for the newly Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":[],"parameters":[]},{"id":"people.batchDeleteContacts","httpMethod":"POST","path":"v1/people:batchDeleteContacts","flatPath":"v1/people:batchDeleteContacts","description":"Delete a batch of contacts. Any non-contact data will not be deleted. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":[],"parameters":[]},{"id":"people.batchUpdateContacts","httpMethod":"POST","path":"v1/people:batchUpdateContacts","flatPath":"v1/people:batchUpdateContacts","description":"Update a batch of contacts and return a map of resource names to PersonResponses for the updated contacts. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":[],"parameters":[]},{"id":"people.connections.list","httpMethod":"GET","path":"v1/{+resourceName}/connections","flatPath":"v1/people/{peopleId}/connections","description":"Provides a list of the authenticated user's contacts. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an [google.rpc.ErrorInfo](https://cloud.google.com/apis/design/errors#error_info) with reason \"EXPIRED_SYNC_TOKEN\". In the case of such an ","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.readonly"],"required":["resourceName"],"parameters":[{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of connections to include in the response. Valid values are between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.","enum":null},{"name":"pageToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A page token, received from a previous response `next_page_token`. Provide this to retrieve the subsequent page. When paginating, all other parameters","enum":null},{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null},{"name":"requestMask.includeField","type":"string","required":false,"repeated":false,"location":"query","description":"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.ph","enum":null},{"name":"requestSyncToken","type":"boolean","required":false,"repeated":false,"location":"query","description":"Optional. Whether the response should return `next_sync_token` on the last page of results. It can be used to get incremental changes since the last request by ","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name to return connections for. Only `people/me` is valid.","enum":null},{"name":"sortOrder","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. The order in which the connections should be sorted. Defaults to `LAST_MODIFIED_ASCENDING`.","enum":["LAST_MODIFIED_ASCENDING","LAST_MODIFIED_DESCENDING","FIRST_NAME_ASCENDING","LAST_NAME_ASCENDING"]},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]},{"name":"syncToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A sync token, received from a previous response `next_sync_token` Provide this to retrieve only the resources changed since the last request. When syn","enum":null}]},{"id":"people.createContact","httpMethod":"POST","path":"v1/people:createContact","flatPath":"v1/people:createContact","description":"Create a new contact and return the person resource for that contact. The request returns a 400 error if more than one field is specified on a field that is a singleton for contact sources: * biographies * birthdays * genders * names Mutate requests for the same user should be sent sequentially to a","scopes":["https://www.googleapis.com/auth/contacts"],"required":[],"parameters":[{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"Required. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fi","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]}]},{"id":"people.deleteContact","httpMethod":"DELETE","path":"v1/{+resourceName}:deleteContact","flatPath":"v1/people/{peopleId}:deleteContact","description":"Delete a contact person. Any non-contact data will not be deleted. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the contact to delete.","enum":null}]},{"id":"people.deleteContactPhoto","httpMethod":"DELETE","path":"v1/{+resourceName}:deleteContactPhoto","flatPath":"v1/people/{peopleId}:deleteContactPhoto","description":"Delete a contact's photo. Mutate requests for the same user should be done sequentially to avoid // lock contention.","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A field mask to restrict which fields on the person are returned. Multiple fields can be specified by separating them with commas. Defaults to empty i","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the contact whose photo will be deleted.","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]}]},{"id":"people.get","httpMethod":"GET","path":"v1/{+resourceName}","flatPath":"v1/people/{peopleId}","description":"Provides information about a person by specifying a resource name. Use `people/me` to indicate the authenticated user. The request returns a 400 error if 'personFields' is not specified.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.other.readonly","https://www.googleapis.com/auth/contacts.readonly","https://www.googleapis.com/auth/directory.readonly","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.gender.read","https://www.googleapis.com/auth/user.organization.read","https://www.googleapis.com/auth/user.phonenumbers.read","https://www.googleapis.com/auth/userinfo.email","https://www.googleapis.com/auth/userinfo.profile"],"required":["resourceName"],"parameters":[{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"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: *","enum":null},{"name":"requestMask.includeField","type":"string","required":false,"repeated":false,"location":"query","description":"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.ph","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. The resource name of the person to provide information about. - To get information about the authenticated user, specify `people/me`. - To get informa","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_PROFILE and READ_SOURCE_TYPE_CONTACT if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]}]},{"id":"people.getBatchGet","httpMethod":"GET","path":"v1/people:batchGet","flatPath":"v1/people:batchGet","description":"Provides information about a list of specific people by specifying a list of requested resource names. Use `people/me` to indicate the authenticated user. The request returns a 400 error if 'personFields' is not specified.","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.other.readonly","https://www.googleapis.com/auth/contacts.readonly","https://www.googleapis.com/auth/directory.readonly","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.gender.read","https://www.googleapis.com/auth/user.organization.read","https://www.googleapis.com/auth/user.phonenumbers.read","https://www.googleapis.com/auth/userinfo.email","https://www.googleapis.com/auth/userinfo.profile"],"required":[],"parameters":[{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null},{"name":"requestMask.includeField","type":"string","required":false,"repeated":false,"location":"query","description":"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.ph","enum":null},{"name":"resourceNames","type":"string","required":false,"repeated":true,"location":"query","description":"Required. The resource names of the people to provide information about. It's repeatable. The URL query parameter should be resourceNames=<name1>&resourceNames=","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]}]},{"id":"people.listDirectoryPeople","httpMethod":"GET","path":"v1/people:listDirectoryPeople","flatPath":"v1/people:listDirectoryPeople","description":"Provides a list of domain profiles and domain contacts in the authenticated user's domain directory. When the `sync_token` is specified, resources deleted since the last sync will be returned as a person with `PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is specified, a","scopes":["https://www.googleapis.com/auth/directory.readonly"],"required":[],"parameters":[{"name":"mergeSources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. Additional data to merge into the directory sources if they are connected through verified join keys such as email addresses or phone numbers.","enum":["DIRECTORY_MERGE_SOURCE_TYPE_UNSPECIFIED","DIRECTORY_MERGE_SOURCE_TYPE_CONTACT"]},{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of people to include in the response. Valid values are between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.","enum":null},{"name":"pageToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A page token, received from a previous response `next_page_token`. Provide this to retrieve the subsequent page. When paginating, all other parameters","enum":null},{"name":"readMask","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null},{"name":"requestSyncToken","type":"boolean","required":false,"repeated":false,"location":"query","description":"Optional. Whether the response should return `next_sync_token`. It can be used to get incremental changes since the last request by setting it on the request `s","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Required. Directory sources to return.","enum":["DIRECTORY_SOURCE_TYPE_UNSPECIFIED","DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT","DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"]},{"name":"syncToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A sync token, received from a previous response `next_sync_token` Provide this to retrieve only the resources changed since the last request. When syn","enum":null}]},{"id":"people.searchContacts","httpMethod":"GET","path":"v1/people:searchContacts","flatPath":"v1/people:searchContacts","description":"Provides a list of contacts in the authenticated user's grouped contacts that matches the search query. The query matches on a contact's `names`, `nickNames`, `emailAddresses`, `phoneNumbers`, and `organizations` fields that are from the CONTACT source. **IMPORTANT**: Before searching, clients shoul","scopes":["https://www.googleapis.com/auth/contacts","https://www.googleapis.com/auth/contacts.readonly"],"required":[],"parameters":[{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of results to return. Defaults to 10 if field is not set, or set to 0. Values greater than 30 will be capped to 30.","enum":null},{"name":"query","type":"string","required":false,"repeated":false,"location":"query","description":"Required. The plain-text query for the request. The query is used to match prefix phrases of the fields on a person. For example, a person with name \"foo name\" ","enum":null},{"name":"readMask","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]}]},{"id":"people.searchDirectoryPeople","httpMethod":"GET","path":"v1/people:searchDirectoryPeople","flatPath":"v1/people:searchDirectoryPeople","description":"Provides a list of domain profiles and domain contacts in the authenticated user's domain directory that match the search query.","scopes":["https://www.googleapis.com/auth/directory.readonly"],"required":[],"parameters":[{"name":"mergeSources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. Additional data to merge into the directory sources if they are connected through verified join keys such as email addresses or phone numbers.","enum":["DIRECTORY_MERGE_SOURCE_TYPE_UNSPECIFIED","DIRECTORY_MERGE_SOURCE_TYPE_CONTACT"]},{"name":"pageSize","type":"integer","required":false,"repeated":false,"location":"query","description":"Optional. The number of people to include in the response. Valid values are between 1 and 500, inclusive. Defaults to 100 if not set or set to 0.","enum":null},{"name":"pageToken","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A page token, received from a previous response `next_page_token`. Provide this to retrieve the subsequent page. When paginating, all other parameters","enum":null},{"name":"query","type":"string","required":false,"repeated":false,"location":"query","description":"Required. Prefix query that matches fields in the person. Does NOT use the read_mask for determining what fields to match.","enum":null},{"name":"readMask","type":"string","required":false,"repeated":false,"location":"query","description":"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: ","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Required. Directory sources to return.","enum":["DIRECTORY_SOURCE_TYPE_UNSPECIFIED","DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT","DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"]}]},{"id":"people.updateContact","httpMethod":"PATCH","path":"v1/{+resourceName}:updateContact","flatPath":"v1/people/{peopleId}:updateContact","description":"Update contact data for an existing contact person. Any non-contact data will not be modified. Any non-contact data in the person to update will be ignored. All fields specified in the `update_mask` will be replaced. The server returns a 400 error if `person.metadata.sources` is not specified for th","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"personFields","type":"string","required":false,"repeated":false,"location":"query","description":"Optional. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fi","enum":null},{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"The resource name for the person, assigned by the server. An ASCII string in the form of `people/{person_id}`.","enum":null},{"name":"sources","type":"string","required":false,"repeated":true,"location":"query","description":"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.","enum":["READ_SOURCE_TYPE_UNSPECIFIED","READ_SOURCE_TYPE_PROFILE","READ_SOURCE_TYPE_CONTACT","READ_SOURCE_TYPE_DOMAIN_CONTACT","READ_SOURCE_TYPE_OTHER_CONTACT"]},{"name":"updatePersonFields","type":"string","required":false,"repeated":false,"location":"query","description":"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 w","enum":null}]},{"id":"people.updateContactPhoto","httpMethod":"PATCH","path":"v1/{+resourceName}:updateContactPhoto","flatPath":"v1/people/{peopleId}:updateContactPhoto","description":"Update a contact's photo. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.","scopes":["https://www.googleapis.com/auth/contacts"],"required":["resourceName"],"parameters":[{"name":"resourceName","type":"string","required":true,"repeated":false,"location":"path","description":"Required. Person resource name","enum":null}]}]}