Method: people.createContact

Crea un contacto nuevo y muestra el recurso de persona correspondiente a ese contacto.

La solicitud muestra un error 400 si se especifica más de un campo en un campo que es un singleton para las fuentes de contactos:

  • biografías
  • cumpleaños
  • Sexos
  • names

Las solicitudes de modificación para el mismo usuario deben enviarse de forma secuencial para evitar aumentos de latencia y fallas.

Solicitud HTTP

POST https://people.googleapis.com/v1/people:createContact

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
personFields

string (FieldMask format)

Obligatorio. Una máscara de campo que restringe los campos que se muestran de cada persona. Se pueden especificar varios campos separándolos con comas. El valor predeterminado es todos los campos si no se configura. Estos son los valores válidos:

  • addresses
  • ageRanges
  • biografías
  • cumpleaños
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventos
  • externalIds
  • Sexos
  • imClients
  • Intereses
  • locales
  • de ubicaciones
  • memberships
  • metadatos
  • miscKeywords
  • names
  • sobrenombres
  • profesiones
  • organizations
  • phoneNumbers
  • fotos
  • relaciones
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Opcional. Una máscara de los tipos de fuentes que se mostrarán. La configuración predeterminada es READ_SOURCE_TYPE_CONTACT y READ_SOURCE_TYPE_PROFILE si no se configura.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Person.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Person.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/contacts

Para obtener más información, consulta la guía de autorización.