Method: contactGroups.batchGet

Aby uzyskać listę grup kontaktów należących do uwierzytelnionego użytkownika, podaj listę nazw zasobów grup kontaktów.

Żądanie HTTP

GET https://people.googleapis.com/v1/contactGroups:batchGet

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
resourceNames[]

string

Wymagane. Nazwy zasobów grup kontaktów do pobrania.

Możesz mieć maksymalnie 200 nazw zasobów.
maxMembers

integer

Opcjonalnie: Określa maksymalną liczbę członków do zwrócenia dla każdej grupy. Jeśli nie zostanie ustawiona, domyślna wartość to 0, co spowoduje zwrócenie 0 członków.
groupFields

string (FieldMask format)

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

  • clientData
  • groupType
  • memberCount
  • metadane
  • nazwa

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie zbiorcze pobrania grupy kontaktów.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "responses": [
    {
      object (ContactGroupResponse)
    }
  ]
}
Pola
responses[]

object (ContactGroupResponse)

Lista odpowiedzi dla każdego żądanego zasobu grupy kontaktów.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

ContactGroupResponse

Odpowiedź dla określonej grupy kontaktów.

Zapis JSON 
{
  "requestedResourceName": string,
  "status": {
    object (Status)
  },
  "contactGroup": {
    object (ContactGroup)
  }
}
Pola
requestedResourceName

string

Pierwotna nazwa żądanego zasobu.
status

object (Status)

Stan odpowiedzi.
contactGroup

object (ContactGroup)

Grupa kontaktów.