- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
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 |
Nazwa zasobu osoby przypisana przez serwer. Ciąg ASCII w formacie |
Parametry zapytania
Parametry | |
---|---|
updatePersonFields |
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:
|
personFields |
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:
|
sources[] |
Opcjonalne. Maska typu typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość 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 po autoryzacji.