Method: debug.datasources.items.checkAccess
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Comprueba si el principal especificado puede acceder a un elemento. El principal debe ser un usuario. No se admiten valores de grupos ni dominios.
Nota: Esta API requiere una cuenta de administrador para ejecutarse.
Solicitud HTTP
POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
name |
string
Nombre del artículo, formato: datasources/{sourceId}/items/{itemId}
|
Parámetros de consulta
| Parámetros |
debugOptions |
object (DebugOptions)
Opciones de depuración comunes.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Principal.
Cuerpo de la respuesta
Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:
| Representación JSON |
{
"hasAccess": boolean
} |
| Campos |
hasAccess |
boolean
Muestra verdadero si el principal tiene acceso. De lo contrario, muestra un valor falso.
|
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/cloud_search.debughttps://www.googleapis.com/auth/cloud_search
Para obtener más información, consulta la Guía de autorización.
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-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Method: debug.datasources.items.checkAccess\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.CheckAccessResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nChecks whether an item is accessible by specified principal. Principal must be a user; groups and domain values aren't supported.\n\n**Note:** This API requires an admin account to execute.\n\n### HTTP request\n\n`POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------|\n| `name` | `string` Item name, format: datasources/{sourceId}/items/{itemId} |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------|\n| `debugOptions` | `object (`[DebugOptions](/workspace/cloud-search/docs/reference/rest/v1/DebugOptions)`)` Common debug options. |\n\n### Request body\n\nThe request body contains an instance of [Principal](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#Principal).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------|\n| ``` { \"hasAccess\": boolean } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------|\n| `hasAccess` | `boolean` Returns true if principal has access. Returns false otherwise. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.debug`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
