Method: projects.datasets.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca tutti i set di dati per il progetto specificato.
Richiesta HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. Il nome del progetto per il quale elencare tutti i set di dati. Formato: projects/{project}
|
Parametri di query
| Parametri |
pageSize |
integer
Il numero massimo di set di dati da restituire per pagina. Se non specificati (o zero), verranno restituiti tutti i set di dati.
|
pageToken |
string
Il token di pagina, ricevuto da una precedente chiamata dataset.list. Forniscilo per recuperare la pagina successiva.
|
tag |
string
Il tag che specifica la versione desiderata per ogni set di dati. Tieni presente che quando viene specificata anche l'impaginazione, alcuni filtri possono essere applicati dopo l'impaginazione, il che potrebbe causare la presenza nella risposta di un numero inferiore di set di dati rispetto alle dimensioni della pagina, anche se non si tratta dell'ultima pagina. Tag "active": ogni set di dati nella risposta includerà le informazioni dell'ultima versione completata e, se non è presente, il set di dati verrà ignorato.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Oggetto risposta di dataset.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"datasets": [
{
object (Dataset)
}
],
"nextPageToken": string
} |
| Campi |
datasets[] |
object (Dataset)
Tutti i set di dati per il progetto.
|
nextPageToken |
string
Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Autorizzazioni IAM
Richiede la seguente autorizzazione IAM per la risorsa parent:
mapsplatformdatasets.datasets.list
Per saperne di più, consulta la documentazione IAM.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eLists all datasets within a specified Google Cloud project, returning details like dataset information and pagination tokens for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size, page token, and version tag to customize the dataset retrieval process.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003emapsplatformdatasets.datasets.list\u003c/code\u003e IAM permission on the target project.\u003c/p\u003e\n"],["\u003cp\u003eUses a simple HTTP GET request with path and query parameters to specify the project and filtering criteria.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing an array of datasets and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This document outlines the process of listing datasets within a specified project. It uses a `GET` request to the provided URL, including the project name as a required path parameter. Optional query parameters like `pageSize`, `pageToken`, and `tag` can filter and paginate results. The request body must be empty. The response includes an array of dataset objects and a `nextPageToken` for further pagination. The request requires the `mapsplatformdatasets.datasets.list` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope.\n"],null,["# Method: projects.datasets.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDatasetsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nLists all the datasets for the specified project.\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the project to list all the datasets for. Format: projects/{project} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of datasets to return per page. If unspecified (or zero), all datasets will be returned. |\n| `pageToken` | `string` The page token, received from a previous datasets.list call. Provide this to retrieve the subsequent page. |\n| `tag` | `string` The tag that specifies the desired version for each dataset. Note that when pagination is also specified, some filtering can happen after pagination, which may cause the response to contain fewer datasets than the page size, even if it's not the last page. Tag \"active\": Each dataset in the response will include the info of its latest completed version, and the dataset will be skipped if it does not have one. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse object of datasets.list.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"datasets\": [ { object (/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `datasets[]` | `object (`[Dataset](/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset)`)` All the datasets for the project. |\n| `nextPageToken` | `string` A token that can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `mapsplatformdatasets.datasets.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
