Skip to main content

contact_groups

Overview

Namecontact_groups
TypeResource
Idgoogledevelopers.people.contact_groups

Fields

NameDatatypeDescription
namestringThe contact group name set by the group owner or a system provided name for system groups. For contactGroups.create or contactGroups.update the name must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error.
resourceNamestringThe resource name for the contact group, assigned by the server. An ASCII string, in the form of contactGroups/{contact_group_id}.
groupTypestringOutput only. The contact group type.
memberCountintegerOutput only. The total number of contacts in the group irrespective of max members in specified in the request.
formattedNamestringOutput only. The name translated and formatted in the viewer's account locale or the Accept-Language HTTP header locale for system groups names. Group names set by the owner are the same as name.
memberResourceNamesarrayOutput only. The list of contact person resource names that are members of the contact group. The field is only populated for GET requests and will only return as many members as maxMembers in the get request.
metadataobjectThe metadata about a contact group.
etagstringThe HTTP entity tag of the resource. Used for web cache validation.
clientDataarrayThe group's client data.

Methods

NameAccessible byRequired ParamsDescription
contactGroups_getSELECTcontactGroupsIdGet a specific contact group owned by the authenticated user by specifying a contact group resource name.
contactGroups_listSELECTList all contact groups owned by the authenticated user. Members of the contact groups are not populated.
contactGroups_createINSERTCreate 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 latency and failures.
contactGroups_deleteDELETEcontactGroupsIdDelete 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.
contactGroups_batchGetEXECGet a list of contact groups owned by the authenticated user by specifying a list of contact group resource names.
contactGroups_updateEXECcontactGroupsIdUpdate 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 avoid increased latency and failures.