Method: people.createContact

Crea un nuovo contatto e restituisci la risorsa persona per quel contatto.

La richiesta restituisce un errore 400 se viene specificato più di un campo in un campo che è un singleton per le origini dei contatti:

  • biografie
  • compleanni
  • generi
  • names

Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
personFields

string (FieldMask format)

obbligatorio. Una maschera di campo per limitare i campi restituiti per ogni persona. È possibile specificare più campi separandoli con virgole. Se non viene configurato, il valore predefinito è tutti i campi. I valori validi sono:

  • addresses
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • names
  • nickname
  • occupazioni
  • organizations
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Campo facoltativo. Una maschera dei tipi di origine da restituire. Se non viene configurato, il valore predefinito è READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Person.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Person.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.