Method: projects.datasets.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle Datasets für das angegebene Projekt auf.
HTTP-Anfrage
GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Name des Projekts, für das alle Datasets aufgelistet werden sollen. Format: projects/{project}
|
Abfrageparameter
| Parameter |
pageSize |
integer
Die maximale Anzahl von Datasets, die pro Seite zurückgegeben werden sollen. Wenn kein Wert (oder null) angegeben ist, werden alle Datasets zurückgegeben.
|
pageToken |
string
Das Seitentoken, das von einem vorherigen Dataset.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.
|
tag |
string
Das Tag, das die gewünschte Version für jedes Dataset angibt. Wenn auch die Paginierung angegeben ist, kann nach der Paginierung einiges nach der Paginierung gefiltert werden. Dies kann dazu führen, dass die Antwort weniger Datasets als die Seitengröße enthält, auch wenn es sich nicht um die letzte Seite handelt. Tag „aktiv“: Jedes Dataset in der Antwort enthält die Informationen der neuesten fertigen Version. Das Dataset wird übersprungen, wenn es keine Version hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortobjekt von datasets.list.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"datasets": [
{
object (Dataset)
}
],
"nextPageToken": string
} |
| Felder |
datasets[] |
object (Dataset)
Alle Datasets für das Projekt.
|
nextPageToken |
string
Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen
Erfordert die folgende IAM-Berechtigung für die Ressource parent:
mapsplatformdatasets.datasets.list
Weitere Informationen finden Sie in der IAM-Dokumentation.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
