- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ContactGroupResponse
- Testen!
Rufen Sie eine Liste der Kontaktgruppen des authentifizierten Nutzers ab, indem Sie eine Liste mit Ressourcennamen für Kontaktgruppen angeben.
HTTP-Anfrage
GET https://people.googleapis.com/v1/contactGroups:batchGet
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
resourceNames[] |
Erforderlich. Die Ressourcennamen der abzurufenden Kontaktgruppen. Es sind maximal 200 Ressourcennamen zulässig. |
maxMembers |
Optional. Gibt die maximale Anzahl von Mitgliedern an, die für jede Gruppe zurückgegeben werden sollen. Wenn nicht festgelegt, ist der Standardwert 0, wodurch keine Mitglieder zurückgegeben werden. |
groupFields |
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
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Antwort auf eine Batchanfrage zum Abrufen von Kontaktgruppen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"responses": [
{
object ( |
Felder | |
---|---|
responses[] |
Die Liste der Antworten für jede angeforderte Kontaktgruppenressource. |
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.
ContactGroupResponse
Die Antwort für eine bestimmte Kontaktgruppe.
JSON-Darstellung |
---|
{ "requestedResourceName": string, "status": { object ( |
Felder | |
---|---|
requestedResourceName |
Der ursprünglich angeforderte Ressourcenname. |
status |
Der Status der Antwort. |
contactGroup |
Kontaktgruppe |