Documento di rilevamento

I documenti di rilevamento sono disponibili per versioni specifiche della maggior parte delle API. Il documento di rilevamento di ogni API descrive la superficie dell'API, come accedere all'API e come sono strutturate le richieste e le risposte dell'API. Le informazioni fornite dal documento di rilevamento includono proprietà a livello di API, come una descrizione dell'API, schemi di risorse, ambiti di autenticazione e metodi.

Metodi

Il documento di Discovery è incentrato sul metodo RESTful per richiamare un'API. Il metodo discovery.apis.list restituisce l'elenco di tutte le API supportate dal servizio di rilevamento delle API di Google, inclusi gli URL per il recupero dei documenti di rilevamento basati su REST.

list
Recupera l'elenco delle API supportate in questo endpoint.

Rappresentazioni delle risorse

{
  "kind": "discovery#restDescription",
  "discoveryVersion": "v1",
  "id": string,
  "name": string,
  "canonicalName": string,
  "version": string,
  "revision": string,
  "title": string,
  "description": string,
  "icons": {
    "x16": string,
    "x32": string
  },
  "documentationLink": string,
  "labels": [
    string
  ],
  "protocol": "rest",
  "baseUrl": string,
  "basePath": string,
  "rootUrl": string,
  "servicePath": string,
  "batchPath": "batch",
  "endpoints": [
    {
      "endpointUrl": string,
      "location": string,
      "deprecated": boolean,
      "description": string
    }
  ],
  "parameters": {
    (key): {
      "id": string,
      "type": string,
      "$ref": string,
      "description": string,
      "default": string,
      "required": boolean,
      "format": string,
      "pattern": string,
      "minimum": string,
      "maximum": string,
      "enum": [
        string
      ],
      "enumDescriptions": [
        string
      ],
      "repeated": boolean,
      "location": string,
      "properties": {
        (key): (JsonSchema)
      },
      "additionalProperties": (JsonSchema),
      "items": (JsonSchema),
      "annotations": {
        "required": [
          string
        ]
      }
    }
  },
  "auth": {
    "oauth2": {
      "scopes": {
        (key): {
          "description": string
        }
      }
    }
  },
  "features": [
    string
  ],
  "schemas": {
    (key): {
      "id": string,
      "type": string,
      "$ref": string,
      "description": string,
      "default": string,
      "required": boolean,
      "deprecated": boolean,
      "format": string,
      "pattern": string,
      "minimum": string,
      "maximum": string,
      "enum": [
        string
      ],
      "enumDescriptions": [
        string
      ],
      "enumDeprecated": [
        boolean
      ],
      "repeated": boolean,
      "location": string,
      "properties": {
        (key): (JsonSchema)
      },
      "additionalProperties": (JsonSchema),
      "items": (JsonSchema),
      "annotations": {
        "required": [
          string
        ]
      }
    }
  },
  "methods": {
    (key): {
      "id": string,
      "path": string,
      "httpMethod": string,
      "description": string,
      "deprecated": boolean,
      "parameters": {
        (key): {
          "id": string,
          "type": string,
          "$ref": string,
          "description": string,
          "default": string,
          "required": boolean,
          "deprecated": boolean,
          "format": string,
          "pattern": string,
          "minimum": string,
          "maximum": string,
          "enum": [
            string
          ],
          "enumDescriptions": [
            string
          ],
          "enumDeprecated": [
            boolean
          ],
          "repeated": boolean,
          "location": string,
          "properties": {
            (key): (JsonSchema)
          },
          "additionalProperties": (JsonSchema),
          "items": (JsonSchema),
          "annotations": {
            "required": [
              string
            ]
          }
        }
      },
      "parameterOrder": [
        string
      ],
      "request": {
        "$ref": string
      },
      "response": {
        "$ref": string
      },
      "scopes": [
        (value)
      ],
      "supportsMediaDownload": boolean,
      "supportsMediaUpload": boolean,
      "mediaUpload": {
        "accept": [
          string
        ],
        "maxSize": string,
        "protocols": {
          "simple": {
            "multipart": true,
            "path": string
          },
          "resumable": {
            "multipart": true,
            "path": string
          }
        }
      },
      "supportsSubscription": boolean
    }
  },
  "resources": {
    (key): {
      "methods": {
        (key): {
          "id": string,
          "path": string,
          "httpMethod": string,
          "description": string,
          "deprecated": boolean,
          "parameters": {
            (key): {
              "id": string,
              "type": string,
              "$ref": string,
              "description": string,
              "default": string,
              "required": boolean,
              "deprecated": boolean,
              "format": string,
              "pattern": string,
              "minimum": string,
              "maximum": string,
              "enum": [
                string
              ],
              "enumDescriptions": [
                string
              ],
              "enumDeprecated": [
                boolean
              ],
              "repeated": boolean,
              "location": string,
              "properties": {
                (key): (JsonSchema)
              },
              "additionalProperties": (JsonSchema),
              "items": (JsonSchema),
              "annotations": {
                "required": [
                  string
                ]
              }
            }
          },
          "parameterOrder": [
            string
          ],
          "request": {
            "$ref": string
          },
          "response": {
            "$ref": string
          },
          "scopes": [
            (value)
          ],
          "supportsMediaDownload": boolean,
          "supportsMediaUpload": boolean,
          "mediaUpload": {
            "accept": [
              string
            ],
            "maxSize": string,
            "protocols": {
              "simple": {
                "multipart": true,
                "path": string
              },
              "resumable": {
                "multipart": true,
                "path": string
              }
            }
          },
          "supportsSubscription": boolean
        }
      },
      "deprecated": boolean,
      "resources": {
        (key): (RestResource)
      }
    }
  }
}
Nome proprietà Valore Descrizione Note
kind string Il tipo di questa risposta.La stringa corretta discovery#restDescription.
discoveryVersion string Indica la versione dell'API Discovery utilizzata per generare questo documento.
id string L'ID del documento di rilevamento per l'API. Ad esempio, urlshortener:v1.
name string Il nome dell'API. Ad esempio, urlshortener.
canonicalName string Il nome canonico dell'API. Ad esempio, Url Shortener.
version string La versione dell'API. Ad esempio, v1.
revision string La revisione dell'API.
title string Il titolo dell'API. Ad esempio, "API Google Url Shortener".
description string La descrizione di questa API.
icons object Link a icone 16 x 16 e 32 x 32 che rappresentano l'API.
icons.x16 string L'URL dell'icona 16 x 16.
icons.x32 string L'URL dell'icona 32x32.
labels[] list Etichette per lo stato di questa API. I valori validi includono limited_availability o deprecated.
protocol string Il protocollo descritto dal documento. ad esempio REST.
rootUrl string L'URL principale in cui sono attivi tutti i servizi API.
endpoints[] list Un elenco di oggetti endpoint basati sulla posizione per questa API. Ogni oggetto contiene l'URL dell'endpoint, la posizione, la descrizione e lo stato del ritiro.
endpoints[].endpointUrl string L'URL dell'host di destinazione dell'endpoint.
endpoints[].location string La posizione dell'endpoint.
endpoints[].description string Una stringa che descrive l'host indicato dall'URL.
endpoints[].deprecated boolean Indica se questo endpoint è deprecato.
parameters object Parametri comuni che si applicano a tutti gli API.
parameters.(key) nested object Descrizione di un singolo parametro.
parameters.(key).id string Identificatore univoco per questo schema.
parameters.(key).type string Il tipo di valore per questo schema. Un elenco di valori è disponibile nella sezione "type" dello schema JSON.
parameters.(key).$ref string Un riferimento a un altro schema. Il valore di questa proprietà è l'ID di un altro schema.
parameters.(key).description string Una descrizione dell'oggetto.
parameters.(key).default string Il valore predefinito di questa proprietà (se esistente).
parameters.(key).required boolean Indica se il parametro è obbligatorio.
parameters.(key).format string Un'espressione o una chiave regolare aggiuntiva che aiuta a limitare il valore. Per maggiori dettagli, consulta l'articolo Riepilogo tipo e formato.
parameters.(key).pattern string L'espressione regolare a cui deve essere conforme questo parametro.
parameters.(key).minimum string Il valore minimo di questo parametro.
parameters.(key).maximum string Il valore massimo di questo parametro.
parameters.(key).enum[] list Valori che questo parametro può assumere (se è un'enumerazione).
parameters.(key).enumDescriptions[] list Le descrizioni per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nella matrice enum.
parameters.(key).repeated boolean Indica se questo parametro può essere visualizzato più volte.
parameters.(key).location string Indica se questo parametro deve essere inserito nella query o nel percorso per le richieste REST.
parameters.(key).properties object Se si tratta di uno schema per un oggetto, elenca lo schema per ogni proprietà dell'oggetto.
parameters.(key).properties.(key) nested object Una sola proprietà di questo oggetto. Il valore stesso è un oggetto schema JSON che descrive questa proprietà.
parameters.(key).additionalProperties nested object Se si tratta di uno schema per un oggetto, questa proprietà è lo schema per tutte le eventuali proprietà aggiuntive con chiavi dinamiche su questo oggetto.
parameters.(key).items nested object Se si tratta di uno schema per un array, questa proprietà è lo schema per ogni elemento nell'array.
parameters.(key).annotations object Ulteriori informazioni su questa proprietà.
parameters.(key).annotations.required[] list Un elenco di metodi che richiedono questa proprietà nelle richieste.
auth object Informazioni di autenticazione.
auth.oauth2 object Informazioni di autenticazione OAuth 2.0.
auth.oauth2.scopes object Ambiti OAuth 2.0 disponibili.
auth.oauth2.scopes.(key) object Il valore dell'ambito.
auth.oauth2.scopes.(key).description string Descrizione dell'ambito.
features[] list Un elenco delle funzionalità supportate per questa API.
schemas object Gli schemi per questa API.
schemas.(key) nested object Una singola descrizione dello schema.
schemas.(key).id string Identificatore univoco per questo schema. Esempio: URL
schemas.(key).type string Il tipo di valore per questo schema. Un elenco dei valori è reperibile nella sezione "type" dello schema JSON.
schemas.(key).$ref string Un riferimento a un altro schema. Il valore di questa proprietà è l'ID di un altro schema.
schemas.(key).description string Una descrizione dell'oggetto.
schemas.(key).default string Il valore predefinito di questa proprietà (se esistente).
schemas.(key).required boolean Indica se il parametro è obbligatorio.
schemas.(key).deprecated boolean Indica se questo schema è deprecato.
schemas.(key).format string Un'espressione o una chiave regolare aggiuntiva che aiuta a limitare il valore.Per maggiori dettagli, consulta la sezione Riepilogo tipo e formato.
schemas.(key).pattern string L'espressione regolare a cui deve essere conforme questo parametro.
schemas.(key).minimum string Il valore minimo di questo parametro.
schemas.(key).maximum string Il valore massimo di questo parametro.
schemas.(key).enum[] list Valori che questo parametro può assumere (se è un'enumerazione).
schemas.(key).enumDescriptions[] list Le descrizioni per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
schemas.(key).enumDeprecated[] list Lo stato di ritiro per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
schemas.(key).repeated boolean Indica se questo parametro può essere visualizzato più volte.
schemas.(key).location string Indica se questo parametro deve essere inserito nella query o nel percorso per le richieste REST.
schemas.(key).properties object Se si tratta di uno schema per un oggetto, elenca lo schema per ogni proprietà dell'oggetto.
schemas.(key).properties.(key) nested object Una sola proprietà di questo oggetto. Il valore stesso è un oggetto schema JSON che descrive questa proprietà.
schemas.(key).additionalProperties nested object Se si tratta di uno schema per un oggetto, questa proprietà è lo schema per tutte le eventuali proprietà aggiuntive con chiavi dinamiche su questo oggetto.
schemas.(key).items nested object Se si tratta di uno schema per un array, questa proprietà è lo schema per ogni elemento nell'array.
schemas.(key).annotations object Ulteriori informazioni su questa proprietà.
schemas.(key).annotations.required[] list Un elenco di metodi che richiedono questa proprietà nelle richieste.
methods object Metodi a livello di API per questa API.
methods.(key) nested object Una descrizione del singolo metodo.
methods.(key).id string Un ID univoco per questo metodo. Questa proprietà può essere utilizzata per trovare corrispondenze tra i diversi metodi di rilevamento delle campagne discovery.
methods.(key).description string Descrizione di questo metodo.
methods.(key).deprecated boolean Indica se questo metodo è deprecato.
methods.(key).parameters object Dettagli di tutti i parametri in questo metodo.
methods.(key).parameters.(key) nested object Dettagli di un singolo parametro in questo metodo.
methods.(key).parameters.(key).id string Identificatore univoco per questo schema.
methods.(key).parameters.(key).type string Il tipo di valore per questo schema. Un elenco di valori è disponibile nella sezione "type" dello schema JSON.
methods.(key).parameters.(key).$ref string Un riferimento a un altro schema. Il valore di questa proprietà è l'ID di un altro schema.
methods.(key).parameters.(key).description string Una descrizione dell'oggetto.
methods.(key).parameters.(key).default string Il valore predefinito di questa proprietà (se esistente).
methods.(key).parameters.(key).required boolean Indica se il parametro è obbligatorio.
methods.(key).parameters.(key).deprecated boolean Indica se il parametro è stato ritirato.
methods.(key).parameters.(key).format string Un'espressione o una chiave regolare aggiuntiva che aiuta a limitare il valore.Per maggiori dettagli, consulta la sezione Riepilogo tipo e formato.
methods.(key).parameters.(key).pattern string L'espressione regolare a cui deve essere conforme questo parametro.
methods.(key).parameters.(key).minimum string Il valore minimo di questo parametro.
methods.(key).parameters.(key).maximum string Il valore massimo di questo parametro.
methods.(key).parameters.(key).enum[] list Valori che questo parametro può assumere (se è un'enumerazione).
methods.(key).parameters.(key).enumDescriptions[] list Le descrizioni per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
methods.(key).parameters.(key).enumDeprecated[] list Lo stato di ritiro per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
methods.(key).parameters.(key).repeated boolean Indica se questo parametro può essere visualizzato più volte.
methods.(key).parameters.(key).location string Indica se questo parametro deve essere inserito nella query o nel percorso per le richieste REST.
methods.(key).parameters.(key).properties object Se si tratta di uno schema per un oggetto, elenca lo schema per ogni proprietà dell'oggetto.
methods.(key).parameters.(key).properties.(key) nested object Una sola proprietà di questo oggetto. Il valore stesso è un oggetto schema JSON che descrive questa proprietà.
methods.(key).parameters.(key).additionalProperties nested object Se si tratta di uno schema per un oggetto, questa proprietà è lo schema per tutte le eventuali proprietà aggiuntive con chiavi dinamiche su questo oggetto.
methods.(key).parameters.(key).items nested object Se si tratta di uno schema per un array, questa proprietà è lo schema per ogni elemento nell'array.
methods.(key).parameters.(key).annotations object Ulteriori informazioni su questa proprietà.
methods.(key).parameters.(key).annotations.required[] list Un elenco di metodi per i quali questa proprietà è obbligatoria nelle richieste.
methods.(key).parameterOrder[] list Elenco ordinato dei parametri obbligatori. Questo serve a suggerire ai clienti come strutturare le firme dei metodi. La matrice viene ordinata in modo tale che il parametro più significativo venga visualizzato per primo.
methods.(key).scopes[] list Ambiti OAuth 2.0 applicabili a questo metodo.
methods.(key).supportsMediaDownload boolean Indica se questo metodo supporta i download multimediali.
methods.(key).supportsMediaUpload boolean Indica se questo metodo supporta i caricamenti multimediali.
methods.(key).mediaUpload object Parametri di caricamento contenuti multimediali.
methods.(key).mediaUpload.accept[] list Intervalli multimediali MIME per caricamenti multimediali accettabili con questo metodo.
methods.(key).mediaUpload.maxSize string Dimensione massima di un caricamento multimediale, ad esempio "1 MB", "2 GB" o "3 TB".
methods.(key).supportsSubscription boolean Indica se questo metodo supporta gli abbonamenti.
baseUrl string [DEPRECATO] L'URL di base per le richieste REST.
basePath string [DEPRECATO] Il percorso di base per le richieste REST.
servicePath string Il percorso di base per tutte le richieste REST.
batchPath string Il percorso per le richieste batch REST.
methods.(key).path string Il percorso URI di questo metodo REST. Da utilizzare in combinazione con la proprietà servicePath a livello di API.
methods.(key).httpMethod string Metodo HTTP utilizzato da questo metodo.
methods.(key).request object Lo schema per la richiesta.
methods.(key).request.$ref string ID schema per lo schema di richiesta.
methods.(key).request.parameterName string [DEPRECATO] Alcune API hanno questo campo per motivi di compatibilità con le versioni precedenti. Può essere ignorato.
methods.(key).response object Lo schema per la risposta.
methods.(key).response.$ref string ID schema per lo schema di risposta.
methods.(key).mediaUpload.protocols object Protocolli di caricamento supportati.
methods.(key).mediaUpload.protocols.simple object Supporta il caricamento come singola richiesta HTTP.
methods.(key).mediaUpload.protocols.simple.multipart boolean True se questo endpoint supporta il caricamento di contenuti multimediali multiparte.
methods.(key).mediaUpload.protocols.simple.path string Il percorso URI da utilizzare per il caricamento. Da utilizzare in combinazione con la proprietà rootURL a livello di API.
methods.(key).mediaUpload.protocols.resumable object Supporta il protocollo Resumable Media Upload.
methods.(key).mediaUpload.protocols.resumable.multipart boolean true se questo endpoint supporta il caricamento di contenuti multimediali multiparte.
methods.(key).mediaUpload.protocols.resumable.path string Il percorso URI da utilizzare per il caricamento. Da utilizzare in combinazione con la proprietà rootURL a livello di API.
resources object Le risorse di questa API.
resources.(key) nested object Descrizione di una singola risorsa. Contiene metodi e risorse secondarie relativi a questa risorsa.
resources.(key).methods object Metodi su questa risorsa.
resources.(key).methods.(key) nested object Descrizione di tutti i metodi su questa risorsa.
resources.(key).methods.(key).id string Un ID univoco per questo metodo. Questa proprietà può essere utilizzata per trovare corrispondenze tra i diversi metodi di rilevamento delle campagne discovery.
resources.(key).methods.(key).path string Il percorso URI di questo metodo REST. Da utilizzare in combinazione con la proprietà servicePath a livello di API.
resources.(key).methods.(key).flatPath string Il percorso URI di questo metodo REST in formato (RFC 6570) senza le funzionalità di livello 2 ({+var}). Supplementare alla proprietà path.
resources.(key).methods.(key).httpMethod string Metodo HTTP utilizzato da questo metodo.
resources.(key).methods.(key).description string Descrizione di questo metodo.
resources.(key).methods.(key).deprecated boolean Indica se questo metodo è deprecato.
resources.(key).methods.(key).parameters object Dettagli di tutti i parametri in questo metodo.
resources.(key).methods.(key).parameters.(key) nested object Dettagli di un singolo parametro in questo metodo.
resources.(key).methods.(key).parameters.(key).id string Identificatore univoco per questo schema.
resources.(key).methods.(key).parameters.(key).type string Il tipo di valore per questo schema. Un elenco di valori è disponibile nella sezione "type" dello schema JSON.
resources.(key).methods.(key).parameters.(key).$ref string Un riferimento a un altro schema. Il valore di questa proprietà è l'"ID" di un altro schema.
resources.(key).methods.(key).parameters.(key).description string Una descrizione dell'oggetto.
resources.(key).methods.(key).parameters.(key).default string Il valore predefinito di questa proprietà (se esistente).
resources.(key).methods.(key).parameters.(key).required boolean Indica se il parametro è obbligatorio.
resources.(key).methods.(key).parameters.(key).deprecated boolean Indica se il parametro è stato ritirato.
resources.(key).methods.(key).parameters.(key).format string Un'espressione o una chiave regolare aggiuntiva che aiuta a limitare il valore.Per maggiori dettagli, consulta la sezione Riepilogo tipo e formato.
resources.(key).methods.(key).parameters.(key).pattern string L'espressione regolare a cui deve essere conforme questo parametro.
resources.(key).methods.(key).parameters.(key).minimum string Il valore minimo di questo parametro.
resources.(key).methods.(key).parameters.(key).maximum string Il valore massimo di questo parametro.
resources.(key).methods.(key).parameters.(key).enum[] list Valori che questo parametro può assumere (se è un'enumerazione).
resources.(key).methods.(key).parameters.(key).enumDescriptions[] list Le descrizioni per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
resources.(key).methods.(key).parameters.(key).enumDeprecated[] list Lo stato di ritiro per le enumerazioni. Ogni posizione viene mappata al valore corrispondente nell'array enum.
resources.(key).methods.(key).parameters.(key).repeated boolean Indica se questo parametro può essere visualizzato più volte.
resources.(key).methods.(key).parameters.(key).location string Indica se questo parametro deve essere inserito nella query o nel percorso per le richieste REST.
resources.(key).methods.(key).parameters.(key).properties object Se si tratta di uno schema per un oggetto, elenca lo schema per ogni proprietà dell'oggetto.
resources.(key).methods.(key).parameters.(key).properties.(key) nested object Una sola proprietà di questo oggetto. Il valore stesso è un oggetto schema JSON che descrive questa proprietà.
resources.(key).methods.(key).parameters.(key).additionalProperties nested object Se si tratta di uno schema per un oggetto, questa proprietà è lo schema per tutte le eventuali proprietà aggiuntive con chiavi dinamiche su questo oggetto.
resources.(key).methods.(key).parameters.(key).items nested object Se si tratta di uno schema per un array, questa proprietà è lo schema per ogni elemento nell'array.
resources.(key).methods.(key).parameters.(key).annotations object Ulteriori informazioni su questa proprietà.
resources.(key).methods.(key).parameters.(key).annotations.required[] list Un elenco di metodi che richiedono questa proprietà nelle richieste.
resources.(key).methods.(key).parameterOrder[] list Elenco ordinato dei parametri obbligatori. Questo serve a suggerire ai clienti come strutturare le firme dei metodi. La matrice viene ordinata in modo tale che il parametro più significativo venga visualizzato per primo.
resources.(key).methods.(key).request object Lo schema per la richiesta.
resources.(key).methods.(key).request.$ref string ID schema per lo schema di richiesta.
resources.(key).methods.(key).response object Lo schema per la risposta.
resources.(key).methods.(key).response.$ref string ID schema per lo schema di risposta.
resources.(key).methods.(key).scopes[] list Ambiti OAuth 2.0 applicabili a questo metodo.
resources.(key).methods.(key).supportsMediaDownload boolean Indica se questo metodo supporta i download multimediali.
resources.(key).methods.(key).supportsMediaUpload boolean Indica se questo metodo supporta i caricamenti multimediali.
resources.(key).methods.(key).mediaUpload object Parametri di caricamento contenuti multimediali.
resources.(key).methods.(key).mediaUpload.accept[] list Intervalli multimediali MIME per caricamenti multimediali accettabili con questo metodo.
resources.(key).methods.(key).mediaUpload.maxSize string Dimensione massima di un caricamento multimediale, ad esempio "1 MB", "2 GB" o "3 TB".
resources.(key).methods.(key).mediaUpload.protocols object Protocolli di caricamento supportati.
resources.(key).methods.(key).mediaUpload.protocols.simple object Supporta il caricamento come singola richiesta HTTP.
resources.(key).methods.(key).mediaUpload.protocols.simple.multipart boolean true se questo endpoint supporta il caricamento di contenuti multimediali multiparte.
resources.(key).methods.(key).mediaUpload.protocols.simple.path string Il percorso URI da utilizzare per il caricamento. Da utilizzare in combinazione con la proprietà rootURL a livello di API.
resources.(key).methods.(key).mediaUpload.protocols.resumable object Supporta il protocollo Resumable Media Upload.
resources.(key).methods.(key).mediaUpload.protocols.resumable.multipart boolean true se questo endpoint supporta il caricamento di contenuti multimediali multiparte.
resources.(key).methods.(key).mediaUpload.protocols.resumable.path string Il percorso URI da utilizzare per il caricamento. Da utilizzare in combinazione con la proprietà rootURL a livello di API.
resources.(key).methods.(key).supportsSubscription boolean Indica se questo metodo supporta gli abbonamenti.
resources.(key).deprecated boolean Indica se questa risorsa è deprecata.
resources.(key).resources object Risorse secondarie su questa risorsa.
resources.(key).resources.(key) nested object Descrizione di eventuali risorse secondarie su questa risorsa.