Method: projects.datasets.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtiene el conjunto de datos.
Solicitud HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
name |
string
Obligatorio. Nombre del recurso. Formato: projects/{project}/datasets/{datasetId} También puedes recuperar algunas versiones especiales agregando “@” y una etiqueta. Formato: projects/{project}/datasets/{datasetId}@{tag} Etiqueta “active”: Se incluirá la información de la última versión completada, y NOT_FOUND si el conjunto de datos no tiene una.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Dataset.
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 name:
mapsplatformdatasets.datasets.get
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\u003eRetrieves a specific dataset's information using its resource name, including optional version tags.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns a \u003ccode\u003eDataset\u003c/code\u003e object upon success.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and \u003ccode\u003emapsplatformdatasets.datasets.get\u003c/code\u003e IAM permission for access.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes gRPC Transcoding syntax in the HTTP request URL for resource identification.\u003c/p\u003e\n"]]],["This outlines how to retrieve a dataset using a `GET` HTTP request to a specific URL, defined by a dataset `name` in the format `projects/{project}/datasets/{datasetId}`. The request body must be empty. A successful response returns a `Dataset` instance. Authorization requires the OAuth scope `https://www.googleapis.com/auth/cloud-platform` and the IAM permission `mapsplatformdatasets.datasets.get` on the dataset resource. You can fetch special versions by adding a tag.\n"],null,["# Method: projects.datasets.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nGets the dataset.\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name. Format: projects/{project}/datasets/{datasetId} Can also fetch some special versions by appending \"@\" and a tag. Format: projects/{project}/datasets/{datasetId}@{tag} Tag \"active\": The info of the latest completed version will be included, and NOT_FOUND if the dataset does not have one. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Dataset](/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset).\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 `name` resource:\n\n- `mapsplatformdatasets.datasets.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
