contactGroups

Changed on

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 avoid increased latency and failures.

put/v1/{+resourceName}

Request

  • Base URL: https://people.googleapis.com
  • URL: https://people.googleapis.com/v1/{+resourceName}
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/contacts) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/contacts)

Path parameters

resourceNamestring required

The resource name for the contact group, assigned by the server. An ASCII string, in the form of contactGroups/{contact_group_id}.

Request body

readGroupFieldsstring google-fieldmask

Optional. A field mask to restrict which fields on the group are returned. Defaults to metadata, groupType, and name if not set or set to empty. Valid fields are: * clientData * groupType * memberCount * metadata * name

updateGroupFieldsstring google-fieldmask

Optional. A field mask to restrict which fields on the group are updated. Multiple fields can be specified by separating them with commas. Defaults to name if not set or set to empty. Updated fields are replaced. Valid values are: * clientData * name

Response

Successful response

Changes

  • 1b617610019dRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status