Zaktualizuj nazwę istniejącej grupy kontaktów należącej do uwierzytelnionego użytkownika.
Zaktualizowane nazwy grup kontaktów muszą być unikalne dla grup kontaktów użytkowników. Próba utworzenia grupy o podwójnej nazwie spowoduje zwrócenie błędu HTTP 409.
Żą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
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
contactGroup.resourceName |
Nazwa zasobu grupy kontaktów przypisana przez serwer. Ciąg ASCII w postaci |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"contactGroup": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
Pola | |
---|---|
contactGroup.etag |
Tag encji HTTP zasobu. Służy do sprawdzania poprawności pamięci podręcznej przeglądarki. |
contactGroup.metadata |
Tylko dane wyjściowe. Metadane grupy kontaktów. |
contactGroup.groupType |
Tylko dane wyjściowe. Typ grupy kontaktów. |
contactGroup.name |
Nazwa grupy kontaktów ustawiona przez właściciela grupy lub nazwa podana przez system. W |
contactGroup.formattedName |
Tylko dane wyjściowe. Nazwa przetłumaczona i sformatowana zgodnie z językiem konta użytkownika lub językiem nagłówka HTTP |
contactGroup.memberResourceNames[] |
Tylko dane wyjściowe. Lista nazw zasobów osób kontaktowych, które są członkami grupy kontaktów. To pole jest wypełniane tylko w przypadku żądań GET i zwraca tylko tyle użytkowników, ile wynosi |
contactGroup.memberCount |
Tylko dane wyjściowe. Łączna liczba kontaktów w grupie niezależnie od maksymalnej liczby członków określonej w prośbie. |
contactGroup.clientData[] |
Dane klienta grupy. |
updateGroupFields |
Opcjonalnie. Maska pola określająca, które pola w grupie mają być aktualizowane. Można określić wiele pól, rozdzielając je przecinkami. Jeśli nie jest ustawiony lub jest pusty, domyślna wartość to
|
readGroupFields |
Opcjonalnie. Maska pola określająca, które pola w grupie mają być zwracane. Jeśli nie jest ustawiony lub jest pusty, domyślna wartość to
|
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ContactGroup
.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/contacts
Więcej informacji znajdziesz w przewodniku po autoryzacji.