otherContacts

Changed on

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.

post/v1/{+resourceName}:copyOtherContactToMyContactsGroup

Request

  • Base URL: https://people.googleapis.com
  • URL: https://people.googleapis.com/v1/{+resourceName}:copyOtherContactToMyContactsGroup
  • Auth: one of:
    • 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)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/contacts.other.readonly) 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.other.readonly)

Path parameters

resourceNamestring required

Required. The resource name of the "Other contact" to copy.

Request body

copyMaskstring google-fieldmask

Required. A field mask to restrict which fields are copied into the new contact. Valid values are: * emailAddresses * names * phoneNumbers

readMaskstring google-fieldmask

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 the copy mask with metadata and membership fields if not set. Valid values are: * addresses * ageRanges * biographies * birthdays * calendarUrls * clientData * coverPhotos * emailAddresses * events * externalIds * genders * imClients * interests * locales * locations * memberships * metadata * miscKeywords * names * nicknames * occupations * organizations * phoneNumbers * photos * relations * sipAddresses * skills * urls * userDefined

sourcesstring[]

Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.

Response

Successful response

Changes

  • 1b617610019dRevision changes
    • breaking

      removed the request body

    • breaking

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

    • info

      the security scope https://www.googleapis.com/auth/contacts was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/contacts was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/contacts.other.readonly was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/contacts.other.readonly was removed from the endpoint's security scheme Oauth2c

  • 2a56b17477daRevision changes
    • info

      the security scope https://www.googleapis.com/auth/contacts was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/contacts was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/contacts.other.readonly was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/contacts.other.readonly was removed from the endpoint's security scheme Oauth2c