Method: people.updateContact

Aktualizowanie danych kontaktowych istniejącej osoby kontaktowej. Żadne dane kontaktowe nie zostaną zmienione. Wszelkie niedotyczące się dane osoby do aktualizacji zostaną zignorowane. Wszystkie pola określone w polu updateMask zostaną zastąpione.

Jeśli nie zostanie podany atrybut person.metadata.sources do zaktualizowania kontaktu lub jeśli nie ma źródła kontaktu, serwer zwraca błąd 400.

Serwer zwraca błąd 400 z przyczyną "failedPrecondition", jeśli parametr person.metadata.sources.etag jest inny niż tag tagu kontaktu, co oznacza, że kontakt zmienił się od czasu odczytania danych. Klienci powinni pobrać najnowszą osobę i scalić jej aktualizacje z najnowszą osobą.

Jeśli na serwerze memberships nie ma określonych kontaktów, serwer zwraca błąd 400.

Serwer 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

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 osoby przypisana przez serwer. Ciąg ASCII w formacie people/{person_id}.

Parametry zapytania

Parametry
updatePersonFields

string (FieldMask format)

Wymagany. Maska ograniczająca, które pola użytkownika są aktualizowane. Możesz określić wiele pól, rozdzielając je przecinkami. Wszystkie zaktualizowane pola zostaną zastąpione. Prawidłowe wartości to:

  • adresy
  • biografie
  • urodziny
  • kalendarzUrl
  • daneklienta
  • adresy-e-mail
  • wydarzenia
  • externalIds
  • płeć
  • klienty
  • zainteresowania
  • języki
  • lokalizacje
  • kanału
  • inne słowa kluczowe
  • imiona i nazwiska
  • pseudonimy
  • zawody
  • organizacje
  • numery telefonów
  • relacje
  • adresy sip
  • adresy
  • definiowany przez użytkownika
personFields

string (FieldMask format)

Opcjonalne. 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.