Method: customers.policies.groups.batchModify

Sie können mehrere Richtlinienwerte ändern, die auf eine bestimmte Gruppe angewendet werden. Alle Ziele müssen dasselbe Zielformat haben. Das heißt, sie müssen auf dieselbe Zielressource verweisen und dieselben Schlüssel in additionalTargetKeyNames angegeben haben, auch wenn die Werte für diese Schlüssel unterschiedlich sein können. Bei einem Fehler gibt die Anfrage die Fehlerdetails als Teil von google.RPC.Status.

HTTP-Anfrage

POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:batchModify

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

ID des Google Workspace-Kontos oder „my_customer“ für den Kunden, der mit der Anfrage verknüpft ist.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (ModifyGroupPolicyRequest)
    }
  ]
}
Felder
requests[]

object (ModifyGroupPolicyRequest)

Liste der zu ändernden Richtlinien gemäß der Definition in requests. Für alle Anfragen in der Liste gelten folgende Einschränkungen:

  1. Alle Schemas in der Liste müssen denselben Stamm-Namespace haben.
  2. Alle „policyTargetKey.targetResource“-Werte müssen auf eine Gruppenressource verweisen.
  3. Alle „policyTargetKey“-Werte müssen in „additionalTargetKeys“ denselben Schlüsselnamen „appId“ haben.
  4. Zwei Änderungsanfragen können nicht auf dasselbe Paar aus „policySchema“ und „policyTargetKey“ verweisen.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/chrome.management.policy

ModifyGroupPolicyRequest

Anfrageparameter zum Ändern eines Richtlinienwerts für ein bestimmtes Gruppenziel.

JSON-Darstellung 
{
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "policyValue": {
    object (PolicyValue)
  },
  "updateMask": string
}
Felder
policyTargetKey

object (PolicyTargetKey)

Erforderlich. Der Schlüssel des Ziels, für das eine Richtlinie geändert werden soll. Die Zielressource muss auf eine Gruppe verweisen.
policyValue

object (PolicyValue)

Der neue Wert für die Richtlinie.
updateMask

string (FieldMask format)

Erforderlich. Zu aktualisierende Richtlinienfelder. Nur Felder in dieser Maske werden aktualisiert. Andere Felder in policyValue werden ignoriert, auch wenn sie Werte enthalten. Wenn sich ein Feld in dieser Liste befindet, muss es einen Wert in „policyValue“ haben.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".