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 Literal „my_customer“ für den Kunden, der mit der Anfrage verknüpft ist.

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 Anfrage zur Auflösung angewendet werden soll.

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

Platzhalter werden unterstützt, aber nur im Blattteil des Schemanamens. 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.printers.*“ 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. Der Standardwert ist 100 und die maximale Anzahl liegt bei 1.000.

pageToken

string

Das Seitentoken, mit dem eine bestimmte Seite der Anfrage abgerufen wird.

Antworttext

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

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

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

object (ResolvedPolicy)

Die Liste der geklärten Richtlinien, die in der entsprechenden Anfrage gefunden wurden.

nextPageToken

string

Das Seitentoken, mit dem der nächste Satz aufgelöster Richtlinien abgerufen wird, die von der Anfrage gefunden werden.

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 am Ziel geändert wird. Andernfalls wäre sie eine andere Ressource, von der die Richtlinie ihren Wert bezieht (falls zutreffend). Wenn nicht vorhanden, wird die Quelle als Standardwert für den Kunden verwendet.

addedSourceKey

object (PolicyTargetKey)

Nur Ausgabe Der hinzugefügte Quellschlüssel gibt an, auf welcher Ebene eine Entität explizit zur Verwaltung hinzugefügt wurde. Das ist bei bestimmten Richtlinientypen nützlich, die nur angewendet werden, wenn sie ausdrücklich zur Verwaltung hinzugefügt werden. Zum Beispiel: Apps und Netzwerke. Eine Entität kann nur in einer Organisationseinheit aus der Verwaltung gelöscht werden, der sie explizit hinzugefügt wurde. Wenn dieses Feld nicht vorhanden ist, wird die Richtlinie verwaltet, ohne dass explizit eine Entität hinzugefügt werden muss, z. B. Standardnutzer- oder Geräterichtlinien.