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 |
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 ( |
Felder | |
---|---|
policySchemaFilter |
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 |
Erforderlich. Der Schlüssel der Zielressource, für die die Richtlinien aufgelöst werden sollen. |
pageSize |
Die maximale Anzahl von Richtlinien, die zurückgegeben werden sollen. Der Standardwert ist 100 und die maximale Anzahl liegt bei 1.000. |
pageToken |
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 ( |
Felder | |
---|---|
resolvedPolicies[] |
Die Liste der geklärten Richtlinien, die in der entsprechenden Anfrage gefunden wurden. |
nextPageToken |
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 ( |
Felder | |
---|---|
targetKey |
Nur Ausgabe Die Zielressource, für die der aufgelöste Richtlinienwert gilt. |
value |
Nur Ausgabe Der aufgelöste Wert der Richtlinie. |
sourceKey |
Nur Ausgabe Die Quellressource, von der dieser Richtlinienwert abgerufen wird. Kann mit |
addedSourceKey |
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. |