Method: contactGroups.create

Utwórz nową grupę kontaktów należącą do uwierzytelnionego użytkownika.

Nazwy utworzonych grup kontaktów muszą być unikalne dla grup kontaktów użytkowników. Próba utworzenia grupy ze zduplikowaną nazwą 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 błędów.

Żądanie HTTP

POST https://people.googleapis.com/v1/contactGroups

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Pola
contactGroup

object (ContactGroup)

Wymagane. Grupa kontaktów do utworzenia.
readGroupFields

string (FieldMask format)

Opcjonalnie: Maska pola ograniczająca, które pola w grupie są zwracane. Jeśli nie jest ustawiona lub jest pusta, domyślna wartość to metadata, groupType i name. Prawidłowe pola to:

  • clientData
  • groupType
  • metadane
  • nazwa

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję ContactGroup.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/contacts

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.