Method: projects.datasets.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de todos los conjuntos de datos del proyecto especificado.
Solicitud HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
parent |
string
Obligatorio. El nombre del proyecto para el que se enumeran todos los conjuntos de datos. Formato: projects/{project}
|
Parámetros de consulta
| Parámetros |
pageSize |
integer
La cantidad máxima de conjuntos de datos que se mostrarán por página. Si no se especifica (o es cero), se mostrarán todos los conjuntos de datos.
|
pageToken |
string
El token de la página, recibido de una llamada anterior de dataset.list Proporciona esto para recuperar la página siguiente.
|
tag |
string
Es la etiqueta que especifica la versión deseada para cada conjunto de datos. Ten en cuenta que cuando también se especifica la paginación, se pueden aplicar algunos filtros después de la paginación, lo que puede provocar que la respuesta contenga menos conjuntos de datos que el tamaño de la página, incluso si no es la última página. Etiqueta “activa”: Cada conjunto de datos en la respuesta incluirá la información de su última versión completada, y el conjunto de datos se omitirá si no tiene una.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Objeto de respuesta de dataset.list.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"datasets": [
{
object (Dataset)
}
],
"nextPageToken": string
} |
| Campos |
datasets[] |
object (Dataset)
Todos los conjuntos de datos del proyecto.
|
nextPageToken |
string
Un token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.
|
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
Permisos de IAM
Se requiere el siguiente permiso de IAM en el recurso parent:
mapsplatformdatasets.datasets.list
Para obtener más información, consulta la documentación de IAM.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)."]]
