Method: contactGroups.get

Sie können eine bestimmte Kontaktgruppe abrufen, deren Inhaber der authentifizierte Nutzer ist, indem Sie den Ressourcennamen einer Kontaktgruppe angeben.

HTTP-Anfrage

GET https://people.googleapis.com/v1/{resourceName=contactGroups/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resourceName

string

Erforderlich. Der Ressourcenname der Kontaktgruppe, die abgerufen werden soll.

Abfrageparameter

Parameter
maxMembers

integer

Optional. Gibt die maximale Anzahl der zurückzugebenden Mitglieder an. Der Standardwert ist 0, wenn kein Wert festgelegt ist. Dadurch werden null Mitglieder zurückgegeben.

groupFields

string (FieldMask format)

Optional. Eine Feldmaske zur Einschränkung der zurückgegebenen Felder in der Gruppe. Die Standardeinstellung ist metadata, groupType, memberCount und name, wenn kein Wert festgelegt oder das Feld leer ist. Gültige Felder sind:

  • Kundendaten
  • Gruppentyp
  • Anzahl der Mitglieder
  • metadata
  • name

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ContactGroup.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.