Method: debug.datasources.items.checkAccess
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 주 구성원이 항목에 액세스할 수 있는지 확인합니다. 주 구성원은 사용자여야 합니다. 그룹 및 도메인 값은 지원되지 않습니다.
참고: 이 API를 실행하려면 관리자 계정이 필요합니다.
HTTP 요청
POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
상품 이름, 형식: datasources/{sourceId}/items/{itemId}
|
쿼리 매개변수
| 매개변수 |
debugOptions |
object (DebugOptions)
일반적인 디버그 옵션
|
요청 본문
요청 본문에 Principal의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
| JSON 표현 |
{
"hasAccess": boolean
} |
| 필드 |
hasAccess |
boolean
사용자에게 액세스 권한이 있으면 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/cloud_search.debughttps://www.googleapis.com/auth/cloud_search
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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)."]]
