Method: people.updateContact

Aktualizowanie danych dotychczasowej osoby kontaktowej. Dane niezwiązane z kontaktami nie zostaną zmienione. Wszelkie aktualizowane bezkontaktowe dane tej osoby zostaną zignorowane. Wszystkie pola podane w updateMask zostaną zastąpione.

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

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

Serwer zwraca błąd 400, jeśli aktualizowana jest memberships, a osoba nie określa członkostwa w grupie kontaktów.

Serwer zwraca błąd 400, jeśli w polu zawierającym źródła kontaktów określono więcej niż jedno pole:

  • biografie
  • urodziny
  • płeć
  • names

Żądania mutacji dotyczące tego samego użytkownika powinny być wysyłane po kolei, aby uniknąć wydłużenia czasu oczekiwania 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 dla osoby przypisana przez serwer. Ciąg ASCII w postaci people/{person_id}.

Parametry zapytania

Parametry
updatePersonFields

string (FieldMask format)

To pole jest wymagane. Maska pola określająca, które pola na osobie mają być aktualizowane. Można określić wiele pól, rozdzielając je przecinkami. Wszystkie zaktualizowane pola zostaną zastąpione. Prawidłowe wartości to:

  • adresy
  • biografie
  • urodziny
  • calendarUrls
  • clientData
  • emailAddresses
  • wydarzenia
  • externalIds
  • płeć
  • imClients
  • zainteresowania
  • locales
  • lokalizacje
  • kanału
  • miscKeywords
  • names
  • pseudonimy
  • zawody
  • organizations
  • phoneNumbers
  • relacje
  • sipAddresses
  • urls
  • userDefined
personFields

string (FieldMask format)

Opcjonalnie. Maska pola określająca, które pola każdej osoby mają być zwracane. Można określić wiele pól, rozdzielając je przecinkami. Jeśli nie zostanie ustawiony, wartość domyślna to wszystkie pola. Prawidłowe wartości to:

  • adresy
  • ageRanges
  • biografie
  • urodziny
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • wydarzenia
  • externalIds
  • płeć
  • imClients
  • zainteresowania
  • locales
  • lokalizacje
  • kanału
  • metadane
  • miscKeywords
  • names
  • pseudonimy
  • zawody
  • organizations
  • phoneNumbers
  • fotografie
  • relacje
  • sipAddresses
  • umiejętności
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Opcjonalnie. Maska 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.