Method: contactGroups.create

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

Utworzone 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

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)

To pole jest wymagane. Grupa kontaktów do utworzenia.
readGroupFields

string (FieldMask format)

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 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 po autoryzacji.