Method: people.createContact

Utwórz nowy kontakt i zwróć zasoby tej osoby.

Żądanie zwraca błąd 400, jeśli w polu jednorazowym w przypadku źródeł kontaktów określono więcej niż jedno pole:

  • biografie
  • urodziny
  • płeć
  • imiona i nazwiska

Żądania mutacji tego samego użytkownika powinny być przesyłane po kolei, co pozwoli uniknąć opóźnień i niepowodzeń.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
personFields

string (FieldMask format)

Wymagany. Maska pola, która ogranicza pola zwracane przez poszczególne osoby. Możesz określić wiele pól, rozdzielając je przecinkami. Jeśli nie zostanie ustawiona, domyślnie przyjmuje się wszystkie pola. Prawidłowe wartości to:

  • adresy
  • przedziały wiekowe
  • biografie
  • urodziny
  • kalendarzUrl
  • daneklienta
  • Zdjęcia na okładkę
  • adresy-e-mail
  • wydarzenia
  • externalIds
  • płeć
  • klienty
  • zainteresowania
  • języki
  • lokalizacje
  • kanału
  • metadane
  • inne słowa kluczowe
  • imiona i nazwiska
  • pseudonimy
  • zawody
  • organizacje
  • numery telefonów
  • zdjęcia
  • relacje
  • adresy sip
  • umiejętności
  • adresy
  • definiowany przez użytkownika
sources[]

enum (ReadSourceType)

Opcjonalne. Maska typu typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to READ_SOURCE_TYPE_CONTACT i READ_SOURCE_TYPE_PROFILE.

Treść żądania

Treść żądania zawiera wystąpienie elementu Person.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Person.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.