Method: people.updateContact

zaktualizować dane kontaktowe istniejącej osoby kontaktowej; Dane bezkontaktowe nie zostaną zmodyfikowane. Wszystkie dane o osobach, które nie są kontaktami, zostaną zignorowane. Wszystkie pola określone w updateMask zostaną zastąpione.

Serwer zwraca błąd 400, jeśli nie określono wartości person.metadata.sources dla aktualizowanego kontaktu lub jeśli nie ma źródła kontaktu.

Serwer zwraca błąd 400 z powodem "failedPrecondition", jeśli person.metadata.sources.etag jest inny niż tag kontaktowy, co oznacza, że kontakt zmienił się od czasu odczytu jego danych. Klienci powinni otrzymać najnowszą osobę i złączyć jej aktualizacje z ostatnią osobą. Jeśli wprowadzasz sekwencyjne zmiany dotyczące tej samej osoby, aby uniknąć błędów, użyj etaga z odpowiedzi updateContact.

Serwer zwraca błąd 400, jeśli memberships są aktualizowane, a nie ma żadnych członkostw w grupie kontaktów określonych dla tej osoby.

Serwer zwraca błąd 400, jeśli w polu, które jest pojedyncze w przypadku źródeł kontaktów, jest określone więcej niż 1 pole:

  • biografie
  • urodziny
  • płeć
  • nazwy

Żądania dotyczące zmian w danych tego samego użytkownika należy wysyłać kolejno, aby uniknąć wydłużenia czasu oczekiwania i błędów.

Żądanie HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
person.resourceName

string

Nazwa zasobu dla osoby przypisana przez serwer. Ciąg znaków ASCII w postaci people/{person_id}.

Parametry zapytania

Parametry
updatePersonFields

string (FieldMask format)

Wymagane. maska pól, która ogranicza, które pola dotyczące osoby są aktualizowane. Aby podać wiele pól, rozdziel je przecinkami. Wszystkie zaktualizowane pola zostaną zastąpione. Prawidłowe wartości to:

  • adresy
  • biografie
  • urodziny
  • calendarUrls
  • clientData
  • emailAddresses
  • zdarzenia
  • externalIds
  • płeć
  • imClients
  • zainteresowania
  • języki
  • lokalizacje
  • kanału
  • miscKeywords
  • nazwy
  • pseudonimy,
  • zawodów,
  • organizacje
  • phoneNumbers
  • relacje
  • sipAddresses
  • adresy
  • userDefined
personFields

string (FieldMask format)

Opcjonalnie. Maska pola, która ogranicza, które pola dotyczące danej osoby mają być zwracane. Aby podać wiele pól, rozdziel je przecinkami. Jeśli nie zostanie ustawione, domyślnie są to wszystkie pola. Prawidłowe wartości to:

  • adresy
  • ageRanges
  • biografie
  • urodziny
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • zdarzenia
  • externalIds
  • płeć
  • imClients
  • zainteresowania
  • języki
  • lokalizacje
  • kanału
  • metadane
  • miscKeywords
  • nazwy
  • pseudonimy,
  • zawodów,
  • organizacje
  • phoneNumbers
  • zdjęcia
  • relacje
  • sipAddresses
  • umiejętności
  • adresy
  • userDefined
sources[]

enum (ReadSourceType)

Opcjonalnie. Maska określająca, jakie typy źródeł mają być zwracane. Jeśli nie zostanie ustawiony, domyślne wartości 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 dotyczącym autoryzacji.