Method: customers.policies.orgunits.batchModify

Ändern Sie mehrere Richtlinienwerte, die auf eine bestimmte Organisationseinheit 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 des google.rpc.Status.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

ID des G Suite-Kontos oder Text "my_customer" für den mit der Anfrage verknüpften Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (ModifyOrgUnitPolicyRequest)

Liste der Richtlinien, die gemäß requests zu ändern sind. Alle Anfragen in der Liste müssen den folgenden Einschränkungen entsprechen:

  1. Alle Schemas in der Liste müssen denselben Stamm-Namespace haben.
  2. Alle „policyTargetKey.targetResource“-Werte müssen auf eine Organisationseinheit verweisen .
  3. Alle "policyTargetKey"-Werte müssen dieselben Schlüsselnamen im Feld "additionalTargetKeys". Das bedeutet auch, wenn einer der die Ziele eine leere „additionalTargetKeys“-Zuordnung, alle Ziele müssen eine leere „additionalTargetKeys“-Zuordnung haben.
  4. Zwei Änderungsanfragen dürfen nicht auf dasselbe `policySchema` + "policyTargetKey"-Paar.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ModifyOrgUnitPolicyRequest

Anfrageparameter zum Ändern eines Richtlinienwerts für ein bestimmtes Ziel einer Organisationseinheit.

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 Organisationseinheit verweisen.

policyValue

object (PolicyValue)

Der neue Wert für die Richtlinie.

updateMask

string (FieldMask format)

Erforderlich. Zu aktualisierende Richtlinienfelder. Es werden nur Felder in dieser Maske 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 vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".