Method: contactGroups.get

Geben Sie den Ressourcennamen einer Kontaktgruppe an, um eine bestimmte Kontaktgruppe abzurufen, die dem authentifizierten Nutzer gehört.

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 abzurufenden Kontaktgruppe.

Abfrageparameter

Parameter
maxMembers

integer

Optional. Gibt die maximale Anzahl von zurückzugebenden Mitgliedern an. Wenn nicht festgelegt, ist der Standardwert 0, wodurch keine Mitglieder zurückgegeben werden.

groupFields

string (FieldMask format)

Optional. Eine Feldmaske, mit der eingeschränkt wird, welche Felder in der Gruppe zurückgegeben werden. Wenn die Richtlinie nicht konfiguriert oder auf „leer“ gesetzt ist, werden standardmäßig metadata, groupType, memberCount und name verwendet. Gültige Felder sind:

  • clientData
  • groupType
  • memberCount
  • Metadaten
  • 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 Leitfaden zur Autorisierung.