Esempi di codice

Le richieste di seguito illustrano la gestione dei criteri con l'API Policy. Prima di iniziare, consulta la Panoramica dell'API Chrome Policy per un riepilogo generale delle funzionalità di questa API.

Tutte le richieste presentate di seguito utilizzano le seguenti variabili:

• $TOKEN - Token OAuth 2
• $CUSTOMER: ID del cliente o valore letterale my_customer

Elenca schemi per i criteri delle stampanti

Per elencare gli schemi che riguardano solo i criteri per le stampanti, applicheremo il parametro filter alla richiesta di elenco del servizio schema. Puoi controllare l'impaginazione del risultato utilizzando i parametri pageSize e pageToken.

Richiesta

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas?filter=chrome.printers&pageSize=2"

Risposta

{
  "policySchemas": [
    {
      "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers",
      "policyDescription": "Allows a printer for users in a given organization.",
      "additionalTargetKeyNames": [
        {
          "key": "printer_id",
          "keyDescription": "Id of printer as visible in Admin SDK printers API."
        }
      ],
      "definition": {
        "messageType": [
          {
            "name": "AllowForUsers",
            "field": [
              {
                "name": "allowForUsers",
                "number": 1,
                "label": "LABEL_OPTIONAL",
                "type": "TYPE_BOOL"
              }
            ]
          }
        ]
      },
      "fieldDescriptions": [
        {
          "field": "allowForUsers",
          "description": "Controls whether a printer is allowed for users in a given organization."
        }
      ],
      "schemaName": "chrome.printers.AllowForUsers"
    },
    {
      "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForDevices",
      "policyDescription": "Allows a printer for devices in a given organization.",
      "additionalTargetKeyNames": [
        {
          "key": "printer_id",
          "keyDescription": "Id of printer as visible in Admin SDK printers API."
        }
      ],
      "definition": {
        "messageType": [
          {
            "name": "AllowForDevices",
            "field": [
              {
                "name": "allowForDevices",
                "number": 1,
                "label": "LABEL_OPTIONAL",
                "type": "TYPE_BOOL"
              }
            ]
          }
        ]
      },
      "fieldDescriptions": [
        {
          "field": "allowForDevices",
          "description": "Controls whether a printer is allowed for devices in a given organization."
        }
      ],
      "schemaName": "chrome.printers.AllowForDevices"
    }
  ],
  "nextPageToken": "AEbDN_obE8A98T8YhIeU9VCIZhEBylLBwZRQpGu_DUug-mU4bnzcDx30UnO2xMuuImvfVpmeuXRF6VhJ4OmZpZ4H6EaRvu2qMOPxVN_u"
}

Cerca schemi

Puoi creare query di ricerca complesse utilizzando il parametro filter= nella richiesta dell'elenco Schema Service. Ad esempio, se vuoi cercare schemi che contengono la parola "stampante" nel nome e la parola "devices" nella descrizione, puoi applicare il seguente valore al filtro name=printers AND description=devices.

Scopri come elencare gli schemi dei criteri.

Richiesta

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas?filter=name=printers%20AND%20description=devices"

Risposta

{
  "policySchemas": [
    {
      "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForDevices",
      "policyDescription": "Allows a printer for devices in a given organization.",
      "additionalTargetKeyNames": [
        {
          "key": "printer_id",
          "keyDescription": "Id of printer as visible in Admin SDK printers API."
        }
      ],
      "definition": {
        "messageType": [
          {
            "name": "AllowForDevices",
            "field": [
              {
                "name": "allowForDevices",
                "number": 1,
                "label": "LABEL_OPTIONAL",
                "type": "TYPE_BOOL"
              }
            ]
          }
        ]
      },
      "fieldDescriptions": [
        {
          "field": "allowForDevices",
          "description": "Controls whether a printer is allowed for devices in a given organization."
        }
      ],
      "schemaName": "chrome.printers.AllowForDevices"
    }
  ]
}

Ottieni uno schema particolare

Il risultato riportato sopra mostra un elenco di schemi di criteri supportati. Ogni schema ha un campo name che lo identifica. In futuro, una volta conosciuto il nome dello schema, potrai leggerlo direttamente facendo riferimento al nome dello schema nell'URL della richiesta.

Vediamo un esempio per lo schema chrome.printers.AllowForUsers.

Richiesta

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas/chrome.printers.AllowForUsers"

Risposta

{
  "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers",
  "policyDescription": "Allows a printer for users in a given organization.",
  "additionalTargetKeyNames": [
    {
      "key": "printer_id",
      "keyDescription": "Id of printer as visible in Admin SDK printers API."
    }
  ],
  "definition": {
    "messageType": [
      {
        "name": "AllowForUsers",
        "field": [
          {
            "name": "allowForUsers",
            "number": 1,
            "label": "LABEL_OPTIONAL",
            "type": "TYPE_BOOL"
          }
        ]
      }
    ]
  },
  "fieldDescriptions": [
    {
      "field": "allowForUsers",
      "description": "Controls whether a printer is allowed for users in a given organization."
    }
  ],
  "schemaName": "chrome.printers.AllowForUsers"
}

Sopra la risposta schema dei criteri descrive lo schema del criterio chrome.printers.AllowForUsers. Campo avviso additionalTargetKeyNames. Questo campo spiega che il criterio richiede l'inserimento di chiavi/valori aggiuntivi quando si gestisce il criterio. In particolare, per questo criterio dobbiamo sempre fornire l'identificatore di una stampante.

Lettura di un valore del criterio

Leggiamo un criterio chrome.printers.AllowForUsers per una stampante specifica. Nota l'utilizzo del campo additionalTargetKeys per specificare l'ID stampante nella richiesta.

Puoi leggere un criterio da un'unità organizzativa o da un gruppo.

Nella risposta, nota il campo sourceKey, che specifica l'unità organizzativa o il gruppo da cui proviene il valore del criterio. Per le unità organizzative, sono disponibili le seguenti possibilità:

• Se l'unità organizzativa di origine corrisponde a quella specificata in una richiesta, significa che il criterio viene applicato localmente in questa unità organizzativa.
• Se l'unità organizzativa di origine è diversa dall'unità organizzativa specificata in una richiesta, significa che il criterio viene ereditato dall'unità organizzativa di origine.
• Se sourceKey non è presente o se la risposta è vuota, significa che il criterio non è impostato per il cliente e ha un valore di sistema predefinito.

Per i gruppi, sourceKey sarà sempre uguale al gruppo specificato nella richiesta.

L'esempio seguente riguarda un'unità organizzativa. Una richiesta Group sarebbe la stessa tranne che per targetResource, che avrebbe "groups/" invece di "orgunits/" prima dell'ID.

Richiesta

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
        },
        policySchemaFilter: "chrome.printers.AllowForDevices"
    }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies:resolve"

Risposta

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/03ph8a2z1xdnme9"
        "additionalTargetKeys": {"printer_id":"0gjdgxs208tpef"}
      },
      "value": {
        "policySchema": "chrome.users.AllowForDevices",
        "value": {
          "allowForDevices": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/03ph8a2z3qhz81k"
      }
    }
  ]
}

Tieni presente che tutte le entità nelle risorse di destinazione possono essere recuperate omettendo additionalTargetKeys dalla richiesta. Ad esempio, se additionalTargetKeys veniva omesso dalla richiesta precedente, verrebbero restituite tutte le stampanti nella risorsa di destinazione specificata.

Leggi più norme

Specifica uno spazio dei nomi dello schema con un asterisco (ad es. chrome.printers.*) ti consente di leggere i valori di tutti i criteri in questo spazio dei nomi in una determinata unità organizzativa o gruppo. Scopri di più sugli schemi dei criteri.

L'esempio seguente riguarda un'unità organizzativa. Una richiesta Group sarebbe la stessa tranne che per targetResource, che avrebbe "groups/" invece di "orgunits/" prima dell'ID.

Richiesta

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
        },
        policySchemaFilter: "chrome.printers.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies:resolve"

Risposta

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "printer_id": "0gjdgxs0xd59y1"
        }
      },
      "value": {
        "policySchema": "chrome.printers.AllowForUsers",
        "value": {
          "allowForUsers": false
        }
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "printer_id": "0gjdgxs0xd59y1"
        }
      },
      "value": {
        "policySchema": "chrome.printers.AllowForDevices",
        "value": {
          "allowForDevices": false
        }
      }
    },
    //...
  ],
  "nextPageToken": "AEbDN_pFvDeGSbQDkvMxr4UA0Ew7UEUw8aJyw95VPs2en6YxMmFcWQ9OQQEIeSkjnWFCQNyz5GGoOKQGEd50e2z6WqvM2w7sQz6TMxVOBD_4NmEHRWtIJCYymeYXWHIrNH29Ezl1wkeyYBAOKnE="
}

Modifica valore del criterio

Come mostrato nella risposta dello schema dei criteri, il criterio chrome.printers.AllowForUsers ha un campo denominato allowForUsers. Questo campo è di tipo booleano. Il valore di esempio del criterio potrebbe essere {allowForUsers: false} o {allowForUsers: true}. In questo caso specifico, abbiamo un solo campo, ma gli altri criteri possono contenere più campi.

Nota: i campi con null supportano uno stato null esplicito per forzare l'impostazione predefinita, anziché ereditarli dall'elemento padre. Se imposti il valore dell'oggetto vuoto "{}", verrà impostato su null.

Nelle richieste di modifica, dobbiamo specificare un updateMask. La maschera di aggiornamento elenca tutti i campi che vogliamo modificare. Se il criterio è già stato applicato localmente nell'unità organizzativa, i campi non elencati tramite la maschera di aggiornamento rimarranno invariati. Se il criterio non è già stato applicato localmente nell'unità organizzativa e tutti i campi non elencati tramite la maschera di aggiornamento verranno copiati dall'unità organizzativa principale e, se opportuno, l'intero criterio verrà applicato localmente.

I seguenti esempi si riferiscono a un'unità organizzativa. Le richieste di gruppo sono le stesse tranne per targetResource, che dovrebbe avere "groups/" anziché "orgunits/" prima dell'ID. In questo caso non sarà più consentita una stampante 0gjdgxs208tpef per gli utenti nell'ID unità organizzativa 04fatzly4jbjho9:

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForUsers",
                        value: {allowForUsers: false}
                        },
                updateMask: {paths: "allowForUsers"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Risposta

Una risposta corretta è vuota.

{}

I campi a più valori, come elenchi o array, sono contrassegnati con l'etichetta "LABEL_REPEATED". Per compilare i campi con più valori, utilizza il seguente formato array JSON: [value1, value2, value3, ...].

Ad esempio, per impostare gli URL di origine per i pacchetti di app ed estensioni come "test1.com", "test2.com" e "test3.com", dobbiamo inviare la seguente richiesta:

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
        requests: [
          {
            policy_target_key: {
              target_resource: 'orgunits/03ph8a2z28rz85a'
            },
            updateMask: {
              paths: ['extensionInstallSources']
            },
            policy_value: {
              policy_schema: 'chrome.users.appsconfig.AppExtensionInstallSources', 
              value: {
                extensionInstallSources: ['test1.com', 'test2.com', 'test3.com']
              }
            }
          }
        ]
      }" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Risposta

Una risposta corretta è vuota.

{}

Esistono due versioni di tutti i criteri che contengono campi NullableDuration. La versione originale accetta solo la stringa come input per NullableDuration e ora è deprecata. Utilizza la versione V2 che sostituisce il tipo di durata con un input numerico. Ad esempio, per impostare la durata massima della sessione utente su 10 minuti, dobbiamo inviare la seguente richiesta:

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
        requests: [
          {
            policy_target_key: {
              target_resource: 'orgunits/03ph8a2z28rz85a'
            },
            updateMask: {
              paths: ['sessionDurationLimit']
            },
            policy_value: {
              policy_schema: 'chrome.users.SessionLengthV2',
              value: {
                sessionDurationLimit: {
                  duration: 10
                }
              }
            }
          }
        ]
      }" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Risposta

Una risposta corretta è vuota.

{}

Modificare più criteri contemporaneamente

Il metodo batchModify ti consente di inviare più modifiche ai criteri contemporaneamente. Tuttavia, non tutti i criteri possono essere raggruppati. Per maggiori dettagli, consulta Criteri di aggiornamento collettivo.

Nota: consigliamo di modificare più criteri contemporaneamente in una singola richiesta batchModify per ridurre il numero di richieste al server. Scopri di più sui limiti di utilizzo.

In questo esempio, modificheremo, nella stessa richiesta, due diversi criteri (chrome.printers.AllowForDevices e chrome.printers.AllowForUsers) per la stessa stampante.

L'esempio seguente riguarda un'unità organizzativa. Una richiesta Group sarebbe la stessa tranne che per targetResource, che avrebbe "groups/" invece di "orgunits/" prima dell'ID.

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForDevices",
                        value: {allowForDevices: true}
                        },
                updateMask: {paths: "allowForDevices"}
                },
                {
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForUsers",
                        value: {allowForUsers: true}
                        },
                updateMask: {paths: "allowForUsers"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/C0202nabg/policies/orgunits:batchModify"

Risposta

Una risposta corretta è vuota.

{}

Ereditano il valore di un criterio in un'unità organizzativa

Il metodo batchInherit consente di modificare lo stato del criterio in un'unità organizzativa da "applicato localmente" a "ereditato". I valori locali verranno cancellati e il criterio erediterà i valori da un'unità organizzativa principale, se applicabile.

Il metodo batchInherit consente inoltre di inviare contemporaneamente più richieste di ereditarietà dei criteri. Tuttavia, non tutti i criteri possono essere raggruppati. Per maggiori dettagli, consulta Criteri di aggiornamento collettivo.

Nota: consigliamo di modificare più criteri contemporaneamente in una singola richiesta batchInherit per ridurre il numero di richieste al server. Scopri di più sui limiti di utilizzo.

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly12wd3ox",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policySchema: "chrome.printers.AllowForUsers"
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchInherit"

Risposta

Una risposta corretta è vuota.

{}

Eliminare un valore del criterio in un gruppo

Il metodo batchDelete ti consente di eliminare un criterio da un gruppo. I valori locali verranno cancellati.

Il metodo batchDelete consente inoltre di inviare contemporaneamente più richieste di eliminazione dei criteri. Tuttavia, non tutti i criteri possono essere raggruppati. Per maggiori dettagli, consulta Criteri di aggiornamento collettivo.

Nota: consigliamo di modificare più criteri contemporaneamente in una singola richiesta batchDelete per ridurre il numero di richieste al server. Scopri di più sui limiti di utilizzo.

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "groups/04fatzly12wd3ox",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policySchema: "chrome.printers.AllowForUsers"
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:batchDelete"

Risposta

Una risposta corretta è vuota.

{}

Elencare l'ordinamento di priorità di un gruppo

Il metodo listGroupPriorityOrdering ti consente di elencare l'ordine di priorità dei gruppi per un'app.

L'ordine degli ID gruppo restituiti indica la priorità con cui le impostazioni verranno applicate per l'app; i criteri degli ID successivi verranno sostituiti da criteri con ID che si trovano nelle prime posizioni nell'elenco.

Tieni presente che le priorità del gruppo sono superiori a quelle dell'unità organizzativa.

In questa richiesta, restituiamo l'ordine di priorità per l'app utente di Chrome "exampleapp".

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
                additionalTargetKeys: {"app_id":"chrome:exampleapp"}
                },
        policyNamespace: 'chrome.users.apps'
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:listGroupPriorityOrdering"

Risposta

{
  "policyTargetKey": {
    "additionalTargetKeys": {
      "app_id": "chrome:exampleapp"
    }
  },
  "policyNamespace": "chrome.users.apps",
  "groupIds": [
    "03ep43zb2k1nodu",
    "01t3h5sf2k52kol",
    "03q5sasy2ihwnlz"
  ]
}

Aggiornare l'ordinamento della priorità per un gruppo

Il metodo updateGroupPriorityOrdering consente di aggiornare l'ordine di priorità dei gruppi per un'app.

L'ordine degli ID gruppo nella richiesta indica la priorità con cui le impostazioni verranno applicate per l'app; i criteri degli ID successivi verranno sostituiti da criteri con ID che si trovano nelle prime posizioni nell'elenco. La richiesta deve includere ogni ID gruppo attualmente applicato all'app.

Tieni presente che le priorità del gruppo sono superiori a quelle dell'unità organizzativa.

In questa richiesta, impostiamo l'ordine di priorità per l'app utente di Chrome "exampleapp".

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
                additionalTargetKeys: {"app_id":"chrome:exampleapp"}
                },
        policyNamespace: 'chrome.users.apps',
        groupIds: ['03ep43zb2k1nodu', '01t3h5sf2k52kol', '03q5sasy2ihwnlz']
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:updateGroupPriorityOrdering"

Risposta

Una risposta corretta è vuota.

{}

Gestione delle norme che richiedono l'accettazione

Alcuni schemi di criteri specificano le "notifiche" per determinati valori di un determinato campo che richiedono l'accettazione.

Esempio per il criterio chrome.users.PluginVmAllowd:

{
  "name": "customers/C0202nabg/policySchemas/chrome.users.PluginVmAllowed",
  "policyDescription": "Parallels Desktop.",
  # ...
  "fieldDescriptions": [
    {
      "field": "pluginVmAllowed",
      "description": "N/A",
      "knownValueDescriptions": [
        {
          "value": "true",
          "description": "Allow users to use Parallels Desktop."
        },
        {
          "value": "false",
          "description": "Do not allow users to use Parallels Desktop."
        }
      ]
    },
    {
      "field": "ackNoticeForPluginVmAllowedSetToTrue",
      "description": "This field must be set to true to acknowledge the notice message associated with the field 'plugin_vm_allowed' set to value 'true'. Please see the notices listed with this policy for more information."
    }
  ],
  "notices": [
    {
      "field": "pluginVmAllowed",
      "noticeValue": "true",
      "noticeMessage": "By enabling Parallels Desktop, you agree to the Parallels End-User License Agreement specified at https://www.parallels.com/about/legal/eula/. Warning: Device identifiers may be shared with Parallels. Please see privacy policy for more details at https://www.parallels.com/about/legal/privacy/. The minimum recommended configuration includes an i5 processor, 16 GB RAM, and 128 GB storage: https://support.google.com/chrome/a/answer/10044480.",
      "acknowledgementRequired": true
    }
  ],
  "supportUri": "...",
  "schemaName": "chrome.users.PluginVmAllowed"
}

Nell'esempio precedente, l'impostazione del valore del campo pluginVmAllowed su true è associata a una notifica che ha acknowledgementRequired. Per impostare correttamente questo valore di campo su true, devi inviare a true una richiesta che specifica il campo di accettazione ackNoticeForPluginVmAllowedSetToTrue. In caso contrario, la richiesta verrà visualizzata di errore.

In questo esempio, devi inviare la seguente richiesta di modifica in batch.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
  'requests': [
    {
      'policyTargetKey': {
        'targetResource': 'orgunits/03ph8a2z10ybbh2'
      },
      'policyValue': {
        'policySchema': 'chrome.users.PluginVmAllowed',
        'value': {
          'pluginVmAllowed': true,
          'ackNoticeForPluginVmAllowedSetToTrue': true
        }
      },
      'updateMask': {
        'paths': [
          'pluginVmAllowed',
          'ackNoticeForPluginVmAllowedSetToTrue'
        ]
      }
    }
  ]
}" \
"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Impostazione dei criteri relativi ai file

Per alcuni criteri i campi sono digitati come UploadedFile. Devi caricare il file che vuoi impostare come valore nel server API per ottenere un URL da utilizzare nelle richieste BatchModify.

In questo esempio imposteremo chrome.users.Wallpaper caricando un file JPEG.

Caricamento del file

Richiesta

curl -X POST \
  -H "Content-Type: image/jpeg" \
  -H "Authorization: Bearer $TOKEN" \
  -T "/path/to/the/file" \
  "https://chromepolicy.googleapis.com/upload/v1/customers/$CUSTOMER/policies/files:uploadPolicyFile?policy_field=chrome.users.Wallpaper.wallpaperImage"

Risposta

Una risposta corretta deve contenere l'URL per accedere al file:

{
  "downloadUri": "https://storage.googleapis.com/chromeos-mgmt/0gjdgxs370bkl6/ChromeOsWallpaper/32ac50ab-b5ae-4bba-afa8-b6b443912897"
}

Imposta i criteri relativi ai file

Richiesta

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        },
                policyValue: {
                        policySchema: "chrome.users.Wallpaper",
                        value: {
                          wallpaperImage: {downloadUri: "https://storage.googleapis.com/chromeos-mgmt/0gjdgxs370bkl6/ChromeOsWallpaper/32ac50ab-b5ae-4bba-afa8-b6b443912897"}
                          }
                        },
                updateMask: {paths: "wallpaperImage"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Risposta

Una risposta corretta deve essere vuota.

{}