Method: customers.policies.resolve

Ruft die aufgelösten Richtlinienwerte für eine Liste von Richtlinien ab, die einer Suchanfrage entsprechen.

HTTP-Anfrage

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

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
{
  "policySchemaFilter": string,
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "pageSize": integer,
  "pageToken": string
}
Felder
policySchemaFilter

string

Erforderlich. Der Schemafilter, der auf die Auflösungsanfrage angewendet werden soll.

Geben Sie einen Schemanamen an, um ein bestimmtes Schema aufzurufen, z. B. chrome.users.ShowLogoutButton

Platzhalter werden nur im Blattteil des Schemanamens unterstützt. Platzhalter können nicht direkt im Namespace verwendet werden. Weitere Informationen zu Schema-Namespaces finden Sie unter https://developers.google.com/chrome/policy/guides/policy-schemas.

Beispiel: Gültig: „chrome.users.*“, "chrome.users.apps.*", „chrome.drucker.*“ Ungültig: "*", "*.users", "chrome.*", „chrome.*.apps.*“

policyTargetKey

object (PolicyTargetKey)

Erforderlich. Der Schlüssel der Zielressource, für die die Richtlinien aufgelöst werden sollen.

pageSize

integer

Die maximale Anzahl von Richtlinien, die zurückgegeben werden sollen. Die Standardeinstellung ist 100, das Maximum ist 1.000.

pageToken

string

Das Seitentoken, das zum Abrufen einer bestimmten Seite der Anfrage verwendet wird.

Antworttext

Antwortnachricht zum Abrufen des aufgelösten Richtlinienwerts für ein bestimmtes Ziel.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "resolvedPolicies": [
    {
      object (ResolvedPolicy)
    }
  ],
  "nextPageToken": string
}
Felder
resolvedPolicies[]

object (ResolvedPolicy)

Die Liste der geklärten Richtlinien, die in der Anfrage zur Lösung gefunden wurden.

nextPageToken

string

Das Seitentoken, mit dem der nächste Satz geklärter Richtlinien abgerufen wird, die in der Anfrage gefunden wurden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

ResolvedPolicy

Der aufgelöste Wert einer Richtlinie für ein bestimmtes Ziel.

JSON-Darstellung
{
  "targetKey": {
    object (PolicyTargetKey)
  },
  "value": {
    object (PolicyValue)
  },
  "sourceKey": {
    object (PolicyTargetKey)
  },
  "addedSourceKey": {
    object (PolicyTargetKey)
  }
}
Felder
targetKey

object (PolicyTargetKey)

Nur Ausgabe. Die Zielressource, für die der aufgelöste Richtlinienwert gilt.

value

object (PolicyValue)

Nur Ausgabe. Der aufgelöste Wert der Richtlinie.

sourceKey

object (PolicyTargetKey)

Nur Ausgabe. Die Quellressource, von der dieser Richtlinienwert abgerufen wird. Kann mit targetKey identisch sein, wenn die Richtlinie direkt für das Ziel geändert wird. Andernfalls wäre es eine andere Ressource, von der die Richtlinie ihren Wert erhält (falls zutreffend). Wenn nicht vorhanden, ist die Quelle der Standardwert für den Kunden.

addedSourceKey

object (PolicyTargetKey)

Nur Ausgabe. Der hinzugefügte Quellschlüssel legt fest, auf welcher Ebene eine Entität explizit zur Verwaltung hinzugefügt wurde. Dies ist bei bestimmten Richtlinientypen nützlich, die nur angewendet werden, wenn sie explizit zur Verwaltung hinzugefügt werden. Beispiele: Apps und Netzwerke. Eine Entität kann nur in einer Organisationseinheit aus der Verwaltung gelöscht werden, der sie explizit hinzugefügt wurde. Wenn diese Option nicht vorhanden ist, wird die Richtlinie verwaltet, ohne dass eine Entität wie Standardnutzer- oder Geräterichtlinien explizit hinzugefügt werden muss.