- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
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 |
Nazwa zasobu dla osoby przypisana przez serwer. Ciąg znaków ASCII w postaci |
Parametry zapytania
Parametry | |
---|---|
updatePersonFields |
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:
|
personFields |
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:
|
sources[] |
Opcjonalnie. Maska określająca, jakie typy źródeł mają być zwracane. Jeśli nie zostanie ustawiony, domyślne wartości to |
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.